【Agent】不用折腾配置文件：用 CCSwitch 给 Codex 接入 DeepSeek / claw-cn 第三方大模型

不用折腾配置文件：用 CCSwitch 给 Codex 接入 DeepSeek / claw-cn 第三方大模型

面向小白的 5 分钟上手教程。目标很简单：让 Codex 能用上第三方大模型，不用一上来就研究复杂配置。

很多人第一次用 Codex，会卡在"模型怎么配置"这一步：

配置文件在哪里？
API Key 填到哪里？
Base URL 是什么？
为什么别人能用 DeepSeek，我这里一直报错？

如果你是小白，不建议一开始就手动改一堆配置文件。更简单的方式是使用 CCSwitch。

CCSwitch 是一个图形化配置工具，可以统一管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的模型配置。你只需要在界面里填好：

API 地址
API Key
模型名称

然后点击启用，重启 Codex，就可以开始使用。

本文主要演示两个第三方模型接口：

DeepSeek 官方接口
claw-cn 接口：https://api.claw-cn.org

重要补充：Codex 0.81.0 及以上版本默认走 /v1/responses 接口，而 DeepSeek 官方没有这个接口。如果你直接配置 DeepSeek 后遇到 /responses、404、接口不存在等报错，可以优先使用 https://api.claw-cn.org/v1 这类兼容接口，或者确保 CCSwitch / 配置文件里选择的是 chat / OpenAI Compatible。

一、你需要先准备什么？

开始之前，先确认你手上有这几样东西。

1. 已经安装 Codex

如果你已经能在终端里运行：

bash 复制代码

codex

说明 Codex 已经安装好了。

如果还没有安装，先去安装 Codex CLI，再回来继续配置。

2. 已经安装 CCSwitch

CCSwitch 是本文推荐的小白配置方式。

它的作用可以简单理解为：

帮你用图形化界面管理 Codex 的模型配置，不用自己手动改配置文件。

安装好之后，打开 CCSwitch，后面我们会在里面添加 Codex 的模型配置。

3. 准备 API Key

你需要提前准备好第三方平台的 API Key。

如果你用 DeepSeek：

text 复制代码

平台：DeepSeek
API 地址：https://api.deepseek.com/v1
模型名称：deepseek-v4-flash
API Key：从 DeepSeek 控制台获取

如果你用 claw-cn：

text 复制代码

平台：claw-cn
API 地址：https://api.claw-cn.org/v1
模型名称：以平台支持的模型名为准，可先尝试 deepseek-v4-flash
API Key：从 claw-cn 平台获取

注意：如果平台给你的地址是：

text 复制代码

https://api.claw-cn.org

在 Codex 这类 OpenAI 兼容工具里，通常建议写成：

text 复制代码

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

因为大多数 OpenAI 兼容接口都需要 /v1。

二、先确认一个关键点：Codex 版本和接口类型

如果你使用的是 Codex 0.81.0 或更新版本，这里有一个很容易踩坑的地方：

text 复制代码

Codex 0.81.0+ 默认走 /v1/responses
DeepSeek 官方接口没有 /v1/responses
所以可能会出现 404、接口不存在、responses 不支持等问题

这不是你的 API Key 填错了，也不一定是模型不能用，而是接口类型不匹配。

小白可以这样理解：

/v1/chat/completions：很多第三方平台都支持，通常叫 Chat / OpenAI Compatible
/v1/responses：OpenAI 新接口，一些第三方平台不一定支持

所以本文推荐两种处理方式：

方式 A：在 CCSwitch 里选择 Chat / OpenAI Compatible

配置 DeepSeek 时，尽量选择：

text 复制代码

API 类型：Chat / OpenAI Compatible
Wire API：chat

这样 Codex 会尽量按 Chat Completions 方式调用。

方式 B：如果 DeepSeek 直连仍然报错，改用 claw-cn

如果 Codex 0.81.0+ 直连 DeepSeek 官方接口无法正常工作，可以使用：

text 复制代码

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

它更适合作为 Codex 新版本下的兼容接口。本文后面会给出 claw-cn 的配置。

三、整体流程先看一遍

整个流程其实就 6 步：

准备 API Key
打开 CCSwitch
添加 Codex Provider
填入 Base URL、API Key、Model
启用配置，并重启 Codex
在 Codex 里测试是否成功

你不需要先理解所有底层原理，先照着跑通最重要。

四、推荐方式：用 CCSwitch 配置 Codex

第 1 步：打开 CCSwitch

打开 CCSwitch 后，找到和 Codex 相关的配置区域。

一般会有类似入口：

text 复制代码

Codex
Provider
Add Provider
新增配置
添加服务商

不同版本界面文案可能略有差异，但核心就是：

给 Codex 新增一个模型服务商配置。

第 2 步：添加 DeepSeek 配置

如果你想让 Codex 使用 DeepSeek，可以新增一个 Provider，按下面填写。

text 复制代码

名称：DeepSeek
Base URL：https://api.deepseek.com/v1
API Key：填写你的 DeepSeek API Key
Model：deepseek-v4-flash
API 类型：Chat / OpenAI Compatible
Wire API：chat

如果界面里没有 Wire API 这个选项，也不用慌，很多图形化工具会自动帮你处理。你重点确认这三项就行：

text 复制代码

Base URL
API Key
Model

填好之后，点击：

text 复制代码

保存 / Save
启用 / Enable

然后关闭当前 Codex，再重新打开 Codex。

小白重点：切换模型配置后，建议重启 Codex。这样可以避免配置没有及时生效。

第 3 步：添加 claw-cn 配置

如果你想使用 claw-cn 接口，也可以新增一个 Provider。

配置如下：

text 复制代码

名称：claw-cn
Base URL：https://api.claw-cn.org/v1
API Key：填写你的 claw-cn API Key
Model：deepseek-v4-flash 或 claw-cn 平台提供的模型名
API 类型：Chat / OpenAI Compatible
Wire API：chat

这里最容易出错的是 模型名称。

如果你填 deepseek-v4-flash 不能用，不代表接口一定有问题，可能是 claw-cn 平台给你的模型名不是这个。

这时候去平台后台查看支持的模型 ID，然后复制准确名称。

记住：

text 复制代码

模型名不要猜，直接复制平台后台给的模型 ID。

五、DeepSeek 和 claw-cn 配置对照

为了方便复制，这里再整理成对照表。

DeepSeek

text 复制代码

名称：DeepSeek
Base URL：https://api.deepseek.com/v1
API Key：你的 DeepSeek API Key
Model：deepseek-v4-flash
Wire API：chat

claw-cn

text 复制代码

名称：claw-cn
Base URL：https://api.claw-cn.org/v1
API Key：你的 claw-cn API Key
Model：deepseek-v4-flash 或平台提供的模型 ID
Wire API：chat

如果你只是想先跑通，建议先用 DeepSeek 的 deepseek-v4-flash，因为配置更明确。

跑通之后，再配置 claw-cn 做备用或切换。

六、启动 Codex 测试是否成功

配置启用后，重新打开终端，运行：

bash 复制代码

codex

进入 Codex 后，可以输入一个简单问题测试：

text 复制代码

你好，请用一句话介绍你自己。

或者测试代码能力：

text 复制代码

请帮我写一个 Python 快速排序示例。

如果 Codex 能正常回复，说明配置已经成功。

如果报错，不要慌，继续看下面的排查部分。

七、DeepSeek 和 claw-cn 怎么选？

选 DeepSeek，如果你：

想直接使用 DeepSeek 官方接口
主要写中文内容、代码、脚本
想先用一个明确、简单的配置跑通 Codex

DeepSeek 的好处是配置清晰：

text 复制代码

Base URL：https://api.deepseek.com/v1
Model：deepseek-v4-flash

适合新手第一步上手。

选 claw-cn，如果你：

使用 Codex 0.81.0 或更新版本，直连 DeepSeek 遇到 /v1/responses 问题
已经有 claw-cn 的 API Key
想通过一个接口接入更多第三方模型
想作为 DeepSeek 之外的备用线路

claw-cn 的关键是确认平台支持的模型名称。

text 复制代码

Base URL：https://api.claw-cn.org/v1
Model：以平台后台为准

如果模型名填错，就算 API Key 和地址都对，也可能无法调用。

八、备用方式：手动修改 Codex 配置

如果你不想用 CCSwitch，也可以手动改 Codex 配置文件。

但对小白来说，优先推荐 CCSwitch。

手动配置文件路径是：

bash 复制代码

~/.codex/config.toml

如果文件不存在，可以创建：

bash 复制代码

mkdir -p ~/.codex
nano ~/.codex/config.toml

DeepSeek 手动配置

把下面内容写入 ~/.codex/config.toml：

toml 复制代码

model = "deepseek-v4-flash"
model_provider = "deepseek"

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "chat"

然后在终端设置 API Key：

bash 复制代码

export DEEPSEEK_API_KEY="你的 DeepSeek API Key"

再运行：

bash 复制代码

codex

claw-cn 手动配置

把下面内容写入 ~/.codex/config.toml：

toml 复制代码

model = "deepseek-v4-flash"
model_provider = "claw_cn"

[model_providers.claw_cn]
name = "claw-cn"
base_url = "https://api.claw-cn.org/v1"
env_key = "CLAW_CN_API_KEY"
wire_api = "chat"

然后设置 API Key：

bash 复制代码

export CLAW_CN_API_KEY="你的 claw-cn API Key"

再运行：

bash 复制代码

codex

如果 deepseek-v4-flash 不可用，就把 model 改成 claw-cn 平台后台提供的模型 ID。

九、API Key 怎么长期保存？

如果你用的是手动配置，每次打开终端都 export 会比较麻烦。

可以把 API Key 写入 shell 配置文件。

macOS / Linux，zsh 用户

bash 复制代码

echo 'export DEEPSEEK_API_KEY="你的 DeepSeek API Key"' >> ~/.zshrc
source ~/.zshrc

macOS / Linux，bash 用户

bash 复制代码

echo 'export DEEPSEEK_API_KEY="你的 DeepSeek API Key"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

powershell 复制代码

setx DEEPSEEK_API_KEY "你的 DeepSeek API Key"

如果你用 claw-cn，就把变量名换成：

text 复制代码

CLAW_CN_API_KEY

安全提醒：

不要把 API Key 发到群里
不要把 API Key 截图发到网上
不要把 API Key 提交到 GitHub
如果怀疑泄露，立刻去平台后台重置

十、最后总结

如果你是小白，记住这 4 个东西就够了：

1. Base URL

DeepSeek：

text 复制代码

https://api.deepseek.com/v1

claw-cn：

text 复制代码

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

2. API Key

从对应平台后台获取，不同平台的 Key 不要混用。

3. Model

DeepSeek 可以先用：

text 复制代码

deepseek-v4-flash

claw-cn 以平台后台支持的模型名为准。

4. 启用后重启 Codex

在 CCSwitch 里切换配置后，建议关闭并重新打开 Codex。

5. Codex 新版本优先注意 `/responses` 问题

如果 Codex 0.81.0+ 直连 DeepSeek 报 /v1/responses 相关错误（因为 DeepSeek 官方没有这个接口），优先检查 API 类型是否为 chat；如果仍然不行，就使用：

text 复制代码

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

一句话版操作流程

打开 CCSwitch → 添加 Codex Provider → 填入 Base URL、API Key、Model → 点击启用 → 重启 Codex → 测试能否正常回复。

如果只是想快速用起来，不需要一开始就研究太多配置原理。先用 CCSwitch 跑通 DeepSeek，再根据需要配置 claw-cn，就已经足够日常使用了。

【Agent】不用折腾配置文件：用 CCSwitch 给 Codex 接入 DeepSeek / claw-cn 第三方大模型

不用折腾配置文件：用 CCSwitch 给 Codex 接入 DeepSeek / claw-cn 第三方大模型

一、你需要先准备什么？

1. 已经安装 Codex

2. 已经安装 CCSwitch

3. 准备 API Key

二、先确认一个关键点：Codex 版本和接口类型

方式 A：在 CCSwitch 里选择 Chat / OpenAI Compatible

方式 B：如果 DeepSeek 直连仍然报错，改用 claw-cn

三、整体流程先看一遍

四、推荐方式：用 CCSwitch 配置 Codex

第 1 步：打开 CCSwitch

第 2 步：添加 DeepSeek 配置

第 3 步：添加 claw-cn 配置

五、DeepSeek 和 claw-cn 配置对照

DeepSeek

claw-cn

六、启动 Codex 测试是否成功

七、DeepSeek 和 claw-cn 怎么选？

选 DeepSeek，如果你：

选 claw-cn，如果你：

八、备用方式：手动修改 Codex 配置

DeepSeek 手动配置

claw-cn 手动配置

九、API Key 怎么长期保存？

macOS / Linux，zsh 用户

macOS / Linux，bash 用户

Windows PowerShell

十、最后总结

1. Base URL

2. API Key

3. Model

4. 启用后重启 Codex

5. Codex 新版本优先注意 /responses 问题

一句话版操作流程

5. Codex 新版本优先注意 `/responses` 问题