不用CCswitch：让 Codex 直连 DeepSeek，并支持v4-pro

一、先安装 Codex CLI

macOS / Linux

官方一键安装脚本：

Windows

在 PowerShell 中执行：

使用 npm 安装

如果你的电脑已经安装 Node.js，也可以使用：

使用 Homebrew 安装（macOS）

安装完成后，新开一个终端窗口，检查是否安装成功：

如果能正常输出版本号，说明 Codex 已经安装完成。

二、准备 DeepSeek API Key

1. 打开 DeepSeek 开放平台：https://platform.deepseek.com/
2. 登录后进入「API Keys」页面。
3. 创建一个新的 API Key，并保存好。
4. 后面配置里的 sk-******* 要替换成你自己的真实 Key。

三、创建 .codex 配置目录

Codex 默认读取用户目录下的 ~/.codex/config.toml。

macOS / Linux

Windows

在资源管理器或终端中创建：

然后在 .codex 目录下新建 config.toml 文件，写入下面的内容。

四、写入 DeepSeek 配置

保存后，重新启动 Codex 即可。

五、关键字段说明

model

这里使用 DeepSeek 的模型 ID。deepseek-v4-pro 就是 V4 Pro 模型的调用名称；如果你想用轻量模型，也可以改成 deepseek-v4-flash。

model_provider

指定使用哪个 Provider，必须和下面 [model_providers.deepseek] 中的 deepseek 对应。

[model_providers.deepseek]

定义一个名为 deepseek 的自定义供应商。

base_url

DeepSeek 的 API 地址，这里使用：

注意不要照搬某些教程里的 /v1，除非你使用的网关或中转服务明确要求加上。

experimental_bearer_token

填你的 DeepSeek API Key，也就是替换掉示例中的 sk-*******。

如果你不想把 Key 明文写在配置文件里，也可以改用环境变量：

然后在终端中设置：

wire_api

responses 表示使用 OpenAI Responses API。DeepSeek V4 Pro 现在支持这个接口，Codex 用起来会更顺。

requires_openai_auth

false 表示不需要 OpenAI 登录。这就是为什么可以跳过 OpenAI 账号，直接连接 DeepSeek。

六、验证是否配置成功

在终端中运行：

进入 Codex 后，确认它使用的是 deepseek 这个 Provider 和 deepseek-v4-pro 模型。如果能看到模型信息，或者可以正常对话，就说明直连成功了。

你也可以先做一次简单测试：

七、常见问题

1. 提示 command not found: codex

通常是安装后没有新开终端，或者终端环境变量没有刷新。可以先关闭终端重新打开，再执行 codex --version。

2. 提示 401 或鉴权失败

检查 experimental_bearer_token 是否写成了真实 Key，以及 DeepSeek 账户是否还有余额。

3. 提示找不到 deepseek-v4-pro

确认模型名没有拼错，同时把 Codex 升级到较新版本。旧版本可能对 Responses API 或自定义 Provider 支持不完整。

4. 配置没有生效

确认文件路径是用户目录下的 ~/.codex/config.toml，而不是项目目录里的 .codex/config.toml。供应商和认证配置建议放在用户级配置中。

5. Windows 找不到配置目录

使用当前用户的目录：

八、总结

这套方案的核心就是 Codex 原生支持自定义 model_providers。只要 DeepSeek 提供 OpenAI 兼容接口，我们就可以用 config.toml 直接指定 DeepSeek 作为模型供应商。

整个过程不需要 cc-switch，不需要 OpenAI 账号，也不需要本地代理转换。把 model 设置为 deepseek-v4-pro，并让 wire_api = "responses"，Codex 就可以在国内直连 DeepSeek 了。

提示：本文示例中的 API Key 请替换为你自己的真实 Key，并妥善保管，不要提交到公开仓库。