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 了!
注意:修改介面地址後,使用所有模型(包括官方預設模型)均調用您設定的、合法授權的自有或組織接入點。