OpenAI Codex 是基于 GPT-5-Codex 模型的 AI 编程 Agent，能连续执行复杂编码任务数小时不间断。但大陆用户面临两大障碍：网络无法直连 OpenAI 和 ChatGPT 账号需要海外手机验证。本文将教你用中转 API 方案绕开这两个障碍，在大陆网络环境下稳定使用 Codex。

一、Codex 是什么？

Codex 是 OpenAI 推出的 AI 代码智能体（Code Agent），不是简单的代码补全插件。它能读取/修改文件、运行命令、联网搜索，可连续执行复杂任务数小时不间断。

五种使用形态

核心能力

• 代码生成与修改：根据自然语言描述生成完整代码，修改现有文件
• 连续任务执行：可连续工作数小时，自动拆解复杂任务
• 文件读写：直接读取、创建、修改项目文件
• 命令执行：运行 shell 命令，执行测试，安装依赖
• 联网搜索：查阅文档、搜索解决方案
• MCP 扩展：通过 Model Context Protocol 接入外部工具

二、为什么选择 Codex？

在 Claude Code 频繁降智、封号成本高的背景下，Codex 正迅速成为大陆开发者的新选择：

三、大陆使用方案

方案一：中转 API + API Key（推荐）

这是大陆最稳定的方案。原理：用兼容 OpenAI 格式的国内中转服务替换 api.openai.com，Codex 以为在连官方，实际走国内线路。

配置方法

编辑全局配置文件 ~/.codex/config.toml：

# ~/.codex/config.toml（全局配置）
model = "gpt-5.5"
model_provider = "my-relay"

[model_providers.my-relay]
name = "中转服务"
base_url = "https://你的中转服务地址/v1"   # 替换为实际 base_url
env_key = "OPENAI_API_KEY"
wire_api = "responses"

设置 API Key 环境变量：

export OPENAI_API_KEY="sk-你的中转API Key"

或写入 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-你的中转API Key"
}

接入国产模型（进阶）

如果想用国产模型降低成本，也可以通过中转服务接入 DeepSeek、通义千问等：

model = "deepseek-chat"
model_provider = "my-relay"

[model_providers.my-relay]
name = "中转服务"
base_url = "https://你的中转服务地址/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

方案二：ChatGPT 账号 + 系统代理

如果你已有 ChatGPT Plus / Pro / Business / Enterprise 账号，并能通过系统代理访问 chatgpt.com，可直接用账号登录：

# 首次运行，按提示登录
codex

# 或指定登录
codex --login

适合已有 ChatGPT 订阅、网络条件允许的用户。订阅包含了 Codex 使用额度。

四、安装 Codex CLI（推荐方式）

4.1 npm 安装（跨平台推荐）

第一步：安装 Node.js（≥18）

Ubuntu / Debian：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
node -v
npm -v

macOS：

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node -v

第二步：安装 Codex CLI

npm install -g @openai/codex

第三步：验证安装

codex --version

4.2 其他安装方式

macOS / Linux 一键脚本：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Homebrew（macOS）：

brew install --cask codex

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

4.3 启动 Codex

# 创建项目目录并进入
mkdir my-project && cd my-project

# 启动 Codex 交互模式
codex

# 或直接传入任务
codex "帮我写一个解析CSV的Python函数"

# 指定模型
codex --model gpt-5.5

五、Windows 用户安装（WSL 方式）

1. 安装 WSL：以管理员身份打开 PowerShell，执行：

   wsl --install -d Ubuntu-24.04

   重启电脑后设置 Ubuntu 用户名和密码。

2. 进入 WSL 环境：

   wsl

3. 在 WSL 中安装 Node.js 和 Codex：按上面 Linux 的步骤安装即可。
4. 配置中转 API：在 WSL 中编辑 ~/.codex/config.toml，配置方式与 Linux 相同。
5. 启动 Codex：

   codex

六、IDE 中使用 Codex

VS Code 安装

1. 打开 VS Code → 左侧扩展面板（Ctrl+Shift+X）
2. 搜索 “Codex”，认准 OpenAI 官方标志
3. 点击 Install 安装
4. 配置中转 API：打开命令面板（Ctrl+Shift+P）→ 搜索 “Codex: Sign In”
   • 选择 API Key 认证方式
   • 粘贴中转 API Key 和 base_url
5. 安装完成后右上角出现 OpenAI Logo，或从侧边栏打开 Codex 面板

支持的 IDE

IDE 扩展功能

• 编辑器上下文：自动读取当前打开的文件、选中代码、@file 引用
• 三档审批模式：Chat（纯对话）/ Agent（工具调用需确认）/ Agent Full Access（全自动）
• 推理深度：low / medium / high 三档，平衡速度与质量
• 云端委托：将耗时任务交给 Codex Cloud 后台运行

七、高频使用技巧

7.1 全局中文回复（强烈推荐）

使用 Codex 的 AGENTS.md 记忆机制，让所有会话默认中文回复：

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

7.2 常用命令一览

7.3 授权模式选择

CLI 启动时直接指定全访问模式（仅限个人开发环境）：

codex --dangerously-bypass-approvals-and-sandbox

7.4 设置别名，效率翻倍

# 写入 ~/.zshrc 或 ~/.bashrc
alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" --search --yolo'

之后直接输入 codex 即可使用最优配置启动。

7.5 API Key 模式与 ChatGPT 模式切换

编辑 ~/.codex/config.toml：

# 使用 API Key
preferred_auth_method = "apikey"

# 切回 ChatGPT 登录
# preferred_auth_method = "chatgpt"

或命令行临时切换：

codex --config preferred_auth_method="chatgpt"

7.6 MCP 集成（进阶）

Codex 支持 MCP（Model Context Protocol），可接入外部工具：

# ~/.codex/config.toml
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

八、常见报错排查

401 Unauthorized

最常见原因（按频率）：

1. auth.json 和 config.toml 同时有认证信息 → 只保留一处，auth.json 只放 API Key
2. API Key 分组权限不足 → 检查中转平台控制台，确认 Key 有目标模型的访问权限
3. model_provider 写在了项目级配置 → 必须写在 ~/.codex/config.toml（全局）
4. 修改配置后未重启 → CLI 重启终端，桌面版完全退出重开

连接超时 / 接口超时

如果不用中转 API，需要设置系统代理：

export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

用中转 API 则不需要代理设置，直接在 config.toml 指定 base_url 即可。

codex 命令找不到

检查 Node.js、npm 的全局路径和 PATH 环境变量：

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

# 确保在 PATH 中
export PATH="$(npm config get prefix)/bin:$PATH"

配置不生效

• 确认配置文件路径：~/.codex/config.toml（全局），不是项目级 .codex/config.toml
• model_provider 字段只能写在全局配置，写在项目级会被忽略
• 修改后重启 Codex，必要时重启终端

九、快速决策指南

十、常见问题 FAQ

Q1：国内用 Codex 一定要科学上网吗？

不一定。CLI、桌面版、IDE 扩展都支持中转 API 方式，填入国内可访问的 base_url 和 API Key 后，完全不需要科学上网。只有 Web 版强绑 ChatGPT 账号。

Q2：中转 API 用的什么模型？和官方一样吗？

主流中转服务转发的是官方 OpenAI API 请求，模型本身和官方一致（gpt-5.5、gpt-5-codex 等）。国产模型也可以通过兼容层接入，但能力有差距。

Q3：桌面版和 CLI 能同时用吗？

可以同时安装，共享同一份 ~/.codex/config.toml 和 ~/.codex/auth.json。在 CLI 里改了配置，桌面版重启后也会生效。

Q4：IDE 扩展需要单独付费吗？

IDE 扩展本身免费，使用时消耗 Codex 额度——额度来源和 CLI/桌面版一样：ChatGPT 订阅或 API Key 余额。

Q5：新手第一单任务应该做什么？

修一个报错、补注释、写测试、改一个小脚本，别一上来就搞大重构。

Q6：Codex 和 GitHub Copilot 有什么区别？

Copilot 是代码补全工具（输入时建议代码），Codex 是代码 Agent（能连续执行复杂任务、修改文件、运行命令）。Copilot 适合日常编码辅助，Codex 适合批量重构、Bug 修复、项目初始化等重任务。两者可以同时使用。

— 本文由 data2.cn 整理发布，最后更新于 2026年7月16日 —
Codex 政策可能随时调整，请以 OpenAI 官方文档 为准