OpenAI Codex CLI
OpenAI Codex CLI 安装教程 — 在 Windows、macOS、Linux 上安装终端 AI 编程助手，对接 Go2AIs。支持沙箱策略与原子补丁编辑。
效果演示
特性
| 功能分类 | 特性 |
|---|---|
| 终端式编码助手 | 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)。
安装完成后重启 Windows 计算机。
wsl安装 Node.js（版本号有时效性，请根据 OpenAI 官网 要求安装对应版本）：
nvm install 22
3.安装 Codex CLI
这个命令会从 npm 官方仓库下载并安装最新版本的 Codex CLI。
4.修改配置文件
5.开始使用 Codex CLI
现在你可以开始使用 Codex CLI 了！
wsl直接启动 Codex CLI：
codex在特定项目中使用：
cd mnt/c/path/to/your/project
codex按 Enter 启动 Codex CLI。
设置 Codex CLI 的权限：1. 允许 Codex 直接修改文件；2. Codex 修改文件需要手动授权
注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。请使用您自己部署的 Go2AIs，或确认服务方具备合法上游授权和合规义务的 Go2AIs 服务。不要将来源不明的 API 地址或密钥接入生产环境。
macOS 端图文指引
1.安装 Homebrew (已安装请跳过)
Homebrew 是 macOS 缺失的软件包的管理器。
2.安装 Node.js 环境
brew update安装 Node.js：
brew install node
node --version
npm --version如果显示版本号，说明安装成功。
3.安装 Codex CLI
# 全局安装 Codex CLI
npm install -g @openai/codex如果遇到权限问题，可以使用 sudo：
sudo npm install -g @openai/codex
codex --version如果显示版本号，恭喜你！Codex CLI 已经成功安装了。
4.修改配置文件
5.开始使用 Codex CLI
现在你可以开始使用 Codex CLI 了！
codex在特定项目中使用：
cd /path/to/your/project
codex按 Enter 启动 Codex CLI。
设置 Codex CLI 的权限：1. 允许 Codex 直接修改文件；2. Codex 修改文件需要手动授权
注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。
6.macOS 常见问题解决
- 使用
sudo安装：sudo npm install -g @openai/codex - 或者配置
npm使用用户目录：npm config set prefix ~/.npm-global
- 打开"系统偏好设置" → "安全性与隐私"
- 点击"仍要打开"或"允许"
- 或者在 Terminal 中运行：
sudo spctl --master-disable
Linux 端图文指引
1.安装 Node.js 环境
Codex CLI 需要 Node.js 环境才能运行。
sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -安装 Node.js：
sudo apt-get install -y nodejs
node --version
npm --version如果显示版本号，说明安装成功。
2.安装 Codex CLI
# 全局安装 Codex CLI
npm install -g @openai/codex如果遇到权限问题，可以使用 sudo：
sudo npm install -g @openai/codex
codex --version如果显示版本号，恭喜你！Codex CLI 已经成功安装了。
3.修改配置文件
4.开始使用 Codex CLI
现在你可以开始使用 Codex CLI 了！
codex在特定项目中使用：
# 进入你的项目目录
cd /path/to/your/project
# 启动 Codex CLI
codex按 Enter 启动 Codex CLI。
设置 Codex CLI 的权限：1. 允许 Codex 直接修改文件；2. Codex 修改文件需要手动授权
注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。
5.Linux 常见问题解决
- 使用
sudo安装：sudo npm install -g @openai/codex - 或者配置
npm使用用户目录：npm config set prefix ~/.npm-global - 然后添加到 PATH：
export PATH=~/.npm-global/bin:$PATH
# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"