DEV Community

Cover image for Como Usar Claude Fable 5 com Claude Code
Lucas
Lucas

Posted on • Originally published at apidog.com

Como Usar Claude Fable 5 com Claude Code

A Anthropic lançou o Claude Fable 5 em 9 de junho de 2026 com foco em sessões de codificação longas e autônomas: exatamente o tipo de trabalho que muitos desenvolvedores tentam delegar ao Claude Code quando precisam alterar uma base de código inteira sem perder coerência. Se você já usa o CLI do Claude Code no dia a dia, habilitar o Fable 5 é basicamente uma troca de modelo — mas vale configurar, verificar e controlar custo antes de deixar o agente rodando por horas.

Experimente o Apidog hoje

Se você quer entender o modelo antes de configurá-lo, leia o que é o Claude Fable 5. Este guia foca no fluxo de trabalho prático com Claude Code.

TL;DR

Atualize e autentique o Claude Code para a versão v2.1.170 ou posterior. Depois, selecione o Fable 5 de uma destas formas:

/model fable
Enter fullscreen mode Exit fullscreen mode

ou:

/model claude-fable-5
Enter fullscreen mode Exit fullscreen mode

Você também pode iniciar uma sessão com:

claude --model fable
Enter fullscreen mode Exit fullscreen mode

ou definir a variável de ambiente:

export ANTHROPIC_MODEL=claude-fable-5
claude
Enter fullscreen mode Exit fullscreen mode

Confirme sempre com:

/status
Enter fullscreen mode Exit fullscreen mode

O Fable 5 custa $10/M tokens de entrada e $50/M tokens de saída, ou seja, 2x o Opus 4.8. Use-o para tarefas longas e complexas, não como padrão para pequenas edições.

Um monitor de computador exibe um dashboard de desempenho ou métricas de um modelo de IA. O título do dashboard é 'Métricas de Desempenho do Claude Fable 5', com gráficos e números que indicam a eficiência e o custo do modelo. Pode haver uma seção destacando o custo por milhão de tokens de entrada e saída. As cores são suaves e profissionais, com texto claro e legível.

Quando usar o Claude Code com Fable 5

O Claude Code é o agente de codificação via terminal da Anthropic. Ele pode editar arquivos, executar comandos, navegar pelo projeto e realizar tarefas em várias etapas dentro do seu repositório.

O modelo escolhido define até onde esse agente consegue ir antes de perder contexto ou consistência. É aqui que o Fable 5 se diferencia.

A tela de um terminal mostrando o Claude Code em ação. O texto do terminal exibe mensagens de status e comandos sendo executados por um agente de IA. O Claude Code parece estar interagindo com uma base de código, talvez realizando uma tarefa de refatoração ou migração. O fundo do terminal é escuro com texto claro e o prompt da linha de comando visível.

Segundo a Anthropic, o Fable 5 foi criado para codificação autônoma de longo prazo. O modelo “mantém o foco em milhões de tokens em tarefas de longa duração e melhora suas saídas usando suas próprias anotações”.

Na prática, isso o torna mais adequado para tarefas como:

  • migrações grandes;
  • refatorações em vários módulos;
  • atualização de APIs em múltiplas rotas;
  • modernização de padrões internos;
  • alterações que exigem manter consistência em muitos arquivos;
  • execução de planos longos com validações intermediárias.

A Anthropic cita um caso da Stripe durante os testes: o Fable 5 completou uma alteração em uma base de 50 milhões de linhas de Ruby em um único dia, trabalho que a empresa estimou que levaria mais de dois meses manualmente. O relato completo está no anúncio do Claude Fable 5.

A contrapartida é custo. O Fable 5 custa:

  • $10 por milhão de tokens de entrada;
  • $50 por milhão de tokens de saída.

Isso é o dobro do Opus 4.8, que custa $5 e $25.

Portanto, não use Fable 5 para tudo. Uma regra prática:

Tarefa Modelo recomendado
Ajuste pequeno em um arquivo Sonnet ou Opus 4.8
Correção pontual de bug Sonnet ou Opus 4.8
Refatoração local Opus 4.8
Migração grande Fable 5
Alteração em muitas rotas, schemas ou módulos Fable 5
Sessão autônoma longa Fable 5

Se você está comparando os modelos, veja também Claude Fable 5 vs Opus 4.8.

Se você já trocou modelos no Claude Code antes, o processo é o mesmo descrito em executando GLM-5.1 com Claude Code. O que muda é o ID do modelo.

Pré-requisitos

Antes de selecionar o Fable 5, valide estes pontos.

1. Atualize o Claude Code

O Fable 5 requer Claude Code v2.1.170 ou posterior.

Execute:

claude update
Enter fullscreen mode Exit fullscreen mode

Depois confirme a versão:

claude --version
Enter fullscreen mode Exit fullscreen mode

Se sua versão for anterior, o Fable 5 pode não aparecer no seletor de modelos.

2. Confirme acesso ao Fable 5

Você precisa de uma conta Anthropic com acesso ao modelo. Segundo o conteúdo original, o Fable 5 está disponível na API da Anthropic e em planos como Max, Team Premium, Enterprise pay-as-you-go e similares.

Importante: o Fable 5 não é o modelo padrão. Mesmo com acesso, você precisa selecioná-lo explicitamente.

3. Verifique faturamento ou assinatura

Como o Fable 5 é pago por token, sua conta precisa de faturamento de API ativo ou um plano que inclua o modelo.

Consulte os níveis atuais na visão geral dos modelos Anthropic.

4. Abra o terminal no repositório certo

O Claude Code opera dentro de um diretório de projeto.

Exemplo:

cd ~/projects/minha-api
claude
Enter fullscreen mode Exit fullscreen mode

5. Atenção a ZDR

O Fable 5 não está disponível sob retenção zero de dados, ou ZDR.

Se sua organização usa Claude Code com ZDR ativado, o Fable 5 pode:

  • não aparecer no seletor;
  • aparecer desativado;
  • não poder ser selecionado.

Isso é uma restrição de política, não um bug do CLI.

Como configurar o Claude Code para usar Claude Fable 5

O Claude Code aceita quatro formas principais de escolher um modelo.

A ordem de prioridade é:

  1. comando /model dentro da sessão;
  2. flag --model na inicialização;
  3. variável de ambiente ANTHROPIC_MODEL;
  4. campo model no arquivo de configurações.

Você pode usar:

fable
Enter fullscreen mode Exit fullscreen mode

ou:

claude-fable-5
Enter fullscreen mode Exit fullscreen mode

O alias fable aponta para a versão Fable recomendada para seu provedor e pode ser atualizado com o tempo. O ID completo claude-fable-5 fixa o modelo exato.

A referência oficial está na documentação de configuração de modelo do Claude Code.

Opção 1: trocar o modelo dentro da sessão com /model

Dentro de uma sessão do Claude Code, execute:

/model fable
Enter fullscreen mode Exit fullscreen mode

Ou use o ID completo:

/model claude-fable-5
Enter fullscreen mode Exit fullscreen mode

Você também pode abrir o seletor interativo:

/model
Enter fullscreen mode Exit fullscreen mode

Depois selecione o Fable 5 na lista.

Nas versões recentes, escolher um modelo com /model pode salvá-lo como padrão para novas sessões, escrevendo o campo model nas configurações do usuário.

No seletor:

  • Enter: troca para o modelo e salva como padrão;
  • s: troca apenas para a sessão atual.

Se você digitar diretamente:

/model fable
Enter fullscreen mode Exit fullscreen mode

o comportamento é equivalente a selecionar e salvar. Sessões futuras iniciarão com Fable 5 até você mudar o modelo novamente.

Cuidado ao trocar no meio de uma conversa

Se a sessão já tiver histórico, o Claude Code pode pedir confirmação antes de trocar.

Motivo: a próxima resposta reprocessa o histórico completo sem o mesmo contexto em cache. Isso pode gerar um custo único adicional.

Para sessões caras, prefira selecionar o modelo antes de começar.

Opção 2: iniciar uma sessão com --model

Para usar Fable 5 em uma sessão específica sem mudar o padrão salvo:

claude --model fable
Enter fullscreen mode Exit fullscreen mode

Ou:

claude --model claude-fable-5
Enter fullscreen mode Exit fullscreen mode

Essa é a melhor opção quando você quer rodar modelos diferentes em terminais diferentes.

Exemplo:

# Terminal 1: tarefa longa
claude --model fable

# Terminal 2: correções menores
claude --model opus
Enter fullscreen mode Exit fullscreen mode

A flag --model vale apenas para a sessão iniciada com ela.

Opção 3: definir ANTHROPIC_MODEL

Se você quer iniciar o Claude Code com Fable 5 a partir do shell:

export ANTHROPIC_MODEL=claude-fable-5
claude
Enter fullscreen mode Exit fullscreen mode

Ou usando o alias:

export ANTHROPIC_MODEL=fable
claude
Enter fullscreen mode Exit fullscreen mode

Isso afeta apenas sessões iniciadas nesse ambiente.

Se você também definir ANTHROPIC_MODEL dentro de settings.json, a variável exportada no shell vence, porque ela já existe antes de o Claude Code carregar o bloco env das configurações.

Opção 4: fixar o modelo em settings.json

Para tornar o Fable 5 o padrão persistente, edite o arquivo de configurações.

Configuração global do usuário:

~/.claude/settings.json
Enter fullscreen mode Exit fullscreen mode

Configuração do projeto:

.claude/settings.json
Enter fullscreen mode Exit fullscreen mode

Configuração local do projeto, aplicada apenas a você:

.claude/settings.local.json
Enter fullscreen mode Exit fullscreen mode

Exemplo mínimo:

{
  "model": "claude-fable-5"
}
Enter fullscreen mode Exit fullscreen mode

Ou usando o alias:

{
  "model": "fable"
}
Enter fullscreen mode Exit fullscreen mode

Configurações de projeto e configurações gerenciadas podem ter precedência. Isso é útil em equipes que querem padronizar o modelo usado em um repositório.

Exemplo de configuração de projeto:

{
  "model": "fable"
}
Enter fullscreen mode Exit fullscreen mode

Se um colega escolher outro modelo com /model, a configuração do projeto poderá ser reaplicada quando ele reiniciar o Claude Code.

Como verificar se você está usando Fable 5

Não presuma que a troca funcionou. Antes de iniciar uma execução longa, confirme o modelo ativo.

Dentro da sessão, execute:

/status
Enter fullscreen mode Exit fullscreen mode

O comando mostra o modelo em uso junto com informações da conta.

Se você usa uma linha de status, o modelo ativo também pode aparecer continuamente no terminal.

Troubleshooting: selecionei Fable 5, mas /status mostra outro modelo

Se /status mostrar Opus 4.8 ou outro modelo, verifique estes pontos.

1. Configuração de projeto sobrescrevendo sua escolha

Procure arquivos como:

.claude/settings.json
.claude/settings.local.json
~/.claude/settings.json
Enter fullscreen mode Exit fullscreen mode

Verifique se algum deles contém:

{
  "model": "opus"
}
Enter fullscreen mode Exit fullscreen mode

ou outro valor.

Se a inicialização vier de uma configuração de projeto ou gerenciada, o cabeçalho de inicialização normalmente informa qual arquivo definiu o modelo.

Você pode sobrescrever apenas a sessão atual com:

/model fable
Enter fullscreen mode Exit fullscreen mode

Mas, ao reiniciar, a configuração do projeto pode voltar a vencer.

2. Fallback automático para Opus 4.8

O Fable 5 executa classificadores de segurança para conteúdo de segurança cibernética e biologia. Quando uma requisição é sinalizada, o Claude Code pode executá-la novamente no modelo Opus padrão, que na API da Anthropic é o Opus 4.8, e mostrar um aviso na transcrição.

Isso significa que, mesmo depois de selecionar Fable 5, uma requisição individual pode cair para Opus 4.8.

Segundo a Anthropic, mais de 95% das sessões Fable não envolvem fallback. Para código de aplicação comum, isso deve ser raro.

Para voltar ao Fable 5 depois de um fallback:

/model fable
Enter fullscreen mode Exit fullscreen mode

Fluxo recomendado para sessões longas

Para aproveitar o Fable 5 sem perder controle de custo e qualidade, trate a sessão como uma execução planejada.

1. Comece com escopo claro

Evite prompts vagos como:

Refatore esta API.
Enter fullscreen mode Exit fullscreen mode

Prefira algo específico:

Migre todos os endpoints de usuários de callbacks para async/await.

Regras:
- mantenha os contratos HTTP existentes;
- não altere nomes de rotas;
- atualize testes relacionados;
- atualize a especificação OpenAPI se existir;
- rode a suíte de testes ao final;
- liste arquivos alterados e riscos.
Enter fullscreen mode Exit fullscreen mode

2. Peça um plano antes das edições

Use um prompt como:

Antes de editar arquivos, analise o repositório e proponha um plano de migração em etapas. 
Não modifique nada ainda.
Enter fullscreen mode Exit fullscreen mode

Depois revise o plano e só então autorize:

Execute o plano. Faça commits lógicos ou agrupe as alterações por etapa.
Enter fullscreen mode Exit fullscreen mode

3. Divida tarefas grandes

Mesmo com Fable 5, uma execução longa fica mais segura com checkpoints.

Exemplo:

Execute apenas a etapa 1: atualizar a camada de serviço.
Depois pare e mostre um resumo das alterações antes de seguir para controllers e testes.
Enter fullscreen mode Exit fullscreen mode

4. Exija validações

Peça para o Claude Code rodar comandos concretos:

Depois das alterações, rode:
- npm test
- npm run lint
- npm run typecheck

Se algum comando falhar, corrija antes de finalizar.
Enter fullscreen mode Exit fullscreen mode

Ajuste os comandos conforme seu projeto:

pytest
go test ./...
mvn test
cargo test
Enter fullscreen mode Exit fullscreen mode

5. Revise diffs antes de aceitar

Ao final, revise:

git diff
Enter fullscreen mode Exit fullscreen mode

ou:

git status
Enter fullscreen mode Exit fullscreen mode

Para tarefas muito grandes, peça um resumo técnico:

Liste:
- arquivos alterados;
- comportamento modificado;
- testes executados;
- riscos conhecidos;
- próximos passos recomendados.
Enter fullscreen mode Exit fullscreen mode

Emparelhando Claude Code com Apidog

Quando o Claude Code termina de escrever ou alterar uma API, você ainda precisa confirmar se os endpoints se comportam corretamente. Um diff pode parecer certo, mas a API pode retornar status, headers ou payloads incompatíveis com o contrato.

É aqui que o Apidog entra no fluxo: Claude Code altera o código; Apidog valida o comportamento da API.

A tela de um computador mostrando o Apidog, uma plataforma de colaboração e gerenciamento de API. O Apidog exibe várias requisições e respostas de API em um ambiente de desenvolvimento. O layout inclui um explorador de projetos à esquerda, uma área principal para criar e testar APIs, e painéis para visualizar detalhes de requisições e respostas. Há gráficos e dados mostrando o desempenho e a validação das APIs.

Use este fluxo após uma sessão do Claude Code que alterou sua API.

Passo 1: peça ao Claude Code para atualizar a especificação OpenAPI

Se o projeto já tem OpenAPI, peça para atualizar junto com a implementação:

Atualize a especificação OpenAPI para refletir as rotas alteradas.
Garanta que métodos, parâmetros, status codes e schemas estejam sincronizados com o código.
Enter fullscreen mode Exit fullscreen mode

Se o projeto não tem uma especificação, peça para gerar uma para as rotas modificadas:

Gere uma especificação OpenAPI apenas para os endpoints alterados nesta sessão.
Inclua parâmetros, exemplos de request, responses e schemas.
Enter fullscreen mode Exit fullscreen mode

Passo 2: importe a especificação no Apidog

No Apidog:

  1. crie ou abra um projeto;
  2. importe o arquivo OpenAPI;
  3. revise os endpoints gerados;
  4. configure o ambiente local ou staging.

O Apidog transforma paths, métodos, parâmetros e schemas em requisições executáveis.

Passo 3: execute os endpoints alterados

Aponte para seu servidor local ou staging e execute as requisições.

Verifique:

  • status code;
  • headers;
  • body;
  • campos obrigatórios;
  • formatos de data;
  • mensagens de erro;
  • paginação;
  • autenticação;
  • compatibilidade com o schema.

Passo 4: valide respostas contra o schema

Use o schema importado para detectar divergências entre contrato e implementação.

Exemplos de problemas que isso ajuda a encontrar:

  • campo obrigatório ausente;
  • tipo errado, como string no lugar de number;
  • status code diferente do documentado;
  • resposta de erro sem schema;
  • payload novo não refletido na OpenAPI.

Esse tipo de desvio é comum depois de alterações automatizadas em grande escala.

Passo 5: salve as requisições como testes de regressão

Depois que os endpoints passarem, salve as requisições como casos de teste.

Na próxima alteração feita pelo Claude Code — ou por qualquer pessoa da equipe — você poderá reexecutar o conjunto e validar rapidamente se algo quebrou.

Esse emparelhamento importa ainda mais com modelos de longo prazo. Quanto maior a alteração autônoma, maior a área de superfície a validar. Um conjunto executável no Apidog transforma “o agente terminou” em “os endpoints foram verificados”.

Você pode baixar o Apidog e importar uma especificação existente em poucos minutos.

Checklist final

Antes de rodar uma sessão longa com Fable 5:

  • [ ] Claude Code está em v2.1.170 ou posterior;
  • [ ] sua conta tem acesso ao Fable 5;
  • [ ] faturamento ou plano está ativo;
  • [ ] você está no repositório correto;
  • [ ] o modelo foi definido com /model, --model, ANTHROPIC_MODEL ou settings.json;
  • [ ] /status confirma Fable 5;
  • [ ] a tarefa tem escopo claro;
  • [ ] há comandos de teste definidos;
  • [ ] você sabe o custo esperado da execução;
  • [ ] endpoints alterados serão validados depois.

Use o Fable 5 quando a tarefa justificar uma sessão autônoma longa. Para mudanças pequenas, continue usando modelos mais baratos. Para migrações e refatorações grandes, configure o modelo explicitamente, confirme com /status, execute com checkpoints e valide o resultado com testes e ferramentas de API.

Top comments (0)