Repository Public
1---2title: Migrating to Claude Haiku 4.53url: https://platform.claude.com/docs/en/models/haiku-4-5/migration-guide4description: "Migrate to Claude Haiku 4.5 from earlier Haiku models: model IDs, breaking changes, and a migration checklist."5---67<Note>8 This guide covers migrating [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) code. If you use [Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview), no changes beyond updating the model name are required.9</Note>1011<Tip>12 **Automate your migration with the Claude API skill.** In Claude Code, run `/claude-api migrate` to invoke the bundled [Claude API skill](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model). It works for any current Claude model as the target:1314 ```text wrap15 /claude-api migrate this project to claude-haiku-4-516 ```1718 The skill applies the model ID swap and, as needed, breaking parameter changes, prefill replacement, and effort calibration for your target model across your code base, then produces a checklist of items to verify manually. It asks you to confirm the migration scope (entire working directory, a subdirectory, or a specific file list) before editing any files. The skill also detects Amazon Bedrock and Claude Platform on AWS clients and adjusts model ID formats and feature changes for those platforms.19</Tip>2021Claude Haiku 4.5 is the fastest and most intelligent Haiku model with near-frontier performance, delivering premium model quality for interactive applications and high-volume processing.2223For a complete overview of capabilities, see the [models overview](https://platform.claude.com/docs/en/models/overview).2425<Note>26 For Claude Haiku 4.5 pricing, see [Claude pricing](https://platform.claude.com/docs/en/about-claude/pricing).27</Note>2829<Tip>30 For significant performance improvements on coding and reasoning tasks, consider enabling extended thinking with `thinking: {type: "enabled", budget_tokens: N}`.31</Tip>3233<Note>34 Extended thinking impacts [prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#caching-with-thinking-blocks) efficiency.3536 Extended thinking is deprecated in Claude 4.6 models and removed in Claude Opus 4.7. If using newer models, use [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking) instead.37</Note>3839## Migrating to Claude Haiku 4.5 from Claude Haiku 3.5 and earlier Haiku models4041**Update your model name:**4243```python44# From Haiku 3.545model = "claude-3-5-haiku-20241022" # Before46model = "claude-haiku-4-5-20251001" # After47```4849**Review new rate limits:** Haiku 4.5 has separate rate limits from Haiku 3.5. See [Rate limits](https://platform.claude.com/docs/en/api/rate-limits) documentation for details.5051**Explore new capabilities:** See the [models overview](https://platform.claude.com/docs/en/models/overview) for details on context awareness, increased output capacity (64k tokens), higher intelligence, and improved speed.5253### Breaking changes5455These breaking changes apply when migrating from Claude 3.x Haiku models.56571. **Update sampling parameters**5859 <Warning>60 This is a breaking change when migrating from Claude 3.x models.61 </Warning>6263 Use only `temperature` OR `top_p`, not both. Setting both returns a 400 error on Claude Haiku 4.5.64652. **Update tool versions**6667 <Warning>68 This is a breaking change when migrating from Claude 3.x models.69 </Warning>7071 Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.72733. **Handle the `refusal` stop reason**7475 Update your application to [handle `refusal` stop reasons](https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).76774. **Update your prompts for behavioral changes**7879 Claude 4 models have a more concise, direct communication style. Review [prompting best practices](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.8081### Haiku 4.5 migration checklist8283* Update model ID to `claude-haiku-4-5-20251001`84* **BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported85* **BREAKING:** Remove any code using the `undo_edit` command (if applicable)86* **BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both (setting both returns a 400 error)87* Handle new `refusal` stop reason in your application88* Review and adjust for new rate limits (separate from Haiku 3.5)89* Review and update prompts following [prompting best practices](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)90* Consider enabling extended thinking for complex reasoning tasks91* Test in development environment before production deployment92