本文基于 B站视频「如何使用第三方模型驱动 Codex（无需 OpenAI 账号）」by 马克的技术工作坊，结合多方资料整理而成。

目录

一、前言：为什么需要这个方案？

Codex 是 OpenAI 推出的 AI 编程助手，支持 CLI（命令行）、IDE 插件和云端三种使用方式，集代码生成、解释、调试、重构于一体。随着 GPT-5-Codex 模型的发布，其编程能力大幅提升，已成为开发者的重要工具。

但国内用户直接使用 Codex 面临两大门槛：

  1. 账号门槛：官方版本需要 ChatGPT Plus / Pro / Team 订阅账号（$20/月起）才能登录使用
  1. 网络门槛：国内网络访问 OpenAI 服务经常遇到连接超时、502 错误等问题

本教程的方案：通过 CC Switch 工具，在本地搭建一个协议转换层，将 Codex 的请求转发到 DeepSeek 的 API。全程无需 OpenAI 账号、无需翻墙、成本极低。

二、核心原理：CC Switch 是如何工作的？

很多人配置失败，根源在于没搞清楚数据链路。

问题所在：协议不兼容

Codex 使用的是 OpenAI Responses API（/responses），而 DeepSeek 等国产模型走的是 Chat Completions API（/chat/completions）。两种协议的请求体、流式事件、返回结构完全不同，直接填地址当然不行。

CC Switch 的解决方案

CC Switch 在本地搭建一个「翻译层」，让 Codex 以为自己在跟 OpenAI 对话，实际请求全部转给 DeepSeek。

改造后的完整链路：

Codex → CC Switch 本地代理 (127.0.0.1:15721) → DeepSeek 官方 API → 结果回传

整个过程对 Codex 完全透明，它根本不知道背后换了供应商。所有 Codex 命令、插件、自动补全等生态功能无需任何适配。

三、准备工作

在开始之前，请确保以下三项资源已就绪：

序号

资源

说明

1

Node.js >= 22

Codex CLI 的必需依赖，下载地址

2

Codex

OpenAI 官方 AI 编程客户端

3

CC Switch

AI 编程工具统一管理路由器，GitHub 下载页

4

DeepSeek API Key

从 DeepSeek 开放平台 获取，当前有免费额度

检查 Node.js 版本

node -v
# 应输出 v22.x.x 或更高版本

如果版本低于 22，请先升级：

  • macOS：brew install node@22
  • Linux：使用 nvm nvm install 22 && nvm use 22

四、第一步：安装 Codex

方式一：通过 npm 安装 CLI 版（推荐）

# 全局安装 Codex CLI
npm install -g @openai/codex

# 国内网络慢？使用淘宝镜像加速
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 验证安装
codex --version
# 输出类似 0.42.0 即表示安装成功

方式二：通过 Homebrew 安装（macOS）

brew update
brew install codex
codex --version

方式三(推荐)：下载桌面版（适合新手）

访问 OpenAI Codex 官网，根据系统下载对应安装包：

  • Windows：下载 .exe 安装包，双击安装
  • macOS：下载 .dmg 镜像包，拖入应用程序文件夹

安装后的现象

安装完成后，在终端运行 codex，会弹出浏览器要求使用 OpenAI 账号登录。国内用户因为没有账号，此时无法继续使用——这正是我们需要 CC Switch 的原因。

注意：先不要关闭这个窗口，后续配置完 CC Switch 后重启 Codex 即可自动登录。

五、第二步：获取 DeepSeek API Key

  1. 访问 DeepSeek 开放平台：DeepSeek
  1. 注册并登录 DeepSeek 账号（支持手机号注册）
  1. 完成实名认证
  1. 进入 API Key 管理页面，点击「创建 API Key」
  1. 填写一个便于识别的名称（如 Codex），确认后系统会生成一串密钥
sk-xxxxxxxxxxxxxxxxxxxx

重要提示：API Key 仅在创建时完整显示一次，请务必立即复制到记事本或密码管理器中保存。若遗失只能删除旧 Key 重新创建。

DeepSeek 当前提供免费额度，完全覆盖个人日常开发调试使用。

六、第三步：安装并配置 CC Switch

6.1 下载 CC Switch

访问 CC Switch 的 GitHub Releases 页面：

Releases · farion1231/cc-switch · GitHub

根据系统下载最新版本：

平台

安装包

Windows

.exe 安装包，双击安装

macOS

.dmg 镜像包，拖入应用程序文件夹

Linux (Ubuntu/Debian)

sudo dpkg -i CC-Switch-*.deb

Linux (Fedora/RHEL)

sudo rpm -i CC-Switch-*.rpm

6.2 添加 DeepSeek 供应商

  1. 打开 CC Switch
  1. 在主界面顶部，切换到 Codex 标签页（所有后续配置只作用于 Codex）
  1. 点击右上角的 + 按钮，添加供应商
  1. 在「预设供应商」下拉列表中，选择 DeepSeek
  1. 向下滚动，在 API Key 输入框中粘贴你刚才复制的 DeepSeek API Key（注意不要有多余空格）
  1. 点击 保存

预设已经帮你配好了 DeepSeek 的请求地址（https://api.deepseek.com/v1）、默认模型、模型菜单、thinking/reasoning 参数，并且自动开启了「需要本地路由映射」。你不需要手动拼任何接口路径。

6.3 测试并启用模型

保存后，CC Switch 会显示该供应商的测试按钮。点击测试，确认连接正常后，点击 启用 该 DeepSeek 渠道。

七、第四步：开启本地路由（最关键）

这是整个配置过程中最重要的一步！ 很多人配置完成后 Codex 仍然无法使用，就是因为漏掉了这一步。

7.1 进入路由设置

  1. 在 CC Switch 中，进入 设置 页面
  1. 找到 路由 选项

7.2 开启两个开关

需要同时开启以下两个开关：

开关名称

说明

状态

路由总开关

启动本地代理服务，默认地址 127.0.0.1:15721

开启

Codex 开关

让 Codex 的请求走本地路由转发

开启

如果只想让 Codex 走路由，Claude 和 Gemini 的开关可以保持关闭。

7.3 确认 DeepSeek 渠道已置顶

在渠道列表中，确保 DeepSeek 渠道处于已启用状态（通常有高亮或对勾标识）。如果配置了多个渠道，建议将 DeepSeek 拖拽到列表顶部，设为最高优先级。

八、第五步：重启 Codex，验证成功

8.1 完全退出 Codex

关闭所有 Codex 窗口和后台进程，确保进程已彻底终止：

  • Windows：在任务管理器中确认 Codex 进程已结束
  • macOS：Cmd+Q 完全退出，或在活动监视器中结束进程
  • CLI 版：在终端中输入 /logout 或直接关闭终端窗口

8.2 重新启动 Codex

codex

重启后，Codex 会重新读取本地代理配置。此时你应该能看到 Codex 已经自动登录，并且正在使用 DeepSeek 模型。

8.3 验证是否接入成功

方式一：终端指令测试

在 Codex 交互模式中输入一个真实代码需求：

帮我写一个 Python 快速排序算法，附带详细注释和单元测试

如果秒级响应、无超时卡顿，即为接入成功。

方式二：查看当前模型

在 Codex 交互模式中输入：

/model

应该能看到 DeepSeek 的模型名称（如 DeepSeek V3 或 DeepSeek-R1）。

方式三：CC Switch 日志查看

打开 CC Switch 的日志面板，可实时查看请求来源（Codex）和转发目标（DeepSeek），路由生效即显示正常记录。

九、配置流程总览

安装 Node.js >= 22
    ↓
安装 Codex（npm 或桌面版）
    ↓
运行 codex → 显示 OpenAI 登录页面（暂时无法登录，正常）
    ↓
获取 DeepSeek API Key（platform.deepseek.com）
    ↓
下载并安装 CC Switch
    ↓
CC Switch → Codex 标签 → 点击 + 添加供应商 → 选择 DeepSeek 预设
    ↓
填入 DeepSeek API Key → 保存 → 测试 → 启用
    ↓
CC Switch → 设置 → 路由 → 开启「路由总开关」+「Codex 开关」
    ↓
完全退出 Codex → 重新启动 codex
    ↓
✅ 自动登录成功，DeepSeek 模型已生效，开始使用！

十、Codex 常用命令与使用技巧

10.1 基本命令

场景

命令

说明

进入交互模式

codex

进入对话界面，可连续提问

直接生成代码

codex "写一个下载文件的 Python 脚本"

非交互式，直接输出结果

自动化执行

codex exec "跑通 pytest"

非交互模式，自动安装依赖并运行测试

读取图片排错

codex -i error.png "分析并修复图中的报错"

自动解析截图中的错误信息

10.2 交互模式指令

指令

说明

/model

查看并切换当前使用的模型

/export session.json

保存当前会话上下文

/load session.json

恢复之前的会话

/logout

清除授权信息

Tab 键

命令补全

Ctrl+R

搜索历史命令

10.3 实用场景示例

# 快速生成代码
codex "写一个 Python 脚本，批量重命名文件夹中的图片文件"

# 代码重构
codex "给整个 Go 项目的所有函数增加 context 参数传递"

# 修复 Bug
codex -i screenshot.png "修复截图中显示的报错"

# 生成测试
codex "为 src/utils.ts 中的所有函数生成单元测试"

# 代码审查
codex "审查最近一次 commit 的代码，找出潜在问题"

# 文档生成
codex "为整个项目生成 API 文档"

# 性能优化
codex "分析 src/api/handler.go 的性能瓶颈并优化"

10.4 设置中文回复

让 Codex 默认使用简体中文与你交流：

# macOS / Linux
mkdir -p ~/.codex && printf 'Always respond in Chinese-simplified\n' > ~/.codex/AGENTS.md

# Windows (PowerShell)
New-Item -ItemType Directory -Path "$env:USERPROFILE\.codex" -Force | Out-Null
Set-Content -Path "$env:USERPROFILE\.codex\AGENTS.md" -Value "Always respond in Chinese-simplified" -Encoding UTF8

十一、进阶：多模型切换

CC Switch 支持同时配置多套模型渠道，可根据不同开发场景一键切换：

场景

推荐模型

说明

代码开发 / 调试重构

DeepSeek-V3

代码推理能力强，长上下文稳定

轻量快速补全

DeepSeek-Flash（deepseek-chat）

响应速度更快，适合高频实时补全

深度逻辑推理

DeepSeek-R1

专为复杂推理设计，处理算法难题

文案 / 文档编写

通义千问、智谱 GLM 等

CC Switch 多渠道管理轻松切换

添加其他模型供应商

不只是 DeepSeek，Kimi、MiniMax、SiliconFlow 等常见 Chat 格式供应商在 CC Switch 里都有预设，操作流程完全一样：

  1. 选预设 → 填 Key → 保存
  1. 开路由 → 接管 Codex
  1. 切换 → 重启

如果预设里没有的供应商，选择「自定义」，按对方文档填 API Key、base URL，把 API 格式选为「OpenAI Chat Completions（需开启路由）」即可。

十二、常见问题与解决方案

问题 1：配置完成后 Codex 仍无响应 / 走原接口

原因：未开启 Codex 路由总开关，或未彻底重启 Codex 进程。

解决：

  1. 进入 CC Switch → 设置 → 路由，确认「路由总开关」和「Codex 开关」均为开启状态
  1. 在任务管理器中确认 Codex 进程已彻底关闭
  1. 重新启动 Codex

问题 2：提示 API Key 无效 / 权限报错

原因：Key 复制不完整、包含空格、Key 已过期、或账户未完成实名认证。

解决：

  1. 重新复制纯净的 API Key，检查前后有无多余字符
  1. 完成 DeepSeek 开发者账户实名认证
  1. 在 DeepSeek 平台刷新密钥后重新填入 CC Switch

问题 3：调用失败，报 404 错误

原因：Codex 目前仅原生支持 OpenAI Responses API 与 GPT 系列模型。如果供应商使用 Chat Completions 协议或非 GPT 模型（如 DeepSeek、Kimi），则需要在使用过程中保持本地路由开启。

解决：

  1. 确认 CC Switch 的路由总开关和 Codex 开关均已开启
  1. 确认 CC Switch 程序正在运行（不要关闭）
  1. 使用 CC Switch 内置的 DeepSeek 预设，不要手动修改 BaseURL

问题 4：响应慢、偶尔中断

原因：DeepSeek 渠道未置顶，系统随机命中其他无效渠道。

解决：在 CC Switch 路由列表中将 DeepSeek 设为最高优先级（拖拽至列表顶部）。

问题 5：/model 看不到 DeepSeek 模型

原因：保存供应商后 Codex 未重启，模型目录需要新进程才能刷新。

解决：完全退出 Codex 后重新启动。

问题 6：command not found: codex

原因：Codex CLI 未正确安装或 PATH 未配置。

解决：

# 检查 npm 全局安装路径
npm config get prefix

# 确保该路径在系统 PATH 中

问题 7：Node.js 版本过低

原因：Codex CLI 要求 Node.js >= 22。

解决：

nvm install 22
nvm use 22

十三、Codex vs 其他 AI 编程工具对比

维度

Codex + DeepSeek

Claude Code (Opus 4.1)

Qwen3-Coder

登录门槛

CC Switch 方案零门槛，无需 OpenAI 账号

需美区账号 + 手机验证，已封国内 IP

开源，本地可跑，零成本

响应速度

DeepSeek 首 token ~1s，响应迅速

~2.5s，习惯先分析再给代码

本地 4090 首 token ~0.8s

上下文能力

DeepSeek 支持 64k~128k 上下文

100k~1M 可调

256k 原生，可扩 1M

工程化

计划面板 + 手动批准，Hooks 生态

Slash + Hooks + Subagents 成熟

暂无生态，需自行拼脚本

代码风格

严格按目录结构，不乱放文件

偶尔合并成单文件

中文 prompt 下也爱整单文件

前端能力

能用，UI 细节一般

动画、渐变、响应式一把梭

需要设计师拯救

价格

DeepSeek 按量计费，极低（有免费额度）

$20-200/月梯度

开源免费，电费自理

隐私

代码经 DeepSeek 云端处理

本地执行，绝对私密

本地执行，可完全离线

国内可用性

完全可用，无需翻墙

已封国内 IP

完全可用

总结

通过 CC Switch + DeepSeek 的方案，国内开发者可以彻底解决 Codex 的三大痛点：

  1. 绕过账号限制：无需 ChatGPT Plus 订阅，无需 OpenAI 账号
  1. 无需翻墙：DeepSeek 国内直连，稳定可靠
  1. 成本极低：DeepSeek 提供免费额度，付费后按量计费也远低于 OpenAI

整个配置过程只需 5 分钟，一次配置永久生效。所有 Codex 命令、插件、自动补全、工作流功能完全兼容，无需任何额外适配。

推荐工作流：

Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

用ChatGPT分析SPC异常：我把排查时间从2.5小时砍到40分钟

avatar AI编程社区

7月28日热点：一个周末，二十年护城河——Claude攻破CUDA

CUDA不光是一套编程接口，它背后是几千个经过极致优化的数学库、十几年积累的调试工具链、数万页的开发者文档，以及——最关键的是——一代又一代GPU工程师用血泪攒出来的"手感"。当时这个决策被华尔街分析师嘲笑了好几年——为GPU配一套完整的编程生态，意味着巨大的研发投入，而当时的GPU市场主要在游戏领域，谁会需要GPU编程？当深度学习在2012年爆发时，全世界的AI研究者突然发现，能大规模训练神经网

avatar AI编程社区

Spec Coding：从氛围编程到规约编程的工程化演进

Vibe Coding让开发者体验到了自然语言驱动开发的魔力，但也暴露了一个根本性问题：模糊的需求描述极易触发AI的幻觉，导致生成代码偏离预期。2026年，行业正在从Vibe Coding向Spec Coding（规约编程）演进——在动手之前，人类与AI必须先达成一套关于架构、边界与逻辑的共识文档，让AI基于规约逐点执行。这种向"契约化"的回归，正在将AI编程从"玄学"拉回"工程学"。

avatar AI编程社区