跳到主要内容
feedback
feedback

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，然后点击右上角的 添加供应商（+），选择 自定义配置。

选择 Claude Code 并添加供应商

填写访问令牌和请求地址​

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

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

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

填写访问令牌、请求地址和高级选项

配置模型映射​

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

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

配置 Claude Code 模型映射

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

工具配置参考​

工具请求地址上游格式认证字段推荐配置说明
Claude Codehttps://moark.com/anthropicAnthropic Messages（原生）ANTHROPIC_AUTH_TOKEN将 Sonnet、Opus、Haiku 等角色映射到可用的编码模型。
Codexhttps://moark.com/v1Responses（原生）无选择可用的编码模型，并按需设置推理强度。
Pihttps://api.moark.com/v1OpenAI Chat Completions无在模型列表中添加或选择需要使用的模型。
OpenCodehttps://ai.gitee.com/v1OpenAI Compatible无填写模力方舟访问令牌，并在模型列表中添加或选择需要使用的模型。
OpenClawhttps://ai.gitee.com/v1OpenAI 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 消耗和费用趋势。
  • 故障转移：为多个服务商配置优先级，在主服务不可用时自动切换到备用服务。

更多资源​

Copyright © 2026 模力方舟京ICP备2025119063号京公网安备11011502039387号京公网安备11011502039387号