Migrando para Claude 4.5

Atualize os parâmetros de amostragem

Esta é uma mudança significativa do Claude Sonnet 3.7.

Use apenas temperature OU top_p, não ambos:

# Antes (Claude Sonnet 3.7) - Isso resultará em erro no Sonnet 4.5
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Não é possível usar ambos
    ...
)

# Depois (Claude Sonnet 4.5)
response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    temperature=0.7,  # Use temperature OU top_p, não ambos
    ...
)

Trate a nova razão de parada refusal

Atualize sua aplicação para tratar razões de parada refusal:

response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Trate a recusa apropriadamente
    pass

Atualize a ferramenta de editor de texto (se aplicável)

Esta é uma mudança significativa do Claude Sonnet 3.7.

Atualize para text_editor_20250728 (tipo) e str_replace_based_edit_tool (nome). Remova qualquer código usando o comando undo_edit.

# Antes (Claude Sonnet 3.7)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Depois (Claude Sonnet 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

Consulte a documentação da ferramenta de editor de texto para detalhes.

Remova o cabeçalho beta de uso de ferramenta eficiente em tokens

O uso de ferramenta eficiente em tokens é um recurso beta que funciona apenas com Claude 3.7 Sonnet. Todos os modelos Claude 4 têm uso de ferramenta eficiente em tokens integrado, portanto você não deve mais incluir o cabeçalho beta.

Remova o cabeçalho beta token-efficient-tools-2025-02-19 de suas solicitações:

# Antes (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["token-efficient-tools-2025-02-19"],  # Remova isto
    ...
)

# Depois (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Sem cabeçalho beta token-efficient-tools
    ...
)

Remova o cabeçalho beta de saída estendida

O cabeçalho beta output-128k-2025-02-19 para saída estendida está disponível apenas no Claude Sonnet 3.7.

Remova este cabeçalho de suas solicitações:

# Antes (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["output-128k-2025-02-19"],  # Remova isto
    ...
)

# Depois (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Sem cabeçalho beta output-128k
    ...
)

Considere ativar o pensamento estendido para tarefas complexas

Ative o pensamento estendido para melhorias significativas de desempenho em tarefas de codificação e raciocínio (desativado por padrão):

response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)

O pensamento estendido impacta a eficiência do cache de prompt.

Atualize o nome do seu modelo:

# Antes (Haiku 3.5)
model="claude-3-5-haiku-20241022"

# Depois (Haiku 4.5)
model="claude-haiku-4-5-20251001"

Atualize as versões de ferramentas (se aplicável)

Esta é uma mudança significativa do Claude Haiku 3.5.

Haiku 4.5 suporta apenas as versões mais recentes de ferramentas:
```
# Antes (Haiku 3.5)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Depois (Haiku 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
```
- Editor de texto: Use text_editor_20250728 e str_replace_based_edit_tool
- Execução de código: Use code_execution_20250825
- Remova qualquer código usando o comando undo_edit

Atualize os parâmetros de amostragem

Esta é uma mudança significativa do Claude Haiku 3.5.

Use apenas temperature OU top_p, não ambos:

# Antes (Haiku 3.5) - Isso resultará em erro no Haiku 4.5
response = client.messages.create(
    model="claude-3-5-haiku-20241022",
    temperature=0.7,
    top_p=0.9,  # Não é possível usar ambos
    ...
)

# Depois (Haiku 4.5)
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    temperature=0.7,  # Use temperature OU top_p, não ambos
    ...
)

Revise os novos limites de taxa

Haiku 4.5 tem limites de taxa separados do Haiku 3.5. Consulte a documentação de limites de taxa para detalhes.
Trate a nova razão de parada refusal

Atualize sua aplicação para tratar razões de parada de recusa.
Considere ativar o pensamento estendido para tarefas complexas

Ative o pensamento estendido para melhorias significativas de desempenho em tarefas de codificação e raciocínio (desativado por padrão):
```
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)
```
O pensamento estendido impacta a eficiência do .
Explore novas capacidades

Consulte O que há de novo no Claude 4.5 para detalhes sobre consciência de contexto, capacidade de saída aumentada (64K tokens), inteligência mais alta e velocidade melhorada.
Teste sua implementação

Teste em um ambiente de desenvolvimento antes de implantar em produção para garantir que todas as mudanças significativas sejam tratadas adequadamente.

Migrando para Claude 4.5

Migrando de Claude Sonnet 3.7 para Claude Sonnet 4.5

Etapas de migração

Migrando para Claude 4.5

Migrando de Claude Sonnet 3.7 para Claude Sonnet 4.5

Etapas de migração

Lista de verificação de migração Sonnet 3.7 → 4.5

Recursos removidos do Claude Sonnet 3.7

Migrando de Claude Haiku 3.5 para Claude Haiku 4.5

Etapas de migração

Lista de verificação de migração Haiku 3.5 → 4.5

Escolhendo entre Sonnet 4.5 e Haiku 4.5

Escolha Claude Sonnet 4.5 (mais inteligente) para:

Escolha Claude Haiku 4.5 (mais rápido e mais inteligente Haiku) para:

Recomendações de pensamento estendido

Outros cenários de migração

Migrando de Claude Sonnet 4 → Sonnet 4.5

Migrando de Claude Opus 4.1 → Sonnet 4.5

Migrando de Claude Opus 4.1 → Opus 4.5

Migrando entre modelos Claude 4.5

Precisa de ajuda?