02 · 安装与认证
01-核心概念与agentic-loop ｜ 下一篇 → 03-上下文与Token管理
前置
- Node.js（CLI 基于 Node）
- Windows 用户建议 WSL 2（在 Linux 子系统里跑体验最好）
- 一个 OpenAI 账号
安装
# 全局安装 Codex CLI
npm install -g @openai/codex
# 启动（在项目目录）
cd your-project
codex
两种认证方式
| 方式 | 说明 | 适合 |
|---|---|---|
| 订阅登录（ChatGPT 账号） | 用 ChatGPT Plus/Pro/Team 额度 | 个人日常，省心 |
| API key | 用 OpenAI API key，按量计费 | 团队/自动化/CI |
# 方式一：交互式登录（走浏览器授权）
codex login
# 方式二：用 API key
export OPENAI_API_KEY=sk-xxx
- 登录后可用
codex内的状态命令检查登录状态/账号。 - CI 环境用 API key（订阅登录需要交互浏览器，不适合自动化）。
Hello World（第一次跑通）
cd ~/some-empty-dir
codex
# 然后在交互里：
> 创建一个 hello.py，打印 "Hello, Codex"，然后运行它
- 它会生成文件 → 在沙箱里运行 → 把输出读回来给你。
- 第一次运行会问你审批（要不要允许它执行命令），这是沙箱机制（见 06-安全与沙箱）。
常见坑
- ❌ Node 版本太低 → 升级到 LTS。
- ❌ Windows 直接在 PowerShell 跑沙箱受限 → 用 WSL 2。
- ❌ CI 里用订阅登录卡住 → 改用
OPENAI_API_KEY。
本节实操
- 装好 Codex CLI
- 选一种认证方式登录
- 跑通 Hello World，观察它的「审批」提示
下一篇 → 03-上下文与Token管理