用 CC Switch 配置 Claude Code

使用 CC Switch 为 Claude Code 添加 Weason 服务，并管理主模型与可选模型映射。请先准备支持 Claude Messages 接口的模型和 Key 分组。

开始前准备

按 Claude Code 官方安装说明 安装工具，再安装 CC Switch 官方版本。到 API 密钥 创建有 Claude 权限的 Key。

推荐：从 Weason 导入 Claude Code

1. 登录 API 密钥，打开目标 Key 的操作菜单，点击 CC Switch。
2. 在导入弹窗中，应用选择 Claude；这里对应 CC Switch 的 Claude Code 配置。
3. 名称填写 Weason Claude，主模型选择当前分组可用的完整 ID，例如 claude-sonnet-4-6。
4. 如需使用工具的 Haiku、Sonnet 或 Opus 档位，为对应字段选择各自分组可用的模型。不确定时先只设置主模型。
5. 点击 打开 CC Switch，允许系统打开应用。
6. 核对 Endpoint 为 https://weason.cn，检查 Key 和模型，再确认保存。
7. 在 CC Switch 的 Claude Code 页面选中 Weason Claude，点击 启用。

导入里的模型下拉框用于选择名称，不会为 Key 增加权限。Haiku、Sonnet、Opus 映射应选实际存在且允许调用的模型。

备用：手动添加 Provider

在 CC Switch 中选择 Claude Code 页面，点击“添加供应商”或加号，选择自定义供应商，再填写：

保存并启用 Provider。Claude Code 会补上 /v1/messages，所以这里使用根地址。不要照搬 Codex 的带 /v1 地址。

启动与验证

重新打开 Claude Code，CLI 用户运行 claude。用 /status 查看当前连接和模型，再发一个简单问题。到 Weason 使用日志 确认请求来自对应 Key 和 Claude 分组。

同协议的直接接入按上述配置即可。CC Switch 的本地路由用于其他接入场景；若已开启，应核对其实际目标和上游协议。

切换服务或模型

在 CC Switch 编辑 Weason Claude 并保存。为排除旧会话影响，修改后重新打开 Claude Code。切回原服务时，启用先前的 Provider，再按目标服务要求完成登录。

常见问题

• 导入打不开软件：先打开 CC Switch 一次，检查协议关联，或手动添加。
• 404：确认 Endpoint 为 https://weason.cn，上游格式为 Anthropic Messages，实际路径没有重复 /v1。
• 模型错误：使用完整 Claude 模型 ID，并核对主模型及档位映射的权限。
• 401 或仍走旧服务：检查当前启用 Provider；旧系统环境变量、凭证助手或本地路由可能影响最终配置。
• 连通检查正常却无法对话：地址可达不等于模型请求成功，请按错误体和使用日志定位。

参考：CC Switch 官方说明 · Claude Messages 示例 · 官方兼容网关说明