88API88API
使用指南AI 應用API 文件幫助支援

Codex CLI


WindowsmacOSLinux

專案介紹

Codex CLI is a coding agent from OpenAI that runs locally on your computer.

Codex CLI 是一個來自 OpenAI 的編碼代理,可在您的計算機上本地執行。

  1. 官方主頁:https://chatgpt.com/codex
  2. 專案主頁:https://github.com/openai/codex
  3. 安裝方法:見本頁下方教程

效果演示


introduce-01.webp

特性

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

AI 模型配置方法

Windows 端圖文指引

1.開啟終端

windows_open_terminal

2.安裝 WSL

Codex 現已原生支援 Windows:可直接在 PowerShell 中執行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"(或已安裝 Node.js 時執行 npm i -g @openai/codex)安裝,再用第 4 步中的 PowerShell 版一鍵腳本配置後直接在 PowerShell 執行 codex。如需 Linux 工具鏈,再按下文使用 WSL2(此時 Codex 和配置腳本都必須在 WSL 內執行,見第 4 步)。

安裝 WSL2,重啟 Windows 計算機

wsl --install 安裝完成後重啟 Windows 計算機

Windows 注意事項

  • 建議使用 PowerShell 而不是 CMD
  • 如果遇到許可權問題,嘗試以管理員身份執行
  • 某些防毒軟體可能會誤報,需要新增白名單

windows-img-03.webp

下載 Node Version Manager (NVM)

重啟後開啟 PowerShell,先輸入 wsl 進入 Ubuntu,再執行:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

windows-img-04.webp

NVM 安裝 Node.js 22

標籤欄新開一個 PowerShell 視窗,開啟 WSL wsl

安裝 Node.js(Codex 的 npm 套件要求 Node.js 16 及以上,推薦安裝 22 LTS):

nvm install 22

windows-img-05.webp

3.安裝 Codex CLI

安裝 Codex CLI

npm i -g @openai/codex 這個命令會從 npm 官方倉庫下載並安裝最新版本的 Codex CLI。

windows-img-06.webp

4.修改配置檔案(在 WSL 中執行)

Codex 安裝在 WSL 裡,配置也必須寫入 WSL。先在 PowerShell 輸入 wsl 進入 Ubuntu,然後執行:

一鍵修改 Codex CLI 配置檔案(在 WSL 中執行)

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

windows-configure

腳本提示為簡體中文,數值與正文相同。

提示 API 基础地址 時直接按 Enter(預設 https://api.88api.ai,腳本會自動補全為 https://api.88api.ai/v1),再貼上你的 88API 權杖(輸入時不顯示)。腳本會寫入 WSL 內的 ~/.codex/config.toml(不是 Windows 的 %USERPROFILE%\.codex;設定了 CODEX_HOME 時寫入該目錄),預設使用 model_provider = "88api"、wire_api = "responses" 和 Provider 專屬 experimental_bearer_token,完成後會顯示 API 基础地址: https://api.88api.ai/v1 和 已写入: …/config.toml。新版腳本不再把 88API Key 寫入 auth.json.OPENAI_API_KEY,避免新版 Codex 出現 API_KEY_REQUIRED / 401 Unauthorized。

注意:腳本會覆蓋現有 config.toml,原檔案會自動備份為 config.toml.bak.<時間>(執行時顯示 已备份原配置: …);如果你配置過 MCP 伺服器、專案信任或其他 Provider,請從備份中合併回來。

不使用 WSL(Windows 原生 PowerShell)

只有在 Windows 原生 PowerShell 中安裝並執行 Codex(不使用 WSL)時,才使用 PowerShell 版腳本,它會寫入 %USERPROFILE%\.codex\config.toml:

curl.exe --ssl-no-revoke -fsSL https://88api.ai/helper/codex-cli-setup.ps1 -o "$env:TEMP\codex-cli-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-cli-setup.ps1"

提示與寫入內容同上,完成後直接在 PowerShell 中執行 codex。

手動配置 config.toml(可選)

如需手動配置,寫入 ~/.codex/config.toml(Windows 原生為 %USERPROFILE%\.codex\config.toml):

model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"

[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-你的88API金鑰"

注意:base_url 必須以 /v1 結尾(Codex 只會在後面拼接 /responses,不會自動補 /v1;漏寫 /v1 會被重新導向到官網導致報錯);wire_api 只能填 responses(新版 Codex 已移除 chat)。

5.開始使用 Codex CLI

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

啟動 Codex CLI

先輸入 wsl 進入 Ubuntu;直接啟動:codex;在特定專案中使用:cd ~/code/your-project(建議放在 WSL 的 Linux 目錄;Windows 目錄寫作 cd /mnt/c/Users/<使用者名稱>/path/to/project),然後執行 codex。

windows-img-09.webp

windows-img-10.webp

設定 Codex CLI 的許可權:1.允許 Codex 直接修改檔案;2.Codex 修改檔案需要手動授權

選擇模型

/model

用方向鍵在 Select Model and Effort 中選擇模型(目前使用的標有 (current)),按 Enter 後在 Select Reasoning Level 中選擇推理強度:按 Enter 設為預設,按 s 只在本次工作階段中使用。標有 (default) 的是設定檔裡 model_reasoning_effort 的值(按本教學設定為 high)。

Codex CLI 中輸入 /model 選擇模型

Codex CLI 中選擇推理強度

注意:配置完成後 /model 中的所有模型都會走 88API 介面,不消耗官方賬號額度。88API 當前可在 Codex 中使用的模型:gpt-6.1-sol(腳本預設,推薦)、gpt-6-astra(旗艦)、gpt-6-sol、gpt-5.6-sol(舊版腳本預設)、gpt-5.6-terra、gpt-6.1-terra、gpt-5.5(需你的權杖分組包含該模型;分組中沒有 gpt-6.1-sol 時可改用 gpt-6-astra);列表中的 gpt-6-luna、gpt-5.6-luna 88API 暫未提供,選擇後會報模型不存在。

macOS 端圖文指引

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

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

官網:https://brew.sh

macos-img-01.webp

安裝 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

macos-img-02.webp

macos-img-03.webp

macos-img-04.webp

2.安裝 Node.js 環境

Node.js 環境安裝步驟

更新 Homebrew brew update 安裝 Node.js brew install node

macOS 注意事項

  • 如果遇到許可權問題,可能需要使用 sudo
  • 首次執行可能需要在「系統設定」中允許
  • 建議使用 Terminal 或 iTerm2

macos-img-05.webp

macos-img-06.webp

驗證安裝是否成功

安裝完成後,開啟終端,輸入以下命令:

node --version
npm --version

如果顯示版本號,說明安裝成功。

3.安裝 Codex CLI

安裝 Codex CLI

開啟終端,執行:

npm install -g @openai/codex

如遇許可權問題:sudo npm install -g @openai/codex。也可以用 Homebrew 安裝:brew install --cask codex。

macos-img-07.webp

驗證 Codex CLI 安裝

安裝完成後,輸入以下命令檢查是否安裝成功: codex --version 如果顯示版本號,恭喜你!Codex CLI 已經成功安裝了。

4.修改配置檔案

一鍵修改 Codex CLI 配置檔案

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

macos-configure

腳本提示為簡體中文,數值與正文相同。

提示 API 基础地址 時直接按 Enter(預設 https://api.88api.ai,腳本會自動補全為 https://api.88api.ai/v1),再貼上你的 88API 權杖(輸入時不顯示)。腳本會寫入 ~/.codex/config.toml(設定了 CODEX_HOME 時寫入該目錄),預設使用 model_provider = "88api"、wire_api = "responses" 和 Provider 專屬 experimental_bearer_token,完成後會顯示 API 基础地址: https://api.88api.ai/v1 和 已写入: …/config.toml。新版腳本不再把 88API Key 寫入 auth.json.OPENAI_API_KEY。

注意:腳本會覆蓋現有 config.toml,原檔案會自動備份為 config.toml.bak.<時間>(執行時顯示 已备份原配置: …);如果你配置過 MCP 伺服器、專案信任或其他 Provider,請從備份中合併回來。

手動配置 config.toml(可選)

如需手動配置,寫入 ~/.codex/config.toml:

model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"

[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-你的88API金鑰"

注意:base_url 必須以 /v1 結尾(Codex 只會在後面拼接 /responses,不會自動補 /v1;漏寫 /v1 會被重新導向到官網導致報錯);wire_api 只能填 responses(新版 Codex 已移除 chat)。

5.開始使用 Codex CLI

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

啟動 Codex CLI

直接啟動 Codex CLI:codex;在特定專案中使用:先 cd ~/path/to/your/project,再執行 codex。

macos-img-09.webp

macos-img-10.webp

設定 Codex CLI 的許可權:1.允許 Codex 直接修改檔案;2.Codex 修改檔案需要手動授權

用方向鍵在 Select Model and Effort 中選擇模型(目前使用的標有 (current)),按 Enter 後在 Select Reasoning Level 中選擇推理強度:按 Enter 設為預設,按 s 只在本次工作階段中使用。標有 (default) 的是設定檔裡 model_reasoning_effort 的值(按本教學設定為 high)。

Codex CLI 中輸入 /model 選擇模型

Codex CLI 中選擇推理強度

注意:配置完成後 /model 中的所有模型都會走 88API 介面,不消耗官方賬號額度。88API 當前可在 Codex 中使用的模型:gpt-6.1-sol(腳本預設,推薦)、gpt-6-astra(旗艦)、gpt-6-sol、gpt-5.6-sol(舊版腳本預設)、gpt-5.6-terra、gpt-6.1-terra、gpt-5.5(需你的權杖分組包含該模型;分組中沒有 gpt-6.1-sol 時可改用 gpt-6-astra);列表中的 gpt-6-luna、gpt-5.6-luna 88API 暫未提供,選擇後會報模型不存在。

6.macOS 常見問題解決

安裝時提示許可權錯誤

嘗試以下解決方法:

  • 使用sudo安裝:sudo npm install -g @openai/codex
  • 或者配置npm使用使用者目錄:npm config set prefix ~/.npm-global

macOS 安全設定阻止執行

如果系統阻止執行 Codex CLI:

  • 開啟「系統設定」→「隱私權與安全性」,在「安全性」區域找到被阻擋的 codex,點選「仍要開啟」
  • 不建議使用 sudo spctl --master-disable 全域關閉 Gatekeeper(透過 npm 安裝的 Codex 一般不會被攔截,新版 macOS 也已不支援直接用該命令關閉)

Linux 端圖文指引

1.安裝 Node.js 環境

Codex CLI 需要 Node.js 環境才能執行。

Node.js 環境安裝步驟

新增 NodeSource 倉庫 sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - 安裝 Node.js sudo apt-get install -y nodejs

Linux 注意事項

  • 某些發行版可能需要安裝額外的依賴
  • 如果遇到許可權問題,使用 sudo
  • 確保你的使用者在 npm 的全域性目錄有寫許可權

linux-img-01.webp

linux-img-02.webp

驗證安裝是否成功

安裝完成後,開啟終端,輸入以下命令:

node --version
npm --version

如果顯示版本號,說明安裝成功。

2.安裝 Codex CLI

安裝 Codex CLI

開啟終端,執行:

npm install -g @openai/codex

如遇許可權問題:sudo npm install -g @openai/codex

linux-img-03.webp

驗證 Codex CLI 安裝

安裝完成後,輸入以下命令檢查是否安裝成功: codex --version 如果顯示版本號,恭喜你!Codex CLI 已經成功安裝了。

3.修改配置檔案

一鍵修改 Codex CLI 配置檔案

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

macos-configure

腳本提示為簡體中文,數值與正文相同。

提示 API 基础地址 時直接按 Enter(預設 https://api.88api.ai,腳本會自動補全為 https://api.88api.ai/v1),再貼上你的 88API 權杖(輸入時不顯示)。腳本會寫入 ~/.codex/config.toml(設定了 CODEX_HOME 時寫入該目錄),預設使用 model_provider = "88api"、wire_api = "responses" 和 Provider 專屬 experimental_bearer_token,完成後會顯示 API 基础地址: https://api.88api.ai/v1 和 已写入: …/config.toml。新版腳本不再把 88API Key 寫入 auth.json.OPENAI_API_KEY。

注意:腳本會覆蓋現有 config.toml,原檔案會自動備份為 config.toml.bak.<時間>(執行時顯示 已备份原配置: …);如果你配置過 MCP 伺服器、專案信任或其他 Provider,請從備份中合併回來。

手動配置 config.toml(可選)

如需手動配置,寫入 ~/.codex/config.toml:

model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"

[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-你的88API金鑰"

注意:base_url 必須以 /v1 結尾(Codex 只會在後面拼接 /responses,不會自動補 /v1;漏寫 /v1 會被重新導向到官網導致報錯);wire_api 只能填 responses(新版 Codex 已移除 chat)。

4.開始使用 Codex CLI

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

啟動 Codex CLI

# 進入你的專案目錄
cd /path/to/your/project
# 啟動 Codex CLI
codex

linux-img-05.webp

linux-img-06.webp

設定 Codex CLI 的許可權:1.允許 Codex 直接修改檔案;2.Codex 修改檔案需要手動授權

用方向鍵在 Select Model and Effort 中選擇模型(目前使用的標有 (current)),按 Enter 後在 Select Reasoning Level 中選擇推理強度:按 Enter 設為預設,按 s 只在本次工作階段中使用。標有 (default) 的是設定檔裡 model_reasoning_effort 的值(按本教學設定為 high)。

Codex CLI 中輸入 /model 選擇模型

Codex CLI 中選擇推理強度

注意:配置完成後 /model 中的所有模型都會走 88API 介面,不消耗官方賬號額度。88API 當前可在 Codex 中使用的模型:gpt-6.1-sol(腳本預設,推薦)、gpt-6-astra(旗艦)、gpt-6-sol、gpt-5.6-sol(舊版腳本預設)、gpt-5.6-terra、gpt-6.1-terra、gpt-5.5(需你的權杖分組包含該模型;分組中沒有 gpt-6.1-sol 時可改用 gpt-6-astra);列表中的 gpt-6-luna、gpt-5.6-luna 88API 暫未提供,選擇後會報模型不存在。

5.Linux 常見問題解決

安裝時提示許可權錯誤

嘗試以下解決方法:

  • 使用sudo安裝:sudo npm install -g @openai/codex

  • 或者配置npm使用使用者目錄:npm config set prefix ~/.npm-global

  • 然後新增到PATH:export PATH=~/.npm-global/bin:$PATH

缺少依賴庫

某些 Linux 發行版需要安裝額外依賴:

# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"