Codex（CLI）安装与使用指南
1.Codex 是什么（快速定位）
Codex CLI 本质是一个本地运行的 AI 编码代理（Agent）：
在终端直接操作代码（读 / 改 / 执行）
类似：
Claude Code / Cursor CLI / Gemini CLI支持：
- 自动写代码
- 执行 shell
- 修 bug / refactor
- 操作项目目录
👉 简单理解：
“会操作你代码仓库的 ChatGPT（CLI Agent）”
2.安装前准备（关键依赖）
2.1 必备环境
| 组件 | 要求 |
|---|---|
| Node.js | ≥ 20 / 推荐 22 |
| npm | ≥ 10 |
| Python | 可选（部分登录流程用） |
| OS | macOS / Linux（推荐），Windows 建议 WSL |
Codex CLI 是基于 Node 生态的工具
3.Codex CLI 安装（核心步骤）
3.1 推荐方式：npm安装
1 | npm install -g @openai/codex |
验证：
1 | codex --version |
3.2 macOS（Homebrew）
1 | brew install codex |
3.3 国内加速（可选）
1 | npm install -g @openai/codex \ |
3.4 Python方式（备用）
1 | pipx install openai-codex-cli |
4.认证登录（重要）
4.1 推荐方式（2026主流）
1 | codex login |
- 使用 ChatGPT 账号登录
- Plus/Pro 用户无需 API Key
4.2 API Key方式（企业环境）
1 | export OPENAI_API_KEY=xxx |
5.基础使用（CLI交互模式）
5.1 启动
1 | codex |
进入类似 REPL 的交互环境
5.2 常见指令
| 操作 | 示例 |
|---|---|
| 生成代码 | write a golang http server |
| 修改代码 | refactor this file to use context |
| 执行命令 | run tests |
| 分析项目 | explain this repo |
5.3 非交互模式（推荐）
1 | codex "帮我写一个Gin API服务" |
6.工作模式（核心理解）
Codex CLI ≠ ChatGPT,它是 Agent + Toolchain
6.1 执行流程
flowchart LR
A[用户输入 Prompt] --> B[Codex解析任务]
B --> C[读取代码仓库]
C --> D[生成修改方案]
D --> E[执行Shell/修改文件]
E --> F[返回结果]
6.2 三种能力层级
| 能力 | 说明 |
|---|---|
| L1 | 代码生成 |
| L2 | 修改已有代码 |
| L3 | 自动执行 + 修复（Agent能力） |
7.高级用法（工程级）
7.1 在项目目录使用
1 | cd your-project |
Codex 会自动感知代码结构
7.2 自动执行模式（减少确认）
1 | codex --dangerously-bypass-approvals-and-sandbox |
适合 CI / 自动化任务
8.总结（核心认知）
Codex CLI 本质：
一个具备“读代码 + 改代码 + 执行代码”的本地 AI Agent
核心价值：
- 提升开发效率（10x）
- 自动化 DevOps 流程
- 减少重复劳动