Codex 国内新手全攻略：账号注册、桌面端安装、CC-Switch 接入 DeepSeek 与 Codex++ 进阶

这篇写给第一次接触 Codex 的国内新手：从「注册一个能登录的账号」开始，一步步走到「用国产 DeepSeek 模型跑代码」，最后再解锁社区增强工具 Codex++。全程不需要任何编程基础，照着抄就行。信息核对时间 2026-08，具体版本号、模型 ID 与界面文案以官方文档 / 服务商页面实时显示为准。

0. 开始之前：你需要准备什么

先看一眼总清单，心里有个数。下面每一行都会在对应章节展开：

序号需要准备用途章节
1国际邮箱（推荐 Gmail / Outlook）注册 Codex / ChatGPT 账号第 1 章
2能接收国际短信的手机号账号手机验证第 1 章
3Codex 桌面端编程入口本体第 2 章
4DeepSeek 开放平台账号 + API Key国产模型服务第 3 章
5CC-Switch 桌面客户端把 Codex 请求路由到 DeepSeek第 4 章
6（可选）Codex++桌面端增强插件第 5 章

一句话概括整条链路：Codex 负责「用起来爽」，DeepSeek 负责「算得快还便宜」，CC-Switch 负责「把两者接起来」，Codex++ 负责「把桌面端再解锁一层」。

⚠️ 安全提示：Codex 能读写你本地的代码项目并执行命令。请只从 OpenAI / Microsoft 官方渠道下载 Codex，从 GitHub 官方仓库下载 CC-Switch / Codex++，不要碰第三方「绿色版 / 破解版 / 汉化版」，避免账号、密钥和源码泄露。

1. 国内注册 Codex / ChatGPT 账号

Codex 目前主要集成在 ChatGPT 桌面应用中（桌面端）和 chatgpt.com 账号体系里（CLI / 云端），所以注册「ChatGPT 账号」就等于拿到了 Codex 的通行证，一套账号两边通用。

1.1 准备一个国际邮箱

  • 推荐 Gmail 或 Outlook；
  • 尽量避免 QQ 邮箱、163 等国内邮箱——验证邮件经常被拦截或延迟，收不到验证码会卡死在第一步；
  • 不要用临时邮箱（接收邮箱），后面找回密码和二次验证会非常麻烦。

ℹ️ 注册过程需要能正常访问 OpenAI 服务的网络环境（合规网络），相关细节这里不展开。

1.2 注册步骤

  1. 打开 chatgpt.com，点击右上角 Log in（登录）；
  2. 选择 Continue with email（使用邮箱继续）；
  3. 输入你的国际邮箱，点击 Continue；
  4. 设置密码：至少 8 位，建议大小写字母 + 数字组合，勾选服务条款后提交；
  5. 去邮箱查收验证邮件（找不到就翻一下「垃圾邮件」文件夹），把六位验证码填回页面；
  6. 完成手机号验证：系统会要求输入一个能接收国际短信的手机号。中国大陆 +86 手机号通常不在支持列表里，社区常见做法是用海外号码或接码平台临时号完成验证——请自行评估账号安全风险，建议优先用自己的长期海外号码，并保留好邮箱和号码的访问权限；
  7. 验证通过后即完成注册，回到 chatgpt.com 登录，左侧或顶部能找到 Codex 入口。

1.3 登录与账号安全建议

  • 注册后建议立刻开启两步验证（2FA）：设置里用 Authenticator 类应用（如 Google Authenticator / Microsoft Authenticator）绑定，别只靠邮箱；
  • 不要把账号共享给他人，也不要用「代注册」服务——账号是登录 Codex 桌面端和保留官方能力的基础；
  • 如果后续只想用国产模型、不打算订阅官方会员，注册一个免费账号即可，不需要开 Plus。

2. 安装 Codex 桌面端（Windows / macOS）

2.1 Windows

推荐使用官方网页安装器：

  1. 打开 developers.openai.com/codex/app，下载 Windows 版 ChatGPT Installer.exe（约 1.4 MB，是引导安装器，不是完整离线包）；
  2. 运行安装器，按提示完成安装；
  3. 安装路径建议不要包含中文和空格，防止后续读取配置文件时出问题；
  4. 安装完成后打开 ChatGPT 应用，登录你在第 1 章注册的账号，在应用内选择 Codex。

也可以直接用命令行安装（Microsoft Store 源）：

winget install --id 9PLM9XGG6VKS -s msstore

如果 msstore 源异常，先重置再装：

winget source reset --force
winget install --id 9PLM9XGG6VKS -s msstore

2.2 macOS

  1. 先确认芯片：苹果菜单 → 关于本机，Apple M 系列选 Apple Silicon，Intel 处理器选 Intel（两种 DMG 架构不同，不要混用）；
  2. 从 developers.openai.com/codex/app 下载对应 DMG；
  3. 打开 DMG，把应用拖入「应用程序」文件夹；
  4. 打开 ChatGPT，登录后选择 Codex。

也可以用 Homebrew 一键安装 CLI 与配套组件：

brew install codex
codex --version   # 输出版本号即代表安装正常

2.3 首次打开：登录方式怎么选

首次打开 Codex 桌面端会弹登录选项，这里有两个分支，二选一，别来回切：

  • 想保留官方插件、远程控制等能力 → 先用官方账号完成一次 OAuth 登录，让客户端生成基础 auth.json 鉴权缓存（第 4 章会用到）；
  • 只想用第三方 API（如 DeepSeek），不需要官方会员能力 → 可以直接选 API Key 登录，后续全部交给 CC-Switch 接管。

⚠️ 重要提醒：不要反复交替登录官方账号和自定义 API，极易造成配置文件冲突，出现调用异常。

2.4 认识配置目录（后面会用）

Codex 的配置默认在用户目录下的 .codex 文件夹：

  • macOS：~/.codex/
  • Windows：C:\Users\你的用户名\.codex\

两个核心文件：

  • config.toml：模型提供商、请求地址、模型映射；
  • auth.json：鉴权模式、密钥标识。

CC-Switch 的本质就是安全改写这两份文件。手动修改前先备份，出问题可以直接还原：

# macOS
cp ~/.codex/config.toml ~/.codex/config.toml.bak
cp ~/.codex/auth.json ~/.codex/auth.json.bak
# Windows PowerShell
Copy-Item $env:USERPROFILE\.codex\config.toml $env:USERPROFILE\.codex\config.toml.bak
Copy-Item $env:USERPROFILE\.codex\auth.json $env:USERPROFILE\.codex\auth.json.bak

3. 获取 DeepSeek API Key

国产模型里，DeepSeek 因为便宜、代码能力强、官方兼容 OpenAI 协议，是接 Codex 最常见的首选。

3.1 创建 API Key

  1. 打开 DeepSeek 开放平台 platform.deepseek.com，注册并登录；
  2. 进入左侧菜单 API Keys；
  3. 点击 创建 API Key，按需命名；
  4. 创建成功后立刻复制保存——Key 只完整展示一次，关闭页面后无法再查看，只能重新创建。

DeepSeek 开放平台创建 API Key 示意图（图源：华为云文档）

3.2 记住三个关键信息

信息值说明
API 地址https://api.deepseek.com兼容 OpenAI 协议，聊天接口为 /chat/completions
模型 IDdeepseek-chat / deepseek-reasoner 等以平台实时显示为准，接入时照抄
计费按 Token 用量付费首次使用需先在平台充值

DeepSeek 官方 API 调用示例（官方文档图，图源：华为云文档）：

DeepSeek 官方 API 调用示例（图源：华为云文档）

💡 说明：DeepSeek 官方接口是标准的 OpenAI 兼容 Chat Completions 协议，而新版 Codex 默认走 OpenAI 的 Responses API。两套协议在消息结构、流式响应、tool call 表达上差异明显——这正是为什么不能「直接改个 Base URL」硬接，而需要 CC-Switch 这层翻译（下一章）。

4. 核心环节：用 CC-Switch 接入 DeepSeek

4.1 先搞懂原理（三层架构）

整套链路分三层：

Codex 桌面客户端  →  CC-Switch 本地网关  →  DeepSeek 等第三方 API
  （图形交互/仓库读取/插件调度）  （协议翻译/密钥托管/模型映射/用量统计）  （模型推理）

CC-Switch 是专门适配 Codex、Claude Code 等编程工具的跨平台桌面网关（Win / Mac / Linux 都有），官方站 ccswitch.io，开源仓库 github.com/farion1231/cc-switch。它承担两件事：把 Codex 的请求转发到第三方 API，并把协议翻译成国产模型能听懂的样子；同时负责密钥存储、模型映射和用量统计。

它支持两种对接模式，先记住区别：

模式原理适合场景
配置写入模式CC-Switch 直接把自定义 provider 写进 config.toml固定用一家服务商、不想常驻代理进程、追求简单稳定
Local Routing 本地路由模式Codex 请求转发到本机 127.0.0.1:15721 端口，由 CC-Switch 再转发到远端 API频繁切换多家模型、多工具共用网关

4.2 安装 CC-Switch 并初始化

  1. 从 CC-Switch 官方站或 GitHub Releases 下载对应系统的安装包，安装并启动；
  2. 首次打开供应商列表为空，属于正常现象；
  3. 进入设置页，重点确认一个选项：
    • Keep official login when switching third-party providers（切换第三方供应商时保留官方登录态）：如果你后续还想用官方插件，打开它——这样切换供应商不会覆盖原有 auth.json 里的官方缓存；只使用自定义 API 的话可以关闭。

4.3 新增 DeepSeek 供应商

  1. 在 CC-Switch 顶部应用栏选中 Codex（表示该供应商只对 Codex 生效，不干扰其他工具）；
  2. 点击右上角 + 新增供应商，有两种方式：
    • 预设模板一键导入：内置 DeepSeek、千问（Qwen）、SiliconFlow 等主流服务商，选 DeepSeek 模板后只需填入 API Key，Base URL、默认模型、协议参数自动填充；
    • 自定义手动填写：填写供应商名称、API Key、远端请求地址、默认模型 ID；如果走 Local Routing 方案，勾选「需要本地路由映射」，并在下方模型映射表里添加模型别名（比如把 Codex 下拉里要显示的 deepseek-chat 映射到远端真实的模型 ID）；
  3. 保存后，在供应商列表里把这条配置的开关启用。

4.4 方案一：Local Routing 本地路由模式（推荐频繁切换）

第一步，开启路由代理：

  1. 进入 CC-Switch 设置 → 高级 → 代理服务；
  2. 启动路由代理，默认监听 127.0.0.1:15721；
  3. 进入应用路由面板，勾选 Codex，打开 Codex 路由总开关；
  4. 顶部状态栏显示「运行中」，说明本地代理就绪。

第二步，修改 Codex 的 config.toml（把模型请求全部指向本机 CC-Switch 代理）：

# Codex config.toml 本地路由模式完整配置
model = "deepseek-chat"
model_provider = "custom_ccswitch"
base_url = "http://127.0.0.1:15721/v1"
wire_api = "responses"
requires_openai_auth = true
disable_response_storage = true
model_catalog_json = "~/.codex/cc-switch-model-catalog.json"

[model_providers.custom_ccswitch]
name = "DeepSeek"
base_url = "http://127.0.0.1:15721/v1"
env_key = "PROXY_MANAGED"

第三步，修改 auth.json 为「代理托管鉴权」（密钥由 CC-Switch 托管，不在 Codex 本地存明文）：

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "PROXY_MANAGED"
}

💡 说明：

  • model = "deepseek-chat" 只是示例，以你在 CC-Switch 供应商里配置的模型 ID 为准（deepseek-reasoner 等同样适用）；
  • wire_api = "responses" 务必保留：新版 Codex 已弃用 wire_api = "chat"，写错会直接拒绝发请求；
  • env_key = "PROXY_MANAGED" 是 CC-Switch 的托管标识，表示真实 Key 存在 CC-Switch 里，Codex 本地不落盘明文密钥。

4.5 方案二：配置写入模式（简单稳定）

如果只固定用一家模型、不想让 CC-Switch 常驻后台：

  1. 在 CC-Switch 里配置好 DeepSeek 供应商（不用开启本地路由）；
  2. 点击「写入配置」，CC-Switch 会自动生成 provider 节点写进 config.toml；
  3. 重启 Codex 生效。

优点是不用后台常驻进程；缺点是切换服务商时需要重新执行一次配置写入。

4.6 连通性测试：先 curl 再开 Codex

改完配置别急着打开 Codex，先用终端直接访问本地代理，验证整条链路：

curl http://127.0.0.1:15721/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model":"deepseek-chat",
"messages":[{"role":"user","content":"编写一个带类型注解和单测的 Python 斐波那契函数"}],
"temperature":0.3,
"max_tokens":2048,
"stream":true
}'
  • 如果终端能正常流式返回代码内容，说明「CC-Switch 代理 → DeepSeek API → 模型映射」整条链路都通；
  • 如果返回连接拒绝：检查 CC-Switch 路由服务是否启动、15721 端口是否被其他程序占用；
  • 如果返回 401：核对 CC-Switch 里填的 API Key 是否正确、DeepSeek 账户是否已充值、额度是否充足。

4.7 在 Codex 里验证

  1. 启动 Codex 桌面客户端，新建代码对话窗口；
  2. 输入一个编程需求，比如「写一个 Python 的 fibonacci(n) 函数，要求带类型注解和单测」；
  3. 正常的话，Codex 的交互界面、快捷键、IDE 联动和官方模式完全一致，但实际推理请求已经走 CC-Switch 转发到了 DeepSeek；
  4. 打开 CC-Switch 的用量统计面板，能看到请求数从 0 涨起来、Token 消耗在累计——这就是「真的走通了」的铁证。

4.8 多供应商一键切换与调优

  • 一键切换：在 CC-Switch 主界面启用/禁用不同供应商，就能在 DeepSeek、千问、GLM 之间来回切，不用再改 Codex 配置文件；
  • 用量统计：面板自动统计每个供应商的 Token 消耗、请求次数、余额，方便控成本；
  • 模型映射：如果 Codex 模型下拉框看不到新增模型，十有八九是模型映射表缺失，回到供应商编辑页补充模型 ID 映射即可；
  • 温度参数：代码场景建议 temperature 设为 0.2 ~ 0.4，降低随机性，输出更规范的工程代码。

4.9 高频故障排查表

现象排查方向
curl 能通，但 Codex 无响应 / 超时系统防火墙、安全软件是否拦截 15721 端口；Codex 读的 config.toml 是不是你改的那份（多版本 Codex 可能有多份配置目录）
流式代码补全中断 / 截断远端 API 是否支持 stream 流式输出（部分兼容接口默认关闭，需在 CC-Switch 开启流式转发）；调低单次 max_tokens
切换供应商后仍走旧模型Local Routing 模式确认路由总开关已开启；配置写入模式重新执行写入，重启 Codex 并清本地缓存
开了「保留官方登录态」后插件异常部分官方付费插件依赖官方会员额度，第三方模型无法解锁，属于正常限制
15721 端口被占用在 CC-Switch 代理设置里改监听端口，并同步修改 config.toml 里 base_url 的端口号，保持两边一致
密钥安全不要把含明文 API Key 的 config.toml 提交进 Git 仓库；统一用 PROXY_MANAGED 托管标识

5. 进阶：Codex++ 桌面增强

如果你已经把 Codex + DeepSeek 跑通，接下来可以试试社区里的增强启动器 Codex++——它解决的是「Codex 官方一直没修、但用户很想要」的几个痛点。

5.1 Codex++ 是什么

Codex++（仓库 github.com/b-nnett/codex-plusplus，非 OpenAI 官方项目）可以理解成 Codex 桌面端的外挂式增强启动器：

  • 它不修改 Codex 的安装文件，而是用自己的 launcher 启动 Codex，再通过 CDP（Chrome DevTools Protocol）注入增强脚本；
  • 打补丁很小，增强运行时、配置、日志都放在用户数据目录，不塞进应用包；
  • Codex 升级后补丁通常会被移除，Codex++ 内置 watcher 会自动重新打补丁。

一句话总结定位：CC-Switch 解决「请求往哪路由、协议怎么翻译」（网络层），Codex++ 解决「桌面端怎么增强、API Key 模式怎么解锁插件」（注入层），两者可以配合使用。

5.2 安装

从 GitHub Releases 下载对应系统的安装包（以 v1.2.3 为例）：

系统安装包
macOS Apple SiliconCodexPlusPlus-*-macos-arm64.dmg
macOS IntelCodexPlusPlus-*-macos-x64.dmg
WindowsCodexPlusPlus-*-windows-x64-setup.exe
  • macOS：DMG 拖进「应用程序」即可；
  • Windows：exe 一路下一步，会创建桌面和开始菜单快捷方式；
  • 也可以 Homebrew 安装：brew install b-nnett/codex-plusplus/codexplusplus，再运行 codexplusplus install。

5.3 配置中转（接入 DeepSeek）

  1. 打开 Codex++ 管理工具 → 供应商配置 → 添加供应商；
  2. 填写 Base URL 和 API Key，DeepSeek 的常见配置：
    • Base URL：https://api.deepseek.com/v1
    • 上游协议：选 Chat Completions（千万别选 Responses，DeepSeek 官方接口是 Chat Completions 协议）
  3. 保存后点「使用」，再点右上角的重启按钮，等 Codex++ 重新拉起 Codex 即生效；
  4. 以后从 Codex++ 图标启动（不是原版 Codex），顶部菜单栏会出现 Codex++ 的状态灯，能看后端连接情况、切配置、看日志。

5.4 核心功能一览

功能说明
解锁插件入口原生 Codex 用 API Key 登录后插件入口会变灰（提示「需要登录 ChatGPT」）；Codex++ 绕过这条检查，API Key 模式也能装插件、用 Skills
会话彻底删除原版会话列表只有「归档」没有删除；Codex++ 注入后在会话列表悬停直接出删除按钮
中转注入把模型请求转到你指定的 API 中转，配置写进 ~/.codex/config.toml，随时可以切回官方登录态
Markdown 导出 / Timeline / 项目移动会话导出成 Markdown 存档、对话 Timeline 回溯、跨目录迁移项目
用户脚本支持注入自定义 JS（类似油猴），会写脚本的高手可以自己扩展
Provider 同步切换模型供应商后，旧会话的 metadata 仍保留，不会因为换 Key 就看不了历史

5.5 踩坑预警

  • macOS 未签名提示「已损坏，无法打开」：终端执行两条命令解锁（v1.2.3 已修复该问题，老版本适用）： 
    sudo xattr -rd com.apple.quarantine "/Applications/Codex++.app"
sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app"
  • Windows 端口被占用导致启动失败：新版已修复单实例端口异常占用；仍遇到就在任务管理器里结束 Codex 和 Codex++ 相关进程后重开；
  • 启动器偶尔卡死：社区反馈较多的小毛病，任务管理器干掉 Codex 和 Codex++ 进程重开即可。

⚠️ Codex++ 是社区开源项目，非 OpenAI 官方出品，使用前自行评估风险；功能与版本持续变化，以仓库实时信息为准。

6. 常见问题速查

Q：注册时验证码收不到怎么办？ 先用国际邮箱（Gmail / Outlook），并检查「垃圾邮件」文件夹；QQ / 163 等国内邮箱经常拦截 OpenAI 验证邮件，这是收不到的最常见原因。

Q：没有海外手机号能注册吗？ OpenAI 手机验证环节需要能接收国际短信的号码，大陆 +86 通常不在支持列表。社区有接码平台方案，但账号有被回收 / 封禁风险，建议优先用自己长期持有的海外号码，并开启两步验证。

Q：Codex 桌面端和 CLI 是同一个东西吗？ 不是。桌面端是图形应用（集成在 ChatGPT 应用里），CLI 是终端命令行工具，两者是不同入口、可以共存。本教程以桌面端为主线，CLI 的网关配置思路完全一样（都在 ~/.codex/config.toml）。

Q：国产模型接入后，官方能力哪些还在？ 按社区实测：代码编写、调试重构、文件读写、多轮对话、任务规划基本不受影响；Skills / 插件体系部分场景降级可用；Image Gen、Computer Use 等强依赖 OpenAI 私有能力，第三方模型无法对等替代。

Q：切换回官方模型怎么办？ Local Routing 模式下关闭 CC-Switch 的路由开关（或停用供应商），再把 config.toml / auth.json 恢复成官方配置即可；CC-Switch 提供了保留官方登录态选项，配置备份也能一键还原。

Q：这些工具要钱吗？ CC-Switch 和 Codex++ 都是免费开源项目；真正花钱的是模型 API 的 Token 用量（DeepSeek 按量计费，充值后使用）。

7. 最后的安全提醒

  1. 只从官方渠道下载：Codex 从 OpenAI / Microsoft 官方渠道；CC-Switch 从 ccswitch.io 或 GitHub 官方仓库；Codex++ 从 GitHub 官方 Releases；
  2. API Key 就是钱：不要提交到 Git、不要截图发群、不要贴进聊天记录；统一用 CC-Switch 的 PROXY_MANAGED 托管，本地配置不落明文；
  3. 第三方网关 / 接码服务需甄别：数据留存策略、价格、账号风险都要自己评估；
  4. 分清官方与社区：CC-Switch、Codex++ 均为社区项目，非 OpenAI 官方，使用前确认版本与风险。

本文整理自 OpenAI / Microsoft 官方安装说明、DeepSeek 开放平台文档、阿里云开发者社区《保姆级实操｜Codex 桌面版安装 + CC Switch 接入 DeepSeek、千问等第三方 API 完整教程》、华为云《接入 DeepSeek 模型并搭建问答助手智能体》及 OSSNAV《Codex++ 使用教程》等公开资料，截图取自华为云文档（已转存本站）。信息核对时间 2026-08，具体版本号、模型 ID 与命令以官方文档 / 服务商页面实时显示为准。