Claude Opus 4.8: fim do modo rápido e migração para Opus 5.5

O modo rápido do Claude Opus 4.8 está em processo de descontinuação. Antes de 30 de novembro de 2026, migre as requisições que combinam claude-opus-4-8 e speed: "fast" para claude-opus-5-5. Após a remoção, a combinação antiga retornará um erro, sem mudar automaticamente para a velocidade padrão.

A Anthropic anunciou o prazo nas notas de versão de 30 de outubro. A versão v2.1.316 do Claude Code confirma explicitamente que não haverá essa mudança automática.

A alteração remove uma opção de velocidade. Em 2026-11-02, a tabela de ciclo de vida dos modelos ainda classifica claude-opus-4-8 como Active. A previsão de retirada aponta para uma data não anterior a 28 de maio de 2027. Se precisar manter esse modelo, remova a configuração de modo rápido e valide as requisições na velocidade padrão.

A migração abaixo usa a Messages API diretamente na Anthropic. Ela também cobre as configurações que usuários do Claude Code devem verificar.

1. Localize requisições afetadas no código e nas configurações de implantação

Localize separadamente as configurações de modelo e velocidade, depois identifique onde a aplicação as combina. Elas podem vir de arquivos, variáveis de ambiente ou regras de gateway diferentes.

Com o ripgrep instalado, execute esta busca na raiz do repositório usando Bash:

rg -l --hidden --no-ignore \
  -g '!.git' \
  -g '!node_modules' \
  -g '!.venv' \
  -e 'claude-opus-4-8' \
  -e 'fast-mode-2026-02-01' \
  -e 'fastMode' \
  -e 'speed' .

O comando lista nomes de arquivos, sem exibir o conteúdo das configurações. Ele inclui arquivos ocultos e ignorados, que podem conter ajustes locais. Inspecione cada correspondência: uma configuração genérica chamada speed pode ter outra finalidade.

Verifique também as configurações fora do repositório:

• Variáveis de implantação e configurações de tarefas de CI.
• Modelos padrão dos agentes e listas de modelos alternativos.
• Mapeamentos de modelos e transformações de requisições no gateway.
• Configurações de usuário, de projeto e gerenciadas do Claude Code.

Confirme que a requisição final enviada contém tanto o identificador antigo do modelo quanto speed: "fast". Um relatório de uso que informa apenas o modelo não comprova que a requisição usou o modo rápido.

Para cada serviço afetado, registre o responsável, a origem da configuração, o modelo solicitado, a velocidade solicitada e a opção de reversão. Não inclua credenciais nem conteúdo de prompts nessa auditoria.

2. Troque o modelo e revise as configurações incompatíveis

Para o Opus 5.5, mantenha speed: "fast" e remova o identificador beta usado exclusivamente pelo modo rápido. A documentação de recursos do Opus 5.5 afirma explicitamente que esse modelo não precisa desse cabeçalho beta.

Se anthropic-beta contiver identificadores de vários recursos, remova apenas fast-mode-2026-02-01. Preserve os identificadores exigidos pelos outros recursos.

Revise estas configurações antes de enviar uma carga de trabalho existente ao novo modelo:

Configuração ou comportamento	Ação para o Opus 5.5
model	Defina claude-opus-5-5.
speed	Mantenha "fast" quando o modo rápido for necessário.
thinking	Omita o parâmetro ou use {"type":"adaptive"}. A API rejeita raciocínio desativado e orçamentos manuais com enabled.
tool_choice	Use {"type":"auto"} ou {"type":"none"}. A API rejeita as opções forçadas any e tool com nome de ferramenta.
temperature, top_p, top_k	Omita esses parâmetros.
Início pré-preenchido da resposta do assistente	Remova a mensagem parcial do assistente usada para iniciar a próxima resposta.
Leitura da resposta	Selecione blocos de texto por type. Não presuma que content[0].text contém a resposta.

Essas verificações constam no guia de migração do Opus 5.5. Algumas restrições já se aplicam a modelos anteriores. Mesmo assim, o código compartilhado de montagem de requisições pode voltar a incluir parâmetros incompatíveis durante a migração.

Se a aplicação exige a chamada de uma ferramenta específica, substituir a seleção forçada por auto muda esse comportamento. Atualize a validação da aplicação e teste esse caminho antes da implantação.

O Opus 5.5 sempre ativa o raciocínio adaptativo. Revise max_tokens, pois o raciocínio e o texto visível compartilham esse limite. Use output_config.effort para controlar a profundidade do raciocínio.

Em ciclos com ferramentas, preserve as mensagens completas do assistente, incluindo blocos de raciocínio, ao devolver os resultados. Filtrar o texto para exibição não deve alterar a conversa enviada de volta. Aplicações que reescrevem o histórico ou usam ferramentas de controle do computador também devem revisar as verificações específicas do guia de migração.

3. Envie uma requisição e confira a velocidade retornada

Verifique usage.speed em uma resposta bem-sucedida antes de migrar o tráfego de produção. O campo da requisição registra o que você pediu; o campo da resposta registra o que foi executado.

Você precisa de Bash, jq e uma versão do curl compatível com --fail-with-body. Use uma chave da API direta da Anthropic com acesso ao modo rápido. Em 2026-11-02, o Opus 5.5 tem limites padrão de modo rápido nos níveis Start, Build e Scale. Organizações no nível Evaluation precisam mudar para um nível elegível.

Este exemplo usa o formato atual de requisição da Messages API. Ele envia uma requisição sem streaming, salva a resposta, faz as verificações e exibe o texto:

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY

curl --silent --show-error --fail-with-body \
  --max-time 600 \
  --dump-header fast-headers.txt \
  --output fast-response.json \
  https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "claude-opus-5-5",
    "max_tokens": 4096,
    "speed": "fast",
    "stream": false,
    "output_config": {"effort": "low"},
    "messages": [
      {
        "role": "user",
        "content": "Explain a cache hit in one sentence."
      }
    ]
  }' &&
jq -e '
  .type == "message"
  and .model == "claude-opus-5-5"
  and .usage.speed == "fast"
  and .stop_reason == "end_turn"
  and any(
    .content[]?;
    .type == "text" and (.text | length > 0)
  )
' fast-response.json &&
jq -r '.content[] | select(.type == "text") | .text' fast-response.json

O resultado esperado da verificação é true, seguido da resposta do modelo. Esse é um critério de aceitação, não um resultado de execução registrado.

Os operadores && impedem que uma requisição com falha chegue às verificações de sucesso. O limite 4096 e o esforço low são escolhas para este pequeno teste. Eles não são requisitos do modo rápido.

O exemplo usa anthropic-version: 2026-10-21. Revise o guia separado de migração da versão da API antes de alterar esse cabeçalho em uma integração existente.

Se o curl falhar, inspecione o erro e o corpo da resposta recém-gravado. Se a validação falhar após uma requisição bem-sucedida, verifique model, usage.speed, stop_reason e content.

Uma resposta pode usar o modo rápido e ainda atingir max_tokens. Siga as orientações sobre motivos de encerramento, depois ajuste o limite de saída ou o esforço. Um campo de velocidade ausente ou com valor "standard" não passa nessa verificação do modo rápido.

Em 2026-11-02, o BetterToken lista tanto claude-opus-4-8 quanto claude-opus-5-5. Sua referência da Messages API documenta https://www.bettertoken.ai/v1/messages. Para essa rota, confirme o encaminhamento do modo rápido, o retorno de usage.speed e a cobrança antes da migração. Use a autenticação documentada pelo serviço: a presença do modelo na lista, por si só, não comprova suporte ao modo rápido.

4. Trate erros de capacidade separadamente dos erros de migração

Planeje a quantidade de requisições simultâneas com base nos limites específicos do modo rápido. A capacidade do Opus na velocidade padrão não representa a capacidade disponível no modo rápido.

A documentação de limites de uso indica a página de limites da organização no Console para consultar os valores reais. Não presuma que a configuração de simultaneidade do Opus 4.8 pode ser mantida sem alterações no Opus 5.5.

Nos cabeçalhos de resposta salvos, procure anthropic-fast-input-tokens-remaining e anthropic-fast-output-tokens-remaining. Eles ajudam a identificar se a pressão está no limite de tokens de entrada ou no de saída.

Defina uma ação explícita para cada falha:

• 429 do modo rápido com retry-after: aguarde o intervalo indicado ou tente novamente sem speed: "fast" se a velocidade padrão for aceitável.
• 429 causado por um teto de gastos: resolva o limite de gastos. Mudar a velocidade não restaura um orçamento esgotado.
• Sobrecarga 529: limite as tentativas e aumente o intervalo entre elas. Não presuma que outra velocidade funcionará.
• Parâmetro inválido ou combinação removida de Opus 4.8 com modo rápido: corrija a requisição. Reenviá-la repetidamente não conclui a migração.

A Anthropic documenta a mudança para a velocidade padrão controlada pela aplicação em erros de limite do modo rápido. Ao escolher esse caminho, confirme que a resposta da nova tentativa informa "standard".

Sempre que possível, controle os limites de tentativas em uma única camada. Um ciclo externo somado às repetições do próprio SDK pode multiplicar requisições e atrasos. O guia de tratamento seguro de Retry-After e espera exponencial explica essa implementação.

5. Compare o mesmo volume de tokens

O Opus 5.5 tem preços publicados de tokens no modo rápido inferiores aos do Opus 4.8. Mesmo assim, custa mais por token do que o próprio Opus 5.5 na velocidade padrão.

Estes são os preços da API direta da Anthropic em USD, em 2026-11-02. MTok significa um milhão de tokens.

Configuração	Entrada por MTok	Saída por MTok
Opus 4.8 no modo rápido	$10	$50
Opus 5.5 no modo rápido	$8	$40
Opus 5.5 na velocidade padrão	$4	$20

Os preços do modo rápido vêm da tabela de preços da Anthropic. Os preços da velocidade padrão também estão na página do modelo Opus 5.5.

Para uma carga estimada de 1 MTok de entrada e 0.2 MTok de saída total, a cobrança por tokens seria:

Opus 4.8 fast:     1 × $10 + 0.2 × $50 = $20
Opus 5.5 fast:     1 ×  $8 + 0.2 × $40 = $16
Opus 5.5 standard: 1 ×  $4 + 0.2 × $20 =  $8

Fast-to-fast reduction at fixed token usage:
($20 - $16) / $20 = 20%

A estimativa considera entrada sem cache, nenhum uso de ferramentas pagas no servidor e nenhum adicional por residência de dados. Ela exclui impostos, créditos e descontos específicos da conta. Cache e condições de residência de dados exigem seus próprios cálculos.

O resultado de 20% se aplica a um uso fixo de tokens. Ele não comprova uma redução de 20% no custo de concluir sua tarefa. Os tokens de raciocínio do Opus 5.5 são cobrados como saída, inclusive quando o raciocínio não é exibido. Uma carga antes executada sem raciocínio pode, portanto, gerar um total diferente de tokens de saída.

Em tarefas representativas, meça os resultados aceitos, a cobrança por tokens, as novas tentativas e o tempo decorrido. Mantenha o modo rápido onde a geração mais veloz melhora de forma relevante a experiência do usuário. Teste primeiro a velocidade padrão em tarefas de segundo plano cujo tempo depende principalmente de ferramentas ou serviços externos.

6. Atualize a seleção do modelo e o modo rápido no Claude Code

Selecione o Opus 5.5 explicitamente, depois confira o controle do modo rápido. Atualizar apenas o Claude Code não comprova que uma configuração salva do modelo mudou.

A documentação de configuração de modelos exige o Claude Code v2.1.280 ou posterior para o Opus 5.5.

Para uma instalação nativa, execute no Bash:

claude update
claude --version
claude

Se a instalação foi feita por um gerenciador de pacotes, use o comando de atualização indicado na documentação de instalação.

Na sessão interativa do Claude Code, execute:

/model claude-opus-5-5
/fast
/status

Em /fast, pressione Space se precisar mudar o controle, depois Enter para confirmar. O estado ativado documentado mostra Fast mode ON e o ícone ↯. Use /status para conferir o modelo selecionado.

Verifique as configurações de modelo em ~/.claude/settings.json, .claude/settings.json e .claude/settings.local.json. Confira também ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, os argumentos de inicialização e as configurações gerenciadas. Altere as chaves existentes sem substituir o arquivo inteiro.

Reinicie uma vez e confira o modelo novamente. Uma sessão retomada ou uma configuração de maior prioridade pode manter uma seleção anterior.

O comportamento do modo rápido no Claude Code inclui a mudança automática para a velocidade padrão durante a espera após atingir seus limites. Esse comportamento não anula o aviso de remoção do modo rápido do Opus 4.8.

Se um limite da conta impedir a mudança, primeiro diferencie os limites da assinatura do Claude Code dos erros 429 da API.

7. Faça a implantação com uma opção de reversão válida

Migre uma pequena parcela do tráfego somente depois que a verificação da requisição e os critérios de aceitação da aplicação forem atendidos.

Inclua uma requisição de texto comum, uma interação representativa com ferramentas, se a aplicação as usa, e uma tarefa próxima do limite habitual de saída. Compare os resultados utilizáveis do novo modelo com os da configuração atual. Acompanhe a confirmação da velocidade, a quantidade de erros, a cobrança por tokens e o tempo total de conclusão.

Mantenha uma configuração de velocidade padrão já validada para reverter a mudança. Após 30 de novembro, restaurar claude-opus-4-8 com speed: "fast" não será uma opção de recuperação válida.

Conclua a migração verificando novamente as requisições dos serviços implantados. Nenhuma rota de produção deve continuar capaz de montar a combinação removida de modelo e velocidade.