Claude Fable 5.2: configuração, preços da API e comparação com Opus
Experimente o Claude Fable 5.2 no Claude Code 2.1.321 ou posterior e na API Messages. Verifique uma tarefa real de programação e escolha o nível de effort. Compare preços por token com os custos publicados por tarefa, entenda a cobrança do fast mode e as diferenças entre plataformas, e evite erros de thinking, seleção forçada de ferramentas e histórico da conversa.
Conteúdo
Experimente o Claude Fable 5.2 quando o Opus 5.5 ainda falhar nas suas verificações de código, mesmo com effort maior. Caso contrário, mantenha o Opus no dia a dia. Comece com medium no Claude Code ou high na API, conforme as orientações da Anthropic.
O nível de effort controla a profundidade do raciocínio. Compare o custo das alterações aceitas: um preço maior por token ainda pode resultar em uma tarefa concluída mais barata.
Lançado em 9 de novembro de 2026, o Fable 5.2 usa o identificador de API claude-fable-5-2. Em 2026-11-12, a referência do modelo informa uma janela de contexto de 1M tokens e saída máxima de 128K.
Selecione o Fable 5.2 no Claude Code e verifique uma alteração real
Use o Claude Code 2.1.321 ou posterior e selecione o identificador completo do modelo. O registro oficial de alterações identifica a versão 2.1.321 como a que adicionou o Fable 5.2.
Você precisa de um cliente Claude Code instalado e autenticado, além de uma conta ou provedor que permita usar o modelo. Antes de enviar código privado, confirme que sua organização aprova as políticas de tratamento de dados de Covered Models aplicáveis ao Fable.
Para uma instalação nativa, execute estes comandos no Bash:
claude update
claude --versionSe a instalação foi feita por um gerenciador de pacotes, siga as instruções de atualização correspondentes. Confirme que a versão exibida é pelo menos 2.1.321. Não presuma que uma instalação antiga foi atualizada com sucesso.
Em uma sessão aberta, execute:
/model claude-fable-5-2A expressão “modelo Fable padrão” não significa que o Fable se torna a opção padrão de todos. A referência de configuração de modelos informa que nenhum modelo Fable é o padrão definido pelo tipo de conta.
Para um teste isolado, use Bash e Python 3 para criar um diretório temporário:
workdir="$(mktemp -d)"
cd "$workdir"
cat > clamp.py <<'PY'
def clamp(value, low, high):
return min(low, max(value, high))
PY
cat > test_clamp.py <<'PY'
from clamp import clamp
assert clamp(-2, 0, 10) == 0
assert clamp(5, 0, 10) == 5
assert clamp(12, 0, 10) == 10
print("3 checks passed")
PY
claude --model claude-fable-5-2 --effort mediumEsses parâmetros da CLI selecionam o modelo e o nível de effort da sessão. Verifique /model antes de começar. Se o effort estiver diferente, confira CLAUDE_CODE_EFFORT_LEVEL: essa variável de ambiente tem prioridade sobre o parâmetro de inicialização.
Passe a tarefa abaixo ao Claude Code. Ela pede a correção da função sem alterar os testes nem usar subagentes:
Read clamp.py and test_clamp.py.
Fix clamp.py so all existing assertions pass.
Do not edit test_clamp.py.
Run python3 test_clamp.py and report the exact result.
Do not use subagents.Mantenha as verificações de permissão ativadas. Aprove apenas as operações com arquivos e os comandos apropriados para esse diretório.
Depois que o agente terminar, saia do Claude Code e execute por conta própria:
python3 test_clamp.pyO resultado esperado é 3 checks passed, sem alterações no arquivo de testes. Um patch proposto não basta: a alteração precisa ser aplicada e o teste precisa passar. Isso verifica o funcionamento das ferramentas, não uma vantagem do Fable sobre outro modelo.
Faça a primeira requisição à API com claude-fable-5-2
Use primeiro a API Messages direta da Anthropic para separar o comportamento do modelo da configuração de um gateway. Este exemplo exige Bash, curl com --fail-with-body, jq e uma chave de API emitida pela Anthropic.
Crie sua própria chave seguindo as instruções do Console e selecione um espaço de trabalho específico. Uma chave restrita a esse espaço permite omitir anthropic-workspace-id neste exemplo, conforme a documentação de autenticação da API.
Cole a chave quando read aguardar a entrada e pressione Enter:
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEYEnvie uma requisição síncrona:
curl --silent --show-error --fail-with-body \
https://api.anthropic.com/v1/messages \
--header "Authorization: Bearer ${ANTHROPIC_API_KEY}" \
--header "anthropic-version: 2026-10-21" \
--header "content-type: application/json" \
--data '{
"model": "claude-fable-5-2",
"max_tokens": 4096,
"output_config": {
"effort": "high"
},
"messages": [
{
"role": "user",
"content": "Fix this Python function and return the corrected function plus three assertions: def clamp(value, low, high): return min(low, max(value, high))"
}
]
}' \
--output fable-response.json &&
jq '{
model,
stop_reason,
usage,
text: [.content[] | select(.type == "text") | .text]
}' fable-response.jsonA requisição usa o cabeçalho da versão atual da API e o campo documentado output_config.effort. Ela omite thinking porque o Fable 5.2 já usa raciocínio adaptativo.
Confira o modelo retornado, a presença de texto não vazio, usage e stop_reason. Uma resposta concluída naturalmente costuma retornar end_turn; max_tokens significa que a saída atingiu o limite definido. Siga as orientações sobre motivos de parada e aumente o limite de saída antes de tratar o truncamento como falha de qualidade.
Se a requisição HTTP falhar, consulte o erro salvo:
jq '.error' fable-response.jsonEssa requisição retorna código como texto. Ela não lê arquivos locais nem executa as verificações. Revise o código recebido antes de executá-lo.
O BetterToken também lista claude-fable-5-2 em seu catálogo em 2026-11-12. Sua integração com o Claude Code usa a Base URL https://bettertoken.ai. Siga separadamente as instruções de autenticação desse caminho. A presença do modelo no catálogo não confirma o suporte a todos os parâmetros de effort ou fast mode.
Compare o preço por token com o custo por tarefa concluída
Nas tarifas padrão da API, o Fable 5.2 custa menos por token que o Fable 5.1, mas o dobro do Opus 5.5. Estes são os preços publicados pela Anthropic, em USD por milhão de tokens, em 2026-11-12.
| Modelo, velocidade padrão | Entrada sem cache | Saída |
|---|---|---|
| Claude Fable 5.1 | $10 | $50 |
| Claude Fable 5.2 | $8 | $40 |
| Claude Opus 5.5 | $4 | $20 |
| Claude Sonnet 5.5 | $2 | $10 |
As tarifas de entrada e saída caíram 20% do Fable 5.1 para o 5.2. Essa redução é no preço unitário, não uma garantia de que a conta de uma sessão ficará 20% menor.
Na velocidade padrão, o Fable 5.2 cobra $10 por gravações de cache de cinco minutos e $16 por gravações de uma hora. Leituras custam $0.20. Cada tarifa corresponde a um milhão de tokens.
As tarifas de entrada/saída do Batch, que é assíncrono, são $4/$20. Elas não se aplicam ao uso interativo do Claude Code.
Para uma carga estimada de 100,000 tokens de entrada sem cache e 20,000 tokens de saída faturados:
Fable 5.2: 0.1 × $8 + 0.02 × $40 = $1.60
Opus 5.5: 0.1 × $4 + 0.02 × $20 = $0.80O cálculo considera velocidade padrão e preços globais, sem operações de cache, ferramentas pagas ou desconto Batch. Impostos aplicáveis não estão incluídos. A quantidade de tokens é igual para os dois modelos, o que muitas vezes não acontece em sessões reais de agentes.
O anúncio do FrontierCode 2.0 pela Anthropic compara outra medida. O Fable 5.2 com effort High alcançou 45.3%, contra o melhor resultado do Opus 5.5, de 45.5%. Segundo a Anthropic, o custo por tarefa foi aproximadamente a metade.
Essa comparação usa Fable High contra Opus Max. Ela não mantém iguais o volume de tokens nem o nível de effort.
Os resultados atuais do CursorBench 4.0 mostram por que a conclusão depende da carga de trabalho. O Fable 5.2 High alcança 56.9% com custo informado de $9.70, enquanto o Opus 5.5 High chega a 56.0% com $3.97. O Fable 5.2 Max atinge 60.0% com $32.79.
Esses são resultados de avaliação publicados pelos responsáveis, não preços de assinatura nem medições no seu repositório. O Cursor identifica a linha de 56.9% como High, não como Medium, o padrão do Claude Code.
Use o guia de avaliação de custo por tarefa para incluir novas tentativas, tentativas malsucedidas e configurações de execução do agente.
Ative fast mode apenas quando a velocidade de saída importar
Ative fast mode para tarefas sensíveis à latência depois que a requisição padrão funcionar. A Anthropic anuncia geração de tokens até 2.5 vezes mais rápida. Isso não garante que uma tarefa completa de programação termine 2.5 vezes mais rápido.
Na API Messages direta, mantenha claude-fable-5-2 e adicione este campo no nível superior do corpo da requisição:
"speed": "fast"Não é necessário um cabeçalho beta de fast mode. Em uma requisição bem-sucedida, confira se usage.speed é "fast", conforme o guia de fast mode da API.
Em 2026-11-12, os preços de entrada/saída do Fable 5.2 em fast mode são $16/$80 por milhão de tokens. Os limites padrão documentados de fast mode se aplicam aos níveis de uso Start, Build e Scale.
Ao exceder um limite de taxa de fast mode, a API retorna 429 com retry-after. Respeite o intervalo indicado. Outra opção é remover explicitamente speed e reenviar a requisição na velocidade padrão.
No Claude Code, selecione o Fable 5.2 e execute /fast. Em planos de assinatura, fast mode consome diretamente os créditos de uso, mesmo quando ainda resta uso incluído no plano. Confira os requisitos do Claude Code antes de ativar.
O caminho Vertex/Agent Platform do Google Cloud exige Claude Code 2.1.322 ou posterior para fast mode. As regiões compatíveis são global, us e eu; siga as instruções específicas do provedor.
A configuração de cURL acima é para a API direta da Anthropic. Não a copie sem alterações para o endpoint de outro provedor de nuvem.
Evite os erros 400 ao migrar
Revise os parâmetros das requisições e o histórico da conversa antes de mudar o tráfego de produção. O raciocínio adaptativo obrigatório e as restrições à seleção forçada de ferramentas já se aplicavam ao Fable 5.1 e ao Opus 5.5. Não são novas restrições introduzidas pelo Fable 5.2.
As orientações de compatibilidade do Fable 5.2 documentam estas falhas:
| Padrão da requisição | Resultado | Correção |
|---|---|---|
thinking: {"type": "enabled"} com budget_tokens | 400 | Omita thinking ou use {"type": "adaptive"}. Controle a profundidade com effort. |
thinking: {"type": "disabled"} | 400 | Remova esse parâmetro. Não é possível desativar o raciocínio adaptativo. |
tool_choice: {"type": "any"} | 400 invalid_request_error | Use {"type": "auto"} e trate a possibilidade de receber uma resposta em texto. |
tool_choice: {"type": "tool", "name": "..."} | 400 invalid_request_error | Remova a seleção forçada e trate a escolha de ferramentas na aplicação. |
Para obter argumentos de ferramentas válidos segundo o esquema, use strict: true com seleção automática onde houver suporte. O modo estrito restringe os argumentos; ele não força a chamada de uma ferramenta. Saídas JSON são outra opção.
Em organizações com chaves de criptografia gerenciadas pelo cliente, o Fable 5.2 não oferece uso estrito de ferramentas nem saídas JSON. Nesse caso, valide as saídas no código da aplicação.
Uma mudança importante na migração é a verificação mais rígida do prefixo da conversa. O Fable 5.2 a aplica a todas as contas, inclusive às antigas cujas requisições ao Fable 5.1 antes passavam.
A mensagem de erro inclui esta frase:
The block is bound to a different conversation.Ela pode aparecer ao reenviar um bloco de raciocínio depois de alterar o prompt system, tools ou conteúdo anterior da conversa. Repetir a mesma requisição não corrige a incompatibilidade.
Siga as regras de preservação do raciocínio. Mantenha o prefixo existente intacto, acrescente as novas mensagens ao final e reenvie os arrays de conteúdo do assistente exatamente como foram recebidos. Para uma integração simples, inicie outra conversa ao substituir o prompt de sistema original ou as definições de ferramentas.
Aplicações que usam computer use ou ferramentas advisor também devem consultar o guia completo de migração antes da implantação.
Ajuste effort e verifique a conclusão de tarefas longas
Controle o raciocínio pelas configurações de effort, não apenas pela redação do prompt. A Anthropic informa que pedidos para responder sem deliberar não impedem o raciocínio do Fable 5.2 em medium ou níveis superiores.
O guia de prompts específico do modelo também descreve encerramentos prematuros em tarefas com várias etapas, principalmente em low e medium. Uma resposta com end_turn significa que o turno terminou. Suas verificações de aceitação ainda precisam determinar se o trabalho está completo.
Em uma tarefa de repositório com escopo delimitado, deixe explícitas as condições de conclusão. Este prompt exige a alteração e os testes, mas orienta a parar diante de falta de acesso, ações destrutivas ou mudanças de escopo:
Complete the requested change and run the relevant tests.
Do not stop after a plan or a list of remaining steps.
Continue through ordinary implementation failures within the approved scope.
Stop and report the blocker if you need unavailable credentials,
destructive actions, or a decision that changes the requested scope.
Do not start subagents for this trial.Para tarefas longas de programação, compare high com seu resultado de referência em medium. Experimente xhigh apenas quando os ganhos medidos justificarem o trabalho adicional. Reserve max para medir o limite de capacidade ou para tarefas em que uma falha seja especialmente cara.
A delegação também muda o custo. Segundo a Anthropic, o Fable delega com facilidade quando o sistema de agentes ao redor incentiva esse comportamento. Subagentes podem consumir uma parte grande do orçamento da sessão. Registre os modelos e o consumo deles antes de atribuir toda a conta ao modelo principal.
Qual modelo manter no dia a dia?
Mantenha o Sonnet 5.5 para alterações delimitadas com testes claros quando a saída já atender aos seus requisitos. As tarifas menores por token fazem dele uma primeira opção razoável para edições repetitivas. Passe para um modelo mais capaz quando a revisão encontrar dependências ignoradas ou exigir várias tentativas de correção.
Mantenha o Opus 5.5 para o trabalho geral no repositório, a menos que o Fable produza uma melhoria mensurável. O guia de seleção do Opus explica como voltar ao modelo e manter essa escolha.
Teste o Fable 5.2 em diagnósticos difíceis, alterações em vários arquivos e migrações longas que o Opus ainda erre com effort maior. Escolha o Fable quando a melhoria nas alterações aceitas ou no custo total de conclusão compensar as tarifas mais altas por token.
Depois de verificar a configuração, compare os modelos no mesmo commit inicial e com os mesmos testes de aceitação. Registre effort, tempo decorrido, uso de cache, consumo dos subagentes e todas as tentativas malsucedidas. Mantenha a configuração mais barata que passe nas suas verificações reais; uma pontuação de benchmark não deve substituir essa decisão.
