# 国内安装使用 OpenAI Codex CLI 保姆级教程（2026 版）

> Codex 是什么？国内怎么装、怎么登录、需要什么账号？从 Node.js 安装到 ChatGPT 账号登录、API 中转配置，一步步带你在国内跑通 Codex CLI。
> 更新于 2026-08-04 · 难度 初级 · 来源 https://aicdks.com/guides/install-codex-cli-china

Codex 是 OpenAI 官方的 AI 编程助手（CLI 命令行工具），你用自然语言描述需求，它直接在你的项目里读代码、改代码、跑测试。对学生做课程项目、研究生跑实验代码、开发者日常写工具，都是效率翻倍的东西。但在国内装它确实有几个坎：网络、账号、支付。这篇按顺序踩平所有坑。

## 你需要准备什么

1. **一台电脑**：macOS / Linux 直接支持；Windows 建议用 WSL2（微软官方的 Linux 子系统）。
2. **网络环境**：能访问 openai.com 的网络（Codex 登录和调用都要连 OpenAI 服务器）。
3. **一个 ChatGPT 付费账号**（Plus / Pro / Team 任一）**或者一个 API Key / 中转额度**——两种登录方式二选一，下文分别讲。

## 第一步：安装 Node.js

Codex 通过 npm 分发，先装 Node.js（18 以上版本）。国内直接从 [Node.js 中文网](https://nodejs.org/zh-cn) 下载安装包即可；命令行党可以用 nvm：

```bash
# macOS / Linux / WSL
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts
```

npm 源慢的话切国内镜像：

```bash
npm config set registry https://registry.npmmirror.com
```

## 第二步：安装 Codex CLI

```bash
npm install -g @openai/codex
codex --version   # 能输出版本号就装好了
```

macOS 也可以用 Homebrew：`brew install codex`。

## 第三步：登录（两种方式）

### 方式 A：用 ChatGPT 账号登录（推荐，额度包含在订阅里）

```bash
codex
```

首次运行选择「Sign in with ChatGPT」，浏览器会弹出 OpenAI 登录页，用你的 **Plus / Pro / Team 账号**登录即可。用量计入订阅额度，Plus 就够轻度使用，重度开发建议 Pro。

没有付费账号？这正是大多数国内用户卡住的地方——注册需要海外手机号收验证码，付费需要海外信用卡。解决路径：

- 没有账号 → 买一个**成品账号**，或用[接码服务](/category/接码与号码)自己注册；
- 有账号没 Plus/Pro → 找[官方直充/代充](/category/ai-账号与服务-chatgpt)开通（各种购买方式的区别看[这篇](/guides/chatgpt-plus-account-types)）。

### 方式 B：用 API Key / 中转额度登录

如果你不想买订阅，可以用 API 计费方式跑 Codex：

```bash
export OPENAI_API_KEY="你的key"
codex
```

官方 API 同样需要海外卡付费，所以国内更常见的做法是买**API 中转额度**（是什么、怎么用见[API 中转教程](/guides/what-is-api-relay)）。中转服务会给你一个兼容 OpenAI 的接口地址，在 `~/.codex/config.toml` 里配置自定义 provider：

```toml
model = "gpt-5"
model_provider = "myrelay"

[model_providers.myrelay]
name = "myrelay"
base_url = "https://你的中转地址/v1"
env_key = "OPENAI_API_KEY"
```

## 第四步：跑起来

进入任意代码目录，直接说需求：

```bash
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 镜像源 |

## 下一步

Windows 原生沙箱、macOS/Linux 安装差异见 [Codex 平台差异篇](/guides/codex-cli-platform-guide)；在 VS Code 里用 Codex 看 [VS Code 插件教程](/guides/vscode-ai-extensions)。装好 Codex 只是开始。想让它长期、自动化地帮你做科研和项目开发（多智能体、技能扩展），看进阶篇：[用 Claude Code / Codex 做科研自动化](/guides/ai-coding-for-research)。遇到 401/403/429、登录卡住等问题，看 [国内常见报错排错指南](/guides/codex-claude-code-troubleshooting)；有多家中转 key 要管理，看 [CC Switch 使用教程](/guides/cc-switch-tutorial)。