1. 为什么要在 Codex 里接 DeepSeek V4Codex 桌面端和 CLI 默认走的是 OpenAI 官方通道对国内开发者来说延迟和成本是两个绕不开的问题。DeepSeek V4 在代码补全、长上下文理解上的表现已经能满足日常开发价格又比官方通道低不少所以把 Codex 的请求切到 DeepSeek V4 上是很多本地已有 Codex 的开发者会做的第一件事。问题在于Codex 本身不提供「换供应商」的图形化入口它读的是~/.codex/config.toml这个配置文件。手动改 TOML 容易写错字段尤其是model_providers下面的base_url、wire_api、env_key这几项一旦拼错Codex 启动时不会给你友好提示只会静默回退到默认模型你甚至察觉不到请求根本没发出去。CC Switch 就是来解决这个痛点的。它是一个专门管理 Codex、Claude Code 这类工具供应商配置的切换器把config.toml的写入和备份做成可视化操作切换供应商时自动改配置、自动重启路由。我试过纯手改和用 CC Switch 两种方式后者在反复切换供应商时省事很多尤其是你同时要维护官方通道和 DeepSeek 通道的时候。这篇面向的是本地已经装好 Codex、想接 DeepSeek V4 的开发者。我会先讲清楚 TaoToken 在链路里的位置再给出可复制的config.toml骨架然后走一遍 CC Switch 的切换步骤最后用一次真实请求验证接入是否生效。目标是一次配置之后在 Codex 里稳定调用 DeepSeek V4。2. TaoToken 在 Codex 接入链路里的位置Codex 要调用 DeepSeek V4需要三样东西一个兼容 OpenAI 协议的base_url、一个可用的 API Key、以及正确的模型名。DeepSeek 官方 API 是兼容 OpenAI 格式的但如果你同时要用多个模型、或者想让 Key 的管理和额度查看集中在一个地方用 TaoToken 做统一入口会更顺手。TaoToken 在这里的角色是「OpenAI 兼容的 API 网关」Codex 把请求发到 TaoToken 的base_urlTaoToken 再按你选的模型转发到对应的上游。对 Codex 来说它只认base_url和api_key不关心中间是谁在转发。所以配置的核心就是把 Codex 的base_url指向 TaoToken 的 API 地址把 Key 填成 TaoToken 生成的 Key。这里要区分两个地址别搞混用途地址官网注册、看文档、进控制台https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基址写进 config.toml 的 base_urlhttps://taotoken.net/api注意 API 基址后面不要加多余的路径Codex 会自己在后面拼/chat/completions或/responses。如果你写成https://taotoken.net/api/v1有些版本会拼成/api/v1/chat/completions导致 404这个坑我在下面排障部分会再展开。提示TaoToken 的 Key 在控制台的 API Keys 页面生成生成后只显示一次记得先复制到安全的地方。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3. 可复制的 config.toml 骨架Codex 的配置文件默认在~/.codex/config.tomlWindows 是C:\Users\你的用户名\.codex\config.toml。如果你之前没改过这个文件可能只有几行默认配置。下面是一个接 DeepSeek V4 的最小可用骨架你可以直接复制后替换 Key# ~/.codex/config.toml # 默认使用的模型这里指向下面定义的 deepseek 供应商 model deepseek-v4 model_provider deepseek # 供应商定义 [model_providers.deepseek] name DeepSeek V4 via TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat # 可选控制请求超时和重试 request_timeout_ms 120000几个字段逐个说明这些是踩过坑之后确认必须对的model_provider的值必须和[model_providers.xxx]里的xxx完全一致大小写敏感。上面写的是deepseek下面就必须是[model_providers.deepseek]。base_url填https://taotoken.net/api不要带尾部斜杠也不要自己加/v1。env_key是环境变量的名字不是 Key 本身。Codex 启动时会去读这个环境变量拿 Key。这样设计是为了避免把 Key 明文写进配置文件。你需要设置# macOS / Linux写进 ~/.zshrc 或 ~/.bashrc export TAOTOKEN_API_KEYsk-你的TaoToken密钥 # Windows PowerShell临时生效 $env:TAOTOKEN_API_KEYsk-你的TaoToken密钥wire_api填chat表示走 OpenAI 的/chat/completions协议。DeepSeek V4 兼容这个协议填responses反而可能因为上游不支持而报错。model填deepseek-v4这是模型标识。如果你在 TaoToken 控制台看到的模型名带前缀或后缀以控制台显示的为准。注意改完config.toml后Codex 需要重启才会重新读取配置。如果你是在终端里跑codex直接退出再进即可。4. 用 CC Switch 切换供应商的完整步骤如果你不想手改 TOML或者需要在多个供应商之间来回切CC Switch 是更省心的选择。它的原理是帮你管理config.toml的写入切换时自动备份旧配置、写入新配置。4.1 安装与首次启动CC Switch 是开源工具从它的 release 页面下载对应平台的安装包即可。安装后首次启动它会自动检测你本地的~/.codex/config.toml如果存在就读取现有供应商列表不存在就创建一个空的。启动后主界面会列出当前已配置的供应商以及一个「当前激活」的标记。默认情况下如果你之前手改过配置这里会显示你手写的那个供应商。4.2 添加 DeepSeek 供应商点击「添加供应商」填写以下字段字段填写值名称DeepSeek V4自定义方便识别即可Base URLhttps://taotoken.net/apiAPI Keysk-你的TaoToken密钥模型deepseek-v4协议chatOpenAI 兼容填完后保存CC Switch 会把这个供应商写进它自己的配置库但此时还没有激活。你会在列表里看到新增的条目旁边有一个「激活」按钮。4.3 激活并写入 config.toml点击 DeepSeek V4 条目旁边的「激活」CC Switch 会做三件事备份当前的config.toml为config.toml.bak把model_provider改成deepseek把[model_providers.deepseek]段写入文件。激活成功后界面上的「当前激活」标记会移到 DeepSeek V4 上。这时候你打开~/.codex/config.toml看一眼应该能看到和上一节骨架一致的内容只是 Key 可能被 CC Switch 用环境变量或直接写入的方式处理取决于它的版本。4.4 打开路由开关部分版本的 CC Switch 有一个「路由开关」作用是启动一个本地代理把 Codex 的请求先转到本地再转发出去。如果你只是直连 TaoToken这个开关可以不开。开了的话base_url会被改成http://127.0.0.1:某端口多一层转发。我的建议是如果你网络环境直连 TaoToken 没问题就别开路由少一层故障点。如果开了记得在 CC Switch 里确认端口没被占用。4.5 重启 Codex 验证关掉所有 Codex 窗口重新打开。如果是 CLI直接在终端重新运行codex。启动后 Codex 会读取新的config.toml用 DeepSeek V4 作为默认模型。5. 发一次请求验证接入是否生效配置改完不代表生效必须发一次真实请求确认。有两种验证方式建议都做一遍。5.1 用 curl 直接打 TaoToken 接口这一步绕过 Codex直接验证 Key 和 base_url 是否可用curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: deepseek-v4, messages: [ {role: user, content: 用一句话说明什么是快速排序} ] }如果返回 JSON 里choices[0].message.content有内容说明 Key 和 base_url 都没问题。如果返回 401是 Key 错了返回 404是 base_url 路径拼错了返回 400 且提示 model 不存在是模型名写错了。5.2 在 Codex 里发一条真实请求打开 Codex输入一个需要模型回答的问题比如「帮我写一个 Python 函数判断一个数是否为质数」。观察返回内容。如果 Codex 正常返回了代码说明整条链路通了。如果 Codex 返回的是官方模型的回答风格或者提示模型不可用说明config.toml没被正确读取回到上一节检查model_provider和model字段。你也可以在 Codex 里输入/model如果版本支持查看当前使用的模型确认显示的是deepseek-v4。5.3 确认请求真的走了 DeepSeek一个简单的判断方法DeepSeek V4 在中文代码注释和中文解释上风格比较明显回答里如果出现比较自然的中文技术解释基本可以确认走的是 DeepSeek。另一个方法是去 TaoToken 控制台的用量页面看请求计数有没有增加增加的那条对应的模型是不是deepseek-v4。6. 本篇常见错误排查下面这些是我在配置过程中实际遇到过的报错按出现频率排序。报错一401 Unauthorized原因通常是环境变量没生效。Codex 读的是env_key指定的那个环境变量如果你在config.toml里写的是TAOTOKEN_API_KEY但终端里export的是别的名字就会 401。检查方法echo $TAOTOKEN_API_KEY如果输出为空说明没设置成功。注意 macOS 上如果你改的是~/.zshrc需要source ~/.zshrc或重开终端。报错二404 Not Found九成是base_url写错了。正确写法是https://taotoken.net/api不要加/v1不要加尾部斜杠。Codex 会自己在后面拼路径你多写一段它就拼成不存在的地址。报错三model not found或模型回退到默认检查model字段的值是否和 TaoToken 控制台里显示的模型名完全一致。有些控制台显示的是deepseek-v4有些带版本号后缀以控制台为准。另外确认model_provider和[model_providers.xxx]的xxx拼写一致。报错四CC Switch 激活后 Codex 没变化CC Switch 写的是~/.codex/config.toml但如果你设置了CODEX_HOME环境变量指向别的目录Codex 读的就不是这个文件。检查echo $CODEX_HOME如果有输出说明 Codex 的配置目录被改过你需要让 CC Switch 也指向那个目录或者把CODEX_HOME去掉。报错五请求超时DeepSeek V4 在长上下文场景下响应会慢一些默认超时可能不够。在config.toml里加一行request_timeout_ms 120000把超时提到 120 秒。如果还是超时检查网络到taotoken.net的连通性。报错六开了路由开关后连不上CC Switch 的路由开关会起一个本地代理如果端口被占用或者代理进程没起来Codex 会连不上。关掉路由开关直接用直连模式base_url改回https://taotoken.net/api。7. 接入之后Key 管理与长期使用建议配置跑通只是第一步长期用下去还有几件事值得做。Key 的管理建议集中在 TaoToken 控制台做。你可以为 Codex 单独生成一个 Key和别的工具用的 Key 分开这样某个 Key 泄露或额度异常时能单独吊销不影响其他工具。控制台的 API Keys 页面可以生成和吊销 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你打算在 Codex 里长期跑编码任务尤其是那种一次要改多个文件、跑好几轮的重构建议了解一下 Coding Plan。它针对长时间、多轮次的编码场景做了额度优化比按次调用更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content配置文件的备份也别忽略。CC Switch 激活时会自动备份config.toml.bak但如果你手改过建议自己再存一份。我习惯把可用的config.toml存到 dotfiles 仓库里换机器时直接拉下来改个 Key 就能用。最后如果你在接入过程中遇到本文没覆盖的报错可以先翻接入文档里面按错误码列了常见原因https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先确认 DeepSeek V4 在当前链路上的回答质量也可以直接在模型对话页面发几条测试请求不用改 Codex 配置就能验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content整套流程走下来核心其实就三件事base_url写对、Key 通过环境变量传进去、model_provider和model字段对齐。这三件事对了Codex 调 DeepSeek V4 就是稳定的。剩下的时间交给模型去写代码就行。 Codex 快速接入 DeepSeek V4：用 CC Switch 与 config.toml 一次跑通
1. 为什么要在 Codex 里接 DeepSeek V4Codex 桌面端和 CLI 默认走的是 OpenAI 官方通道对国内开发者来说延迟和成本是两个绕不开的问题。DeepSeek V4 在代码补全、长上下文理解上的表现已经能满足日常开发价格又比官方通道低不少所以把 Codex 的请求切到 DeepSeek V4 上是很多本地已有 Codex 的开发者会做的第一件事。问题在于Codex 本身不提供「换供应商」的图形化入口它读的是~/.codex/config.toml这个配置文件。手动改 TOML 容易写错字段尤其是model_providers下面的base_url、wire_api、env_key这几项一旦拼错Codex 启动时不会给你友好提示只会静默回退到默认模型你甚至察觉不到请求根本没发出去。CC Switch 就是来解决这个痛点的。它是一个专门管理 Codex、Claude Code 这类工具供应商配置的切换器把config.toml的写入和备份做成可视化操作切换供应商时自动改配置、自动重启路由。我试过纯手改和用 CC Switch 两种方式后者在反复切换供应商时省事很多尤其是你同时要维护官方通道和 DeepSeek 通道的时候。这篇面向的是本地已经装好 Codex、想接 DeepSeek V4 的开发者。我会先讲清楚 TaoToken 在链路里的位置再给出可复制的config.toml骨架然后走一遍 CC Switch 的切换步骤最后用一次真实请求验证接入是否生效。目标是一次配置之后在 Codex 里稳定调用 DeepSeek V4。2. TaoToken 在 Codex 接入链路里的位置Codex 要调用 DeepSeek V4需要三样东西一个兼容 OpenAI 协议的base_url、一个可用的 API Key、以及正确的模型名。DeepSeek 官方 API 是兼容 OpenAI 格式的但如果你同时要用多个模型、或者想让 Key 的管理和额度查看集中在一个地方用 TaoToken 做统一入口会更顺手。TaoToken 在这里的角色是「OpenAI 兼容的 API 网关」Codex 把请求发到 TaoToken 的base_urlTaoToken 再按你选的模型转发到对应的上游。对 Codex 来说它只认base_url和api_key不关心中间是谁在转发。所以配置的核心就是把 Codex 的base_url指向 TaoToken 的 API 地址把 Key 填成 TaoToken 生成的 Key。这里要区分两个地址别搞混用途地址官网注册、看文档、进控制台https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基址写进 config.toml 的 base_urlhttps://taotoken.net/api注意 API 基址后面不要加多余的路径Codex 会自己在后面拼/chat/completions或/responses。如果你写成https://taotoken.net/api/v1有些版本会拼成/api/v1/chat/completions导致 404这个坑我在下面排障部分会再展开。提示TaoToken 的 Key 在控制台的 API Keys 页面生成生成后只显示一次记得先复制到安全的地方。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3. 可复制的 config.toml 骨架Codex 的配置文件默认在~/.codex/config.tomlWindows 是C:\Users\你的用户名\.codex\config.toml。如果你之前没改过这个文件可能只有几行默认配置。下面是一个接 DeepSeek V4 的最小可用骨架你可以直接复制后替换 Key# ~/.codex/config.toml # 默认使用的模型这里指向下面定义的 deepseek 供应商 model deepseek-v4 model_provider deepseek # 供应商定义 [model_providers.deepseek] name DeepSeek V4 via TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat # 可选控制请求超时和重试 request_timeout_ms 120000几个字段逐个说明这些是踩过坑之后确认必须对的model_provider的值必须和[model_providers.xxx]里的xxx完全一致大小写敏感。上面写的是deepseek下面就必须是[model_providers.deepseek]。base_url填https://taotoken.net/api不要带尾部斜杠也不要自己加/v1。env_key是环境变量的名字不是 Key 本身。Codex 启动时会去读这个环境变量拿 Key。这样设计是为了避免把 Key 明文写进配置文件。你需要设置# macOS / Linux写进 ~/.zshrc 或 ~/.bashrc export TAOTOKEN_API_KEYsk-你的TaoToken密钥 # Windows PowerShell临时生效 $env:TAOTOKEN_API_KEYsk-你的TaoToken密钥wire_api填chat表示走 OpenAI 的/chat/completions协议。DeepSeek V4 兼容这个协议填responses反而可能因为上游不支持而报错。model填deepseek-v4这是模型标识。如果你在 TaoToken 控制台看到的模型名带前缀或后缀以控制台显示的为准。注意改完config.toml后Codex 需要重启才会重新读取配置。如果你是在终端里跑codex直接退出再进即可。4. 用 CC Switch 切换供应商的完整步骤如果你不想手改 TOML或者需要在多个供应商之间来回切CC Switch 是更省心的选择。它的原理是帮你管理config.toml的写入切换时自动备份旧配置、写入新配置。4.1 安装与首次启动CC Switch 是开源工具从它的 release 页面下载对应平台的安装包即可。安装后首次启动它会自动检测你本地的~/.codex/config.toml如果存在就读取现有供应商列表不存在就创建一个空的。启动后主界面会列出当前已配置的供应商以及一个「当前激活」的标记。默认情况下如果你之前手改过配置这里会显示你手写的那个供应商。4.2 添加 DeepSeek 供应商点击「添加供应商」填写以下字段字段填写值名称DeepSeek V4自定义方便识别即可Base URLhttps://taotoken.net/apiAPI Keysk-你的TaoToken密钥模型deepseek-v4协议chatOpenAI 兼容填完后保存CC Switch 会把这个供应商写进它自己的配置库但此时还没有激活。你会在列表里看到新增的条目旁边有一个「激活」按钮。4.3 激活并写入 config.toml点击 DeepSeek V4 条目旁边的「激活」CC Switch 会做三件事备份当前的config.toml为config.toml.bak把model_provider改成deepseek把[model_providers.deepseek]段写入文件。激活成功后界面上的「当前激活」标记会移到 DeepSeek V4 上。这时候你打开~/.codex/config.toml看一眼应该能看到和上一节骨架一致的内容只是 Key 可能被 CC Switch 用环境变量或直接写入的方式处理取决于它的版本。4.4 打开路由开关部分版本的 CC Switch 有一个「路由开关」作用是启动一个本地代理把 Codex 的请求先转到本地再转发出去。如果你只是直连 TaoToken这个开关可以不开。开了的话base_url会被改成http://127.0.0.1:某端口多一层转发。我的建议是如果你网络环境直连 TaoToken 没问题就别开路由少一层故障点。如果开了记得在 CC Switch 里确认端口没被占用。4.5 重启 Codex 验证关掉所有 Codex 窗口重新打开。如果是 CLI直接在终端重新运行codex。启动后 Codex 会读取新的config.toml用 DeepSeek V4 作为默认模型。5. 发一次请求验证接入是否生效配置改完不代表生效必须发一次真实请求确认。有两种验证方式建议都做一遍。5.1 用 curl 直接打 TaoToken 接口这一步绕过 Codex直接验证 Key 和 base_url 是否可用curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: deepseek-v4, messages: [ {role: user, content: 用一句话说明什么是快速排序} ] }如果返回 JSON 里choices[0].message.content有内容说明 Key 和 base_url 都没问题。如果返回 401是 Key 错了返回 404是 base_url 路径拼错了返回 400 且提示 model 不存在是模型名写错了。5.2 在 Codex 里发一条真实请求打开 Codex输入一个需要模型回答的问题比如「帮我写一个 Python 函数判断一个数是否为质数」。观察返回内容。如果 Codex 正常返回了代码说明整条链路通了。如果 Codex 返回的是官方模型的回答风格或者提示模型不可用说明config.toml没被正确读取回到上一节检查model_provider和model字段。你也可以在 Codex 里输入/model如果版本支持查看当前使用的模型确认显示的是deepseek-v4。5.3 确认请求真的走了 DeepSeek一个简单的判断方法DeepSeek V4 在中文代码注释和中文解释上风格比较明显回答里如果出现比较自然的中文技术解释基本可以确认走的是 DeepSeek。另一个方法是去 TaoToken 控制台的用量页面看请求计数有没有增加增加的那条对应的模型是不是deepseek-v4。6. 本篇常见错误排查下面这些是我在配置过程中实际遇到过的报错按出现频率排序。报错一401 Unauthorized原因通常是环境变量没生效。Codex 读的是env_key指定的那个环境变量如果你在config.toml里写的是TAOTOKEN_API_KEY但终端里export的是别的名字就会 401。检查方法echo $TAOTOKEN_API_KEY如果输出为空说明没设置成功。注意 macOS 上如果你改的是~/.zshrc需要source ~/.zshrc或重开终端。报错二404 Not Found九成是base_url写错了。正确写法是https://taotoken.net/api不要加/v1不要加尾部斜杠。Codex 会自己在后面拼路径你多写一段它就拼成不存在的地址。报错三model not found或模型回退到默认检查model字段的值是否和 TaoToken 控制台里显示的模型名完全一致。有些控制台显示的是deepseek-v4有些带版本号后缀以控制台为准。另外确认model_provider和[model_providers.xxx]的xxx拼写一致。报错四CC Switch 激活后 Codex 没变化CC Switch 写的是~/.codex/config.toml但如果你设置了CODEX_HOME环境变量指向别的目录Codex 读的就不是这个文件。检查echo $CODEX_HOME如果有输出说明 Codex 的配置目录被改过你需要让 CC Switch 也指向那个目录或者把CODEX_HOME去掉。报错五请求超时DeepSeek V4 在长上下文场景下响应会慢一些默认超时可能不够。在config.toml里加一行request_timeout_ms 120000把超时提到 120 秒。如果还是超时检查网络到taotoken.net的连通性。报错六开了路由开关后连不上CC Switch 的路由开关会起一个本地代理如果端口被占用或者代理进程没起来Codex 会连不上。关掉路由开关直接用直连模式base_url改回https://taotoken.net/api。7. 接入之后Key 管理与长期使用建议配置跑通只是第一步长期用下去还有几件事值得做。Key 的管理建议集中在 TaoToken 控制台做。你可以为 Codex 单独生成一个 Key和别的工具用的 Key 分开这样某个 Key 泄露或额度异常时能单独吊销不影响其他工具。控制台的 API Keys 页面可以生成和吊销 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你打算在 Codex 里长期跑编码任务尤其是那种一次要改多个文件、跑好几轮的重构建议了解一下 Coding Plan。它针对长时间、多轮次的编码场景做了额度优化比按次调用更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content配置文件的备份也别忽略。CC Switch 激活时会自动备份config.toml.bak但如果你手改过建议自己再存一份。我习惯把可用的config.toml存到 dotfiles 仓库里换机器时直接拉下来改个 Key 就能用。最后如果你在接入过程中遇到本文没覆盖的报错可以先翻接入文档里面按错误码列了常见原因https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先确认 DeepSeek V4 在当前链路上的回答质量也可以直接在模型对话页面发几条测试请求不用改 Codex 配置就能验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content整套流程走下来核心其实就三件事base_url写对、Key 通过环境变量传进去、model_provider和model字段对齐。这三件事对了Codex 调 DeepSeek V4 就是稳定的。剩下的时间交给模型去写代码就行。