Skip to main content
本頁的安裝命令和 config.toml 欄位依據 OpenAI Codex 官方儲存庫及自訂 Provider 參考。NexusAPI 僅提供位址、API Key 和模型 ID。

​
1. 安裝

選擇一種官方方式即可：

​
Windows PowerShell

​
macOS、Linux 或 WSL

​
已安裝 Node.js 的使用者

安裝完成後亦可在新終端單獨確認版本：

​
2. 建立相容的 Key

在控制台 令牌管理 → 新增令牌 選擇包含目標模型的群組，設定名稱和專案額度。建立後請看能力矩陣，並以 /v1/models 確認 supported_endpoint_types 包含 openai-response。

​
3. 設定自訂 Provider

請將 YOUR_MODEL_ID 替換成目前 Key 可用的準確模型 ID。不要在設定檔中保存真實 Key。
請將 NexusAPI Key 保存在環境變數。上方設定會透過 env_key 從 NEXUSAPI_API_KEY 讀取 Key；auth.json 可能包含 Codex 的憑證狀態，無須把 NexusAPI Key 寫入其中，也不要將包含 Key 的檔案提交或截圖分享。

​
4. 設定環境變數

​
Windows PowerShell

​
macOS、Linux 或 WSL

Windows 的 setx 需要新開終端才生效；臨時 export 僅對目前 Shell 生效。請使用系統憑證或受控的環境變數管理方案長期保存，不要提交到儲存庫。

​
5. 驗證與排查

進入專案目錄後啟動：
首次請使用不修改檔案的任務：
然後檢查控制台使用紀錄。若失敗，確認新終端已取得 Key、Key／群組／模型 ID 正確，並保留錯誤及 Request ID 後依問題自查處理。

​
問題排查

  1. 確認 NEXUSAPI_API_KEY 已在新開的終端中生效。
  2. 確認 Key 已啟用、帳戶額度足夠且所屬群組包含選定模型。
  3. 從模型廣場或 /v1/models 重新複製完全一致的模型 ID。
  4. 持續錯誤時保存原始錯誤與 Request ID，並依問題自查處理。

​
VS Code / Cursor

可從擴充功能市集安裝由 OpenAI 發布的 Codex 擴充功能。它會共用使用者層級的 Codex 設定；不要在 VS Code 寫入舊版的 chatgpt.apiBase 或 chatgpt.config 欄位。

​
官方來源