Function call is missing a thought_signature Claude Code

Quick fix

使用社区补丁 cc-switch-gemini-fixer 或在历史消息中注入 skip_thought_signature_validator 以绕过 Gemini 工具调用的签名验证。

Symptom

报错原文复制

API Error: 400 Function call is missing a thought_signature in functionCall parts. This is required for tools to work correctly, and missing thought_signature may lead to degraded model performance. Additional data, function call `default_api:Bash` , position 64. Please refer to https://ai.google.dev/gemini-api/docs/thought-signatures for more details.

Cause

Google Gemini 3.x 及带 Thinking 功能的模型在工具调用时采用无状态推理链，产生 functionCall 时会包含加密凭证 thought_signature，并要求后续回传 functionResponse 时必须原样携带。CC Switch 在将 Anthropic 协议转译为 Gemini 格式时，在消息上下文透传中丢弃了该字段，导致 Google API 拒绝请求并返回 400 错误。另外，部分用户遇到的 User location is not supported 属于 API 地区限制，是与此不同的另一个 400 错误变种。

Fix

1. 1

   下载并运行社区提供的临时修复补丁 cc-switch-gemini-fixer，该程序会自动处理 Gemini 响应的签名透传。

2. 2

   或者在代理转换层构造包含 functionCall 的历史消息时，默认注入 "thought_signature": "skip_thought_signature_validator" 以绕过官方验证。

Affected Versions

ToolClaude Code / Codex

Version3.16.1 - 3.19.2

PlatformsWindowsmacOS

Source Issues

本页汇总自 3 个真实 issue

• #3882CodeX + Gemini API have HTTP 400 status":"INVALID_ARGUMENT" wrong
• #5725[Bug] Gemini 3.x / 思考型模型在 Claude Code 工具调用（Bash/Tool Call）时触发 400 missing thought_signature
• #6497tomboy

FAQ

Mac 系统可以使用这个补丁吗？

可以，社区开发者已提供适用于 macOS 的 cc-switch-gemini-fixer 补丁版本。

报错提示 User location is not supported 也是签名问题吗？

不是。这是 Google Gemini API 对当前网络所在地区的限制，与 thought_signature 缺失无关，需要更换支持地区的代理节点。

相关问题

CC Switch 目前的架构是黑盒的，用户无法自定义处理逻辑这是为 CC Switch 增加可编程路由转换脚本的功能请求，原帖尚未提供可验证的正式解法。1 issues mergedGtk-CRITICAL: gtk_widget_get_scale_factor 失败在 Linux 或 WSL2 中运行 cc-switch 遇到 GTK 断言失败时，请修改 settings.json 关闭静默启动，或清理残留配置重装。3 issues merged[DISCUSS] 支持 pi coding agent这是功能请求，维护者已将其合并至统一追踪 issue #1855，原帖未提供可验证的解法。1 issues merged