OpenAI Codex CLI
OpenAI Codex CLI 安装教程 — 在 Windows、macOS、Linux 上安装终端 AI 编程助手，对接 CoffeeRouter。支持沙箱策略与原子补丁编辑。
效果演示
特性
| 功能分类 | 特性 |
|---|---|
| 终端式编码助手 | Codex CLI 是一个基于终端的交互式编码助理，用于在命令行中编辑代码、生成补丁并运行命令。 |
| 工具驱动架构 | 提供 apply_patch、shell、update_plan、multi_tool_use 等工具，用于对仓库文件和操作进行可控修改。 |
| 原子补丁编辑 | 使用专门的补丁格式通过 apply_patch 原子地添加/更新/删除文件，便于审计与回滚。 |
| 沙箱与审批 | 支持沙箱策略（如 workspace-write、read-only）和审批模式（on-request、on-failure、never），控制写入与网络访问权限。 |
| 计划追踪 | update_plan 用于列出步骤并跟踪状态，要求始终只有一个 in_progress 步骤以保持明确进度。 |
| 交互规范 | 在重要操作前发送简短前导说明，保持语气友好、简洁并提供进度更新。 |
| 安全约束 | 遵循严格规则（不随意更改无关文件、不添加版权头、不执行破坏性命令），需要用户批准敏感操作。 |
| 测试与格式化 | 推荐在修改后运行相关测试与格式化工具，但不负责修复与当前任务无关的问题。 |
| 输出与风格 | 最终输出遵循 CLI 渲染规范（例如 ** 标题、反引号表示路径/命令），保持可扫描的简洁结构。 |
| 并行执行 | 支持通过 multi_tool_use.parallel 并行运行多个工具以提升效率。 |
AI 模型配置方法
Windows 端图文指引
1.打开终端
2.安装 WSL
为在 Windows 上获得最佳性能，请安装并使用 Windows Subsystem for Linux (WSL2)。
3.安装 Codex CLI
4.修改配置文件
5.开始使用 Codex CLI
现在你可以开始使用 Codex CLI 了！
注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。请使用您自己部署的 CoffeeRouter，或确认服务方具备合法上游授权和合规义务的 CoffeeRouter 服务。不要将来源不明的 API 地址或密钥接入生产环境。
macOS 端配置说明
1.安装 Homebrew (已安装请跳过)
Homebrew 是 macOS 缺失的软件包的管理器。
2.安装 Node.js 环境
3.安装 Codex CLI
4.修改配置文件
5.开始使用 Codex CLI
现在你可以开始使用 Codex CLI 了！
注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。
6.macOS 常见问题解决
Linux 端配置说明
1.安装 Node.js 环境
Codex CLI 需要 Node.js 环境才能运行。
2.安装 Codex CLI
3.修改配置文件
4.开始使用 Codex CLI
现在你可以开始使用 Codex CLI 了！
注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。