Este guia aborda dois caminhos principais de migração para os modelos Claude 4.5:
  • Claude Sonnet 3.7 → Claude Sonnet 4.5: Nosso modelo mais inteligente com capacidades de raciocínio, codificação e agentes de longa duração de primeira classe
  • Claude Haiku 3.5 → Claude Haiku 4.5: Nosso modelo Haiku mais rápido e inteligente com desempenho quase de fronteira para aplicações em tempo real e processamento inteligente de alto volume
Ambas as migrações envolvem mudanças críticas que requerem atualizações na sua implementação. Este guia irá orientá-lo através de cada caminho de migração com instruções passo a passo e mudanças críticas claramente marcadas. Antes de iniciar sua migração, recomendamos revisar O que há de novo no Claude 4.5 para entender os novos recursos e capacidades disponíveis nestes modelos, incluindo pensamento estendido, consciência de contexto e melhorias comportamentais.

​
Migrando do Claude Sonnet 3.7 para Claude Sonnet 4.5

Claude Sonnet 4.5 é nosso modelo mais inteligente, oferecendo desempenho de primeira classe para raciocínio, codificação e agentes autônomos de longa duração. Esta migração inclui várias mudanças críticas que requerem atualizações na sua implementação.

​
Passos da migração

  1. Atualize o nome do seu modelo: 
    # Antes (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"

# Depois (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
  2. Atualize os parâmetros de amostragem
    Esta é uma mudança crítica do Claude Sonnet 3.7.
    Use apenas temperature OU top_p, não ambos: 
    # Antes (Claude Sonnet 3.7) - Isto causará erro no Sonnet 4.5
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Não pode 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
    ...
)
  3. Trate o novo motivo de parada refusal Atualize sua aplicação para tratar motivos de parada refusal: 
    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Trate a recusa apropriadamente
    pass
  4. Atualize a ferramenta de editor de texto (se aplicável)
    Esta é uma mudança crítica 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"}]
    Veja Documentação da ferramenta de editor de texto para detalhes.
  5. Atualize a ferramenta de execução de código (se aplicável) Atualize para code_execution_20250825. A versão legada code_execution_20250522 ainda funciona mas não é recomendada. Veja Documentação da ferramenta de execução de código para instruções de migração.
  6. Remova o cabeçalho beta de uso eficiente de tokens Uso eficiente de tokens é um recurso beta no Claude 3.7. Todos os modelos Claude 4 têm uso eficiente de tokens integrado, então você não deve mais incluir o cabeçalho beta. Remova o cabeçalho beta token-efficient-tools-2025-02-19 das suas requisiçõ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
    ...
)
  7. 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 das suas requisiçõ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
    ...
)
  8. Atualize seus prompts para mudanças comportamentais Claude Sonnet 4.5 tem um estilo de comunicação mais conciso e direto e requer direção explícita. Revise Melhores práticas de engenharia de prompt do Claude 4 para orientação de otimização.
  9. Considere habilitar pensamento estendido para tarefas complexas Habilite pensamento estendido para melhorias significativas de desempenho em tarefas de codificação e raciocínio (desabilitado por padrão): 
    response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)
    Pensamento estendido impacta a eficiência do cache de prompt.
  10. Teste sua implementação
Teste em um ambiente de desenvolvimento antes de implantar em produção para garantir que todas as mudanças críticas sejam tratadas adequadamente.

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

  • Atualize o ID do modelo para claude-sonnet-4-5-20250929
  • CRÍTICO: Atualize os parâmetros de amostragem para usar apenas temperature OU top_p, não ambos
  • Trate o novo motivo de parada refusal na sua aplicação
  • CRÍTICO: Atualize a ferramenta de editor de texto para text_editor_20250728 e str_replace_based_edit_tool (se aplicável)
  • CRÍTICO: Remova qualquer código usando o comando undo_edit (se aplicável)
  • Atualize a ferramenta de execução de código para code_execution_20250825 (se aplicável)
  • Remova o cabeçalho beta token-efficient-tools-2025-02-19 (se aplicável)
  • Remova o cabeçalho beta output-128k-2025-02-19 (se aplicável)
  • Revise e atualize prompts seguindo melhores práticas do Claude 4
  • Considere habilitar pensamento estendido para tarefas de raciocínio complexas
  • Trate o motivo de parada model_context_window_exceeded (específico do Sonnet 4.5)
  • Considere habilitar a ferramenta de memória para agentes de longa duração (beta)
  • Considere usar limpeza automática de chamadas de ferramenta para edição de contexto (beta)
  • Teste em ambiente de desenvolvimento antes da implantação em produção

​
Recursos removidos do Claude Sonnet 3.7

  • Uso eficiente de tokens: O cabeçalho beta token-efficient-tools-2025-02-19 não é suportado (veja passo 6)
  • Saída estendida: O cabeçalho beta output-128k-2025-02-19 não é suportado (veja passo 7)
Ambos os cabeçalhos podem ser incluídos nas requisições mas não terão efeito.

​
Migrando do Claude Haiku 3.5 para Claude Haiku 4.5

Claude Haiku 4.5 é nosso modelo Haiku mais rápido e inteligente com desempenho quase de fronteira, oferecendo qualidade de modelo premium com desempenho em tempo real para aplicações interativas e processamento inteligente de alto volume. Esta migração inclui várias mudanças críticas que requerem atualizações na sua implementação. Para uma visão completa das novas capacidades, veja O que há de novo no Claude 4.5.
Preço do Haiku 4.5: 1pormilha~odetokensdeentrada,1 por milhão de tokens de entrada, 5 por milhão de tokens de saída. Veja Preços do Claude para detalhes.

​
Passos da migração

  1. 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"
  2. Atualize as versões das ferramentas (se aplicável)
    Esta é uma mudança crítica do Claude Haiku 3.5.
    Haiku 4.5 suporta apenas as versões mais recentes das 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
  3. Atualize os parâmetros de amostragem
    Esta é uma mudança crítica do Claude Haiku 3.5.
    Use apenas temperature OU top_p, não ambos: 
    # Antes (Haiku 3.5) - Isto causará erro no Haiku 4.5
response = client.messages.create(
    model="claude-3-5-haiku-20241022",
    temperature=0.7,
    top_p=0.9,  # Não pode 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
    ...
)
  4. Revise os novos limites de taxa Haiku 4.5 tem limites de taxa separados do Haiku 3.5. Veja Documentação de limites de taxa para detalhes.
  5. Trate o novo motivo de parada refusal Atualize sua aplicação para tratar motivos de parada de recusa.
  6. Considere habilitar pensamento estendido para tarefas complexas Habilite pensamento estendido para melhorias significativas de desempenho em tarefas de codificação e raciocínio (desabilitado por padrão): 
    response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)
    Pensamento estendido impacta a eficiência do cache de prompt.
  7. Explore novas capacidades Veja O que há de novo no Claude 4.5 para detalhes sobre consciência de contexto, capacidade de saída aumentada (64K tokens), maior inteligência e velocidade melhorada.
  8. Teste sua implementação Teste em um ambiente de desenvolvimento antes de implantar em produção para garantir que todas as mudanças críticas sejam tratadas adequadamente.

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

  • Atualize o ID do modelo para claude-haiku-4-5-20251001
  • CRÍTICO: Atualize as versões das ferramentas para as mais recentes (ex: text_editor_20250728, code_execution_20250825) - versões legadas não são suportadas
  • CRÍTICO: Remova qualquer código usando o comando undo_edit (se aplicável)
  • CRÍTICO: Atualize os parâmetros de amostragem para usar apenas temperature OU top_p, não ambos
  • Revise e ajuste para os novos limites de taxa (separados do Haiku 3.5)
  • Trate o novo motivo de parada refusal na sua aplicação
  • Considere habilitar pensamento estendido para tarefas de raciocínio complexas (nova capacidade)
  • Aproveite a consciência de contexto para melhor gerenciamento de tokens em sessões longas
  • Prepare-se para respostas maiores (saída máxima aumentada de 8K para 64K tokens)
  • Revise e atualize prompts seguindo melhores práticas do Claude 4
  • Teste em ambiente de desenvolvimento antes da implantação em produção

​
Escolhendo entre Sonnet 4.5 e Haiku 4.5

Tanto Claude Sonnet 4.5 quanto Claude Haiku 4.5 são modelos Claude 4 poderosos com diferentes pontos fortes:

​
Escolha Claude Sonnet 4.5 (mais inteligente) para:

  • Raciocínio e análise complexos: Inteligência de primeira classe para tarefas sofisticadas
  • Agentes autônomos de longa duração: Desempenho superior para agentes trabalhando independentemente por períodos estendidos
  • Tarefas avançadas de codificação: Nosso modelo de codificação mais forte com planejamento avançado e engenharia de segurança
  • Fluxos de trabalho de contexto grande: Gerenciamento de contexto aprimorado com ferramenta de memória e capacidades de edição de contexto
  • Tarefas que requerem capacidade máxima: Quando inteligência e precisão são as principais prioridades

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

  • Aplicações em tempo real: Tempos de resposta rápidos para experiências de usuário interativas com desempenho quase de fronteira
  • Processamento inteligente de alto volume: Inteligência econômica em escala com velocidade melhorada
  • Implantações sensíveis ao custo: Desempenho quase de fronteira a preços mais baixos
  • Arquiteturas de sub-agentes: Agentes rápidos e inteligentes para sistemas multi-agente
  • Uso de computador em escala: Automação econômica de desktop e navegador autônoma
  • Tarefas que requerem velocidade: Quando baixa latência é crítica mantendo inteligência quase de fronteira

​
Recomendações de pensamento estendido

Os modelos Claude 4, particularmente Sonnet e Haiku 4.5, mostram melhorias significativas de desempenho ao usar pensamento estendido para tarefas de codificação e raciocínio complexo. O pensamento estendido está desabilitado por padrão mas recomendamos habilitá-lo para trabalho exigente. Importante: O pensamento estendido impacta a eficiência do cache de prompt. Quando conteúdo não-resultado de ferramenta é adicionado a uma conversa, blocos de pensamento são removidos do cache, o que pode aumentar custos em conversas multi-turno. Recomendamos habilitar o pensamento quando os benefícios de desempenho superam a desvantagem do cache.

​
Outros cenários de migração

Os caminhos de migração primários cobertos acima (Sonnet 3.7 → 4.5 e Haiku 3.5 → 4.5) representam as atualizações mais comuns. No entanto, você pode estar migrando de outros modelos Claude para Claude 4.5. Esta seção cobre esses cenários.

​
Migrando do Claude Sonnet 4 → Sonnet 4.5

Mudança crítica: Não é possível especificar tanto temperature quanto top_p na mesma requisição. Todas as outras chamadas de API funcionarão sem modificação. Atualize seu ID de modelo e ajuste os parâmetros de amostragem se necessário: 
# Antes (Claude Sonnet 4)
model="claude-sonnet-4-20250514"

# Depois (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

​
Migrando do Claude Opus 4.1 → Sonnet 4.5

Sem mudanças críticas. Todas as chamadas de API funcionarão sem modificação. Simplesmente atualize seu ID de modelo: 
# Antes (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Depois (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Claude Sonnet 4.5 é nosso modelo mais inteligente com capacidades de raciocínio, codificação e agentes de longa duração de primeira classe. Oferece desempenho superior comparado ao Opus 4.1 para a maioria dos casos de uso.

​
Precisa de ajuda?