Claude Code 配置后无法调用模型 - CC Switch

Quick fix

先确认 cc-switch 只是改写配置；检查跳过初次安装确认、代理/区域限制与上游 API 兼容性。

Symptom

报错原文复制

配置后无法正常工作，疑似正常包括以下之一：
- Base URL 域名/路径校验过严
- 细节工作流进行了硬编码假设（endpoint/path/header 或配置字段限制）

Cause

该聚类包含三种相关但不同的 Claude Code 接入失败场景：1）使用 ZenMux 等 Anthropic 聚合服务时，配置自定义 Base URL + API Key 后无法正常工作；2）开启代理后本地测试可用，但 terminal 中调用模型仍显示区域不可用；3）通过 OpenAI 兼容协议路由 Ollama 云端模型时普通问答正常但工具调用失败。维护者说明 cc-switch 本身只是帮助配置，工作原理是修改配置文件，并不会修改请求，因此自定义网关/代理/模型能力问题需要结合上游服务、代理环境和 Claude Code 本身排查。对于 terminal 区域不可用的情况，评论中提到需要检查是否开启“跳过初次安装确认”；对于 OpenAI 兼容路由工具调用失败，问题仍开放，未给出已确认修复。

Fix

1. 1

   确认 cc-switch 的作用：它只负责修改 Claude Code 相关配置文件，不会代理或改写实际请求。若使用 ZenMux 等第三方 Anthropic 兼容网关，先确认该服务的 Base URL、API Key、endpoint/header 与 Claude Code 要求兼容。

2. 2

   如果使用代理/VPN 后浏览器或本地测试正常，但 terminal 中 Claude Code 仍提示模型在该区域无法调用，检查系统代理、终端代理环境变量是否对 Claude Code 生效，并确认 VPN/代理节点所在区域可访问模型服务。

3. 3

   在 cc-switch 中检查是否开启“跳过初次安装确认”。有评论提示该选项可能影响首次登录/调用流程。

4. 4

   如果使用 OpenAI 兼容协议接入 Ollama 云端或自建网关，且普通问答正常但工具调用失败，先确认上游模型/网关支持 Claude Code 所需的 tools/tool_calls 能力；该问题目前未有已确认修复，建议收集 cc-switch 调试日志、上游日志和 curl 请求后提交/跟进 issue。

Affected Versions

ToolClaude Code

Version未知

PlatformsmacOSWindows

Source Issues

本页汇总自 3 个真实 issue

• #944不支持 ZenMux 的 Anthropic 聚合服务（Base URL + API Key 无法正常工作）
• #2158gpt，Claude相关模型，调试可以，但打开terminal后，调用显示模型在该区域无法调用（开了vpn），该如何处理？
• #6359[Bug] 开启 OpenAI 协议路由接入 Ollama 云端模型时，工具调用失败（普通问答正常）

FAQ

cc-switch 会不会帮我代理或修改请求？

不会。维护者说明 cc-switch 只是帮助配置，工作原理是修改配置文件，并不会修改请求。自定义 Base URL、网关兼容性和上游服务问题需要咨询对应服务商或检查上游配置。

开了代理/VPN，本地测试可以，但 Claude Code terminal 里仍显示区域不可用怎么办？

需要确认终端/Claude Code 实际走代理，而不仅是浏览器或本地测试工具走代理。同时检查 cc-switch 中“跳过初次安装确认”是否开启，并确认代理节点区域支持模型调用。

ZenMux 这类 Anthropic 聚合服务无法使用是 cc-switch 不支持吗？

issue 中未确认是 cc-switch 不支持。维护者表示 cc-switch 只修改配置文件，不修改请求，因此需要确认 ZenMux 提供的 Base URL/API Key/接口行为与 Claude Code 兼容，或咨询 ZenMux 客服。

OpenAI 兼容路由 Ollama 云端时普通问答正常但工具调用失败，有修复吗？

该问题在聚类中仍为 open，未给出已确认修复。建议检查上游是否支持 tools/tool_calls，并提供 cc-switch 调试日志、Ollama 日志和 curl 抓包用于定位。

相关问题

Claude Desktop 模式下代理接管 Claude 开关无法勾选在 claude-desktop 模式下，设置页的“应用接管”区域硬编码显示的是 Claude Code (claude) 开关，而非 Claude Desktop (claude-desktop) 开关，导致点击无反应或报错。2 issues mergedUnknown name "prompt_cache_key" cc-switch升级 cc-switch 至 v3.16.2+ 修复 prompt_cache_key 注入问题，或改用 OpenRouter 原生 Claude Code 格式端点以规避兼容性报错。6 issues merged401 Unauthorized: Incorrect API key provided切换到 OpenAI Official 或关闭代理后，需手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 并重启 Codex 以恢复官方 OAuth 登录。2 issues merged