@anthropic-ai/sdk migration guide
Plan an Anthropic TypeScript SDK upgrade through the 0.50.1 client rewrite, selected 0.x changes and legacy Completions removal in 1.0.
Start an @anthropic-ai/sdk upgrade with the client rewrite if you still depend on old upload helpers, shims or core imports. Moving to 1.0 also removes the legacy Completions surface. Check the intervening 0.x release pages for changes to the message, tool and client types your code uses.
Choose your migration path
- Migrate the client plumbing in 0.50.1: fileFromPath and the fetch shims are removed, APIClient is replaced, and public core modules move. Some import moves have deterministic patches. Other edits need a named model provider, and internal upload helper removals are report only.
- Move off legacy Completions for 1.0: Review imports of Completions, its parameter types, HUMAN_PROMPT and AI_PROMPT. The release guide explains the removals and the limits of possible patches; it does not promise to convert an entire application to Messages.
Check your upgrade
Check your installed version in the manifest and lockfile, then read the release pages your upgrade crosses. Run npx emendant scan to find supported changes in TypeScript and JavaScript source without editing your files. Use npx emendant fix --dry-run to preview deterministic patches where available. The preview does not install dependencies, run your checks or call a model. Assisted patches need a named model provider and a fix run without --dry-run. After updating dependencies, run your typecheck and tests and review the patch grades in the fix guide.
Coverage and limits
Coverage is limited to the changes listed on these pages. A finding on an exported type does not prove that the changed member affects your code. Review the member you supply or read, then check your application against the tagged sources and the target SDK.
The linked release pages list covered findings, possible fixes and tagged sources. A clean scan does not prove that every migration step is complete. Read the supported projects guide for the scan's scope.
@anthropic-ai/sdk release pages
- @anthropic-ai/sdk 1.0.0: legacy Completions removed
@anthropic-ai/sdk 1.0.0, released 21 October 2026. 17 breaking, 0 deprecations. - @anthropic-ai/sdk 0.x breaking changes: 0.50.1 to 0.135.0
15 releases, 0.50.1 to 0.135.0, released 9 May 2025 to 15 October 2026. 34 breaking, 1 deprecation.
Releases without a page here may still be in the feed. Run emendant feed status to see what your snapshot holds.