OpenAI Codex CLI

OpenAI Codex CLI 安裝教程 — 在 Windows、macOS、Linux 上安裝終端 AI 編程助手,對接 CoffeeRouter。支援沙箱策略與原子補丁編輯。

效果演示

introduce-01.webp

特性

功能分類特性
終端式編码助手Codex CLI 是一個基於終端的交互式編码助理,用於在命令行中編輯程式碼、生成補丁并執行命令。
工具驅動架構提供 apply_patchshellupdate_planmulti_tool_use 等工具,用於對倉庫檔案和操作進行可控修改。
原子補丁編輯使用專門的補丁格式通過 apply_patch 原子地添加/更新/刪除檔案,便於審計與回滾。
沙箱與審批支援沙箱策略(如 workspace-writeread-only)和審批模式(on-requeston-failurenever),控制寫入與網路訪問權限。
計劃追蹤update_plan 用於列出步驟并跟蹤狀態,要求始終只有一個 in_progress 步驟以保持明確進度。
交互規范在重要操作前發送簡短前導說明,保持語氣友好、簡潔并提供進度更新。
安全約束遵循嚴格規則(不隨意更改無關檔案、不添加版權頭、不執行破壞性命令),需要使用者批准敏感操作。
測試與格式化推薦在修改後執行相關測試與格式化工具,但不負責修復與目前任務無關的問題。
輸出與風格最終輸出遵循 CLI 渲染規范(例如 ** 標題、反引號表示路徑/命令),保持可掃描的簡潔結構。
并行執行支援通過 multi_tool_use.parallel 并行執行多個工具以提升效率。

AI 模型設定方法

Windows 端圖文指引

1.打開終端

windows_open_terminal

2.安裝 WSL

為在 Windows 上獲得最佳性能,請安裝并使用 Windows Subsystem for Linux (WSL2)。

windows-img-04.webp

windows-img-05.webp

3.安裝 Codex CLI

windows-img-06.webp

4.修改設定檔案

windows-configure

5.開始使用 Codex CLI

現在你可以開始使用 Codex CLI 了!

windows-img-09.webp

windows-img-10.webp

windows-img-11.webp

windows-img-12.webp

windows-img-13.webp

windows-img-14.webp

注意:修改介面地址後,使用所有模型(包括官方預設模型)均調用您設定的、合法授權的自有或組織接入點。請使用您自己部署的 CoffeeRouter,或確認服務方具備合法上遊授權和合規義務的 CoffeeRouter 服務。不要將來源不明的 API 地址或密鑰接入生產環境。

macOS 端設定說明

1.安裝 Homebrew (已安裝請跳過)

Homebrew 是 macOS 缺失的軟件包的管理器。

官網:https://brew.sh

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 了!

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

5.Linux 常見問題解決