Claude code 不支持 gemini - CC Switch

Quick fix

cc-switch 目前不支持将 Gemini 作为 Claude Code 的 provider；需要等待本地代理功能或使用第三方代理项目。

Symptom

报错原文复制

claude code 不支持 gemini

Cause

cc-switch 的 provider 管理目前不能直接把 Gemini 接口作为 Claude Code 的供应商接入。用户在添加 Gemini 供应商时会遇到 404 或被明确告知 Claude Code 不支持 Gemini。相关讨论还提到，普通 API 转接供应商不能直接使用，需要类似 CCR 的接口转换能力，而 cc-switch 的本地代理功能仍在开发中。

该集群中还包含 Windows 上诊断提示“检测到多处安装”的反馈，但那是安装诊断检测逻辑问题，与 Gemini provider 不支持不是同一个故障；因此本页只处理 Gemini provider 无法添加/不支持的问题。

Fix

1. 1

   不要在 cc-switch 中把 Gemini 作为 Claude Code 的 provider 添加；当前 Claude Code 不支持 Gemini。

2. 2

   如需代理或转换接口，可暂时使用第三方项目 claude-code-router，但该项目也不能代理 Codex 和 Gemini。

3. 3

   等待 cc-switch 后续版本提供本地代理/接口转换功能后再尝试配置 Gemini。

Affected Versions

ToolClaude Code

Version未知

Platforms未知

Source Issues

本页汇总自 3 个真实 issue

• #229api方式转换更新
• #301cc-switch能使用自己公司包了一层的provider吗，规范接近openai的。能不能同时支持Claude code、 codex 、Gemini cli
• #730Claude code 新增 gemini 供应商失败 - 404

FAQ

cc-switch 能使用公司包了一层、规范接近 OpenAI 的 provider 吗？

相关 issue 中维护者表示 cc-switch 正在开发本地代理功能，工作量很大；当前可先尝试 claude-code-router 项目。

能不能同时支持 Claude Code、Codex、Gemini CLI？

issue 中没有给出已支持的结论。维护者表示本地代理功能正在开发，且目前似乎没有合适的 Gemini 代理方案。

CCR 能代理 Gemini 吗？

有用户反馈 claude-code-router 不能代理 Codex 和 Gemini；维护者表示 Gemini CLI 相关代理好像还没有特别突出的方案。

为什么普通 API 转接供应商不能直接使用？

issue 中提到需要类似 CCR 的接口转换能力；维护者表示发完 Gemini 支持版本后会全力开发本地代理功能。

相关问题

not installed or not executable升级 CC Switch 到 v3.16.2+，或在设置中手动指定 CLI 安装目录，并清理 shell 启动输出噪音。4 issues mergedGemini 出现 default 配置且无法删除default 是 CC Switch 导入现有 live 配置生成的预期供应商；需先在设置中切换当前供应商，再删除不需要的配置。4 issues mergedHTTP 401 Unauthorized - CC Switch Anthropic升级 cc-switch 至修复版，以支持 Anthropic 所需的 x-api-key 和 anthropic-version 请求头。2 issues merged