Appearance
Codex CLI 是 OpenAI 开源的本地终端 AI 编程 Agent，用 Rust 编写，速度快。在你的机器上启动一个 TUI 交互会话，可以读文件、改代码、执行命令——所有操作都在你选定的目录里进行。支持图片输入、子代理并行、MCP 集成和脚本自动化，跨 macOS/Linux 运行。Windows 实验性支持，推荐 WSL2 方案。
Codex CLI：本地终端 AI 编程 Agent
Codex CLI 是 OpenAI 开源（基于 Rust）的本地 AI 编程 Agent，可以在终端里读代码、改代码、执行命令。ChatGPT Plus、Pro、Business、Edu、Enterprise 计划均已包含。
详细定价参考：Codex 定价
安装与启动
安装 Codex CLI
bash
# macOS / Linux（使用 npm）
npm install -g @openai/codex
# 或使用 Homebrew（macOS）
brew install codexCodex CLI 支持 macOS 和 Linux。Windows 支持为实验性——建议在 WSL2 里使用，参考 Windows 安装指南。
登录
bash
codex login用 ChatGPT 账户或 OpenAI API Key 登录。API Key 方式下，部分云端功能可能不可用。
第一次运行
在你的项目目录下执行：
bash
codex这会启动一个终端交互界面（TUI），Codex 在当前目录里工作。
核心功能
交互模式（TUI）
执行 codex 直接进入 TUI 会话。在这里你可以用自然语言向 Codex 下指令，Codex 会在当前目录里读写文件、执行命令。
常用 slash 命令：
| 命令 | 作用 |
|---|---|
/model | 切换模型（GPT-5.4、GPT-5.3-Codex 等） |
/approvals | 调整审批模式 |
/agent | 切换查看子代理线程 |
/mcp | 查看已连接的 MCP 服务器 |
完整 slash 命令列表参考：CLI Slash 命令
模型与推理控制
在 TUI 里输入 /model 即可切换模型。可选模型包括 GPT-5.4（最强）、GPT-5.3-Codex（性价比高）等，也可调整 reasoning effort（高/中/低）控制速度与质量的平衡。
图片输入
发送指令时可以附上截图或设计稿，Codex 会把图片和你的文本一起理解。适合「按设计图修改 UI」「参考截图排查 Bug」等场景。
本地 Code Review
让一个单独的 Codex 子代理在你提交之前帮你审查代码：
text
Review the current changes in this branch before I commit.
Focus on: correctness, security, edge cases.这会启动一个 read-only 探索模式的子代理，只审查不修改。
子代理并行
对于复杂任务（多文件改动、多维度 PR Review），可以让 Codex 同时启动多个子代理并行工作：
text
Review this PR. Spawn one agent per point and summarize:
1. Security issues
2. Code quality
3. Bugs
4. Test coverage详见：子代理使用指南
Web Search
Codex CLI 内置联网搜索，可以在任务里检索最新文档或资料：
text
Find the latest breaking changes in React 19 and update our components accordingly.Codex Cloud 集成
在 CLI 里也能启动 Cloud 任务——选择云端环境，让 Codex 在隔离沙箱里跑长时任务，完成后把 diff 拉回本地应用。
text
Run this refactor in a cloud environment. Apply the diff when done.详见：Codex Cloud
MCP 集成
通过 MCP（Model Context Protocol）给 Codex 接入更多工具和文档。在 CLI 里用 codex mcp add 添加 MCP 服务器：
bash
codex mcp add context7 -- npx -y @upstash/context7-mcp详见：MCP 配置指南
脚本自动化（exec 模式）
用 exec 命令把 Codex 变成可脚本化的工具，用于 CI/CD 流水线或批量任务：
bash
codex exec "Fix all TypeScript errors and run tests"审批模式
Codex 在执行写文件、运行命令等操作前需要你的审批。根据信任程度选择合适的模式：
| 模式 | 含义 |
|---|---|
suggest（默认） | 每次操作都要确认 |
auto-edit | 自动允许文件编辑，命令仍需确认 |
full-auto | 完全自动化，不弹确认（谨慎使用） |
在 TUI 里输入 /approvals 实时切换。
最佳实践
- 初次接触新项目：先让 Codex
Tell me about this project，建立上下文再开始任务 - 给出约束条件：在 Prompt 里明确"只改 X 目录"、"不添加新依赖"，避免意外大改
- 配合 AGENTS.md：把项目级规则写进
AGENTS.md，Codex 每次启动都会自动加载 - Code Review 前：用
Review this branch让 Codex 做一轮检查，再自己审查
更多最佳实践：Codex 最佳实践
常见问题
Q: Codex CLI 和 Codex App 有什么区别？
A: CLI 是纯命令行的，轻量灵活，适合集成到现有终端工作流、配合脚本自动化使用。App 是专注于并行多任务的桌面客户端，内置 Git 工具、Worktrees 和 Automations。两者共享 Skills 配置，可以配合使用。
Q: Windows 上能用吗？
A: 可以，但目前是实验性支持。推荐在 WSL2 里运行，体验更稳定。参考 Windows 配置指南。
Q: Codex 可以执行危险命令吗？如何防止误操作？
A: 默认的 suggest 审批模式下，所有写文件和执行命令的操作都需要你手动确认。只有你明确切换到 full-auto 模式才会完全自动化。沙箱配置详见 Agent 审批与安全。