Claude Fable 5.2: como usar no Claude Code e na API

👁 112 leituras

Se você digitar /model fable em uma versão antiga do Claude Code, não vai receber o modelo novo. A documentação do Claude Code informa que o Fable 5.2 exige a versão 2.1.321 ou posterior. Essa é a primeira armadilha para quem quer experimentar o Claude Fable 5.2. A segunda está no aplicativo: o Fable não está disponível no plano Free. A terceira aparece na API, onde configurações antigas usadas com outros modelos podem resultar em um erro 400.

Consultei a documentação, os preços e os termos da promoção para verificar as formas de acessar o Fable 5.2: o aplicativo claude.ai, o Claude Code, a API da Anthropic, o OpenRouter e os serviços de nuvem de parceiros. A Anthropic lista a Polônia entre os países atendidos. Em 9 de novembro de 2026, o anúncio não mencionava restrições regionais para esse modelo. Isso não confirma a disponibilidade em outros países: consulte a Anthropic para verificar se o serviço está disponível onde você está. Planos e configurações também fazem diferença.

No aplicativo Claude, o plano define o acesso

O Fable 5.2 está disponível nos planos Pro, Max, Ultra, Team e Enterprise. Ele não está incluído no plano gratuito, e a central de ajuda da Anthropic informa que as promoções de lançamento não se aplicam ao Free. Em um plano pago, você pode selecioná-lo no menu de modelos, assim como o Opus ou o Sonnet.

O quanto você pode usar o modelo depende do plano. No Pro, que custa US$ 20 por mês, o uso do Fable é cobrado à parte, com créditos de uso. No lançamento, porém, a Anthropic oferece uma semana sem custo adicional, até 16 de novembro, às 23h59 do horário do Pacífico (8h59 de 17 de novembro na Polônia), com limite de metade da cota semanal e uma redefinição gratuita. Nos planos Max (US$ 100) e Ultra (US$ 200), o Fable está incluído na assinatura, até metade do limite semanal. Os assinantes desses planos receberam de uma a três redefinições, dependendo do tempo de assinatura. Elas podem ser usadas até 8 de março de 2027.

Você precisa iniciar a redefinição manualmente: Configurações > Usage > Limit resets > “Reset for free”. Ela renova o limite semanal do Fable e, se a sua conta tiver um, o limite de cinco horas. Não aumenta o limite, então vale a pena guardar a redefinição para quando a cota realmente acabar. Lembre-se também de que o Fable consome os limites mais rapidamente que outros modelos. O nível de esforço (effort) padrão nos aplicativos Claude é Medium.

Claude Code: três comandos para começar

No Claude Code, o Fable 5.2 não é o modelo padrão em nenhum plano, então você precisa selecioná-lo. Depois de atualizar para a versão 2.1.321 ou posterior, há duas maneiras de fazer isso:

/model fable
claude --model fable

O primeiro comando troca de modelo durante a sessão; o segundo inicia uma sessão diretamente com o Fable. O alias fable aponta para o Fable 5.2 em todos os casos, exceto em sessões pelo Claude apps gateway. Nesse ambiente, ele aponta por padrão para o Fable 5, mais antigo. Para usar o modelo novo, digite o identificador completo: /model claude-fable-5-2.

Você pode definir o nível de esforço com o comando /effort e uma das opções: low, medium, high, xhigh ou max. Também pode escolher um nível para uma sessão ao iniciá-la: claude --effort high. No Claude Code, o padrão do Fable 5.2 é medium. Segundo o anúncio da Anthropic, nesse nível o modelo usa menos tokens que o Fable 5.1 em tarefas difíceis, enquanto os melhores resultados na tabela de benchmarks foram obtidos nos níveis mais altos.

O terceiro comando é /fast, que ativa o modo rápido (a barra de espaço alterna a seleção, Enter confirma e o ícone ↯ aparece ao lado do campo de mensagem). Nesse modo, o Fable gera texto até 2,5 vezes mais rápido, mas custa US$ 16 e US$ 80 por milhão de tokens, em vez de US$ 8 e US$ 40. Nos planos por assinatura, o modo fast usa exclusivamente créditos de uso, mesmo que ainda haja cota disponível. Primeiro, é preciso ativar os créditos nas configurações. Nos planos Team e Enterprise, o proprietário da organização também precisa habilitar o recurso. A documentação recomenda ativá-lo no início da conversa: na primeira ativação, você paga o preço integral do modo fast por todo o contexto acumulado até aquele momento.

Na API: identificador e duas mudanças importantes

Na API da Anthropic, o identificador do modelo é claude-fable-5-2. Veja um exemplo simples para executar no terminal. O texto entre aspas é uma tradução do prompt original testado em polonês; não é um novo teste em português:

curl https://api.anthropic.com/v1/messages 
  -H "x-api-key: $ANTHROPIC_API_KEY" 
  -H "anthropic-version: 2023-06-01" 
  -H "content-type: application/json" 
  -d '{"model": "claude-fable-5-2", "max_tokens": 16000,
       "messages": [{"role": "user", "content": "Resuma este relatório em 5 tópicos: ..."}]}'

O mesmo exemplo em Python, usando a biblioteca oficial anthropic. O prompt é uma tradução do original testado em polonês, não um novo teste em português:

import anthropic

client = anthropic.Anthropic()  # chave de ANTHROPIC_API_KEY
msg = client.messages.create(
    model="claude-fable-5-2",
    max_tokens=16000,
    messages=[{"role": "user", "content": "Resuma este relatório em 5 tópicos: ..."}],
)
print("".join(b.text for b in msg.content if b.type == "text"))

A última linha seleciona apenas os blocos de texto, porque o Fable 5.2 sempre raciocina antes de responder. Não é possível desativar o raciocínio adaptativo; o parâmetro effort controla a profundidade do raciocínio e, na API, o padrão é high (nos aplicativos e no Claude Code, é medium). Duas configurações podem fazer scripts antigos falharem: o Fable 5.2 retorna um erro 400 quando você força o uso de ferramentas (tool_choice com o tipo any ou tool), e a documentação recomenda omitir os parâmetros temperature, top_p e top_k. A janela de contexto é de 1 milhão de tokens, a resposta pode ter até 128 mil tokens, e os preços são US$ 8 por milhão de tokens de entrada e US$ 40 por milhão de tokens de saída.

Há ainda um ponto importante para empresas: o Fable 5.2 exige retenção de dados por 30 dias. Ele não funciona no modo zero data retention, a menos que a Anthropic autorize explicitamente. Clientes que precisam desse recurso têm uma opção específica chamada Enterprise Frontier Safeguards.

Como foi o teste

Fiz todo o teste do Fable 5.2 pelo OpenRouter, com effort medium, e executei as 27 tarefas em polonês. A mediana do tempo até o primeiro token foi de 2,24 s. Um ensaio de 500 palavras ficou pronto em 19,1 s, 27% mais rápido que com o Fable 5.1. O conjunto inteiro custou US$ 0,75. Um detalhe: em 1 das 3 tarefas que pediam uma resposta somente em JSON, o Fable acrescentou cálculos; por isso, vale analisar a resposta com cuidado.

OpenRouter e serviços de nuvem

Se você não quiser criar uma conta no console da Anthropic, pode usar o OpenRouter. Na noite de 9 de novembro de 2026, consultei a lista pública de modelos e encontrei anthropic/claude-fable-5.2 pelo mesmo preço da Anthropic, US$ 8 e US$ 40, com contexto de 1 milhão de tokens. Basta trocar o nome do modelo no código que já usa o OpenRouter.

Nos serviços de nuvem de parceiros, o identificador é o mesmo: claude-fable-5-2 no Google Cloud (tanto na versão gerenciada pelo Google quanto na gerenciada pela Anthropic), no Microsoft Foundry e no Claude Platform on AWS. A exceção é o Amazon Bedrock: a tabela de modelos da documentação mostra um traço no campo do Fable 5.2, embora Opus 5.5 e Sonnet 5.5 tenham identificadores. No momento, quem usa o ecossistema da AWS deve recorrer ao Claude Platform on AWS. O modo fast na API funciona na Anthropic, no Google Cloud e no Foundry hospedado pela Anthropic. No Claude Code, está disponível apenas pela API da Anthropic ou por assinatura.

Por fim, a própria Anthropic recomenda começar pelo Opus 5.5 se você não souber qual modelo escolher, e recorrer ao Fable 5.2 para tarefas de raciocínio difícil e tarefas agentivas longas. Reuni preços, benchmarks e diferenças entre modelos no guia do Claude Fable 5.2.

Perguntas frequentes

O Claude Fable 5.2 está disponível no meu país?

A Anthropic lista a Polônia entre os países atendidos, mas isso não confirma a disponibilidade em outros lugares. Consulte a lista de países atendidos pela Anthropic para verificar se você pode usar o serviço onde está. O Fable 5.2 está disponível nos planos pagos do aplicativo Claude, no Claude Code, na API, no OpenRouter e nos serviços de nuvem do Google e da Microsoft.

Como ativar o Fable 5.2 no Claude Code?

Atualize o Claude Code para a versão 2.1.321 ou posterior e digite /model fable ou execute claude --model fable. Em sessões pelo Claude apps gateway, use o nome completo: /model claude-fable-5-2.

O Fable 5.2 está disponível no plano gratuito do Claude?

Não. O Fable 5.2 está disponível a partir do plano Pro. Depois da semana promocional, que termina na manhã de 17 de novembro de 2026 na Polônia, o uso no Pro é cobrado com créditos de uso.

Qual é o identificador do Fable 5.2 na API?

O identificador é claude-fable-5-2 na API da Anthropic, no Google Cloud, no Microsoft Foundry e no Claude Platform on AWS. No OpenRouter, é anthropic/claude-fable-5.2.

Fontes

• Documentação do Claude Code: configuração de modelos (consultada em 9 de novembro de 2026)
• Documentação do Claude Code: modo fast (consultada em 9 de novembro de 2026)
• Documentação do Claude: Claude Fable 5.2 (consultada em 9 de novembro de 2026)
• Documentação do Claude: visão geral dos modelos (consultada em 9 de novembro de 2026)
• Documentação do Claude: preços (consultada em 9 de novembro de 2026)
• Central de ajuda do Claude: promoção de lançamento do Fable 5.2
• Claude: preços dos planos (consultados em 9 de novembro de 2026)
• Anthropic: países atendidos
• Anthropic: apresentação do Claude Fable 5.2 e do Claude Mythos 5.2 (9 de novembro de 2026)
• Lista de modelos do OpenRouter (API /api/v1/models), consultada na noite de 9 de novembro de 2026