SpyBara
Go Premium

fast-mode.md 2026-11-12 23:02 UTC to 2026-11-13 01:02 UTC

No changes for this document in this history range.

2026
Mon 2 23:57 Fri 6 23:01 Mon 9 23:02 Tue 10 21:57 Thu 12 23:02

Acelere respostas com modo rápido

Obtenha respostas mais rápidas do Opus e do Fable no Claude Code alternando o modo rápido com /fast.

[!NOTE]

O modo rápido para Claude Fable 5.2 e Claude Opus 5.5 está disponível. O modo rápido para Claude Opus 5 e Claude Opus 4.8 está em prévia de pesquisa.

O modo rápido é uma configuração de alta velocidade para modelos suportados, tornando o modelo até 2,5x mais rápido a um custo maior por token. Ative-o com /fast quando você precisar de velocidade para trabalho interativo como iteração rápida ou depuração ao vivo, e desative-o quando o custo importa mais do que a latência.

O modo rápido usa o mesmo modelo com uma configuração de API diferente que prioriza a velocidade sobre a eficiência de custo, portanto a qualidade e as capacidades permanecem as mesmas. Na API da Anthropic, o modo rápido é suportado no Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8, mas não no Sonnet, Haiku ou outros modelos. Para os modelos na Agent Platform do Google Cloud, consulte Usar o modo rápido na Agent Platform.

[!WARNING]

O modo rápido para Opus 4.8 foi descontinuado em 30 de outubro de 2026 e será removido em 30 de novembro de 2026. Se o Opus 4.8 ainda for o seu modelo com o modo rápido ativado após essa data, a API rejeitará suas requisições. Até essa data, mude para o Opus 5.5 ou desative o modo rápido na sua sessão:

O Opus 4.7 não suporta modo rápido, portanto alternar para ele desativa o modo rápido. O modo rápido para Opus 4.7 foi descontinuado em 25 de junho de 2026 e removido em 24 de julho de 2026.

O que você precisa saber:

  • Use /fast para alternar o modo rápido no CLI do Claude Code. A extensão VS Code oferece um comando Toggle fast mode quando o modelo selecionado suporta modo rápido. Na API da Anthropic, o Claude Code salva essa alternância na sua configuração fastMode.
  • O preço do modo rápido da Anthropic por MTok de entrada/saída é $16/$80 no Fable 5.2, $8/$40 no Opus 5.5 e $10/$50 no Opus 5 e Opus 4.8.
  • Disponível para usuários do Claude Code em planos de assinatura (Pro/Max/Ultra/Team/Enterprise), no Claude Console e na Agent Platform do Google Cloud com condições. Organizações Team e Enterprise precisam que um Owner o ative primeiro, e organizações Console precisam ter acesso provisionado primeiro para usá-lo com Opus 5 ou Opus 4.8. Requisitos descreve ambos.
  • Para usuários do Claude Code em planos de assinatura (Pro/Max/Ultra/Team/Enterprise), o modo rápido está disponível apenas via créditos de uso e não está incluído nos rate limits da assinatura.

Alternar modo rápido

Na Agent Platform, /fast e a configuração fastMode funcionam de forma diferente, portanto siga Usar modo rápido na Agent Platform em vez disso.

Na CLI, alterne o modo rápido de uma destas formas:

  • Execute /fast, pressione Space para alternar ativado ou desativado, depois pressione Enter para confirmar
  • Em um modelo que suporta modo rápido, defina "fastMode": true no seu arquivo de configurações do usuário. Se você defini-lo em qualquer outro modelo, você permanece nesse modelo com o modo rápido desativado. No Fable 5.2, essa configuração sozinha não tem efeito até que você execute /fast enquanto usa o Fable 5.2.

Por padrão, na Anthropic API, o modo rápido que você ativa em uma sessão interativa persiste entre sessões em um modelo suportado. No Fable 5.2, o modo rápido persiste apenas se você o ativou enquanto usava o Fable 5.2. Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte require per-session opt-in para obter detalhes.

Fora de uma sessão em nuvem, no modo não interativo com a flag -p, /fast funciona apenas em uma sessão iniciada com modo rápido em seu valor --settings, por exemplo claude -p --settings '{"fastMode": true}'; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão. O formulário -p requer Claude Code v2.1.205 ou posterior. Em qualquer outro lugar no modo não interativo, o comando relata que o modo rápido não está disponível.

Você pode executar /fast enquanto Claude está trabalhando, e Claude Code alterna o modo rápido sem esperar que o turno termine. Claude Code conclui o turno em execução em sua velocidade original, portanto a mudança de velocidade entra em vigor a partir do seu próximo turno. Se seu modelo atual não suportar modo rápido, ativá-lo também alterna seu modelo, e Claude Code usa o novo modelo a partir de sua próxima solicitação naquele turno.

Para melhor eficiência de custo, ative o modo rápido no início de uma sessão em vez de alternar no meio da conversa. Consulte understand the cost tradeoff para obter detalhes.

Quando você ativa o modo rápido com /fast:

  • Na Anthropic API, se seu modelo atual não suportar modo rápido, Claude Code alterna para Opus
  • O modo rápido no Fable 5.2 requer Claude Code v2.1.321 ou posterior
  • Você verá uma mensagem de confirmação: "Fast mode ON"
  • Um pequeno ícone ↯ aparece ao lado do prompt enquanto o modo rápido está ativo
  • Execute /fast novamente a qualquer momento para verificar se o modo rápido está ativado ou desativado

Na Anthropic API, Opus 5.5 é o padrão do modo rápido no Claude Code v2.1.280 e posterior. Antes da v2.1.280, o modo rápido usava como padrão Opus 5 a partir da v2.1.219.

Quando você desativa o modo rápido com /fast novamente, você permanece no seu modelo atual. Para alternar para um modelo diferente, use /model.

Alternar modelos enquanto o modo rápido está ativado

O modo rápido segue suas alternâncias de modelo:

  • Alternar para outro: quando você alterna para um modelo que não suporta modo rápido, Claude Code desativa o modo rápido. Isso inclui Opus 4.7; antes da v2.1.221, o modo rápido permanecia ativado após uma alternância para Opus 4.7 e a API rejeitava as solicitações.
  • Alternar de volta: o modo rápido volta a ser ativado em um modelo Opus suportado quando sua preferência salva está ativada. Com per-session opt-in, execute /fast em vez disso.
  • Alternar para o Fable 5.2: o modo rápido é desativado, a menos que você o tenha ativado enquanto usava o Fable 5.2. Para ativá-lo, execute /fast no Fable 5.2. A menos que você tenha configurado per-session opt-in, essa escolha persiste entre sessões na Anthropic API até que você desative o modo rápido ou o ative com outro modelo.

Sempre que uma alternância de modelo ativa ou desativa o modo rápido, Claude Code mostra uma confirmação Fast mode ON ou Fast mode OFF, e o ícone ↯ aparece enquanto o modo rápido está ativado. Isso vale se você alternar com /model, com /config model=<model>, ou de um dispositivo conectado através de Remote Control.

Usar modo rápido em sessões em nuvem

O modo rápido funciona em sessões na nuvem quando está disponível em sua conta, seja a sessão executada em infraestrutura gerenciada pela Anthropic ou em um executor auto-hospedado na Anthropic API. Requer Claude Code v2.1.271 ou posterior no ambiente da sessão.

Digite /fast on na sessão para ativar o modo rápido. Ele permanece ativado apenas para essa sessão e não é salvo como seu padrão. Os requisitos também se aplicam em sessões em nuvem.

No navegador em claude.ai/code, você também pode ativar e desativar o modo rápido no menu de modelo na caixa de mensagem. O menu mostra a alternância quando seu plano inclui modo rápido e o modelo selecionado o suporta.

Entender o tradeoff de custo

O modo rápido tem preços por token mais altos do que a velocidade padrão. Estas são as taxas da Anthropic:

Modelo Entrada (MTok) Saída (MTok)
Fable 5.2 $16 $80
Opus 5.5 $8 $40
Opus 5 $10 $50
Opus 4.8 $10 $50

O preço do modo rápido é fixo em toda a janela de contexto de 1M token. Para a taxa padrão para comparar, consulte a referência de preços do Claude.

A primeira vez que você ativa o modo rápido em uma conversa, você paga o preço total do token de entrada não armazenado em cache do modo rápido para todo o contexto da conversa. Quanto mais profundo você estiver em uma conversa, mais isso custa, portanto a cobrança é menor quando você ativa o modo rápido no início. O modo rápido e a velocidade padrão mantêm caches separados, portanto cada alternância posterior lê parte ou toda a conversa novamente sem cache.

Veja onde o gasto do modo rápido aparece

Você vê o gasto do modo rápido em um lugar diferente dependendo de como você se conectou, portanto primeiro execute /status para verificar. Se mostrar uma linha Login method como Claude Max account, você se conectou com uma assinatura Claude. Se mostrar uma linha API key em vez disso, suas solicitações são cobradas em uma organização do Claude Console.

  • Pro, Max e Ultra: você paga pelo modo rápido com seus créditos de uso. Vá para Settings > Usage em claude.ai, onde a seção Usage credits mostra quanto você gastou em créditos de uso este mês. Essa figura inclui o modo rápido, mas não o separa individualmente.
  • Team e Enterprise: sua organização paga pelo seu uso do modo rápido com seus créditos de uso. Para ver seu próprio gasto de créditos de uso, execute /usage. Para ver onde sua organização vê esse gasto, consulte Claude for Teams and Enterprise.
  • Claude Console: sua organização paga pelo modo rápido junto com o resto de seu uso de API. Nas páginas Usage e Cost do Console, selecione Speed no menu Group by para separar o modo rápido do uso em velocidade padrão. Você vê essa opção apenas quando o intervalo de datas selecionado inclui uso do modo rápido.

Decidir quando usar o modo rápido

O modo rápido é melhor para trabalho interativo onde a latência de resposta importa mais do que o custo:

  • Iteração rápida em mudanças de código
  • Sessões de depuração ao vivo
  • Trabalho sensível ao tempo com prazos apertados

O modo padrão é melhor para:

  • Tarefas autônomas longas onde a velocidade importa menos
  • Processamento em lote ou pipelines CI/CD
  • Cargas de trabalho sensíveis ao custo

Modo rápido vs nível de esforço

O modo rápido e o nível de esforço afetam a velocidade de resposta, mas de formas diferentes:

Configuração Efeito
Modo rápido Mesma qualidade de modelo, latência mais baixa, custo mais alto
Nível de esforço mais baixo Menos tempo de pensamento, respostas mais rápidas, qualidade potencialmente mais baixa em tarefas complexas

Você pode combinar ambos: use o modo rápido com um nível de esforço mais baixo para máxima velocidade em tarefas diretas.

Requisitos

O modo rápido requer todos os seguintes:

  • Provedor compatível: o modo rápido está disponível através da API do Anthropic Console, para planos de assinatura Claude usando créditos de uso e no Google Cloud's Agent Platform com condições. Não está disponível no Amazon Bedrock, Microsoft Foundry ou Claude Platform na AWS, onde /fast mostra "Fast mode is not available on this provider". As organizações do Console também devem ter acesso ao modo rápido provisionado para usá-lo com Opus 5 ou Opus 4.8.
  • Créditos de uso ativados para planos de assinatura: em um plano Pro, Max, Ultra, Team ou Enterprise, sua conta deve ter créditos de uso ativados, o que permite cobrança além do uso incluído no seu plano. Até que estejam ativados, /fast mostra "Fast mode requires usage credits". Para ativá-los, siga a etapa correspondente ao seu plano:
    • Em Pro, Max e Ultra, ative-os na seção Usage credits de Settings > Usage em claude.ai, ou execute /usage-credits para abrir essa página.
    • Em Team e Enterprise, um membro com acesso ao faturamento os ativa para a organização em Organization settings > Usage, e um membro sem esse acesso executa /usage-credits para enviar uma solicitação aos administradores da organização.

[!NOTE]

O uso do modo rápido é cobrado diretamente nos créditos de uso, mesmo que você tenha uso restante no seu plano.

  • Organização Console paga: contas do Claude Console não usam créditos de uso, e sua organização paga pelo modo rápido por token junto com o resto do seu uso de API. No plano Evaluation gratuito do Console, /fast mostra "Fast mode unavailable during evaluation. Please purchase credits." Para limpar isso, compre créditos nas suas configurações de cobrança do Console.

    O modo rápido com Fable 5.2 ou Opus 5.5 também depende do nível de uso da sua organização.

  • Habilitação de proprietário para Team e Enterprise: o modo rápido está desativado por padrão para organizações Team e Enterprise. Um proprietário deve explicitamente ativar o modo rápido antes que os usuários possam acessá-lo.

[!NOTE]

Quatro configurações de organização podem bloquear a ativação do modo rápido com /fast:

  • Modo rápido não ativado: se o modo rápido não tiver sido ativado para sua organização, ativar o modo rápido com /fast mostra "Fast mode has been disabled by your organization."
  • Modo rápido desativado por configurações gerenciadas: se sua organização implanta configurações gerenciadas que definem fastMode: false, ativar o modo rápido com /fast mostra a mesma mensagem "Fast mode has been disabled by your organization".
  • Opt-in obrigatório por sessão: configurações gerenciadas que definem fastModePerSessionOptIn: true recusam /fast on com a mesma mensagem em todos os lugares, exceto em uma sessão de terminal interativa.
  • Modelo de modo rápido não permitido: se a allowlist availableModels da sua organização excluir o modelo para o qual /fast alterna, ativá-lo é recusado com "is not in your organization's allowed models". Em uma sessão já em execução em um modelo permitido que suporte modo rápido, /fast em vez disso ativa o modo rápido no seu modelo atual sem alternar modelos.

Ativar modo rápido para sua organização

Onde você ativa o modo rápido depende de qual produto sua organização usa:

As organizações do Console que usam Claude Opus 5 ou Claude Opus 4.8 também precisam de acesso provisionado, conforme descrito em modo rápido na API Claude. Sem esse acesso, as requisições de modo rápido nesses modelos atingem o rate limit do modo rápido e voltam para a velocidade padrão até que o acesso seja provisionado.

Outra opção para desativar completamente o modo rápido é definir CLAUDE_CODE_DISABLE_FAST_MODE=1. Consulte Variáveis de ambiente.

Usar modo rápido no Agent Platform

No Google Cloud's Agent Platform, você pode ativar o modo rápido para o Fable 5.2, com /fast em uma sessão interativa ou com flags de inicialização no modo não interativo. Requer Claude Code v2.1.322 ou posterior.

O modo rápido precisa que a região do Fable 5.2 seja global, us ou eu. Em outra região, /fast mostra Fast mode needs Vertex region global, us or eu, e claude -p é executado em velocidade padrão. Defina a região no seu shell antes de iniciar o Claude Code, por exemplo como global:

export VERTEX_REGION_CLAUDE_FABLE_5_2=global

Em seguida, ative o modo rápido:

  • Em uma sessão interativa: execute /fast. Ele alterna você para o Fable 5.2 a partir de um modelo Opus ou de outro modelo sem modo rápido no Agent Platform. O modo rápido não é salvo como seu padrão.
  • No modo não interativo: passe o Fable 5.2 em --model e o modo rápido em --settings, por exemplo claude -p "Summarize this project" --model claude-fable-5-2 --settings '{"fastMode": true}'

No Agent Platform, "fastMode": true nas suas configurações de usuário, de projeto, locais ou gerenciadas não tem efeito.

Se o Agent Platform recusar o modo rápido, o Claude Code volta para a velocidade padrão. Uma sessão interativa então mostra uma destas mensagens no terminal:

  • Using standard speed on Fable 5.2 · fast mode wasn't available: execute /fast on para tentar o modo rápido novamente
  • Fast mode was refused for this project · trying again in 30m: o Agent Platform respondeu a uma requisição de modo rápido com um erro 403 ou 404. Para tentar antes, execute /fast on.

Usar modo rápido atrás de proxies e gateways LLM

Antes de oferecer modo rápido na API Anthropic, Claude Code verifica a disponibilidade de modo rápido da sua organização com uma requisição diretamente para api.anthropic.com. A verificação não segue ANTHROPIC_BASE_URL, portanto em uma rede que roteia o tráfego Claude através de um gateway de LLM e bloqueia a saída direta para api.anthropic.com, a verificação falha mesmo que as requisições de inferência funcionem.

A verificação usa um proxy HTTP configurado, portanto um bloqueio de rede falha na verificação apenas onde api.anthropic.com é inacessível mesmo através do proxy. Se sua organização tem o modo rápido ativado e /fast diz o contrário, encontre a mensagem que ele mostra entre estes casos.

Fast mode unavailable due to network connectivity issues

A verificação de disponibilidade falhou, por exemplo porque sua rede bloqueia api.anthropic.com, e as requisições são executadas em velocidade padrão. Uma verificação que foi bem-sucedida no passado continua funcionando a partir de seu resultado em cache, portanto uma verificação bloqueada afeta principalmente novas instalações.

Para restaurar o modo rápido, adicione à allowlist a saída direta para api.anthropic.com, ou defina CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1, que trata uma verificação com falha como disponível e ainda honra uma resposta "disabled by your organization".

Fast mode is currently unavailable

Atrás de um gateway, verifique estas configurações, nas quais Claude Code não envia a verificação de disponibilidade e não tem nenhuma verificação bem-sucedida anterior em cache:

Para restaurar o modo rápido em qualquer uma dessas configurações, defina CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1.

Fast mode has been disabled by your organization

Atrás de um gateway, você pode ver esta mensagem mesmo quando sua organização tem o modo rápido ativado, em qualquer uma destas configurações:

  • Você se autentica apenas com ANTHROPIC_AUTH_TOKEN, sem login claude.ai, sem chave de API e sem verificação bem-sucedida em cache. Claude Code então trata o modo rápido como desativado pela sua organização sem enviar a requisição.
  • Um proxy intercepta a verificação e responde com sua própria página, por exemplo um proxy de inspeção TLS retornando uma página de bloqueio HTTP 200. Claude Code lê essa página como uma resposta dizendo que sua organização tem o modo rápido desativado.

Em ambos os casos, defina CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1, que pula a verificação inteiramente, em vez de CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS, que não se aplica a nenhum dos dois.

[!NOTE]

As variáveis de pulo alteram apenas a verificação do lado do cliente. Quando sua organização tem o modo rápido desativado, a API rejeita requisições de modo rápido independentemente de estarem definidas ou não. Claude Code então tenta novamente a requisição em velocidade padrão, desativa o modo rápido e /fast relata que sua organização desativou o modo rápido.

Exigir opt-in por sessão

Por padrão, na API Anthropic, o modo rápido que um usuário ativa em uma sessão interativa persiste entre sessões em um modelo compatível. No Fable 5.2, o modo rápido persiste apenas se o usuário o ativou enquanto usava o Fable 5.2.

Para fazer com que cada sessão comece com o modo rápido desativado, defina fastModePerSessionOptIn como true em qualquer arquivo de configurações. Os usuários então o ativam com /fast em cada sessão. Os Owners em planos Team ou Enterprise podem implantá-lo em toda a organização através de configurações gerenciadas pelo servidor.

{
  "fastModePerSessionOptIn": true
}

Isso é útil para controlar custos em organizações onde os usuários executam várias sessões simultâneas. A preferência de modo rápido do usuário ainda é salva, portanto remover essa configuração restaura o comportamento padrão persistente.

Quando configurações gerenciadas definem a chave, /fast on funciona apenas em uma sessão de terminal interativa. Em todos os outros lugares, incluindo modo não interativo, a extensão VS Code e sessões em nuvem, é recusado com uma mensagem de que sua organização desativou o modo rápido.

Lidar com limites de taxa

O modo rápido tem rate limits separados da velocidade padrão; para organizações do Console, a página de rate limits da Claude Platform os descreve. Quando você atinge o rate limit do modo rápido:

  1. O modo rápido automaticamente volta para velocidade padrão
  2. O ícone ↯ fica cinza para indicar cooldown
  3. Você continua trabalhando com velocidade e preços padrão
  4. Quando o cooldown expira, o modo rápido é automaticamente reativado

Para desativar o modo rápido manualmente em vez de esperar pelo cooldown, execute /fast novamente.

Se você ficar sem créditos de uso no meio de uma sessão, Claude Code tenta novamente cada solicitação de modo rápido rejeitada com velocidade e preços padrão, para que você continue trabalhando, e não há cooldown. Como você vê a rejeição depende do tipo de sessão:

  • Em uma sessão interativa, Claude Code mostra uma notificação "Fast mode disabled · Out of usage credits" e desativa o modo rápido. Sua preferência de modo rápido salva não muda; execute /fast para ativar o modo rápido novamente.
  • Em modo não interativo com --output-format stream-json, e através do Agent SDK, Claude Code emite o mesmo texto no fluxo de mensagens como uma mensagem system com subtipo notification. A mensagem chega uma vez por turno enquanto você estiver sem créditos de uso. O modo rápido permanece ativado.

Research preview

O modo rápido para Claude Opus 5 e Claude Opus 4.8 é um recurso em prévia de pesquisa, o que significa:

  • O recurso pode mudar com base no feedback
  • A disponibilidade e preços estão sujeitos a alterações
  • A configuração de API subjacente pode evoluir

Relate problemas ou feedback através de seus canais de suporte Anthropic usuais.

Veja também