[

随着 AI 编程工具进入「工程化阶段」，CLI 型 Code Agent 正在逐步替代早期的“对话式写代码”。
在 Claude Code 频繁降智、封号成本高的背景下，OpenAI Codex 正迅速成为国内开发者的新选择。

本文将从国内视角，完整讲清楚：

• Codex 是什么，适合谁
• 国内如何稳定使用 Codex
• IDE / CLI / WSL 三种安装方式
• Codex CLI 的高效使用技巧与避坑
• Codex 能否平替 Claude Code

所有步骤均来自真实可跑通实践。

---

一、什么是 Codex？

Codex 是 OpenAI 推出的代码智能体（Code Agent）工具，而不是一个简单的代码补全插件。

它有三种形态：

• Codex Web：ChatGPT 网页中的 Codex
• Codex IDE 插件：VS Code / Cursor / Windsurf
• Codex CLI：本地终端运行的 AI 编码代理（重点）

核心能力

• 使用 GPT-5-Codex 专用代码模型
• 可连续执行复杂任务 数小时不间断
• 可读取 / 修改文件、运行命令、联网搜索
• 支持 MCP（Model Context Protocol）扩展

在定位上，Codex 对标的是：

工具	类型
Cursor	AI IDE
Claude Code	Code CLI
Gemini CLI	Code CLI
Codex	Code CLI / IDE / Web 全覆盖

---

二、为什么很多人从 Claude Code 转向 Codex？

真实原因只有三点：

1. Claude Code 国内封号率高
2. Claude Code 容易“降智”，长任务不稳定
3. ChatGPT Plus 成本更低

Codex 目前使用 ChatGPT 账号体系，风控明显宽松很多。

---

三、Codex 的三种使用方式

3.1 方式一：IDE 中使用 Codex（最简单）

Codex 官方提供 IDE 插件，支持：

• VS Code
• Cursor
• Windsurf

安装步骤（以 VS Code 为例）

1. 打开 VS Code 插件市场
2. 搜索 Codex
3. 认准 OpenAI 官方标志
4. 安装完成后：
   • 右上角出现 OpenAI Logo
   • 或从侧边栏直接打开 Codex 面板

你可以：

• 直接用自然语言描述需求
• 指定文件修改
• 切换模型为 GPT-5-Codex（high）

👉 适合人群：

小白 / 不想折腾环境 / IDE 重度用户

---

3.2 方式二：终端使用 Codex CLI（推荐）

Codex CLI 是 完整体，能力最强。

支持系统：

• ✅ macOS
• ✅ Linux
• ⚠️ Windows（实验阶段，建议 WSL）

---

四、安装 Codex CLI（Mac / Linux）

4.1 方式一：npm 安装（推荐）

安装 Node.js（≥18）

Ubuntu / Debian

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

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

macOS

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

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

安装 Codex CLI

Bash```bash
npm install -g @openai/codex

```bash
npm install -g @openai/codex

---

4.2 方式二：Homebrew 安装

Bash```bash
brew install codex

```bash
brew install codex

任选一种即可。

---

4.3 启动 Codex

Bash```bash
mkdir demo && cd demo
codex

```bash
mkdir demo && cd demo
codex

即可进入 Codex CLI 交互模式。

---

五、国内使用 Codex 的关键注意点（非常重要）

5.1 登录与网络

• 必须开启全局 Tun 模式
• 不建议规则模式
• 避免频繁切换 IP

OpenAI 对 Codex 的算力消耗监控比 ChatGPT 更严格。

---

5.2 Codex CLI 使用资格

• 需要 ChatGPT Plus / Team / Enterprise
• 或使用 API Key 方式

---

六、Codex CLI 高频使用技巧（实战）

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

使用 Codex 的 AGENTS.md 记忆机制

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

之后所有 Codex 会话默认中文。

---

6.2 切换和查看模型

/model

推荐组合：

• 模型：gpt-5-codex
• 推理等级：high

---

6.3 常用快捷命令一览

命令	说明
/model	切换模型
/approvals	授权模式
/init	初始化 AGENTS.md
/diff	查看 git diff
/compact	压缩上下文
/status	Token 与配置
/new	新会话

---

6.4 授权模式选择（重点）

模式	说明
Auto	默认，安全
Read Only	只读
Full Access	最高效率（推荐）

CLI 启动时可直接指定：

Bash```bash
codex --dangerously-bypass-approvals-and-sandbox

```bash
codex --dangerously-bypass-approvals-and-sandbox

（仅限个人开发环境）

---

6.5 使用别名，效率翻倍

alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" --search --yolo'

写入 ~/.zshrc 或 ~/.bashrc 永久生效。

---

6.6 API Key 模式（无订阅方案）

编辑配置文件：

~/.codex/config.toml

preferred_auth_method = "apikey"

切回 ChatGPT 登录：

Bash```bash
codex --config preferred_auth_method=“chatgpt”

```bash
codex --config preferred_auth_method="chatgpt"

---

6.7 MCP 集成（进阶）

Codex 支持 MCP（Model Context Protocol）：

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

启动时报错即表示 MCP 未连通。

---

七、Windows 用户如何使用 Codex（WSL）

7.1 安装 WSL

开启 Windows 功能：

• Virtual Machine Platform
• Windows Subsystem for Linux

安装 Ubuntu：

Bash```bash
wsl --install -d Ubuntu-24.04

```bash
wsl --install -d Ubuntu-24.04

7.2 在 WSL 中安装 Codex

Bash```bash
wsl

按 Linux 步骤安装 Node + Codex

```bash
wsl
# 按 Linux 步骤安装 Node + Codex

👉 不要直接在 Windows 原生环境跑 Codex CLI

---

八、Codex vs Claude Code 实战对比

场景	Codex	Claude Code
100 行 Bug 修复	42s / $0.009	55s / $0.045
300 行重构	4m15s	5m01s
项目初始化	10m58s	14m20s
国内稳定性	高	低
封号风险	低	高

---

九、总结

• Codex 已经不是“玩具级 AI 编程工具”

• CLI + GPT-5-Codex 组合，是真正能干活的 Agent

• 国内只要网络配置正确，体验优于 Claude Code

  接入国内大模型 ​

  如果你想让 Codex 接国内模型，也可以改配置。

  但要注意，OpenAI 兼容不等于 Codex 一定可用。它更依赖 Responses API，只有部分平台适配得比较完整。

  如果你想少折腾，可以把 endpoint 统一到 Code80 这样的入口，少掉一层支付和网络处理。

  常见问题 ​

  1. 登录失败怎么办？ ​

  先检查网络，再清浏览器缓存，再试 codex logout / codex login。

  2. codex 命令找不到怎么办？ ​

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

  3. 配了环境变量还是不生效？ ​

  重启 Codex，必要时重启电脑。

  4. 国内用户怎么更省事地接上官方 API？ ​

  可以直接把入口统一到 Code80。

  5. 新手最适合从哪开始？ ​

  先从 CLI 或 App 选一个跑通，再补 IDE 插件。

  6. 第一单任务应该做什么？ ​

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