# Claude Fable 5: quando usar o modelo avançado e qual nível de esforço escolher

> Análise completa do modelo Claude Fable 5 e do parâmetro effort: como funciona o sinal comportamental de raciocínio, a matriz de disponibilidade dos níveis (low/xhigh), o cálculo de custo por execução e as configurações na API e no Claude Code.

Claude Fable 5 é o modelo flagship da Anthropic na nova classe Mythos, projetado para as tarefas mais complexas de raciocínio multi-etapa e desenvolvimento agentic autônomo. Junto com este modelo, os desenvolvedores ganharam um novo mecanismo fundamental de controle de comportamento — o parâmetro `effort`.

Este guia detalha as capacidades do Fable 5, os princípios de funcionamento do parâmetro `effort`, a tarifação dos tokens de raciocínio e estratégias práticas para escolher a configuração ideal para otimizar velocidade e custos em produção.

---

## 1. Fable 5 em duas palavras: o que é este modelo e por que ele existe

O Claude Fable 5 posiciona-se como o modelo mais poderoso amplamente disponível da Anthropic, superando o nível Opus. Ele foi desenvolvido para tarefas onde modelos convencionais chegam a becos sem saída ou perdem contexto em longas distâncias.

### 1.1. Posicionamento do modelo e família Mythos

O Fable 5 é a primeira implementação publicamente acessível da arquitetura da classe Mythos. Acima dele existe uma versão limitada de pesquisa — Mythos 5, que carece das camadas adicionais de filtros externos e é fornecida exclusivamente a grupos de pesquisa autorizados através da iniciativa Project Glasswing.

O modelo é suportado no ambiente **Claude Code** e na plataforma **Managed Agents**, oferecendo uma janela de contexto de 1.000.000 de tokens e geração de até 128.000 tokens por requisição.

> [!NOTE]
> Na interface web, o Fable 5 está disponível para usuários dos planos Pro e Max, enquanto na API é chamado pelo identificador `claude-fable-5`.

### 1.2. Benchmarks, multimodalidade e o conceito de No-Slop Code

Nos testes, o Fable 5 demonstra resultados State-of-the-Art (SOTA) em disciplinas complexas:
- **Programação Agentic:** deploy autônomo de repositórios, busca de bugs e escrita de testes.
- **Geração de No-Slop Code:** código sem wrappers redundantes, comentários artificiais e abstrações inúteis.
- **Percepção Multimodal:** conclusão de jogos (especificamente Pokemon FireRed) exclusivamente via fluxo de vídeo/screenshots, sem dicas textuais.
- **Pesquisa Científica:** modelagem em VibeCAD e análise de estruturas biomédicas.

A principal regularidade do Fable 5: a vantagem sobre Sonnet e Opus torna-se perceptível justamente em iterações longas e multi-etapas.

---

## 2. Quando faz sentido usar o Fable 5 e quando não

O alto desempenho do modelo vem acompanhado de um custo elevado, portanto seu uso deve ser economicamente e tecnicamente justificado.

### 2.1. Cenários de uso ótimos e ineficientes

O Fable 5 foi criado para tarefas com alto custo de erro:

| Recomendado usar | Não vale a pena pagar a mais |
| --- | --- |
| Refatoração complexa de monolitos e migrações de sistemas | Operações CRUD simples e scripts padrão |
| Sessões agentivas multi-etapas (de 20 a 100+ turnos) | Classificação única ou extração de dados |
| Busca de race conditions sutis e problemas de segurança | Escrita de testes unitários simples para funções conhecidas |
| Projeto arquitetural de novos subsistemas | Resumo rápido de notas curtas |

### 2.2. Quatro regras de preparação para produção e parâmetros de acesso

Antes de integrar o Fable 5 nos seus pipelines, considere estes aspectos técnicos:

1. **Simplifique os system prompts:** O Fable 5 pensa conceitualmente. Scripts rígidos passo a passo de modelos antigos apenas limitam seu potencial — defina o objetivo final e os limites do aceitável.
2. **Gerencie o parâmetro effort:** A configuração de esforço é a alavanca principal para controlar latência e custos financeiros.
3. **Estabeleça timeouts para turnos longos:** Raciocínios complexos em tarefas de fronteira podem levar minutos; limite as iterações máximas dos agentes.
4. **Trate recusas (Refusals):** Devido às rigorosas regras internas de segurança, parte das requisições limítrofes retorna recusa, exigindo tratamento de fallback no código.

---

## 3. O que exatamente o effort faz e como ele funciona

Com o surgimento do Fable 5, os engenheiros da Anthropic revisaram radicalmente o sistema de configurações. Os parâmetros usuais de sampling (temperatura, top-p) e o `budget_tokens` manual tornaram-se obsoletos.

### 3.1. Mecanismo de sinal comportamental vs orçamento fixo de tokens

A principal ferramenta para ajuste fino tornou-se o parâmetro **`effort`**, transmitido dentro da configuração de saída: `output_config={"effort": "..."}`.

> [!IMPORTANT]
> O parâmetro `effort` é um sinal comportamental qualitativo, não um limite rígido de tokens. Ele informa ao modelo quão profundamente explorar o espaço de hipóteses e quanto esforço dedicar à verificação. O único limite rígido de geração permanece sendo `max_tokens`.

### 3.2. Impacto nas chamadas de ferramentas, explicações e geração

Diferente do antigo `budget_tokens`, que controlava apenas a fase de raciocínio interno, o `effort` escala todos os aspectos da resposta:
- **No nível low:** o modelo gera menos chamadas de ferramentas, agrupa comandos em uma única requisição, minimiza introduções e retorna um resultado conciso.
- **No nível high / xhigh:** o modelo desdobra um plano interno, verifica resultados intermediários com ferramentas adicionais e fornece comentários abrangentes.

---

## 4. Os cinco níveis de effort e onde cada um está disponível

A Messages API suporta uma lista fixa de cinco valores permitidos para o parâmetro `effort`.

### 4.1. Escala oficial de low a xhigh

| Nível | Descrição comportamental conforme documentação da Anthropic | Disponibilidade na família de modelos |
| :--- | :--- | :--- |
| **xhigh** | Profundidade máxima de raciocínio para sessões agentivas longas (>30 min) com orçamentos milionários | Apenas Fable 5, Mythos 5, Opus 4.8, Opus 4.7 |
| **high** | Valor padrão: raciocínio expandido, planejamento e verificação de etapas | Todos os modelos com suporte a effort |
| **medium** | Nível equilibrado com economia moderada de tokens sem perda de lógica | Todos os modelos com suporte a effort |
| **low** | Velocidade máxima e mínimo gasto de tokens com controle básico de qualidade | Todos os modelos com suporte a effort |
| **max** | Raciocínio extremo, ilimitado, para tarefas científicas específicas | Sessões especiais do Claude Code |

### 4.2. Suporte por modelo e calibração individual

O nível **xhigh** é exclusivo: não está presente no Opus 4.6 e Sonnet 4.6. Além disso, a escala de esforço é calibrada individualmente para cada rede neural: `high` no Fable 5 gera uma trajetória de raciocínio significativamente mais profunda do que `high` no Opus 4.6.

---

## 5. Padrões por modelo e diferentes ambientes: API e Claude Code

O comportamento do modelo sem especificação explícita de parâmetros difere dependendo do ambiente de execução.

### 5.1. Comparação dos valores padrão na API e no Claude Code

| Modelo | Padrão na Messages API | Padrão no Claude Code |
| :--- | :--- | :--- |
| **Claude Fable 5** | `high` | `high` |
| **Claude Opus 4.8** | `high` | `high` |
| **Claude Opus 4.7** | `high` | `xhigh` |
| **Claude Opus 4.6 / Sonnet 4.6** | `high` | `high` |

### 5.2. Comportamento de fallbacks e persistência de estado entre sessões

- **Rollback automático (Fallback):** Se você iniciar uma sessão com nível `xhigh` e depois alternar para Opus 4.6, o Claude Code fará rollback automaticamente para `high` sem interrupção abrupta.
- **Persistência dos níveis:** Os níveis de `low` a `xhigh` são mantidos entre execuções do Claude Code. O nível `max` é intencionalmente resetado após o término da sessão para evitar consumo descontrolado do orçamento do usuário.

---

## 6. Como o effort se relaciona com o raciocínio do modelo

O trabalho com o raciocínio interno (Thinking) difere drasticamente entre as gerações de modelos.

### 6.1. Particularidades do Fable 5 vs modo adaptativo no Opus

- **Fable 5:** O raciocínio está embutido na arquitetura e sempre ativado. Tentar passar `thinking: {"type": "disabled"}` retorna um erro `HTTP 400 Bad Request`.
- **Opus 4.7 / 4.8:** O raciocínio adaptativo está desativado por padrão e é ativado pela chamada `thinking: {"type": "adaptive"}`.

### 6.2. Migração do parâmetro obsoleto budget_tokens

> [!WARNING]
> Se você estiver atualizando sua base de código de versões anteriores do Claude SDK, o parâmetro `budget_tokens` não é mais suportado. Seu uso retornará um erro da API. Substitua-o pelo objeto `output_config={"effort": "..."}`.

---

## 7. Quanto custa cada nível: cálculo de valor

O parâmetro `effort` não altera a taxa base por milhão de tokens. Ele impacta a fatura final indiretamente — através da quantidade de tokens de raciocínio gerados.

### 7.1. Tarifação dos tokens ocultos de raciocínio (Thinking Tokens)

No Fable 5, por padrão, a saída do texto de raciocínio é ocultada (`omitted`), porém cada token de reflexão interna é tarifado como um token de saída completo na taxa padrão: **$10 por 1M de tokens de entrada** e **$50 por 1M de tokens de saída**.

### 7.2. Cálculo de custo por turno e impacto do novo tokenizer

Estimativa de custo de um turno em uma tarefa agentiva com 20.000 tokens de entrada (exemplo com Opus 4.8):

| Cenário e nível | Tokens de saída | Entrada ($5/M) | Saída ($25/M) | Total por 1 turno |
| :--- | :--- | :--- | :--- | :--- |
| **low** (conciso, ferramentas compactas) | 5.000 | $0,10 | $0,125 | **~$0,23** |
| **high** (planejamento, validação de código) | 20.000 | $0,10 | $0,50 | **~$0,60** |
| **xhigh** (investigação profunda de arquitetura) | 60.000 | $0,10 | $1,50 | **~$1,60** |

> [!TIP]
> Para o Fable 5, multiplique esses números por 2 (saída $50/M). A diferença entre `low` e `xhigh` em uma sessão agentiva longa de 50 turnos pode variar de $25 a $160!

---

## 8. Qual nível escolher para cada tipo de tarefa

Para não desperdiçar orçamento, utilize uma abordagem diferenciada na distribuição de carga.

### 8.1. Estratégias de escolha para Fable 5 e Opus

:::tabs
=== Fable 5 (Tarefas Flagship)
Comece o trabalho com o nível padrão **high**. O nível `high` no Fable 5 supera em qualidade o `xhigh` das gerações anteriores de modelos. Mude para `xhigh` apenas quando o agente resolver tarefas com duração superior a 30 minutos ou projetar uma nova arquitetura do zero.
=== Opus 4.8 / 4.7 (Coding)
O início recomendado para desenvolvimento é o nível **xhigh**. Ele revela o máximo potencial de análise de código no Opus. Ative o nível `medium` após a validação dos testes para otimizar o orçamento.
=== Automação em Background (low)
Use o nível **low** para subtarefas rotineiras, geração de documentação, parsing rápido e subagentes, onde a latência é mais crítica que a análise profunda.
:::

### 8.2. Arquitetura multinível: orquestrador e subagentes

O padrão mais eficiente em produção é a hierarquia de agentes:
- **Orquestrador Principal:** Fable 5 no nível `high` ou `xhigh` (constrói a árvore de tarefas e valida o código).
- **Subagentes de Trabalho:** Sonnet 4.6 ou Fable 5 no nível `low` (executam rapidamente edições locais isoladas).

---

## 9. Como definir effort na prática: Claude Code e API

É possível gerenciar o parâmetro tanto via interface CLI do desenvolvedor quanto programaticamente através da Messages API.

### 9.1. Configuração no Claude Code CLI e modo ultracode

A utilidade Claude Code oferece recursos flexíveis de gerenciamento:
- O comando `/effort` abre um menu interativo.
- Flag de inicialização: `claude --effort xhigh`.
- Variável de ambiente: `export CLAUDE_CODE_EFFORT_LEVEL=xhigh`.

> [!NOTE]
> O modo **ultracode** no menu `/effort` é um modo interno do Claude Code que combina o nível `xhigh` com direitos estendidos do orquestrador para executar ciclos autônomos longos de ações.

### 9.2. Chamadas via Messages API e interação com fast mode

:::tabs
=== Python SDK
```python
import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-fable-5",
    max_tokens=64000,
    output_config={"effort": "xhigh"},
    messages=[
        {"role": "user", "content": "Проведи аудит архітектури мікросервісів"}
    ]
)
print(response.content[0].text)
```
=== TypeScript SDK
```typescript
import Anthropic from "@anthropic-ai/sdk";

const anthropic = new Anthropic();

const response = await anthropic.messages.create({
  model: "claude-fable-5",
  max_tokens: 64000,
  output_config: { effort: "xhigh" },
  messages: [
    { role: "user", content: "Проведи аудит архітектури мікросервісів" }
  ],
});
console.log(response.content[0]);
```
=== cURL (Messages API)
```bash
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",
    "max_tokens": 64000,
    "output_config": {"effort": "high"},
    "messages": [{"role": "user", "content": "Hello Fable!"}]
  }'
```
:::

---

## 10. Perguntas Frequentes (FAQ)

### 10.1. Disponibilidade do nível xhigh e fallbacks entre modelos

> **Pergunta:** Posso usar `xhigh` em todos os modelos Claude?  
> **Resposta:** Não. O nível `xhigh` está disponível exclusivamente para Fable 5, Mythos 5, Opus 4.8 e Opus 4.7. Se selecionar `xhigh` no Claude Code para Opus 4.6 ou Sonnet 4.6, o sistema executará automaticamente a requisição no nível `high`.

### 10.2. Precificação por token vs custo total

> **Pergunta:** O nível `effort` aumenta o custo por token?  
> **Resposta:** Não, o preço por 1.000.000 de tokens é fixo ($10 entrada / $50 saída para Fable 5). O maior custo da requisição é devido exclusivamente ao fato de o modelo gerar mais tokens ocultos de raciocínio e realizar mais chamadas de ferramentas.

### 10.3. Diferenças entre ultracode e a instrução de sistema ultrathink

> **Pergunta:** Qual a diferença entre `ultracode` e `ultrathink`?  
> **Resposta:** `ultracode` é uma configuração do ambiente Claude Code (nível `xhigh` + direitos estendidos de autonomia). Por sua vez, `ultrathink` é um gatilho de prompt textual do usuário dentro do chat, solicitando raciocinar o mais profundamente possível no turno atual.

### 10.4. Consequências de trabalhar sempre nas configurações máximas

> **Pergunta:** Vale a pena deixar o Fable 5 sempre no nível `xhigh`?  
> **Resposta:** Não. Segundo os dados dos desenvolvedores da Anthropic, o Fable 5 no nível `high` já supera os flagships anteriores no máximo. Trabalhar constantemente em `xhigh` leva a uma latência perceptível e esgotamento rápido dos limites sem ganho significativo de qualidade em tarefas comuns.