Codex CLI 国内怎么用：OpenAI 终端 AI 编程上手（2026）
发布于 2026年6月5日
Codex CLI 是 OpenAI 推出的终端编码代理（agentic CLI），用 Rust 编写、开源，能在终端里读代码、改文件、跑命令——和 Claude Code 是同一种新形态。国内很多同学卡在「装不上、连不上、不会配」。本文按国内环境，带你从 npm 安装到跑通第一条命令。
Codex CLI 是什么
不是编辑器插件，而是终端里的「自动工程师」：你用自然语言描述目标，它自己理解代码库、规划、跨文件修改、执行命令。形态等同 Claude Code。
安装（npm，国内加速）
先确认 Node.js 版本不低于 22。然后全局安装；国内 npm 慢的话加淘宝镜像源。
bash
# 需要 Node.js >= 22
node -v
# 全局安装
npm i -g @openai/codex
# 国内网络慢，可换淘宝镜像
npm i -g @openai/codex --registry=https://registry.npmmirror.com
# macOS 也可用 Homebrew
brew install codex
# 验证
codex --version登录与启动
- 1在你的项目目录打开终端
- 2输入 codex 回车启动
- 3首次使用按提示登录 OpenAI 账号
- 4用自然语言描述需求，让它开始干活
国内访问提醒
Codex 依赖 OpenAI 账号与服务，国内网络环境下登录/调用可能不稳定，需自备可用的网络条件与已开通的账号。若主要图省事、零成本，可考虑国产终端 AI 编程 CLI（如 iFlow CLI、Qwen Code）作为替代或补充。
常见问题
想系统学会用 Codex、Claude Code 这类 AI 编程工具，从入门到做出真实产品，可以看 IMAI 的系统课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程