Nota do autor: o claude-haiku-5-5 pensa por padrão — quer desativar e recebe erro? Na maioria das vezes, é porque o effort está acima de high. Este artigo explica as regras, a correção em três passos e os limites dos parâmetros.
Fazer o claude-haiku-5-5 pensar menos e reservar o orçamento de saída para o corpo da resposta é um pedido muito comum em processamento em lote e tarefas estruturadas. Talvez você já tenha definido thinking como disabled e, mesmo assim, a API devolveu um erro: justamente quando você queria desligar o pensamento, por que foi barrado? Este artigo apresenta a regra de combinação entre effort e disabled, para você dominar rapidamente o jeito certo de desativar o pensamento no claude-haiku-5-5.
Não é questão de misticismo, nem de o modelo estar “pirando”. A documentação é bem clara: no claude-haiku-5-5, não passar thinking significa pensamento adaptativo, ativado por padrão; para desligar o pensamento usa-se type: disabled em thinking, mas essa sintaxe só é aceita quando effort não é superior a high. Os parâmetros deste artigo seguem a documentação oficial da Anthropic de 2026-11-08 (UTC+8), com verificação em 2026-11-13.
Valor central: ao terminar a leitura, você vai entender a causa real do erro, o método de correção em três passos e a relação entre max_tokens e os tokens de pensamento. Depois disso, em qualquer ambiente de invocação, essa regra não vai mais te atrapalhar.
Pontos-chave do claude-haiku-5-5
Vamos direto ao ponto: quem está com pressa só precisa ler esta seção.
| Ponto | O que diz a documentação | Impacto para você |
|---|---|---|
| Pensamento ativado por padrão | Se você não passar thinking, o pensamento adaptativo entra em ação — ou seja, está ligado por padrão |
Para economizar cota, é preciso desligar explicitamente |
| Chave de desligamento | thinking definido como type: disabled |
É a única forma de desligar |
Limite de effort |
disabled só é aceito quando effort não passa de high |
Combinar com xhigh ou max gera erro |
Valor padrão de effort |
Padrão medium, igual ao claude-opus-5-5 |
Se você não subir o valor por conta própria, não cai na armadilha |
| Limite de cota | Saída máxima de 128000, com os tokens de pensamento contados dentro de max_tokens |
O pensamento ocupa espaço que seria do texto final |
Detalhes importantes do claude-haiku-5-5
Primeiro: ele pensa por padrão. O claude-haiku-5-5 é um modelo que roda com capacidade de pensamento ativada por padrão: quando o campo thinking não aparece na requisição, ele opera em modo de pensamento adaptativo. A documentação não detalha como o modo adaptativo toma suas decisões, mas o que está claro é que, no estado padrão, o pensamento está ligado.
Se o seu cenário é de perguntas curtas, rotulagem em lote, conversão de formato — tarefas que não exigem raciocínio profundo —, os tokens de pensamento são puro custo. A documentação também registra que os tokens de pensamento entram na conta de max_tokens e que a saída máxima é de 128000: quanto mais pensamento, menos cota sobra para o texto final. É justamente daí que vem a vontade de “desligar o pensamento e deixar a cota para o conteúdo”.
Segundo: desligar tem limite. A única chave para desativar o pensamento é definir thinking como type: disabled. Mas a documentação também deixa claro que essa sintaxe só é aceita quando effort não passa de high: com effort em medium ou high, tudo funciona normalmente; já com xhigh ou max, a requisição dá erro. A orientação oficial de correção é igualmente direta — baixe o effort para high ou menos. Se você chama o claude-haiku-5-5 via APIYI apiyi.com, ao investigar esse tipo de erro comece também por essa combinação de parâmetros.
Terceiro: o valor padrão, no fim das contas, é o seguro. O effort padrão do claude-haiku-5-5 é medium, o mesmo do claude-opus-5-5, enquanto a maioria dos outros modelos usa high por padrão. O caminho que costuma dar problema é: migrar código de outro modelo, subir o effort para xhigh ou max por hábito, na tentativa de ganhar qualidade, e ao mesmo tempo acrescentar disabled para controlar custo — as duas intenções brigam entre si e o erro aparece.
Por outro lado, basta não subir o effort ativamente: o medium padrão já satisfaz naturalmente a condição “não passa de high”, e o disabled funciona normalmente. Quando precisar alternar e comparar modelos diferentes, usar uma única chave API na APIYI apiyi.com para chamar vários modelos também evita ficar mexendo na configuração de integração toda hora.
O diagrama acima é o caminho padrão de diagnóstico, e o caso mais comum trava naquele losango do meio: effort fora do limite. Depois de corrigir, vale rodar uma vez na APIYI apiyi.com com cota pequena para validar, confirmar que a resposta volta normal, e só então colocar no tráfego de produção.
claude-haiku-5-5 início rápido: correção em três passos
Não precisa vasculhar documentação longa: seguindo os três passos abaixo, esse tipo de erro basicamente desaparece:
- Confirme o ID do modelo: o
modelna requisição deve serclaude-haiku-5-5; comece eliminando a interferência de um nome de modelo escrito errado. - Reduza o effort: defina como
highou menos.mediumé o valor padrão, dá para simplesmente não enviar; o importante é não enviarxhighnemmax. - Depois desative o pensamento: defina
thinkingcomo{"type": "disabled"}. Nesse momento, comeffortnão superior ahigh, a requisição será aceita normalmente.
Consulta rápida dos parâmetros de requisição do claude-haiku-5-5
| Parâmetro | Valor recomendado | Descrição |
|---|---|---|
model |
claude-haiku-5-5 |
O modelo discutido neste artigo; atenção para não escrever outra versão |
thinking |
{"type": "disabled"} |
O único interruptor para desativar o pensamento |
effort |
medium (padrão) ou high |
Deve ser no máximo high, caso contrário entra em conflito com disabled |
Valores proibidos de effort |
xhigh, max |
Combinados com disabled, geram erro |
max_tokens |
limite de 128000 | Os tokens de pensamento contam nesse valor; desativando o pensamento, tudo fica para o corpo da resposta |
As informações do lado de acesso também não são complicadas; tomando o APIYI como exemplo:
- Endereço de acesso:
https://api.apiyi.com/v1 - Autenticação: basta uma API Key
- Estilo de interface: interface compatível com OpenAI
- Cobrança: pagamento por uso, preços vantajosos, novos usuários têm cota gratuita de teste
- Cobertura: modelos主流 como OpenAI, Claude, Gemini etc.
🚀 Início rápido: recomendo concluir esta verificação no APIYI apiyi.com. Depois de se registrar, execute a requisição já corrigida com a cota gratuita de teste, confirme que
disabledfunciona normalmente e que o erro desapareceu, e só então conecte ao negócio real — o ciclo se fecha em poucos minutos.
Compatibilidade de effort do claude-haiku-5-5
A tabela abaixo é a mais importante de todo o texto — vale guardar direto nas notas do time:
| valor de effort | combinação com disabled | resultado |
|---|---|---|
medium (padrão) |
compatível | desativa o raciocínio normalmente |
high |
compatível | desativa o raciocínio normalmente |
xhigh |
conflito | a requisição retorna erro |
max |
conflito | a requisição retorna erro |
Olhando para essa tabela e depois para a sua própria requisição, a direção fica clara: se o erro aparecer em uma requisição que também envia disabled, a primeira coisa a verificar é se o effort passou da linha do high. A documentação registra uma única solução — baixar o effort para high ou menos, sem nenhuma outra forma de contornar.
Comparação do effort padrão entre claude-haiku-5-5 e outros modelos
| modelo | effort padrão | relação com desativar o raciocínio |
|---|---|---|
| claude-haiku-5-5 | medium |
por padrão já atende “não acima de high”, então disabled funciona direto |
| claude-opus-5-5 | medium |
o valor padrão é igual ao do haiku; as regras do seu interruptor de raciocínio não são detalhadas neste artigo |
| a maioria dos demais modelos | high |
o valor padrão também fica dentro do limite; só subir manualmente faz ultrapassar |
Essa tabela explica “por que justamente a minha requisição deu erro”: o effort padrão varia entre os modelos, e ao migrar código mantendo o hábito antigo de parâmetros é muito fácil definir o effort explicitamente como xhigh ou max. Conferir os valores padrão antes de migrar é a ação preventiva de menor custo.
Solução de erros e lista de autoverificação do claude-haiku-5-5
| Sintoma | Causa mais provável | Como resolver |
|---|---|---|
Passou disabled e ainda dá erro |
effort está em xhigh ou max |
Reduza o effort para high ou menos |
Não sabe qual é o effort |
Se não for passado, o padrão é medium |
O valor padrão já atende ao requisito, não precisa fazer mais nada |
| O texto fica mais curto ou é cortado | Os tokens de raciocínio entram na conta de max_tokens |
Desative o raciocínio ou aumente o max_tokens dentro do limite de 128000 |
| Quer uma qualidade de raciocínio mais profunda | Com o raciocínio desativado, não há processo de raciocínio | Remova o disabled e volte ao raciocínio adaptativo padrão |
Depois de corrigir, passe por esta lista de autoverificação antes de enviar a requisição:
modelestá escrito corretamente comoclaude-haiku-5-5effortestá omitido, ou explicitamente emmediumouhighthinkingestá como{"type": "disabled"}max_tokensnão passa de 128000
Com os quatro requisitos atendidos, esse tipo de erro não vai mais aparecer. Fixar a combinação final de parâmetros como um template de requisição também evita alterações erradas mais tarde.
Perguntas frequentes (FAQ) sobre o claude-haiku-5-5
P1: O claude-haiku-5-5 pensa por padrão?
Sim. A documentação registra que, quando `thinking` não é informado, o claude-haiku-5-5 opera com raciocínio adaptativo, ativado por padrão. Para deixar todo o orçamento de saída para o texto principal, é preciso passar `disabled` explicitamente para desativar.
P2: Por que ainda recebo erro mesmo passando disabled?
A causa mais comum é `effort` acima de `high`. A documentação especifica que `disabled` só é aceito quando `effort` não é superior a `high`; usar `xhigh` ou `max` causa erro, e a correção é reduzir `effort` para `high` ou menos.
P3: O que acontece se eu não passar effort?
O padrão é `medium`. O claude-haiku-5-5 e o claude-opus-5-5 têm o mesmo valor padrão, `medium`, enquanto a maioria dos outros modelos usa `high` por padrão. Esse valor já satisfaz a condição “não superior a high”, então pode ser combinado com `disabled` diretamente.
P4: O que muda no comprimento da saída depois de desativar o raciocínio?
A documentação registra que os tokens de raciocínio entram em `max_tokens`, e a saída máxima é 128000. Ao desativar o raciocínio, o mesmo orçamento de `max_tokens` pode ser usado inteiramente para o texto principal, e o risco de truncamento também diminui.
P5: E se eu quiser temporariamente um raciocínio mais profundo?
Basta remover `disabled` e deixar o claude-haiku-5-5 voltar ao raciocínio adaptativo padrão. Se também quiser aumentar `effort`, só tome cuidado para não cair na combinação de `xhigh` ou `max` com `disabled`.
P6: Como verificar rapidamente se a correção funcionou?
Depois de se cadastrar no APIYI (apiyi.com) e obter uma cota gratuita de teste, use o endereço de acesso `https://api.apiyi.com/v1` e execute uma vez com os parâmetros corrigidos: se a requisição não retornar mais erro e o texto principal vier normalmente, significa que `disabled` entrou em vigor. A plataforma cobra por uso, então o custo de validar com uma cota pequena é bem baixo.
P7: O erro vem sempre do effort?
Não necessariamente, mas esse é um tipo de erro explicitamente registrado na documentação. Primeiro confira se `model` foi escrito corretamente como `claude-haiku-5-5`, depois veja se a combinação de `thinking` e `effort` está fora dos limites; se tudo estiver excluído, examine outras causas. Ao chamar via APIYI e encontrar erro, também comece verificando esse par de parâmetros.
P8: Qual versão serve de referência para essas regras dos parâmetros?
Este artigo se baseia na documentação oficial da Anthropic de 2026-11-08 (UTC+8), com data de conferência em 2026-11-13. Se a documentação oficial ajustar posteriormente as regras de `effort` e `disabled`, prevalece a versão mais recente.
Resumo
Desativar o pensamento no claude-haiku-5-5 se resume a quatro pontos:
- Pensa por padrão: se você não passar
thinking, o modelo usa pensamento adaptativo, que vem ativado por padrão. Para economizar cota, é preciso desativar explicitamente. - Desativar tem condição: quando
thinkingé definido comodisabled,effortnão pode ser superior ahigh; usarxhighoumaxgera erro. - O padrão já é seguro: o
effortpadrão émedium, igual ao claude-opus-5-5. Se você não aumentar manualmente, não há conflito. - Limite de cota: a saída máxima é 128000, e os tokens de pensamento entram em
max_tokens. Ao desativar o pensamento, toda a cota fica disponível para o texto principal.
Da próxima vez que você esbarrar no “quero desligar o pensamento mas dá erro”, primeiro verifique se o effort passou da linha do high. Com a combinação de parâmetros ajustada, o problema praticamente se resolve. Recomendo usar a APIYI apiyi.com com cota de teste gratuita para validar o resultado rapidamente: uma única chave API permite chamar vários modelos populares, incluindo o claude-haiku-5-5, e a interface compatível com OpenAI também facilita bastante a troca de modelo.
📚 Referências
- Documentação APIYI: descrição dos parâmetros effort e thinking do Claude
- Link:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Descrição: valores de effort, condições de aceitação do disabled e padrão de erro
-
Documentação APIYI: atualização do guia de pensamento do Claude (2026-11)
- Link:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Descrição: registro de atualizações e contexto do guia relacionado a pensamento
-
Documentação oficial da Anthropic
- Link:
docs.anthropic.com - Descrição: os parâmetros deste artigo seguem a versão oficial de 2026-11-08 (UTC+8)
Autor: equipe técnica da APIYI
Contato técnico: fale conosco pela página inicial do site da APIYI; mais materiais estão disponíveis no centro de documentação
