Claude Code “context_management: Extra inputs are not permitted” — o cabeçalho beta que não chegou

Confirme se o cabeçalho é o que está faltando

O Claude Code associa cada campo de corpo de pré-lançamento ao valor anthropic-beta que o ativa, e os dois precisam viajar juntos: um gateway que remove o cabeçalho enquanto permite a passagem do corpo produz erros 400 definitivos, e somente quando ambos estão ausentes o recurso é desativado silenciosamente (https://code.claude.com/docs/en/llm-gateway-protocol#feature-pass-through, em setembro de 2026). Envie uma solicitação à sua URL base com o campo e seu cabeçalho, no formato usado pela página de edição de contexto da Anthropic, sem a ferramenta de pesquisa na Web (https://platform.claude.com/docs/en/build-with-claude/context-editing). O mesmo 400 com o cabeçalho presente significa que o cabeçalho não está chegando a um backend que o aceite.

curl -s "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: context-management-2025-06-27" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 64,
       "messages": [{"role": "user", "content": "ping"}],
       "context_management": {"edits": [{"type": "clear_tool_uses_20250919"}]}}'

Impedir que o Claude Code o envie: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Esta é a correção documentada no lado do cliente: a própria referência de erros do Claude Code a fornece para esta mensagem como alternativa quando não é possível fazer o gateway encaminhar o cabeçalho (https://code.claude.com/docs/en/errors#extra-inputs-are-not-permitted). Ela remove os cabeçalhos anthropic-beta específicos da Anthropic e campos de esquema de ferramentas beta, como defer_loading e eager_input_streaming (https://code.claude.com/docs/en/env-vars), e o guia do gateway acrescenta que também interrompe os campos de corpo de pré-lançamento, incluindo o gerenciamento de contexto (https://code.claude.com/docs/en/llm-gateway-protocol#disable-pre-release-capabilities). É necessária a versão 2.1.27 ou posterior do Claude Code: essa versão, de 30 de janeiro de 2026, é aquela cujo changelog informa que o sinalizador agora evita o erro de gerenciamento de contexto para usuários de gateways (https://code.claude.com/docs/en/changelog). O custo é deixar de usar recursos de pré-lançamento e a pesquisa de ferramentas MCP, portanto as ferramentas MCP são carregadas antecipadamente (a partir da versão 2.1.227, as configurações gerenciadas podem manter a pesquisa de ferramentas ativada); o raciocínio adaptativo é escolhido pelo modelo, não por um beta, e continua ativado. Coloque-o no bloco env de ~/.claude/settings.json para aplicá-lo a todas as sessões (https://code.claude.com/docs/en/settings-reference#env).

claude --version          # 2.1.27 or later
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

# Every session, in ~/.claude/settings.json:
#   { "env": { "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" } }

Se você executa o gateway: encaminhe anthropic-beta ou faça a ponte entre os formatos

O guia de gateways do Claude Code lista anthropic-version e anthropic-beta como cabeçalhos a serem encaminhados sem alterações em uma rota no formato Anthropic e solicita que os gateways transmitam cabeçalhos e campos de corpo anthropic-* como listas abertas, em vez de permitir apenas os vistos atualmente, porque cada versão adiciona novos elementos. Ele cita uma fonte comum desse 400: um gateway que aceita solicitações no formato Anthropic e as encaminha para o Amazon Bedrock. Se essa for sua configuração, disponibilize o formato próprio do provedor e aponte o Claude Code para ele usando as variáveis do provedor abaixo; nessa rota, o Claude Code limita os cabeçalhos beta e campos que envia àqueles aceitos pelo provedor (https://code.claude.com/docs/en/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway).

# Only if your gateway exposes the Amazon Bedrock format:
export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

O que significa “context_management: Extra inputs are not permitted”?

A API, ou o backend por trás do seu gateway, recebeu um campo context_management que não aceita. Na API da Anthropic, esse campo precisa do cabeçalho beta de edição de contexto (context-management-2025-06-27), e a referência de erros do Claude Code atribui essa mensagem a um proxy ou gateway que removeu o cabeçalho anthropic-beta. O Claude Code envia o campo e o cabeçalho como um par, portanto algo no caminho removeu o cabeçalho ou encaminhou a solicitação para um backend com um esquema diferente.

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS desativa o pensamento ou o cache de prompts?

Não. O raciocínio adaptativo é selecionado pelo modelo, não por um beta, e o cache padrão de prompts (cache_control) não tem um pareamento beta. O que o sinalizador remove são recursos de pré-lançamento — cabeçalhos beta, campos de ferramentas beta e gerenciamento de contexto — além da pesquisa de ferramentas MCP, portanto as ferramentas MCP são carregadas antecipadamente. Em modelos mais antigos que usam pensamento estendido manual, o pensamento intercalado entre chamadas de ferramentas precisa de um cabeçalho beta, portanto também é desativado.

Existe um sinalizador que desative apenas context_management?

Não há um sinalizador documentado, em setembro de 2026. O sinalizador abrange todos os recursos de pré-lançamento de uma vez — a única exceção, a partir do Claude Code 2.1.227, é manter a pesquisa de ferramentas MCP ativada por meio das configurações gerenciadas —, e uma solicitação de um sinalizador exclusivo para context_management (anthropics/claude-code#64510) foi encerrada por inatividade. Não dependa de variáveis que não estejam na referência de variáveis de ambiente do Claude Code.

Devo fazer downgrade do Claude Code?

Em janeiro de 2026, comentaristas em anthropics/claude-code#21612 relataram a versão 2.1.20 como a última que funcionava, mas a correção lançada foi a 2.1.27, cujo registro de alterações faz o sinalizador abranger este erro. Uma versão tão antiga também não inclui a 2.1.77, que fez o sinalizador remover campos de ferramentas beta. Defina o sinalizador e mantenha-se atualizado.

O erro menciona tools.0.custom.eager_input_streaming

É o mesmo tipo de incompatibilidade, mas com outro campo: um campo de esquema de ferramenta chegou a um backend que o rejeita. Atrás de uma URL base personalizada, o Claude Code envia esse campo — streaming de ferramentas com granularidade fina — somente se você definir CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1. O sinalizador remove campos de ferramentas beta a partir da versão 2.1.77, e a versão 2.1.80 corrigiu erros 400 de streaming de ferramentas com granularidade fina por meio de proxies, Bedrock e Vertex.