国内安装使用 OpenAI Codex CLI 保姆级教程（2026 版）
更新于 2026-08-04 · 本站教程免费，长期更新
Codex 是 OpenAI 官方的 AI 编程助手（CLI 命令行工具），你用自然语言描述需求，它直接在你的项目里读代码、改代码、跑测试。对学生做课程项目、研究生跑实验代码、开发者日常写工具，都是效率翻倍的东西。但在国内装它确实有几个坎：网络、账号、支付。这篇按顺序踩平所有坑。
你需要准备什么
- 一台电脑：macOS / Linux 直接支持；Windows 建议用 WSL2（微软官方的 Linux 子系统）。
- 网络环境：能访问 openai.com 的网络（Codex 登录和调用都要连 OpenAI 服务器）。
- 一个 ChatGPT 付费账号（Plus / Pro / Team 任一）或者一个 API Key / 中转额度——两种登录方式二选一，下文分别讲。
第一步：安装 Node.js
Codex 通过 npm 分发，先装 Node.js（18 以上版本）。国内直接从 Node.js 中文网 下载安装包即可；命令行党可以用 nvm：
# macOS / Linux / WSL
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts
npm 源慢的话切国内镜像：
npm config set registry https://registry.npmmirror.com
第二步：安装 Codex CLI
npm install -g @openai/codex
codex --version # 能输出版本号就装好了
macOS 也可以用 Homebrew：brew install codex。
第三步：登录（两种方式）
方式 A：用 ChatGPT 账号登录（推荐，额度包含在订阅里）
codex
首次运行选择「Sign in with ChatGPT」，浏览器会弹出 OpenAI 登录页，用你的 Plus / Pro / Team 账号登录即可。用量计入订阅额度，Plus 就够轻度使用，重度开发建议 Pro。
没有付费账号？这正是大多数国内用户卡住的地方——注册需要海外手机号收验证码，付费需要海外信用卡。解决路径：
方式 B：用 API Key / 中转额度登录
如果你不想买订阅，可以用 API 计费方式跑 Codex：
export OPENAI_API_KEY="你的key"
codex
官方 API 同样需要海外卡付费，所以国内更常见的做法是买API 中转额度（是什么、怎么用见API 中转教程）。中转服务会给你一个兼容 OpenAI 的接口地址，在 ~/.codex/config.toml 里配置自定义 provider：
model = "gpt-5"
model_provider = "myrelay"
[model_providers.myrelay]
name = "myrelay"
base_url = "https://你的中转地址/v1"
env_key = "OPENAI_API_KEY"
第四步：跑起来
进入任意代码目录，直接说需求：
cd my-project
codex "把这个项目里所有 print 换成 logging，并加上时间戳"
Codex 会展示它准备做的修改，确认后执行。常用技巧：
codex --full-auto：免确认自动执行（在信任的目录里用）；/model：会话内切换模型；- 在项目根目录放一个
AGENTS.md，写清项目结构和规范，Codex 会遵守。
常见报错排查
| 现象 | 原因与解决 |
|---|---|
| 登录页打不开 / 超时 | 网络到不了 openai.com，检查代理设置（终端也要走代理：export https_proxy=...） |
stream error / 频繁断开 | 网络不稳定，换节点或改用 API 中转方式 |
| 登录后提示需要付费计划 | 账号没有 Plus/Pro，见上文方式 A |
| npm 安装卡住 | 切 npmmirror 镜像源 |
下一步
装好 Codex 只是开始。想让它长期、自动化地帮你做科研和项目开发（多智能体、技能扩展），看进阶篇：用 Claude Code / Codex 做科研自动化。