CC Switch

CC Switch 是一款开源、跨平台的桌面应用，可集中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等 AI 编程工具的服务商配置。通过图形界面保存 API Key、请求地址和模型映射后，可以在不同服务商之间一键切换，无需反复手动编辑各工具的配置文件。

下载并安装

前往 CC Switch Releases 下载与操作系统匹配的最新安装包，也可以访问 CC Switch 官网 获取客户端。

• Windows：下载并安装 .msi 文件。
• macOS：下载 .dmg 文件，或运行 brew install --cask cc-switch。
• Linux：下载适用于发行版的 .deb、.rpm 或 .AppImage 文件。

安装完成后，启动 CC Switch。首次使用时，应用会识别本机已安装的 AI 编程工具；如未自动识别，请确认对应 CLI 已完成安装并至少启动过一次。

获取模力方舟访问令牌

登录模力方舟后，前往 工作台 → 设置 → 访问令牌。

添加模力方舟服务商

下面以 Claude Code 为例说明完整流程；Codex、Pi 的添加方式相同，只需在顶部应用切换器中选择对应工具，并按其协议填写请求地址。

选择 Claude Code 并新建供应商

在顶部应用切换器中选择 Claude Code，然后点击右上角的 添加供应商（+），选择 自定义配置。

填写访问令牌和请求地址

在供应商配置页面填写以下内容：

• 供应商名称：例如 模力方舟。
• API Key：粘贴前一步获取的模力方舟访问令牌。
• 官网链接：可选，填写 https://ai.gitee.com。
• 请求地址：填写 https://ai.gitee.com/anthropic；完整 URL 保持关闭。

展开 高级选项后，保持默认的 Anthropic Messages（原生） 上游格式和 ANTHROPIC_AUTH_TOKEN（默认） 认证字段。

配置模型映射

在 模型映射 中，为 Sonnet、Opus、Fable、Haiku 和默认兜底模型填写实际请求模型。初次配置时，可以将这些角色统一设置为 deepseek-v4-flash-0731；“声明支持 1M”保持不勾选。

Subagent 为可选项，可以不填写。留空时，相关请求会使用默认兜底模型处理。

填写完成后保存配置，并在供应商卡片上点击 启用。

工具	请求地址	上游格式	认证字段	推荐配置说明
Claude Code	https://ai.gitee.com/anthropic	Anthropic Messages（原生）	ANTHROPIC_AUTH_TOKEN	将 Sonnet、Opus、Haiku 等角色映射到可用的编码模型。
Codex	https://ai.gitee.com/v1	Responses（原生）	无	选择可用的编码模型，并按需设置推理强度。
Pi	https://ai.gitee.com/v1	OpenAI Chat Completions	无	在模型列表中添加或选择需要使用的模型。

使用 /model 确认映射

保存并启用 Claude Code 供应商后，在 Claude Code 中使用以下命令确认模型映射：

/model

选择 sonnet、opus 等映射角色时，CC Switch 会将请求转发到对应的实际模型。

启用并验证

服务商添加完成后，在对应供应商卡片上点击 启用。当前启用的配置通常会显示高亮边框或“当前启用”标识。

随后重新打开相应的终端或客户端，并运行简单测试：

# Claude Code
claude

# Codex
codex

# OpenCode
opencode

若工具能够正常返回内容，说明配置已生效。Claude Code 通常支持热加载；其他工具若未立即生效，请完全退出后重新启动。

常用功能

• 一键切换：在主界面或系统托盘菜单中，快速切换不同工具的服务商配置。
• 统一管理 MCP：集中编辑 MCP Server，并按需同步到已启用的工具。
• 提示词管理：维护 Markdown 提示词，并同步至 CLAUDE.md、AGENTS.md 或 GEMINI.md。
• 用量统计：启用本地代理后，可查看请求、Token 消耗和费用趋势。
• 故障转移：为多个服务商配置优先级，在主服务不可用时自动切换到备用服务。

更多资源

• CC Switch 项目主页
• CC Switch 使用手册
• 模力方舟 API 文档
• 访问令牌管理