Claude API 400 “Invalid `signature` in `thinking` block” — imzayı ne bozdu ve nasıl kurtarılır

Hangi denetimin başarısız olduğunu okuyun

İfadeler size bunu söyler. “Invalid `signature` in `thinking` block” ile duran bir ileti, imzanın kendisinin doğrulanmadığı anlamına gelir: Anthropic, nedenler olarak kesilmiş, değiştirilmiş veya boş geri gönderilmiş imzaları listeler (https://platform.claude.com/docs/en/build-with-claude/thinking-troubleshooting, Eylül 2026 itibarıyla); korunan thinking sayfası da bunu her zaman 400 döndüren, kurcalanmış veya çözülemeyen bir imza olarak açıklar. ***.***.content.0 olarak maskelenmiş bir yol veya ağ geçidi tarafından eklenen bir istek kimliği bunu değiştirmez; önemli olan, konuşma hakkında bir cümlenin devam edip etmediğidir. Claude Fable 5.1 ve Claude Opus 5.5'te aynı sözcükler “The block is bound to a different conversation” ile devam edebilir — bu, son adımda ele alınan farklı bir denetimdir. “blocks in the latest assistant message cannot be modified” şeklindeki üçüncü ileti, en yeni assistant dönüşünün düzenlendiği, filtrelendiği, yeniden sıralandığı veya yeniden oluşturulduğu anlamına gelir; düzenlenmiş thinking metni bu hatayı üretir, imza hatasını değil. Aynı gövdeyi yeniden denemek bunların hiçbirini temizlemez.

Invalid `signature` in `thinking` block
  -> the signature did not verify: truncated, altered, empty, or not Claude's

Invalid `signature` in `thinking` block. The block is bound to a different conversation. ...
  -> Fable 5.1 / Opus 5.5: system, tools or an earlier message changed after the block was made

`thinking` or `redacted_thinking` blocks in the latest assistant message cannot be modified
  -> the newest assistant turn was edited, filtered, reordered or rebuilt before it was sent back

assistant dönüşlerini tam olarak döndürüldükleri şekliyle geri gönderin

Her thinking bloğu, tam akıl yürütmenin şifrelenmiş kopyası olan bir imza taşır ve API bu imzayı bloğun Claude tarafından oluşturulduğunu doğrulamak için kullanır (https://platform.claude.com/docs/en/build-with-claude/thinking#thinking-encryption). Yanıtın içerik listesini değiştirmeden ekleyin: thinking, redacted_thinking ve tool_use blokları; buna metni boş olan ve yeni modellerde varsayılan görüntüleme davranışı olan thinking blokları da dahildir. Akış sırasında imza, blok kapanmadan hemen önce tek bir signature_delta içinde gelir; bu nedenle bunu kaçıran elle yazılmış bir birleştirici boş imza saklar ve boş imzayla geri gönderilen blok başarısız olur. Anthropic'in önerisi, iletinin birleştirilmesini SDK'ya bırakmaktır. JSON anahtar sırası ve boşluklar önemli değildir — değerler önemlidir.

import anthropic

client = anthropic.Anthropic(base_url="https://api.kunavo.com", api_key="sk-kn-...")

tools = [{
    "name": "get_weather",
    "description": "Current weather for a city.",
    "input_schema": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
    },
}]
messages = [{"role": "user", "content": "What's the weather in Paris?"}]

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    tools=tools,
    messages=messages,
) as stream:
    final = stream.get_final_message()   # signature_delta already applied

# Append the content list untouched: thinking, redacted_thinking, tool_use.
messages.append({"role": "assistant", "content": final.content})

# Not this: a store that keeps the text but not the signature replays
# {"type": "thinking", "thinking": "...", "signature": ""}  -> this 400.

Diğer arka uçların thinking içeriğini Claude geçmişinden uzak tutun

Anthropic belgelerine göre kendi API'sinde Claude modelleri arasında geçiş yapmak tek başına bunu tetiklememelidir: geçiş yaptığınızda blokları göndermeye devam etmenizi, yeni modelin okuyamadıklarını hata vermeden atmasını ister ve imzaların Claude API, Amazon Bedrock ve Google Cloud arasında taşınabilir olduğunu belirtir (https://platform.claude.com/docs/en/build-with-claude/thinking, Eylül 2026 itibarıyla). Doğrulayamayacağı şey, Claude'un hiç imzalamadığı bir bloktur. Kamuya açık raporlar, başka bir arka uçtan geçen geçmişleri içerir: GLM arka ucunda çalışıp sonra Anthropic'e dönen bir Claude Code oturumu (github.com/anthropics/claude-code/issues/21726), Claude thinking blokları gibi görünen ve kendi imzalarını oluşturan bir proxy üzerinden Gemini dönüşleri (github.com/router-for-me/CLIProxyAPI/issues/1584), oturum ortasında başka bir anahtara geçip geri dönen bir Claude Code oturumu (github.com/lbjlaq/Antigravity-Manager/issues/388). Claude dışı bir modelin ürettiği dönüşlerde Anthropic'in önerisi, o modelin çıktısını yalnızca metin ve tool_use içeriği olarak geri göndermektir.

def as_foreign_turn(content: list[dict]) -> list[dict]:
    """A turn a non-Claude model produced: keep what it said and did,
    never its thinking blocks, which Claude cannot verify."""
    return [b for b in content if b["type"] in ("text", "tool_use")]

Zaten başarısız olan bir konuşmayı kurtarın

Saklanan geçmişten thinking ve redacted_thinking bloklarını bir kez kaldırın — hepsini kaldırmak en basitidir; “farklı bir konuşmaya bağlı” varyantında Anthropic'in belirttiği minimum, adı geçen blok ve ondan sonraki her bloktur — diğer tüm blokları yerlerinde tutun, bu geçmişi kaydedin ve devam edin. Anthropic bunu artık yeniden oynatılamayan kaydedilmiş bir oturum için kurtarma yöntemi olarak verir (https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#faq); bir imza doğrulanmadığında diğer tek çıkış, hâlâ elinizdeyse bloğu döndürüldüğü şekliyle yeniden oynatmaktır. Claude Code, API bir imzayı reddettiğinde önceki thinking içeriğini kendisi kaldırır. Blokları kaldırıp devam ettikten sonra onları geri koymayın: Fable 5.1'de kaldırılıp geri konan bir blok, yokluğu sırasında üretilen thinking'i geçersiz kılar. Model önceki akıl yürütmesi olmadan yanıt verir ve yeni thinking bundan sonra geçerli olur. Claude Code 2.1.152 (27 Mayıs 2026, https://code.claude.com/docs/en/changelog), model veya oturum değişikliğinden sonra eski imzaları kaldırır; ağ geçidi kılavuzu da imza reddini önceki thinking blokları olmadan yeniden denediğini söyler — ancak bu yeniden deneme upstream'in hata metniyle eşleşir ve hataları kendi sarmalayıcısıyla saran bir ağ geçidi bunu bozabilir (https://code.claude.com/docs/en/llm-gateway-protocol#automatic-retry-and-error-forwarding).

THINKING = {"thinking", "redacted_thinking"}

def block_type(b) -> str:
    return b["type"] if isinstance(b, dict) else b.type   # dicts or SDK objects

def strip_thinking(messages: list[dict]) -> list[dict]:
    """One-time recovery: drop every thinking block, keep everything else."""
    out = []
    for m in messages:
        content = m["content"]
        if m["role"] == "assistant" and isinstance(content, list):
            kept = [b for b in content if block_type(b) not in THINKING]
            content = kept or [{"type": "text", "text": "(no visible reply)"}]  # keep the turn non-empty
        out.append({**m, "content": content})
    return out

messages = strip_thinking(messages)   # save this version; never re-add the blocks

Fable 5.1'de öneki sabit tutun — veya drop_block seçeneğini etkinleştirin

“Farklı bir konuşmaya bağlı” korunan-thinking denetimidir: Claude Fable 5.1 ve Claude Opus 5.5'te yeniden oynatılan bir blok yalnızca sistem istemi, araçlar ve önceki her ileti değişmeden kaldığında geçerlidir. Anthropic bunu 31 Ağustos 2026 veya sonrasında oluşturulan hesaplarda varsayılan olarak uygular (https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#enforcement); bir ağ geçidinin arkasında bu hesap size ait değildir, bu nedenle açık olduğunu varsayın. Oturum boyunca sistemi ve araçları sabit tutun ve düzenlemek yerine ekleme yapın. Düzenlemeyi bulana kadar isteklerin başarılı olmasını sağlamak için prefix_mismatch_behavior değeri drop_block olacak şekilde thinking-binding-controls-2026-08-01 beta üstbilgisini gönderin; bu üstbilgi olmadan alanın kendisi “block_binding: Extra inputs are not permitted” ile reddedilir (https://platform.claude.com/docs/en/api/errors).

# Anthropic's API directly. The field needs the beta header; Kunavo forwards it (see below).
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: thinking-binding-controls-2026-08-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5-1",
    "max_tokens": 16000,
    "thinking": {
      "type": "adaptive",
      "block_binding": {"prefix_mismatch_behavior": "drop_block"}
    },
    "messages": [{"role": "user", "content": "..."}]
  }'

“Invalid `signature` in `thinking` block” ne anlama gelir?

API, geri gönderdiğiniz bir thinking bloğunu doğrulayamadı. Her thinking bloğu, Claude'un akıl yürütmesinin şifrelenmiş kopyası olan bir imza taşır; bu imza kesildiğinde, değiştirildiğinde veya boş geri gönderildiğinde ya da blok hiçbir zaman Claude tarafından imzalanmadığında denetim başarısız olur. Bu geçici bir hata değil, 400 hatasıdır: aynı istek her seferinde başarısız olur.

Thinking bloğu imzalarının süresi dolar mı?

Anthropic'in belgelerinde bir süre sonundan bahsedilmiyor. anthropic-sdk-python takipçisinde (issue #1598, Ağustos 2026), GitHub'ın katkıda bulunan olarak işaretlediği bir hesaptan gelen yanıta göre imzaların süresi dolmuyor ve denetim, API'ye ulaşan blok döndürülen bloktan farklı olduğunda başarısız oluyor — bu bir belge değil, issue yorumudur. Daha önce çalışan kaydedilmiş bir oturum şimdi başarısız oluyorsa, saklanan blokları veya izledikleri rotayı değiştirmiş olabilecek şeylere bakın: depolama katmanınız, bir proxy veya arka uç değişikliği.

Thinking bloklarını silip devam edebilir miyim?

Evet. Anthropic bunu yeniden oynatılamayan kaydedilmiş bir oturum için kurtarma yöntemi olarak verir ve Claude Code, imza reddedildiğinde önceki thinking içeriğini kendisi kaldırır. Thinking ve redacted_thinking bloklarını kaldırın — hepsini kaldırmak en basitidir — diğer blokları koruyun ve bir kez yeniden deneyin. Model önceki akıl yürütmesini kaybeder, konuşmayı değil; araç kullanımı dışında Anthropic belgeleri önceki dönüşlerin thinking içeriğinin dışarıda bırakılmasına zaten izin verir.

Modelleri veya sağlayıcıları değiştirdikten sonra neden olur?

Anthropic belgeleri, kendi API'sindeki Claude modelleri arasında geçişte yeni modelin okuyamadığı blokların hata vermeden atıldığını ve imzaların Claude API, Amazon Bedrock ve Google Cloud arasında çalıştığını söyler. Claude Code yine de model veya oturum değişikliğinden sonra eski imzalara takılan oturumları düzeltmek zorunda kaldı (2.1.152); kamuya açık raporlar da Claude'un doğrulayamayacağı bir şeyden geçen geçmişleri içeriyor — aynı temel URL'nin arkasındaki Claude dışı bir model, kendi imzalarını yazan bir proxy veya imzaları kaybeden bir istemci. Değişiklikten sonra thinking bloklarını bir kez kaldırın.

Claude Code bunu otomatik olarak düzeltir mi?

Güncel sürümler deniyor. 2.1.152'den beri model veya oturum değişikliğinden sonra eski imzaları kaldırıyor ve imza reddini önceki thinking blokları olmadan yeniden deniyor. Bu yeniden deneme upstream'in hata metniyle eşleşir; Anthropic'in ağ geçidi kılavuzuna göre hataları kendi zarfıyla saran bir ağ geçidi bunu bozabilir. Önce claude update çalıştırın; bir oturum her dönüşte hâlâ başarısız oluyorsa yeni bir oturum başlatın.