摘要CC-Switch 是一款跨平台的 API 渠道管理工具可以统一管理多个 API 服务商的密钥并在 Claude Code、Codex 等 AI 编程工具之间快速切换。本文从下载安装开始详细介绍如何添加官方 API 供应商、配置 API Key、开启本地路由以及将配置接入 Claude Code 和 Codex 的完整步骤。所有示例均使用官方 API确保配置过程合规、稳定、可复现。关键词CC-Switch、API 渠道管理、多模型切换、Claude Code、Codex、本地路由、官方 API一、CC-Switch 能做什么CC-Switch 的核心作用是统一管理多个 API 服务商的配置。如果你同时使用 DeepSeek、OpenAI、Anthropic 等官方 API或者需要在不同项目之间切换模型手动修改配置文件会非常麻烦。CC-Switch 通过图形界面帮你完成三件事集中管理 API Key不用在多个配置文件之间来回粘贴。一键切换供应商在不同官方 API 之间快速切换无需重启终端。自动接管配置文件把配置写入 Claude Code、Codex 等工具读取的路径。合规提示本文所有示例均使用各服务商官方 API。请遵守对应服务商的服务条款不要使用未经授权的第三方中转服务。二、下载与安装 CC-Switch2.1 获取安装包在 GitHub 上搜索cc-switch进入官方仓库的 Releases 页面根据系统下载对应版本系统推荐格式WindowsMSI 安装程序 / 便携版压缩包macOSZIP 压缩包 / HomebrewLinuxdeb 包 / rpm 包 / AppImage2.2 安装Windows双击 MSI 安装程序跟随向导完成安装。便携版解压后直接双击主程序运行。macOS解压 ZIP 包将程序拖入“应用程序”文件夹或通过 Homebrew 安装。Linux使用发行版对应的包管理器安装 deb 或 rpm 包。AppImage 文件添加执行权限后直接运行。安装完成后打开 CC-Switch无需注册登录。三、添加官方 API 供应商3.1 选择面板CC-Switch 顶部导航栏分为Claude Code和Codex两个面板两者配置相互独立。根据你要配置的工具选择对应面板。3.2 新增供应商点击右上角按钮填写以下信息字段填写内容说明名称自定义如DeepSeek 官方便于识别API Key从服务商官方平台获取的密钥不要分享给他人请求地址官方 API 端点见下方示例默认模型官方模型名称如deepseek-chat3.3 官方 API 地址示例DeepSeek 官方 APIClaude Code 面板https://api.deepseek.com/anthropicCodex 面板https://api.deepseek.com/v1OpenAI 官方 APICodex 面板https://api.openai.com/v1Anthropic 官方 APIClaude Code 面板https://api.anthropic.com填写完成后点击保存。你可以重复此步骤添加多个官方供应商。四、开启本地路由本地路由是 CC-Switch 接管工具配置文件的关键开关。不开启本地路由配置不会生效。进入 CC-Switch 的设置页面。找到本地路由选项。打开路由总开关。打开对应工具的开关Claude Code或Codex。如果使用 Claude Code勾选“接管本地 Claude 配置文件”相关选项。开启后CC-Switch 会自动把当前激活的供应商配置写入工具读取的路径。五、接入 Claude Code在 CC-Switch 顶部选择Claude Code面板。在供应商列表中激活你配置好的官方供应商。完全退出 Claude Code不是最小化而是彻底关闭进程。重新打开终端运行claude。如果配置正确Claude Code 会直接使用你配置的官方 API不再要求登录 Anthropic 官方账号。六、接入 Codex在 CC-Switch 顶部选择Codex面板。激活你配置好的官方供应商。完全退出 Codex 客户端。重新打开 Codex。在 Codex 中提一个问题验证是否能正常返回模型回复。七、验证与常见问题7.1 验证配置是否生效Claude Code启动后不再要求登录能正常对话即成功。Codex能正常返回模型回复即成功。CC-Switch 界面显示当前激活的供应商名称。7.2 常见问题Q配置后工具仍然要求登录官方账号检查本地路由是否开启以及是否勾选了“接管本地配置文件”选项。修改后需要完全退出工具再重启。QAPI Key 填错了怎么办在 CC-Switch 中删除该供应商重新添加并填入正确的 Key。Q修改配置后需要重启吗需要。CC-Switch 修改的是工具读取的配置文件必须完全退出工具再重新打开才能生效。QAPI Key 安全吗API Key 保存在本地配置文件中不要分享给他人也不要提交到公开仓库。CC-Switch 本身不上传你的 Key。八、合规使用提示请使用各服务商官方 API遵守其服务条款。不要使用未经授权的第三方中转服务。不要分享或出售自己的 API Key。不要将配置用于绕过服务商的计费或访问限制。九、总结CC-Switch 的价值在于把多个官方 API 的配置集中到一个界面里让你在 Claude Code、Codex 等工具之间快速切换。核心步骤只有四步下载安装 CC-Switch。添加官方 API 供应商填写 API Key 和官方端点。开启本地路由接管工具配置文件。完全重启工具验证配置生效。按照本文步骤操作你可以在不使用任何非官方渠道的前提下完成多模型 API 的统一管理。
