夜雨聆风Codex CLI 是 OpenAI 推出的开源终端 AI 编程代理。说人话就是：你在终端里用自然语言下指令，它能读你的代码、改文件、跑命令、执行多步骤任务——全程不需要打开 IDE。
它和 Claude Code 是同一类工具，但 Codex 有三个独特优势：完全开源（Rust 实现，Apache-2.0 协议）、内置系统级沙盒（macOS Seatbelt / Linux Landlock）、以及包含在 ChatGPT Plus 订阅里无需额外付费。
一句话总结：如果你已经有 ChatGPT Plus，Codex CLI 就是免费的 AI 编程助手。
安装前准备
在动手安装之前，确认这三件事：
Node.js ≥ 18（推荐 ≥ 22）。没有的话先去 nodejs.org 下载安装。
一个 OpenAI 账号。任何 ChatGPT 付费计划都行——Plus、Pro、Team、Enterprise、Edu。截至 2026 年 4 月，Codex 已包含在所有 ChatGPT 计划中，Free 和 Go 用户也可限时使用。
操作系统：macOS 或 Linux 原生支持。Windows 用户走 WSL2，不要直接在 Windows 下跑。
验证 Node.js 是否装好：
node --version
# 输出 v22.x.x 就对了三种安装方式
方式一：npm 全局安装（推荐）
最简单，全平台通用：
npm install -g @openai/codex国内用户如果下载慢，换淘宝镜像：
npm install -g @openai/codex --registry=https://registry.npmmirror.com方式二：Homebrew（仅 macOS）
brew install --cask codex方式三：GitHub Releases 二进制包
适合离线环境或不想装 Node.js 的情况。去 GitHub Releases 下载对应平台的包：
• macOS Apple Silicon → codex-aarch64-apple-darwin.tar.gz• macOS Intel → codex-x86_64-apple-darwin.tar.gz• Linux x86_64 → codex-x86_64-unknown-linux-musl.tar.gz• Linux ARM64 → codex-aarch64-unknown-linux-musl.tar.gz
解压后把二进制文件重命名为 codex，放到 PATH 里即可。
验证安装
codex --version
# 输出类似：@openai/codex, 0.125.0看到版本号就说明装好了。
Windows 用户看这里
Windows 原生支持仍处于实验阶段，走 WSL2 是最稳的方案：
第一步，安装 WSL2（管理员 PowerShell）：
wsl --install重启电脑后进入 WSL 终端。
第二步，在 WSL 里装 Node.js：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22第三步，按 Linux 流程装 Codex：
npm install -g @openai/codex注意：项目文件一定要放在 Linux 文件系统里（~/code/我的项目/），不要放在 /mnt/c/ 下，否则文件读写极慢。
首次启动与认证
进入你的项目目录，直接敲 codex：
cd ~/my-project
codex首次运行会自动弹浏览器，选认证方式：
ChatGPT 账号登录（推荐）：浏览器里完成 OAuth 授权，凭据缓存在 ~/.codex/token。此后使用不再需要重复登录。
API Key 登录：适合没有 ChatGPT 订阅、用 API 付费的用户：
export OPENAI_API_KEY="你的API_Key"
codex无浏览器环境（SSH/远程服务器）：
codex login --device-code终端会打印一个验证码和 URL，在任意设备的浏览器里打开 URL 输入验证码即可。
看懂界面：终端就是你的工作台
Codex CLI 没有图形界面，整个终端就是交互面板。启动后你会看到一个提示符，直接输入中文或英文指令即可。
核心工作流
Codex 遵循一套固定的 读取 → 提议 → 确认 → 应用 → 验证 循环：
你：解释一下这个项目的结构
→ Codex 读取文件目录，输出分析
你：给 login 函数加输入验证
→ Codex 读取 login 相关代码
→ 展示修改 diff
→ 你确认后应用修改
→ Codex 运行测试验证所有文件修改都会先展示 diff，你必须明确批准才会写入磁盘。
常用键盘快捷键
Enter | |
Esc | |
Esc Esc | |
Ctrl+C | |
Ctrl+C Ctrl+C | |
Ctrl+D | |
Ctrl+K | |
↑ / ↓ | |
Tab | |
@ | |
!command |
斜杠命令：会话中的控制面板
在输入框里输入 / 会弹出命令面板。以下是所有常用命令：
会话管理
/model | |
/permissions | |
/status | |
/compact | |
/plan | |
/review | |
/diff | |
/init | |
/quit/exit |
/status 长什么样
输入 /status 你会看到类似这样的信息：
Model: gpt-5-codex
Sandbox: workspace-write
Directory: ~/my-project
Token usage: 12,345 / 200,000
Plan: ChatGPT Plus沙盒模式：你的安全网
这是 Codex 相比 Claude Code 最大的差异化功能——操作系统级沙盒。
read-only | ||||
workspace-write | 日常开发首选 | |||
danger-full-access |
启动时指定模式：
codex -s workspace-write # 日常使用
codex --full-auto "任务描述" # 自动模式 + 沙盒保护
codex --yolo "任务描述" # 完全自主，无沙盒（仅限容器/VM）建议 永远保持 workspace-write，除非你在 Docker 容器里跑。
配置优化
config.toml（全局配置）
位置：~/.codex/config.toml，TOML 格式。
常用配置示例：
model = "gpt-5-codex"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
web_search = "cached"国内用户关键配置
如果你用第三方 API 代理：
openai_base_url = "https://你的代理地址/v1"
model = "gpt-5-codex"
model_provider = "openai"
sandbox_mode = "workspace-write"AGENTS.md（项目指令文件）
这是 Codex 版的 CLAUDE.md。在项目里输入 /init 自动生成，或者手动在项目根目录创建 AGENTS.md：
# AGENTS.md
- 使用 TypeScript 严格模式
- 所有函数必须有 JSDoc 注释
- 测试框架使用 Vitest
- 提交前运行 npm testCodex 每次启动都会读取这份文件，严格遵守你定的规则。也可以创建全局指令文件 ~/.codex/AGENTS.md，对所有项目生效。
启动参数速查
codex # 交互式 TUI
codex "解释这个项目" # 带初始提示启动
codex exec "修复测试" # 非交互执行，适合 CI/脚本
codex exec --full-auto "重构代码" # 全自动 + 沙盒保护
codex resume --last # 恢复上次会话
codex fork --last # 分叉上次会话到新线程
codex doctor # 诊断配置和网络问题与 Claude Code 的主要区别
如果你同时在用 Claude Code，这张表帮你快速对照：
codex resume --last | claude -c | |
--full-auto--yolo | --dangerously-skip-permissions | |
几个实用技巧
多用 /compact：AI 编程代理的上下文膨胀很快，感觉回复变慢就压缩一下，能省不少 token。
用 @ 引用文件：不要复制粘贴大段代码到输入框——费 token 还不精确。输入 @ 然后模糊搜索文件名即可。
先 /plan 再执行：做复杂任务时，先让 Codex 出方案，确认思路对了再切回执行模式，避免返工。
善用 /diff：改了什么随时看，不用切到另一个终端跑 git diff。
管道传日志：遇到报错直接把错误日志 pipe 给 Codex：
cat error.log | codex exec "解释这个错误并给出修复方案"总结
Codex CLI 的上手路径很简单：装 Node → npm 装 Codex → 登录 ChatGPT → 进项目目录敲 codex → 开始对话。五步走完，你就拥有了一个能在终端里帮你读代码、改文件、跑命令的 AI 编程代理。
如果你是 ChatGPT Plus 用户，Codex 是零额外成本的编程助手。如果你是 Claude Code 用户，Codex 的内置沙盒和全自动模式值得一试——两者可以共存，不同任务用不同工具。
它和 Claude Code 是同一类工具，但 Codex 有三个独特优势：完全开源（Rust 实现，Apache-2.0 协议）、内置系统级沙盒（macOS Seatbelt / Linux Landlock）、以及包含在 ChatGPT Plus 订阅里无需额外付费。
一句话总结：如果你已经有 ChatGPT Plus，Codex CLI 就是免费的 AI 编程助手。
安装前准备
在动手安装之前，确认这三件事：
Node.js ≥ 18（推荐 ≥ 22）。没有的话先去 nodejs.org 下载安装。
一个 OpenAI 账号。任何 ChatGPT 付费计划都行——Plus、Pro、Team、Enterprise、Edu。截至 2026 年 4 月，Codex 已包含在所有 ChatGPT 计划中，Free 和 Go 用户也可限时使用。
操作系统：macOS 或 Linux 原生支持。Windows 用户走 WSL2，不要直接在 Windows 下跑。
验证 Node.js 是否装好：
node --version
# 输出 v22.x.x 就对了三种安装方式
方式一：npm 全局安装（推荐）
最简单，全平台通用：
npm install -g @openai/codex国内用户如果下载慢，换淘宝镜像：
npm install -g @openai/codex --registry=https://registry.npmmirror.com方式二：Homebrew（仅 macOS）
brew install --cask codex方式三：GitHub Releases 二进制包
适合离线环境或不想装 Node.js 的情况。去 GitHub Releases 下载对应平台的包：
• macOS Apple Silicon → codex-aarch64-apple-darwin.tar.gz• macOS Intel → codex-x86_64-apple-darwin.tar.gz• Linux x86_64 → codex-x86_64-unknown-linux-musl.tar.gz• Linux ARM64 → codex-aarch64-unknown-linux-musl.tar.gz
解压后把二进制文件重命名为 codex，放到 PATH 里即可。
验证安装
codex --version
# 输出类似：@openai/codex, 0.125.0看到版本号就说明装好了。
Windows 用户看这里
Windows 原生支持仍处于实验阶段，走 WSL2 是最稳的方案：
第一步，安装 WSL2（管理员 PowerShell）：
wsl --install重启电脑后进入 WSL 终端。
第二步，在 WSL 里装 Node.js：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22第三步，按 Linux 流程装 Codex：
npm install -g @openai/codex注意：项目文件一定要放在 Linux 文件系统里（~/code/我的项目/），不要放在 /mnt/c/ 下，否则文件读写极慢。
首次启动与认证
进入你的项目目录，直接敲 codex：
cd ~/my-project
codex首次运行会自动弹浏览器，选认证方式：
ChatGPT 账号登录（推荐）：浏览器里完成 OAuth 授权，凭据缓存在 ~/.codex/token。此后使用不再需要重复登录。
API Key 登录：适合没有 ChatGPT 订阅、用 API 付费的用户：
export OPENAI_API_KEY="你的API_Key"
codex无浏览器环境（SSH/远程服务器）：
codex login --device-code终端会打印一个验证码和 URL，在任意设备的浏览器里打开 URL 输入验证码即可。
看懂界面：终端就是你的工作台
Codex CLI 没有图形界面，整个终端就是交互面板。启动后你会看到一个提示符，直接输入中文或英文指令即可。
核心工作流
Codex 遵循一套固定的 读取 → 提议 → 确认 → 应用 → 验证 循环：
你：解释一下这个项目的结构
→ Codex 读取文件目录，输出分析
你：给 login 函数加输入验证
→ Codex 读取 login 相关代码
→ 展示修改 diff
→ 你确认后应用修改
→ Codex 运行测试验证所有文件修改都会先展示 diff，你必须明确批准才会写入磁盘。
常用键盘快捷键
Enter | |
Esc | |
Esc Esc | |
Ctrl+C | |
Ctrl+C Ctrl+C | |
Ctrl+D | |
Ctrl+K | |
↑ / ↓ | |
Tab | |
@ | |
!command |
斜杠命令：会话中的控制面板
在输入框里输入 / 会弹出命令面板。以下是所有常用命令：
会话管理
/model | |
/permissions | |
/status | |
/compact | |
/plan | |
/review | |
/diff | |
/init | |
/quit/exit |
/status 长什么样
输入 /status 你会看到类似这样的信息：
Model: gpt-5-codex
Sandbox: workspace-write
Directory: ~/my-project
Token usage: 12,345 / 200,000
Plan: ChatGPT Plus沙盒模式：你的安全网
这是 Codex 相比 Claude Code 最大的差异化功能——操作系统级沙盒。
read-only | ||||
workspace-write | 日常开发首选 | |||
danger-full-access |
启动时指定模式：
codex -s workspace-write # 日常使用
codex --full-auto "任务描述" # 自动模式 + 沙盒保护
codex --yolo "任务描述" # 完全自主，无沙盒（仅限容器/VM）建议 永远保持 workspace-write，除非你在 Docker 容器里跑。
配置优化
config.toml（全局配置）
位置：~/.codex/config.toml，TOML 格式。
常用配置示例：
model = "gpt-5-codex"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
web_search = "cached"国内用户关键配置
如果你用第三方 API 代理：
openai_base_url = "https://你的代理地址/v1"
model = "gpt-5-codex"
model_provider = "openai"
sandbox_mode = "workspace-write"AGENTS.md（项目指令文件）
这是 Codex 版的 CLAUDE.md。在项目里输入 /init 自动生成，或者手动在项目根目录创建 AGENTS.md：
# AGENTS.md
- 使用 TypeScript 严格模式
- 所有函数必须有 JSDoc 注释
- 测试框架使用 Vitest
- 提交前运行 npm testCodex 每次启动都会读取这份文件，严格遵守你定的规则。也可以创建全局指令文件 ~/.codex/AGENTS.md，对所有项目生效。
启动参数速查
codex # 交互式 TUI
codex "解释这个项目" # 带初始提示启动
codex exec "修复测试" # 非交互执行，适合 CI/脚本
codex exec --full-auto "重构代码" # 全自动 + 沙盒保护
codex resume --last # 恢复上次会话
codex fork --last # 分叉上次会话到新线程
codex doctor # 诊断配置和网络问题与 Claude Code 的主要区别
如果你同时在用 Claude Code，这张表帮你快速对照：
codex resume --last | claude -c | |
--full-auto--yolo | --dangerously-skip-permissions | |
几个实用技巧
多用 /compact：AI 编程代理的上下文膨胀很快，感觉回复变慢就压缩一下，能省不少 token。
用 @ 引用文件：不要复制粘贴大段代码到输入框——费 token 还不精确。输入 @ 然后模糊搜索文件名即可。
先 /plan 再执行：做复杂任务时，先让 Codex 出方案，确认思路对了再切回执行模式，避免返工。
善用 /diff：改了什么随时看，不用切到另一个终端跑 git diff。
管道传日志：遇到报错直接把错误日志 pipe 给 Codex：
cat error.log | codex exec "解释这个错误并给出修复方案"总结
Codex CLI 的上手路径很简单：装 Node → npm 装 Codex → 登录 ChatGPT → 进项目目录敲 codex → 开始对话。五步走完，你就拥有了一个能在终端里帮你读代码、改文件、跑命令的 AI 编程代理。
如果你是 ChatGPT Plus 用户，Codex 是零额外成本的编程助手。如果你是 Claude Code 用户，Codex 的内置沙盒和全自动模式值得一试——两者可以共存，不同任务用不同工具。
