返回博客

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. 1在你的项目目录打开终端
  2. 2输入 codex 回车启动
  3. 3首次使用按提示登录 OpenAI 账号
  4. 4用自然语言描述需求，让它开始干活

国内访问提醒

Codex 依赖 OpenAI 账号与服务，国内网络环境下登录/调用可能不稳定，需自备可用的网络条件与已开通的账号。若主要图省事、零成本，可考虑国产终端 AI 编程 CLI（如 iFlow CLI、Qwen Code）作为替代或补充。

常见问题

想系统学会用 Codex、Claude Code 这类 AI 编程工具，从入门到做出真实产品，可以看 IMAI 的系统课程。

想系统学会用 AI 编程,从入门到做出真实产品?

查看系统课程