$ recombobulate _
home / tips / generate-a-typed-api-client-sdk-from-your-openapi-spec-with-claude
105

Generate a Typed API Client SDK from Your OpenAPI Spec with Claude

recombobulate @recombobulate · Mar 26, 2026 · Workflows
generate-a-typed-api-client-sdk-from-your-openapi-spec-with-claude

Code-generated API clients from OpenAPI often produce unwieldy, poorly named output — ask Claude to write a handcrafted client that's actually pleasant to use.

claude "Read openapi.yaml and generate a fully typed TypeScript API client in src/lib/api-client.ts. Use the fetch API, include request/response types for every endpoint, group methods by resource (users, posts, orders), handle errors with a custom ApiError class, and support an auth token passed via constructor."

Claude produces a real client — not a sprawling auto-gen dump — with clean method names derived from the operationIds, proper generic return types, and an interceptor pattern for retries and token refresh.

For a React project, ask Claude to wrap it in a set of TanStack Query hooks at the same time:

claude "Now wrap the API client in React Query hooks in src/hooks/api/. Generate useQuery hooks for GET endpoints and useMutation hooks for POST/PUT/DELETE. Include optimistic updates for mutation hooks where the response matches a cached query key."

You can target any language — Python, Go, PHP:

claude "Read openapi.yaml and generate a Python requests-based client with dataclass models for all request/response bodies. Group by tag, use snake_case method names, and raise a typed APIError on non-2xx responses."

A Claude-written SDK feels like it was written by a developer who knows your codebase — not generated by a tool that doesn't.

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Run Claude Code in GitHub Actions to Automatically Review Every Pull Request

Set up Claude Code as an automated reviewer in your CI pipeline — on every pull request, it reads the diff, checks for bugs, security issues, missing tests, and convention violations, then posts its findings as a PR comment. Your human reviewers get a head start because the obvious issues are already flagged before they look.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Build a Deployment Checklist from Your Actual Infrastructure

Before deploying, tell Claude to read your project — migrations, environment variables, queue workers, scheduled tasks, caching, third-party integrations — and generate a deployment checklist that's specific to your app. Not a generic "did you run migrations?" list, but one that knows YOUR infrastructure and catches the things YOUR deploy can break.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Generate a README from Your Actual Codebase — Not a Template

Instead of writing a README from memory or copying a template, tell Claude to read your project and generate one that's actually accurate — real setup instructions from your config, real architecture from your directory structure, real API examples from your routes, and real prerequisites from your dependency files.

recombobulate @recombobulate · 1 month ago