Migrando para Claude 4.5

Este guia cobre dois caminhos de migração principais para modelos Claude 4.5:

• Claude Sonnet 3.7 → Claude Sonnet 4.5: Nosso modelo mais inteligente com raciocínio de primeira classe, capacidades de codificação e agentes de longa duração
• Claude Haiku 3.5 → Claude Haiku 4.5: Nosso modelo Haiku mais rápido e inteligente com desempenho próximo à fronteira para aplicações em tempo real e processamento inteligente de alto volume

Ambas as migrações envolvem mudanças significativas que requerem atualizações em sua implementação. Este guia o orientará através de cada caminho de migração com instruções passo a passo e mudanças significativas 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 nesses modelos, incluindo pensamento estendido, consciência de contexto e melhorias comportamentais.

Migrando de 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 significativas que requerem atualizações em sua implementação.

Etapas de 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 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
       ...
   )

3. 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

4. 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 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. Consulte Documentação da ferramenta de execução de código para instruções de migração.

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

   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
       ...
   )

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 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
       ...
   )

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 práticas recomendadas de engenharia de prompt Claude 4 para orientação de otimização.

9. Considere ativar o pensamento estendido para tarefas complexas

   Ative 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.

10. 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.

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

• Atualize o ID do modelo para claude-sonnet-4-5-20250929
• MUDANÇA SIGNIFICATIVA: Atualize os parâmetros de amostragem para usar apenas temperature OU top_p, não ambos
• Trate a nova razão de parada refusal em sua aplicação
• MUDANÇA SIGNIFICATIVA: Atualize a ferramenta de editor de texto para text_editor_20250728 e str_replace_based_edit_tool (se aplicável)
• MUDANÇA SIGNIFICATIVA: 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 práticas recomendadas Claude 4
• Considere ativar o pensamento estendido para tarefas complexas de raciocínio
• Trate a razão de parada model_context_window_exceeded (específica do Sonnet 4.5)
• Considere ativar 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 de ferramenta eficiente em tokens: O cabeçalho beta token-efficient-tools-2025-02-19 funciona apenas com Claude 3.7 Sonnet e não é suportado em modelos Claude 4 (veja etapa 6)
• Saída estendida: O cabeçalho beta output-128k-2025-02-19 não é suportado (veja etapa 7)

Ambos os cabeçalhos podem ser incluídos em solicitações Claude 4, mas não terão efeito.

Migrando de Claude Haiku 3.5 para Claude Haiku 4.5

Claude Haiku 4.5 é nosso modelo Haiku mais rápido e inteligente com desempenho próximo à 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 significativas que requerem atualizações em sua implementação.

Para uma visão geral completa das novas capacidades, consulte O que há de novo no Claude 4.5.

Etapas de 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 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

3. 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
       ...
   )

4. Revise os novos limites de taxa

   Haiku 4.5 tem limites de taxa separados do Haiku 3.5. Consulte Documentação de limites de taxa para detalhes.

5. Trate a nova razão de parada refusal

   Atualize sua aplicação para tratar razões de parada de recusa.

6. Considere ativar o pensamento estendido para tarefas complexas

   Ative 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 cache de prompt.

7. 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.

8. 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.

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

• Atualize o ID do modelo para claude-haiku-4-5-20251001
• MUDANÇA SIGNIFICATIVA: Atualize as versões de ferramentas para as mais recentes (por exemplo, text_editor_20250728, code_execution_20250825) - versões legadas não suportadas
• MUDANÇA SIGNIFICATIVA: Remova qualquer código usando o comando undo_edit (se aplicável)
• MUDANÇA SIGNIFICATIVA: Atualize os parâmetros de amostragem para usar apenas temperature OU top_p, não ambos
• Revise e ajuste para novos limites de taxa (separados do Haiku 3.5)
• Trate a nova razão de parada refusal em sua aplicação
• Considere ativar o pensamento estendido para tarefas complexas de raciocínio (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 práticas recomendadas 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 (mais rápido e mais inteligente Haiku) para:

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

Recomendações de pensamento estendido

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 é desativado por padrão, mas recomendamos ativá-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 ativar o pensamento quando os benefícios de desempenho superam a compensação de 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 de Claude Sonnet 4 → Sonnet 4.5

Mudança significativa: Não é possível especificar tanto temperature quanto top_p na mesma solicitaçã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 de Claude Opus 4.1 → Sonnet 4.5

Sem mudanças significativas. 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 raciocínio de primeira classe, capacidades de codificação e agentes de longa duração. Oferece desempenho superior comparado ao Opus 4.1 para a maioria dos casos de uso.

Migrando de Claude Opus 4.1 → Opus 4.5

Sem mudanças significativas. 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 Opus 4.5)
model="claude-opus-4-5-20251101"

Claude Opus 4.5 é nosso modelo mais inteligente, combinando capacidade máxima com desempenho prático. Apresenta melhorias significativas em visão, codificação e uso de computador com um preço mais acessível que Opus 4.1. Ideal para tarefas especializadas complexas e engenharia de software profissional.

Migrando entre modelos Claude 4.5

Sem mudanças significativas. Todas as chamadas de API funcionarão sem modificação.

Simplesmente atualize seu ID de modelo.

Precisa de ajuda?

• Verifique nossa documentação de API para especificações detalhadas
• Revise capacidades de modelo para comparações de desempenho
• Revise notas de lançamento de API para atualizações de API
• Entre em contato com o suporte se encontrar algum problema durante a migração