Codex 国内如何使用与安装？一篇真正能跑通的完整教程

随着 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 对标的是：

二、为什么很多人从 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

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

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

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

npm install -g @openai/codex

4.2 方式二：Homebrew 安装

brew install codex

brew install codex

任选一种即可。

4.3 启动 Codex

mkdir demo && cd demo
codex

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 常用快捷命令一览

6.4 授权模式选择（重点）

CLI 启动时可直接指定：

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

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 登录：

codex --config preferred_auth_method="chatgpt"

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：

wsl --install -d Ubuntu-24.04

wsl --install -d Ubuntu-24.04

7.2 在 WSL 中安装 Codex

wsl
# 按 Linux 步骤安装 Node + Codex

wsl
# 按 Linux 步骤安装 Node + Codex

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

八、Codex vs Claude Code 实战对比

九、总结

• Codex 已经不是“玩具级 AI 编程工具”
• CLI + GPT-5-Codex 组合，是真正能干活的 Agent
• 国内只要网络配置正确，体验优于 Claude Code

AI 不会替你写 100% 的代码，但会替你写掉 80% 的脏活。