【Agent】不用折腾配置文件：用CCSwitch给Codex v0.81.0+ 接入 DeepSeek ：官方 DeepSeek 与 claw-cn（其他三方类似）

白萝卜弟弟

113人浏览 · 2026-06-26 21:59:30

白萝卜弟弟 · 2026-06-26 21:59:30 发布

本文面向已经安装 Codex CLI / Codex App，并希望在 Codex v0.81.0 及后续版本中使用 DeepSeek 模型的用户。教程以 CC Switch 作为配置工具，分别演示接入 DeepSeek 官方 API 与 claw-cn API 两种方式。

在这里插入图片描述

0. 本文最终效果

配置完成后，你可以在 Codex 中正常使用 DeepSeek 模型，例如：

╭────────────────────────────────────────────────────────╮
│ >_ OpenAI Codex (v0.142.2)                             │
│                                                        │
│ model:     deepseek-v4-flash   /model to change │
│ directory: ~/codex-project/demo                        │
╰────────────────────────────────────────────────────────╯

  Tip: New Build faster with the Codex App. Run 'codex app' or xxxx

⚠ MCP client for `node_repl` failed to start: MCP startup failed: No such file or directory (os error 2)

⚠ MCP startup incomplete (failed: node_repl)


› 你好


• 你好！有什么我可以帮你的吗？

最终效果包括：

Codex 可以正常调用 DeepSeek 模型；
Codex /model 中可以看到配置好的模型；
可以正常完成代码生成、代码解释、项目修改、Agent 任务；
可以在 DeepSeek 官方 API 和 claw-cn 两种方案之间切换；
通过 CC Switch 管理 API Key、Base URL、模型映射和本地路由。

注意：本文统一使用 deepseek-v4-flash 作为示例模型 ID。如果你使用的平台实际模型 ID 不同，请以平台控制台、模型列表或官方文档为准，将文中的 deepseek-v4-flash 替换成真实模型 ID。

整体调用链路如下：

在这里插入图片描述

Codex
  ↓
CC Switch 本地代理 / 路由转换
  ↓
DeepSeek 官方 API
或
claw-cn API

1. 为什么 Codex v0.81.0+ 接入 DeepSeek 需要特殊配置？

很多人一开始会以为：只要有 API Key 和 Base URL，Codex 就应该能直接调用第三方模型。

但新版 Codex 并不是这么简单。

1.1 Codex v0.81.0+ 的接口特点

Codex v0.81.0 及后续版本只能使用 OpenAI Responses API。

在 Codex 配置文件中，经常会看到类似配置：

wire_api = "responses"

这意味着 Codex 侧默认希望上游接口能够理解 Responses API 的请求格式。

但问题是，DeepSeek官方和很多第三方模型服务并不支持 Responses API，而是更常见的：

OpenAI Chat Completions API

也就是常见的：

/v1/chat/completions

1.2 DeepSeek 类接口和 Codex 的协议差异

简单理解：

角色	常见协议
Codex v0.81.0+	OpenAI Responses API
DeepSeek / 很多第三方平台	OpenAI Chat Completions API

两者虽然都属于 OpenAI 风格 API，但请求格式、返回格式、流式输出、工具调用、reasoning 参数等细节并不完全一样。

所以如果你直接把 DeepSeek 的接口地址填进 Codex，可能会遇到：

404；
模型不可用；
model not found；
请求格式错误；
流式输出异常；
Codex 识别不到模型。

这时候就需要 CC Switch 在中间做一层转换。

1.3 CC Switch 在中间做什么？

CC Switch 的作用不只是“切换 API Key”。

在 Codex 接第三方模型时，它主要做几件事：

管理 Codex 的 API Key；
管理 Base URL；
管理模型 ID；
管理模型映射；
开启本地代理；
接管 Codex 请求；
把 Codex 的 Responses 请求转换成上游的 Chat Completions 请求；
把上游返回结果再转换回 Codex 能识别的格式。

协议转换关系可以理解为：

在这里插入图片描述

Codex 发出 Responses 请求
  ↓
CC Switch 本地代理接收请求
  ↓
CC Switch 转换成 Chat Completions 请求
  ↓
发送给 DeepSeek / claw-cn
  ↓
上游返回结果
  ↓
CC Switch 转回 Responses 格式
  ↓
Codex 正常展示结果

2. 准备工作

正式配置前，需要准备三个东西：

Codex v0.81.0 或更高版本；
CC Switch；
对应平台的 API Key。

2.1 检查 Codex 版本

先在终端执行：

codex --version

确认你的 Codex 版本是：

codex-cli 0.142.2

或更高版本。

如果版本过低，建议先升级 Codex，再继续配置。

2.2 安装或更新 CC Switch

CC Switch 是一个用于管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具 API 配置的工具。

它可以帮你避免手动改配置文件，也能统一管理多个 Provider。

安装完成后，打开 CC Switch，确认界面中能看到 Codex 入口。

2.3 准备 API Key

本文会演示两种接入方式，因此你需要准备对应的 Key。

第一种：

DeepSeek 官方 API Key

第二种：

claw-cn API Key

注意：

API Key 不要泄露；
截图时一定要打码；
不要把真实 Key 写到文章、笔记、Git 仓库中；
DeepSeek 官方 Key 和 claw-cn Key 不要混用。

3. 核心配置概念：Base URL、模型 ID、本地路由映射

在正式配置前，先把几个关键概念讲清楚。

3.1 Base URL 是什么？

Base URL 就是 API 请求的基础地址。

本文涉及两个 Base URL。

DeepSeek 官方 API：

以 DeepSeek 官方文档 / 控制台为准

如果官方文档给的是：

https://api.deepseek.com

就按官方地址填写。

claw-cn API 固定为：

https://api.claw-cn.org/v1

注意，claw-cn 这里要带 /v1。

3.2 模型 ID 是什么？

模型 ID 就是你实际调用的模型名称。

本文统一使用：

deepseek-v4-flash

后面无论是 DeepSeek 官方方案，还是 claw-cn 方案，都以这个模型 ID 作为示例。

如果你的平台模型名称不同，比如平台实际显示的是其他模型 ID，需要替换成平台实际支持的模型名。

3.3 为什么要配置模型映射？

在这里插入图片描述

Codex 需要知道当前 Provider 下有哪些模型可以选。

CC Switch 的模型映射表，作用就是告诉 Codex：

这个 Provider 下有 deepseek-v4-flash 这个模型。

配置完成后，你在 Codex 中输入：

/model

就可以看到这个模型。

如果不配置模型映射，常见问题是：

/model 中看不到模型；
Codex 仍然使用默认模型；
报 model not found；
请求发出后上游不识别。

所以使用自定义模型 ID 时，模型映射非常关键。

3.4 为什么要开启“需要本地路由映射”？

在这里插入图片描述

原因有三个：

第一，deepseek-v4-flash 不是 OpenAI 官方 GPT 模型名。

第二，DeepSeek官方是 Chat Completions 协议，不支持Responses协议，其他三方上游大概率也是。

第三，开启本地路由后，CC Switch 可以自动帮 Codex 做协议转换。

也就是说：

Codex Responses 请求

会被 CC Switch 转成：

上游 Chat Completions 请求

这样才适合新版 Codex。

4. 方案一：接入 DeepSeek 官方 API

第一种方式是直接接入 DeepSeek 官方 API。

这种方式的优点是链路更清晰，账号、账单、额度都在 DeepSeek 官方控制台管理。

4.1 方案说明

DeepSeek 官方 API 适合下面这些用户：

只想使用 DeepSeek 模型；
希望使用官方通道；
希望账单和调用记录更清晰；
不想依赖第三方中转平台；
已经有 DeepSeek 官方 API Key。

本文示例模型：

deepseek-v4-flash

如果 DeepSeek 官方控制台中的模型 ID 和本文不同，请以官方实际模型 ID 为准。

4.2 配置参数总览

DeepSeek 官方方案的核心配置如下：

Provider 名称：DeepSeek Official
Base URL：以 DeepSeek 官方文档 / 控制台为准
模型 ID：deepseek-v4-flash
需要本地路由映射：开启

如果官方文档提供的 Base URL 是：

https://api.deepseek.com

那么就填写：

https://api.deepseek.com

4.3 在 CC Switch 中添加 DeepSeek 官方 Provider

打开 CC Switch，进入：

CC Switch → Codex → Add Provider / 添加供应商

这里有两种方式。

第一种：如果 CC Switch 里有 DeepSeek 预设，可以直接选择 DeepSeek 预设。

第二种：如果你想完全手动配置，也可以选择自定义 Provider。

建议新手优先使用预设。如果预设里的模型和你要用的模型 ID 不一致，再手动修改模型映射。

配置时填写：

名称：DeepSeek Official
API Key：你的 DeepSeek 官方 API Key
Base URL：DeepSeek 官方 Base URL
需要本地路由映射：开启

4.4 配置模型映射

接下来配置模型映射。

模型映射表中填写：

模型 ID：deepseek-v4-flash
显示名称：DeepSeek V4 Flash - Official
上下文窗口：按实际支持填写

其中最关键的是模型 ID：

deepseek-v4-flash

显示名称可以自定义，建议带上来源，比如：

DeepSeek V4 Flash - Official

这样后面和 claw-cn 的模型区分更清楚。

上下文窗口如果不确定，可以先按平台说明填写；如果 CC Switch 允许为空，也可以先留空，后续再补。

4.5 开启本地代理和 Codex 接管

配置完 Provider 后，还需要开启 CC Switch 的本地代理。

通常在 CC Switch 顶部或设置中可以看到代理开关。

在这里插入图片描述

开启后，默认本地代理地址一般是：

http://127.0.0.1:15721

你需要确认两件事：

CC Switch 本地代理：已开启
DeepSeek Official Provider：已启用

开启 Codex 接管后，Codex 的请求会先发到 CC Switch 本地代理，再由 CC Switch 转发到 DeepSeek 官方 API。

这时候 Codex 配置文件里看到的 Base URL 可能不是 DeepSeek 官方地址，而是本地代理地址，例如：

http://127.0.0.1:15721/v1

这是正常现象，不要手动改回去。

4.6 重启 Codex 并测试

模型映射修改后，需要重启 Codex。

操作步骤：

关闭当前 Codex；
重新打开 Codex；
在 Codex 中输入：

/model

如果配置正确，应该能看到：

DeepSeek V4 Flash - Official

然后可以输入一个简单问题提问：

hi

如果 Codex 能正常返回代码，说明 DeepSeek 官方 API 接入成功。

5. 方案二：接入 claw-cn

第二种方式是通过 claw-cn 接入 DeepSeek。

这种方式适合已经有 claw-cn API Key，或者希望通过统一入口管理多个模型的用户。

5.1 方案说明

claw-cn 的 Base URL 固定为：

https://api.claw-cn.org/v1

本文仍然统一使用模型 ID：

deepseek-v4-flash

这种方式适合：

已经有 claw-cn API Key；
希望使用统一 API 入口；
想通过一个平台管理多个模型；
希望在 Codex 中快速切换模型；
需要国内访问体验或更方便的中转服务。

5.2 配置参数总览

claw-cn 方案的核心参数如下：

Provider 名称：Claw CN DeepSeek
Base URL：https://api.claw-cn.org/v1
模型 ID：deepseek-v4-flash
API Format：OpenAI Chat Completions
需要本地路由映射：开启

这里注意：

https://api.claw-cn.org/v1

不要写成：

https://api.claw-cn.org

也不要额外拼成：

https://api.claw-cn.org/v1/chat/completions

在 CC Switch 中填写 Base URL 时，填：

https://api.claw-cn.org/v1

即可。

5.3 在 CC Switch 中添加 claw-cn 自定义 Provider

打开 CC Switch，进入：

CC Switch → Codex → Add Provider → Custom / 自定义

填写以下内容：

名称：Claw CN DeepSeek
API Key：你的 claw-cn API Key
Base URL：https://api.claw-cn.org/v1
需要本地路由映射：开启

因为 claw-cn 是自定义第三方入口，所以建议使用自定义 Provider，而不是套用其他平台预设。

5.4 配置 claw-cn 模型映射

claw-cn 方案同样需要配置模型映射。

填写：

模型 ID：deepseek-v4-flash
显示名称：DeepSeek V4 Flash - Claw CN
上下文窗口：按 claw-cn 平台说明填写

建议显示名称写成：

DeepSeek V4 Flash - Claw CN

这样在 Codex /model 中可以清楚区分：

eepSeek V4 Flash - Official
DeepSeek V4 Flash - Claw CN

如果你只配置 claw-cn 一种方式，也可以简单写成：

DeepSeek V4 Flash

但为了后续对比和排错，建议加上来源。

5.5 开启本地代理和 Codex 接管

和官方 DeepSeek 方案一样，claw-cn 方案也需要开启本地代理和 Codex 接管。

确认以下状态：

CC Switch 代理服务：开启
Claw CN DeepSeek Provider：启用

代理地址通常是：

http://127.0.0.1:15721

开启后，Codex 的请求链路会变成：

Codex
  ↓
CC Switch 本地代理
  ↓
https://api.claw-cn.org/v1
  ↓
deepseek-v4-flash

5.6 重启 Codex 并测试 claw-cn

配置完成后，同样需要重启 Codex。

步骤：

关闭当前 Codex；
重新打开 Codex；
输入：

/model

检查是否能看到：

DeepSeek V4 Flash - Claw CN

然后输入测试任务：

hi

如果 Codex 能正常返回结果，说明 claw-cn 方案配置成功。

6. 两种方案配置对比

下面把 DeepSeek 官方 API 和 claw-cn 两种方式做一个对比。

在这里插入图片描述

6.1 配置项对比

对比项	DeepSeek 官方 API	claw-cn
接入地址	DeepSeek 官方 Base URL	`https://api.claw-cn.org/v1`
API Key 来源	DeepSeek 官方控制台	claw-cn 平台
示例模型	`deepseek-v4-flash`	`deepseek-v4-flash`
Provider 类型	DeepSeek 预设或自定义	自定义 Provider
API Format	OpenAI Chat Completions	OpenAI Chat Completions
是否开启本地路由映射	开启	开启
是否开启 Codex 接管	需要	需要
是否需要重启 Codex	需要	需要
适合人群	偏官方、偏稳定、账单清晰	偏统一入口、多模型管理、国内接口体验

7. Codex 配置文件说明

使用 CC Switch 后，一般不需要手动修改 Codex 配置文件。

但了解一下配置文件位置，有助于排错。

7.1 Codex 配置文件位置

Codex 主要涉及两个配置文件：

~/.codex/auth.json
~/.codex/config.toml

其中：

auth.json

主要保存 API Key 相关信息。

config.toml

主要保存模型、Provider、Base URL、协议类型等配置。

7.2 CC Switch 会写入什么？

通过 CC Switch 配置 Codex 后，它可能会写入：

API Key；
当前 Provider；
当前模型；
Base URL；
wire_api = "responses"；
model_catalog_json；
本地代理地址。

其中，模型映射通常会转换成 Codex 可识别的模型列表。

所以你在 CC Switch 中添加的：

deepseek-v4-flash

会被写入 Codex 的模型配置中，这样 Codex /model 才能看到它。

7.3 配置效果示意

开启 CC Switch 本地代理和 Codex 接管后，Codex 配置里看到的 Base URL 可能是：

base_url = "http://127.0.0.1:15721/v1"
wire_api = "responses"

而不是：

https://api.claw-cn.org/v1

或者 DeepSeek 官方地址。

这是正常的。

因为 Codex 实际上是先请求本地代理：

http://127.0.0.1:15721/v1

再由 CC Switch 转发到真正的上游接口。

所以不要看到本地地址就以为配置错了。

8. 常见问题与排错

下面整理几个常见问题。

在这里插入图片描述

8.1 `/model` 里看不到 `deepseek-v4-flash`

优先检查：

是否配置了模型映射；
模型 ID 是否填写为：

deepseek-v4-flash

Provider 是否保存成功；
当前 Provider 是否已启用；
Codex 接管是否开启；
修改模型映射后是否重启 Codex。

很多情况下，问题出在最后一步：

改完模型映射后没有重启 Codex。

Codex 的模型列表通常在启动时加载，所以改完后建议重启。

8.2 报 404

如果出现 404，重点检查 Base URL。

claw-cn 方案必须填写：

https://api.claw-cn.org/v1

不要写成：

https://api.claw-cn.org

也不要写成：

https://api.claw-cn.org/v1/chat/completions

另外还要检查：

是否开启“需要本地路由映射”；
是否开启 CC Switch 本地代理；

8.3 报 `model not found`

如果报：

model not found

重点检查模型 ID。

本文示例统一使用：

deepseek-v4-flash

请确认：

模型映射里是这个名字；
当前选择的模型也是这个名字；
上游平台确实支持这个模型；
当前启用的是正确 Provider；
DeepSeek 官方 Key 没有填到 claw-cn Provider；
claw-cn Key 没有填到 DeepSeek 官方 Provider。

8.4 报 unauthorized / invalid api key

如果报认证失败，通常是 API Key 问题。

检查：

Key 是否复制完整；
Key 前后是否有空格；
Key 是否属于当前平台；
DeepSeek 官方 Key 不要填到 claw-cn；
claw-cn Key 不要填到官方 DeepSeek；
Key 是否被禁用；
账号余额或额度是否正常。

截图或分享配置时，务必把 Key 打码。

8.5 代理开启后仍然不生效

检查：

CC Switch 本地代理是否真的运行中；
Codex 接管是否开启；
当前启用的是否是正确 Provider；
Codex 是否已经重启；
是否有多个 Codex 配置目录；
当前终端读取的是否是旧配置；
是否存在手动修改配置导致冲突。

可以尝试：

关闭 Codex → 确认 CC Switch Provider 启用 → 确认代理开启 → 重新打开 Codex

8.6 输出中断或响应慢

如果能连上，但输出慢或中断，可以检查：

上游服务是否限流；
网络是否稳定；
模型是否繁忙；
当前 API Key 是否额度不足；
CC Switch 请求日志中是否有错误；
换官方 DeepSeek 或 claw-cn 互相对比测试。

如果官方 DeepSeek 正常、claw-cn 异常，可能是 claw-cn 或其上游状态问题。

如果 claw-cn 正常、官方 DeepSeek 异常，可能是官方 API Key、官方额度或网络问题。

9. 总结

Codex v0.81.0 及后续版本接入 DeepSeek，关键不是只填一个 API Key。

真正要处理好的是这几个点：

Base URL
模型 ID
API Format
模型映射
本地路由映射
Codex 接管

本文演示了两种方式。

第一种是 DeepSeek 官方 API：

Provider：DeepSeek Official
模型 ID：deepseek-v4-flash
API Format：OpenAI Chat Completions
需要本地路由映射：开启
Codex 接管：开启

第二种是 claw-cn：

Provider：Claw CN DeepSeek
Base URL：https://api.claw-cn.org/v1
模型 ID：deepseek-v4-flash
API Format：OpenAI Chat Completions
需要本地路由映射：开启
Codex 接管：开启

如果你已经有 claw-cn Key，或者想使用统一入口管理多个模型，可以选择：

https://api.claw-cn.org/v1

最后再强调一次：

配置完模型映射后，一定要重启 Codex。

否则 /model 中可能看不到新模型。

智能体开发者社区

中国智能体开发者社区，聚焦智能体与大模型开发，提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动，促进经验交流与协作，助力开发者快速构建创新智能应用。

更多推荐

主流大模型矩阵对比（Claude/Codex/Gemini 等）

智能体开发者社区

GPT-6 来了，这次可能会重新定义 ChatGPT 的用法

帮我写一篇 CSDN 风格文章，标题是《GPT-6 来了，这次可能会重新定义 ChatGPT 的用法》，读者是程序员和 AI 用户，前半段讲趋势，中间讲使用场景，后半段自然带出 Plus、Pro、Codex，不要太硬广，语气像经验分享。你说“写给程序员看”，它要知道不能写太小白，要讲真实开发场景，比如调试、重构、测试、接口、项目维护。真实开发里面，有需求分析、项目理解、代码结构、接口设计、异常处理

智能体开发者社区

OpenClaw 入门：如何自建一个 Skill

摘要：Skill是AI的插件功能，让AI具备特定能力（如查天气）。自建Skill只需三步：创建技能文件夹、添加SKILL.md文件（纯Markdown编写规则）、重启AI即可生效。示例展示了如何创建鼓励回复的Skill，强调文件名必须全大写。进阶可扩展工具调用和模板功能。整个过程无需编程，适合快速定制AI行为。

智能体开发者社区

所有评论(0)

查看更多评论

白萝卜弟弟

@stxyg

已为社区贡献2条内容

【Agent】不用折腾配置文件：用CCSwitch给Codex v0.81.0+ 接入 DeepSeek ：官方 DeepSeek 与 claw-cn（其他三方类似）

白萝卜弟弟

0. 本文最终效果

1. 为什么 Codex v0.81.0+ 接入 DeepSeek 需要特殊配置？

1.1 Codex v0.81.0+ 的接口特点

1.2 DeepSeek 类接口和 Codex 的协议差异

1.3 CC Switch 在中间做什么？

2. 准备工作

2.1 检查 Codex 版本

2.2 安装或更新 CC Switch

2.3 准备 API Key

3. 核心配置概念：Base URL、模型 ID、本地路由映射

3.1 Base URL 是什么？

3.2 模型 ID 是什么？

3.3 为什么要配置模型映射？

3.4 为什么要开启“需要本地路由映射”？

4. 方案一：接入 DeepSeek 官方 API

4.1 方案说明

4.2 配置参数总览

4.3 在 CC Switch 中添加 DeepSeek 官方 Provider

4.4 配置模型映射

4.5 开启本地代理和 Codex 接管

4.6 重启 Codex 并测试

5. 方案二：接入 claw-cn

5.1 方案说明

5.2 配置参数总览

5.3 在 CC Switch 中添加 claw-cn 自定义 Provider

5.4 配置 claw-cn 模型映射

5.5 开启本地代理和 Codex 接管

5.6 重启 Codex 并测试 claw-cn

6. 两种方案配置对比

6.1 配置项对比

7. Codex 配置文件说明

7.1 Codex 配置文件位置

7.2 CC Switch 会写入什么？

7.3 配置效果示意

8. 常见问题与排错

8.1 /model 里看不到 deepseek-v4-flash

8.2 报 404

8.3 报 model not found

8.4 报 unauthorized / invalid api key

8.5 代理开启后仍然不生效

8.6 输出中断或响应慢

9. 总结

所有评论(0)

温馨提示：您尚未绑定手机号

白萝卜弟弟

8.1 `/model` 里看不到 `deepseek-v4-flash`

8.3 报 `model not found`