DeepSeek 接入 Codex/Claude 超详细手册

CC Switch 是什么​

Claude Code、Codex 这些命令行工具，每一个的配置格式都不一样。如果你想给它们换个模型供应商，得自己去翻文档，手动编辑 JSON、TOML 或者 .env 文件，填一堆 Base URL、API Key、模型名之类的参数。说不定改错一个字符就跑不起来，想在几个模型之间来回切换就更麻烦了。。。​

CC Switch 就是来解决这个痛点的。它是一个免费开源的跨平台桌面工具，用一个可视化界面统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等多个 AI 编程工具的配置。​

​

​

安装 CC Switch​

到 CC Switch 官网 或者GitHub Releases 页面，根据你的操作系统选择对应的安装方式。​

​

​

Mac 用户推荐直接用 Homebrew 一行命令安装，装完直接就能用：​

​

代码块​

YAML

brew install --cask cc-switch​

​

​

​

Windows 用户从 Releases 页面下载 .msi 安装包，双击运行即可；Linux 用户根据发行版选择 .deb、.rpm 或 .AppImage。​

安装完成后启动 CC Switch，主界面会出现在桌面或者系统托盘里。​

下面我们就分别给 Claude Code 和 Codex 接上 DeepSeek 了。不过在那之前，得先把 DeepSeek 的 API Key 准备好。​

准备大模型 API Key​

不管接哪个工具，都得先有一个 DeepSeek 的 API Key。​

到 DeepSeek 开放平台注册登录，进入 API keys 页面，点击创建一个新的 key。​

​

​

注意，key 只会在创建时完整显示这一次，记得当场复制保存好，后面在 CC Switch 里要用到它。​

把 DeepSeek 接入 Claude Code​

我们先从简单的 Claude Code 开始。​

先装好 Claude Code​

简单介绍一下 Claude Code。它是 Anthropic 推出的 AI 编程工具，直接在终端里运行，你跟它聊天描述需求，它就能自主分析项目、写代码、跑命令、修 Bug，全程自主执行。​

​

​

安装 Claude Code 很简单，先确保电脑里有 Node.js 环境，没有的话去 Node 官网下个傻瓜式安装包。然后一行命令搞定：​

​

代码块​

YAML

npm install -g @anthropic-ai/claude-code​

​

装好后在终端输入 claude 就能进入对话界面，首次使用需要登录。但很多同学没有 Anthropic 的官方账号，登录这步就卡住了，根本没法直接用。​

别急，下面就用 CC Switch 把它切换成 DeepSeek。​

用 CC Switch 切换模型​

打开 CC Switch，在顶部应用栏选择 Claude，然后点击「添加供应商」：​

​

​

在预设的模型供应商列表里选择 DeepSeek：​

​

​

接下来填写刚才在 DeepSeek 开放平台创建好的 API Key：​

​

​

其余字段基本不用动，CC Switch 的 DeepSeek 预设已经帮你把模型都配好了，里面内置了 DeepSeek-V4-Pro 和 DeepSeek-V4-Flash 两个版本，主模型默认就是 Pro，相比 Flash，它的 Agent 能力和复杂推理更强，更适合写代码。​

如果你想用上 DeepSeek V4 的百万 tokens 超长上下文，还能在这里直接勾选开启 1M 模式，告诉 Claude Code 这个模型能吃下这么长的上下文，不用自己去改配置。​

​

​

填完点右下角的「添加」按钮。这里能看到 Claude Code 的 JSON 配置文件，CC Switch 干的活儿就是帮你可视化地修改它，省去手动编辑的麻烦。​

​

​

最后点击启用 DeepSeek 模型：​

​

​

重新进入 Claude Code，左上角能看到当前用的模型。我们让它自报家门，输入一句：你是什么模型？​

AI 能正常给出回复，就说明切换成功了：​

​

​

你可能会发现，用 CC Switch 给 Claude Code 接 DeepSeek，整套流程格外简单。这是因为 DeepSeek 提供了兼容 Anthropic 协议的接口，而 Claude Code 本身就是按这个协议来通信的，CC Switch 直接把配置写进 settings.json 就能用了。​

二、把 DeepSeek 接到 Codex​

搞定 Claude Code，我们再来看 Codex。它是 OpenAI 推出的 AI 编程工具，最近的热度堪称炸裂。​

Codex 有两种形态，一种是在终端里跑的命令行版 Codex CLI，一种是带图形界面的桌面 APP。​

命令行版的安装方式跟 Claude Code 类似，一行命令就能搞定：​

​

代码块​

YAML

npm install -g @openai/codex​

​

装好后在终端输入 codex 就能进入对话界面，首次使用同样需要登录 OpenAI 账号。没有账号的话，就要用 CC Switch 来切换模型。​

​

​

Codex 接入原理​

既然 Codex 的配置都放在 ~/.codex/config.toml 这个文件里，那我直接把里面的接口地址 base_url 改成 DeepSeek 的不就行了？​

能想到这说明你很聪明，但是这么干大概率会翻车，直接给你报一个 404 错误。​

问题出在协议上。Codex 用的是 OpenAI 的 Responses API，而 DeepSeek 这些国内模型走的是 Chat Completions API，这俩压根儿不是一套东西。就好比你打电话，号码是拨通了，可你说中文、对方只懂法语，照样聊不到一块儿去。​

所以 Codex 接国内模型，关键在于中间得有个「翻译」，把 Codex 发出的请求转换成 DeepSeek 能听懂的格式。​

好在 CC Switch 已经把这件事给我们办妥了。它的「本地路由」功能会在你电脑上起一个轻量级的代理服务，请求的流转过程是这样的：​

​

代码块​

YAML

Codex → CC Switch → DeepSeek → CC Switch → Codex​

​

用 CC Switch 配置​

打开 CC Switch，在顶部应用栏切换到 Codex，点击「添加供应商」：​

​

​

在预设里搜索并选择 DeepSeek，跟前面给 Claude Code 配置时的步骤一样：​

​

​

填入你的 DeepSeek API Key，其余字段保持默认。​

跟 Claude Code 一样，模型这些 CC Switch 都已经预设好了，其他字段不用动。​

要特别注意的是，这一步的关键是得 开启「本地路由映射」，然后点右下角的「添加」按钮保存就好。​

回到主页后，选择启用 DeepSeek。​

但是到目前为止，我们还不能在 Codex 中正常使用 DeepSeek，对话会直接报前面说的 404 错误。​

开启本地路由​

切换到 DeepSeek 后，系统会提示你开启路由。点击左上角的「设置」按钮进入设置页面。​

找到路由设置菜单，把本地路由的「路由总开关」打开，然后选择启用 Codex 路由：​

​

​

这一步就是让 CC Switch 的本地代理正式接管 Codex 的请求，前面说的协议转换全靠它。​

大功告成！​

重新打开 Codex CLI，就能看到已经切换为 DeepSeek 模型了。同样让它自报家门，能正常对话就说明切换成功了：​

​

​

再来试试 Codex 桌面 APP。因为它和命令行版共用 ~/.codex 这套配置，CC Switch 切换之后直接打开就能用，同样问它是什么模型，底层跑的也是 DeepSeek：​

​

​

如果想改回来，反向操作即可，把路由关掉、再启用默认配置就行​

​

​

​