Unknown name "prompt_cache_key" cc-switch

Quick fix

升级 cc-switch 至 v3.16.2+ 修复 prompt_cache_key 注入问题，或改用 OpenRouter 原生 Claude Code 格式端点以规避兼容性报错。

Symptom

报错原文复制

API Error: 400 [{"error":{"code":400,"details":[{"@type":"type.googleapis.com/google.rpc.BadRequest","fieldViolations":[{"description":"Invalid JSON payload received. Unknown name \"prompt_cache_key\": Cannot find field."}]}],"message":"Invalid JSON payload received. Unknown name \"prompt_cache_key\": Cannot find field.","status":"INVALID_ARGUMENT"}}]

Cause

当 cc-switch 将 Claude 的请求转换为 OpenAI 格式时，会向请求体中注入 `prompt_cache_key` 字段。部分上游网关（如 Google AI Studio）不支持该字段，导致返回 400 错误。此外，集群中还混合了其他变体：使用 OpenRouter 时因 IP 限制或 Claude Code 初始化机制导致“地区错误”；以及配置 Gemini 时未填写 `base_url` 触发的配置错误。

Fix

1. 1

   升级 cc-switch 至 v3.16.2 或更高版本，该版本已调整适配器中 `prompt_cache_key` 的回退与注入逻辑，解决缓存串用及不兼容问题。

2. 2

   对于 OpenRouter 用户，建议直接使用其原生支持 Claude Code 格式的端点，无需开启本地代理。若遇地区错误，请先在终端环境变量中配置一次 API key 和请求地址，成功运行一次后再使用 cc-switch 切换。

3. 3

   若使用 Google AI Studio / Gemini，请确保在配置中正确填写 `base_url`，或直接使用 OpenRouter 进行转发以规避格式兼容性问题。

Affected Versions

ToolClaude Code

Version未知

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 6 个真实 issue

• #425使用openRouter发现proxy没有生效？
• #1159代理gemini，供应商为OpenRouter，都是默认配置，失败
• #1340使用google ai studio的openai的接口配置到ccs中，使用claudecode 无响应输出（已经使用代理服务模式）
• #1574代理问题请教
• #3193[Bug] Multiple Claude Code sessions share the same prompt_cache_key, causing prompt cache eviction and low hit rates
• #5319Add TokenRouter as a provider preset

FAQ

为什么 OpenRouter 测试连接正常，但在 Claude Code 中一直报地区错误？

可能是 OpenRouter 封堵了国内 IP，或 Claude Code 需要先通过环境变量配置一次 key 和请求地址并成功运行后，才能在 cc-switch 中正常切换。建议直接使用 OpenRouter 原生支持 Claude Code 格式的端点。

提示“Gemini Provider 缺少 base_url 配置”怎么解决？

请在 cc-switch 的 Gemini 供应商配置中补充完整的 `base_url`，或者改用 OpenRouter 转发 Gemini 模型。

相关问题

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY打开 `~/.claude/settings.json`，删除重复的 auth 环境变量，只保留当前供应商需要的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，保存后重启 Claude Code。4 issues mergedClaude Desktop 模式下代理接管 Claude 开关无法勾选在 claude-desktop 模式下，设置页的“应用接管”区域硬编码显示的是 Claude Code (claude) 开关，而非 Claude Desktop (claude-desktop) 开关，导致点击无反应或报错。2 issues merged在线更新时卡死无响应 CC Switch在 FlClash TUN 模式下 CC Switch 在线更新会卡死，请切换为系统代理模式或手动下载覆盖安装。1 issues merged