CC Switch 智能体配置指南#
CC Switch 可以统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等客户端的供应商配置。推荐优先使用「统一供应商」配置同一套 Xmodel Key 和接口地址；如果只想单独配置某个客户端，也可以进入对应应用页签添加「应用专属供应商」。
准备内容#
Xmodel 官网：https://token.xmodel.chat/
Xmodel 接口地址：https://api.xmodel.chat/v1
一、安装并打开 CC Switch#
首次启动后，确认 CC Switch 能正常打开，并在顶部看到 Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes 等应用入口。二、新增供应商#
点击主界面右上角的 + 新增供应商。
统一供应商：一份配置可同步到 Claude Code、Codex、Gemini CLI 等多个客户端。
Codex供应商：只适用于 Codex 应用中使用
三、统一供应商配置#
在「添加统一供应商」页面，选择预设类型为 NewAPI，然后填写以下配置：API 地址：填写 https://api.xmodel.chat
官网地址：填写 https://token.xmodel.chat
备注：可不填
四、保存、启用并让配置生效#
启用后，CC Switch 会把当前供应商配置写入对应客户端的配置文件。不同客户端的生效方式不同：| 客户端 | 生效方式 |
|---|
| Claude Code | 通常可即时生效 |
| Gemini CLI | 通常可即时生效 |
| Codex | 关闭并重新打开终端后生效 |
| OpenCode | 关闭并重新打开终端后生效 |
| OpenClaw | 关闭并重新打开终端后生效 |
| Claude Desktop | 完整退出并重新打开客 户端后生效 |
在「所需的应用」中，打开需要使用这套配置的客户端开关，例如 Claude Code、OpenAI Codex、Gemini CLI。未启用的客户端不会写入这套统一供应商配置。如果不确定当前客户端是否已经重新读取配置，最稳妥的做法是完整退出对应客户端或终端，再重新打开测试。
常见情况#
获取模型列表失败：优先检查 API Key 是否正确、API 请求地址是否为 https://api.xmodel.chat/v1
端点不支持模型列表：如果返回 404、405 或解析失败，说明当前接口可能不支持自动模型发现，可以手动填写模型 ID
某个智能体看不到需要的模型：检查 Xmodel 新建的 AK 是否属于对应分组，并确认该分组已授权对应模型
启用后还是旧配置：确认已经点击「启用」，并按对应客户端要求重启终端或客户端
只想恢复官方登录：在对应页签选择官方登录相关预设，启用后重新走官方登录流程
说明：不同版本的 CC Switch 按钮位置和字段名称可能略有变化，但核心流程一致：新增供应商，填写 API Key 和端点地址，保存，启用，然后让对应客户端重新读取配置。
