Guia de Migração para Opus 4.5
Migração única do Sonnet 4.0, Sonnet 4.5 ou Opus 4.1 para o Opus 4.5.
Fluxo de Trabalho da Migração
- Pesquise na base de código por strings de modelo e chamadas de API
- Atualize as strings de modelo para Opus 4.5 (veja as strings específicas da plataforma abaixo)
- Remova cabeçalhos beta não suportados
- Adicione o parâmetro
effortdefinido como"high"(vejareferences/effort.md) - Resuma todas as alterações realizadas
- Informe ao usuário: "Se você encontrar algum problema com o Opus 4.5, me avise e posso ajudar a ajustar seus prompts."
Atualizações de Strings de Modelo
Identifique qual plataforma a base de código utiliza e substitua as strings de modelo de acordo.
Cabeçalhos Beta Não Suportados
Remova o cabeçalho beta context-1m-2025-08-07 se presente — ele ainda não é suportado com o Opus 4.5. Deixe um comentário notando isso:
# Nota: O beta de contexto de 1M (context-1m-2025-08-07) ainda não é suportado com Opus 4.5
Strings de Modelo de Destino (Opus 4.5)
| Plataforma | String de Modelo Opus 4.5 |
|---|---|
| Anthropic API (1P) | claude-opus-4-5-20251101 |
| AWS Bedrock | anthropic.claude-opus-4-5-20251101-v1:0 |
| Google Vertex AI | claude-opus-4-5@20251101 |
| Azure AI Foundry | claude-opus-4-5-20251101 |
Strings de Modelo de Origem a Substituir
| Modelo de Origem | Anthropic API (1P) | AWS Bedrock | Google Vertex AI |
|---|---|---|---|
| Sonnet 4.0 | claude-sonnet-4-20250514 | anthropic.claude-sonnet-4-20250514-v1:0 | claude-sonnet-4@20250514 |
| Sonnet 4.5 | claude-sonnet-4-5-20250929 | anthropic.claude-sonnet-4-5-20250929-v1:0 | claude-sonnet-4-5@20250929 |
| Opus 4.1 | claude-opus-4-1-20250422 | anthropic.claude-opus-4-1-20250422-v1:0 | claude-opus-4-1@20250422 |
NÃO migre: Quaisquer modelos Haiku (ex.: claude-haiku-4-5-20251001).
Ajustes de Prompt
O Opus 4.5 tem diferenças comportamentais conhecidas em relação aos modelos anteriores. Aplique essas correções apenas se o usuário solicitá-las explicitamente ou relatar um problema específico. Por padrão, apenas atualize as strings de modelo.
Diretrizes de integração: Ao adicionar trechos, não os anexe simplesmente aos prompts. Integre-os com cuidado:
- Use tags XML (ex.:
<code_guidelines>,<tool_usage>) para organizar as adições - Iguale o estilo e a estrutura do prompt existente
- Coloque os trechos em locais lógicos (ex.: diretrizes de codificação perto de outras instruções de codificação)
- Se o prompt já usar tags XML, adicione novo conteúdo dentro de tags existentes apropriadas ou crie novas tags consistentes
1. Superativação de Ferramentas
O Opus 4.5 é mais responsivo a prompts de sistema. Linguagem agressiva que impedia a subativação em modelos anteriores pode agora causar superativação.
Aplicar se: O usuário relatar que as ferramentas são chamadas com muita frequência ou desnecessariamente.
Encontre e suavize:
CRITICAL:→ remova ou suavizeVocê DEVE...→Você deve...SEMPRE faça X→Faça XNUNCA pule...→Não pule...OBRIGATÓRIO→ remova ou suavize
Aplique apenas a instruções de ativação de ferramentas. Deixe outros usos de ênfase inalterados.
2. Prevenção de Engenharia Excessiva
O Opus 4.5 tende a criar arquivos extras, adicionar abstrações desnecessárias ou construir flexibilidade não solicitada.
Aplicar se: O usuário relatar arquivos indesejados, abstração excessiva ou funcionalidades não solicitadas. Adicione o trecho de references/prompt-snippets.md.
3. Exploração de Código
O Opus 4.5 pode ser excessivamente conservador ao explorar código, propondo soluções sem ler arquivos.
Aplicar se: O usuário relatar que o modelo está propondo correções sem inspecionar o código relevante. Adicione o trecho de references/prompt-snippets.md.
4. Design de Frontend
Aplicar se: O usuário solicitar melhoria na qualidade do design de frontend ou relatar saídas genéricas.
Adicione o trecho de estética de frontend de references/prompt-snippets.md.
5. Sensibilidade a 'Pensamento'
Quando o pensamento estendido não está habilitado (o padrão), o Opus 4.5 é particularmente sensível à palavra "pense" e suas variantes. O pensamento estendido só é ativado se a requisição à API contiver um parâmetro thinking.
Aplicar se: O usuário relatar problemas relacionados a "pensamento" enquanto o pensamento estendido não estiver habilitado (nenhum parâmetro thinking na requisição).
Substitua "pense" por alternativas como "considere", "acredite" ou "avalie."
Referência
Consulte references/prompt-snippets.md para o texto completo de cada trecho a adicionar.
Consulte references/effort.md para configurar o parâmetro de esforço (apenas se o usuário solicitar).