INFO: 项目介绍 Codex CLI 是一个来自 OpenAI 的编码代理,可在您的计算机上本地运行。

| 功能分类 | 特性 |
|---|---|
| 终端式编码助手 | 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 并行运行多个工具以提升效率。 |

INFO: 安装 WSL2,重启 Windows 计算机 wsl --install安装完成后重启 Windows 计算机。
WARN: Windows 注意事项 建议使用 PowerShell 而不是 CMD 如果遇到权限问题,尝试以管理员身份运行 某些杀毒软件可能会误报,需要添加白名单

INFO: 下载 Node Version Manager (NVM)

INFO: NVM 安装 Node.js 22 标签栏新开一个 PowerShell 窗口,打开 WSL: 安装 Node.js(版本号有时效性,请根据 OpenAI 官网 要求安装对应版本):

INFO: 安装 Codex CLI 这个命令会从 npm 官方仓库下载并安装最新版本的 Codex CLI。

INFO: 一键修改 Codex CLI 配置文件 iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.ps1')

INFO: 启动 Codex CLI 启动 WSL2: 直接启动 Codex CLI: 在特定项目中使用: 按 Enter 启动 Codex CLI。


设置 Codex CLI 的权限:1. 允许 Codex 直接修改文件;2. Codex 修改文件需要手动授权
INFO: 选择模型




注意:修改接口地址后,使用所有模型(包括官方预设模型)均调用自定义接入点,而不使用官方账号额度。

INFO: 安装 Homebrew



INFO: Node.js 环境安装步骤 更新 Homebrew: 安装 Node.js:
WARN: macOS 注意事项 如果遇到权限问题,可能需要使用 sudo首次运行可能需要在系统偏好设置中允许 建议使用 Terminal 或 iTerm2


INFO: 验证安装是否成功 安装完成后,打开终端,输入以下命令: 如果显示版本号,说明安装成功。
INFO: 安装 Codex CLI 打开终端,运行以下命令: 如果遇到权限问题,可以使用 sudo:

INFO: 验证 Codex CLI 安装 安装完成后,输入以下命令检查是否安装成功: 如果显示版本号,恭喜你!Codex CLI 已经成功安装了。