context_management: Extra inputs are not permitted

Claude Code, context_management alanını onu etkinleştiren anthropic-beta başlığıyla birlikte gönderir ve bu 400 hatası, alanın onu kabul etmeyecek bir arka uca ulaştığı anlamına gelir: bir ağ geçidi veya proxy başlığı düşürmüş ya da isteği Amazon Bedrock gibi farklı bir şemaya sahip bir arka uca iletmiş olabilir. Claude Code bunu yeniden denemez. Alanın gönderilmesini durdurmak için (Claude Code 2.1.27 veya sonrası) CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 ayarlayın ya da ağ geçidinin anthropic-beta başlığını iletmesini sağlayın.

Hata

yanıt (HTTP 400)

// Through Kunavo, if a channel rejects the field: the upstream message, typed as
// Anthropic types a 400; no request_id field, the upstream's own id is appended:
{"type":"error","error":{"type":"invalid_request_error","message":"context_management: Extra inputs are not permitted (request id: …)"}}

// From Anthropic's API directly, as Claude Code prints it:
//   API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"context_management: Extra inputs are not permitted"},"request_id":"req_011C..."}

// request_id varies per request; a gateway may drop it, or append its own id to the message.
// Same mismatch, other fields: tools.0.custom.eager_input_streaming, tools.N.custom.defer_loading

Nedenler ve çözümler özeti

Neden	Çözüm
Bir ağ geçidi gövdeyi iletiyor ancak anthropic-beta'yı düşürüyor	Başlığı değiştirmeden iletin veya istemcide CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 ayarlayın.
Amazon Bedrock ya da Google Cloud'un önündeki Anthropic biçimli ağ geçidi	Claude Code'u ilgili sağlayıcının kendi biçimine yönlendirin (CLAUDE_CODE_USE_BEDROCK veya CLAUDE_CODE_USE_VERTEX) ya da bayrağı ayarlayın.
2.1.27'den eski Claude Code	Güncelleyin. 2.1.27'den önce bayrak, bağlam yönetimini kapsamıyordu.
Hata bunun yerine eager_input_streaming veya defer_loading adını veriyor	Aynı uyumsuzluk, beta araç alanı. Bayrak, 2.1.77 ve sonrasında bunları kaldırır.

Eksik olanın başlık olduğunu doğrulayın

Claude Code, her ön sürüm gövde alanını onu etkinleştiren anthropic-beta değeriyle eşleştirir ve ikisinin birlikte taşınması gerekir: gövdeyi geçirirken başlığı çıkaran bir ağ geçidi kesin 400 hataları üretir; özellik yalnızca ikisi de eksik olduğunda sessizce kapanır (https://code.claude.com/docs/en/llm-gateway-protocol#feature-pass-through, Eylül 2026 itibarıyla). Temel URL'nize, alanı ve başlığını içeren tek bir istek gönderin; Anthropic'in bağlam düzenleme sayfasındaki biçimi kullanın ancak web arama aracını çıkarın (https://platform.claude.com/docs/en/build-with-claude/context-editing). Başlık mevcutken aynı 400 hatasını almanız, başlığın bunu kabul eden bir arka uca ulaşmadığı anlamına gelir.

check_header.sh

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"}]}}'

Claude Code'un bunu göndermesini durdurun: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Bu, belgelenmiş istemci tarafı çözümdür: Claude Code'un kendi hata referansı, ağ geçidi başlığı iletmeye zorlanamıyorsa bu ileti için geri dönüş olarak bunu verir (https://code.claude.com/docs/en/errors#extra-inputs-are-not-permitted). Anthropic'e özgü anthropic-beta başlıklarını ve defer_loading ile eager_input_streaming gibi beta araç şeması alanlarını kaldırır (https://code.claude.com/docs/en/env-vars); ağ geçidi kılavuzu bunun context management dahil ön sürüm gövde alanlarını da durdurduğunu ekler (https://code.claude.com/docs/en/llm-gateway-protocol#disable-pre-release-capabilities). Claude Code 2.1.27 veya sonrası gerekir: 30 Ocak 2026 tarihli bu sürümün değişiklik günlüğü, bayrağın ağ geçidi kullanıcıları için bağlam yönetimi hatasını artık önlediğini belirtir (https://code.claude.com/docs/en/changelog). Bedeli, ön sürüm özellikleri ve MCP araç aramasıdır; bu nedenle MCP araçları başlangıçta yüklenir (2.1.227'den itibaren yönetilen ayarlar araç aramasını açık tutabilir); uyarlamalı akıl yürütme beta tarafından değil model tarafından seçilir ve açık kalır. Her oturuma uygulamak için bunu ~/.claude/settings.json dosyasının env bloğuna ekleyin (https://code.claude.com/docs/en/settings-reference#env).

disable_betas.sh

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" } }

Ağ geçidini siz çalıştırıyorsanız: anthropic-beta'yı iletin veya biçimler arasında köprü kurun

Claude Code'un ağ geçidi kılavuzu, anthropic-version ve anthropic-beta başlıklarının Anthropic biçimli bir rotada değiştirilmeden iletilmesini ister. Ayrıca ağ geçitlerinin anthropic-* başlıklarını ve gövde alanlarını, bugün görülenleri izin listesine almak yerine açık listeler olarak geçirmesini ister; çünkü her sürüm yenilerini ekler. Bu 400 hatasının yaygın bir kaynağı olarak Anthropic biçimli istekleri kabul edip Amazon Bedrock'a ileten bir ağ geçidini belirtir. Kurulumunuz buysa sağlayıcının kendi biçimini açın ve aşağıdaki sağlayıcı değişkenleriyle Claude Code'u buna yönlendirin; bu rotada Claude Code beta başlıklarını ve alanlarını sağlayıcının kabul ettiği değerlerle sınırlar (https://code.claude.com/docs/en/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway).

bedrock_format.sh

# 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

Kunavo üzerinden çağrı yapıyorsanız

Kunavo, bu sayfanın sözünü ettiği ağ geçitlerinden biriydi. 24 Eylül 2026'ya kadar /v1/messages, context_management dahil JSON gövdenizi gönderildiği gibi üst akışa iletir ancak anthropic-beta'yı düşürürdü — Claude Code'un hata referansında adı geçen, gövdenin iletilip başlığın düşürüldüğü birleşim — ve Kunavo üzerinden Claude Code istekleri Eylül 2026'nın başlarına kadar bu iletiyle başarısız oldu; bunların tümü 11 Eylül'de kullanımdan kaldırılan bir üst akış kanalındaydı. Kunavo artık istek maliyetini değiştirmeyen anthropic-beta değerlerini, bunların arasında context-management-2025-06-27'yi iletir ve fast mode, compaction, server-side fallbacks ile 1M-context beta gibi diğerlerini düşürür; fast mode, server-side fallbacks, compaction veya advisor tool kullanan bir istek, alanın adını veren 400 hatası alır. Claude'a bugün hizmet veren kanal, 24 Eylül 2026 tarihli bir testte context_management alanını başlıkla ve başlıksız kabul etti; bu nedenle Kunavo ile CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS kullanmanız gerekmemelidir. Bu kanal, gelen başlıklardan bağımsız olarak hangi ön sürüm alanlarını kabul edeceğine karar verir: aynı testte output_config.task_budget ve bir system mesajının clear_at alanını, başlıkları olsun veya olmasın ek girdiler olarak reddetti. Bir ret size ulaşırsa HTTP 400, türü invalid_request_error olarak gelir; üst akışın ileti metnini ve sonuna eklenmiş üst akışın kendi istek kimliğini taşır. Ne Kunavo ne de Claude Code bunu yeniden dener ve ücretlendirilmez. Kunavo için Claude Code kurulumunun geri kalanı şurada Claude Code entegrasyon kılavuzu.

Sık sorulan sorular

“context_management: Extra inputs are not permitted” ne anlama gelir?

API veya ağ geçidinizin arkasındaki arka uç, kabul etmediği bir context_management alanı aldı. Anthropic API'sinde bu alan, bağlam düzenleme beta başlığını (context-management-2025-06-27) gerektirir ve Claude Code'un hata referansı bu iletiyi anthropic-beta başlığını çıkaran bir proxy veya ağ geçidine bağlar. Claude Code alanı ve başlığı çift olarak gönderir; dolayısıyla aradaki bir şey başlığı düşürmüş veya isteği farklı şemaya sahip bir arka uca iletmiş olabilir.

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS düşünmeyi veya istem önbelleğe almayı kapatır mı?

Hayır. Uyarlamalı akıl yürütme beta tarafından değil model tarafından seçilir ve standart istem önbelleğe alma (cache_control) bir beta eşleşmesine sahip değildir. Bayrağın kaldırdığı şey ön sürüm özellikleri — beta başlıkları, beta araç alanları, context management — ve MCP araç aramasıdır; bu nedenle MCP araçları başlangıçta yüklenir. Manuel genişletilmiş düşünme kullanan eski modellerde araç çağrıları arasındaki aralıklı düşünme bir beta başlığı gerektirir; bu da kaldırılır.

Yalnızca context_management'i kapatan bir ayar var mı?

Eylül 2026 itibarıyla belgelenmiş bir ayar yok. Bayrak tüm ön sürüm özelliklerini birlikte kapsar — Claude Code 2.1.227'den itibaren tek istisna, yönetilen ayarlar aracılığıyla MCP araç aramasını açık tutabilmektir — ve yalnızca context_management'i kapatma isteği (anthropics/claude-code#64510) etkin olmadığı gerekçesiyle kapatılmıştır. Claude Code'un ortam değişkenleri referansında bulunmayan değişkenlere dayanarak sistem kurmayın.

Bunun yerine Claude Code'u eski bir sürüme mi düşürmeliyim?

Ocak 2026'da anthropics/claude-code#21612 yorumcuları 2.1.20'nin çalışan son sürüm olduğunu bildirdi; ancak yayımlanan düzeltme, değişiklik günlüğü girdesinde bu hatayı bayrağın kapsadığı belirtilen 2.1.27 idi. Bu kadar eski bir sürüme sabitlemek, bayrağın beta araç alanlarını kaldırmasını sağlayan 2.1.77'yi de kaçırır. Bayrağı ayarlayın ve güncel kalın.

Hata bunun yerine tools.0.custom.eager_input_streaming adını veriyor

Aynı türden uyumsuzluk, farklı bir alan: bir araç şeması alanı onu reddeden bir arka uca ulaştı. Özel bir temel URL'nin arkasında Claude Code, bu alanı — ince taneli araç akışını — yalnızca CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1 ayarlanmışsa gönderir. Bayrak, 2.1.77'den itibaren beta araç alanlarını kaldırır; 2.1.80 ise proxy'ler, Bedrock ve Vertex üzerinden ince taneli araç akışında oluşan 400 hatalarını düzeltti.

İlgili kılavuzlar

Hata anlamlarına ilişkin daha fazla bilgi hata referansı bölümünde; anahtar almak kayıt ve kimlik doğrulama kılavuzu üzerinden bir dakika sürer.