Codex - Alibaba Cloud Model Studio

Codex 是 OpenAI 推出的終端 AI 編程助手。可通過 Token Plan 團隊版、Coding Plan 或隨用隨付接入阿里雲百鍊。

安裝 Codex

安裝或更新 Node.js（v18.0 或更高版本）。
在終端中執行以下命令安裝 Codex。
```
npm install -g @openai/codex
```
執行以下命令驗證安裝。
```
codex --version
```

配置接入憑證

接入需要編輯設定檔~/.codex/config.toml並配置環境變數OPENAI_API_KEY。根據所選計費方案替換對應值，阿里雲百鍊提供三種計費方案：

Token Plan 團隊版

model請選擇支援的模型。將OPENAI_API_KEY環境變數設定為 Token Plan 團隊版專屬 API Key。

Responses API（qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

qwen3.7-max、qwen3.7-plus、qwen3.6-plus 和 qwen3.6-flash 支援 Responses API，可使用最新版 Codex。

model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-max"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API（其他模型）

其他模型需通過 Chat/Completions API 接入，需安裝舊版本 Codex，如 0.80.0：

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Token_Plan"
model = "glm-5"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置環境變數

將OPENAI_API_KEY環境變數設定為 Token Plan 團隊版專屬 API Key。

macOS

在終端中執行以下命令，查看預設 Shell 類型。
```
echo $SHELL
```

根據 Shell 類型設定環境變數：

Zsh

# 將 YOUR_API_KEY 替換為 Token Plan 團隊版 API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# 將 YOUR_API_KEY 替換為 Token Plan 團隊版 API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

執行以下命令使環境變數生效。
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

在 CMD 中運行以下命令，設定環境變數。

REM 將 YOUR_API_KEY 替換為 Token Plan 團隊版 API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

開啟一個新的 CMD 視窗，運行以下命令檢查環境變數是否生效。
```
echo %OPENAI_API_KEY%
```

PowerShell

在 PowerShell 中運行以下命令，設定環境變數。

# 將 YOUR_API_KEY 替換為 Token Plan 團隊版 API Key
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

開啟一個新的 PowerShell 視窗，運行以下命令檢查環境變數是否生效。
```
echo $env:OPENAI_API_KEY
```

Coding Plan

model請選擇支援的模型。將OPENAI_API_KEY環境變數設定為 Coding Plan 專屬 API Key。

Chat/Completions API

Coding Plan 僅支援 Chat/Completions API，需安裝舊版本 Codex，如 0.80.0：

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Coding_Plan"
model = "qwen3.7-plus"
[model_providers.Model_Studio_Coding_Plan]
name = "Model_Studio_Coding_Plan"
base_url = "https://coding-intl.dashscope.aliyuncs.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置環境變數

將OPENAI_API_KEY環境變數設定為 Coding Plan 專屬 API Key。

macOS

在終端中執行以下命令，查看預設 Shell 類型。
```
echo $SHELL
```

根據 Shell 類型設定環境變數：

Zsh

# 將 YOUR_API_KEY 替換為 Coding Plan API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# 將 YOUR_API_KEY 替換為 Coding Plan API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

執行以下命令使環境變數生效。
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

在 CMD 中運行以下命令，設定環境變數。

REM 將 YOUR_API_KEY 替換為 Coding Plan API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

開啟一個新的 CMD 視窗，運行以下命令檢查環境變數是否生效。
```
echo %OPENAI_API_KEY%
```

PowerShell

在 PowerShell 中運行以下命令，設定環境變數。

# 將 YOUR_API_KEY 替換為 Coding Plan API Key
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

開啟一個新的 PowerShell 視窗，運行以下命令檢查環境變數是否生效。
```
echo $env:OPENAI_API_KEY
```

隨用隨付

將OPENAI_API_KEY環境變數設定為百鍊 API Key。可用模型參見支援的模型。

根據地區設定base_url，API Key 須與所選地區對應：

華北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1，請將WorkspaceId替換為真實的擷取Workspace ID

隨用隨付支援 Responses API 和 Chat/Completions API 兩種接入方式，請根據使用的模型選擇：

Responses API

適用於支援 OpenAI Responses API 的模型（如 qwen3.7-max），可使用最新版 Codex。

model_provider = "Model_Studio"
model = "qwen3.7-max"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API

適用於僅支援 Chat/Completions API 的模型，需安裝 Codex 0.80.0：

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio"
model = "qwen3.6-plus"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置環境變數

將OPENAI_API_KEY環境變數設定為百鍊 API Key。

macOS

在終端中執行以下命令，查看預設 Shell 類型。
```
echo $SHELL
```

根據 Shell 類型設定環境變數：

Zsh

# 將 YOUR_API_KEY 替換為百鍊 API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# 將 YOUR_API_KEY 替換為百鍊 API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

執行以下命令使環境變數生效。
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

在 CMD 中運行以下命令，設定環境變數。

REM 將 YOUR_API_KEY 替換為百鍊 API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

開啟一個新的 CMD 視窗，運行以下命令檢查環境變數是否生效。
```
echo %OPENAI_API_KEY%
```

PowerShell

在 PowerShell 中運行以下命令，設定環境變數。

# 將 YOUR_API_KEY 替換為百鍊 API Key
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

開啟一個新的 PowerShell 視窗，運行以下命令檢查環境變數是否生效。
```
echo $env:OPENAI_API_KEY
```

驗證配置

配置完成後，建立終端視窗，執行以下命令啟動 Codex：

codex

如果正常進入對話介面，說明配置成功。

常見問題

第三方工具提示“不支援國內模型”或“檢查被拒 / Bad request (400)”怎麼辦？

原因：部分第三方管理工具（如 CC-Switch）在切換供應商時會發起“健全狀態檢查/串連測試”探測請求，該探測請求的格式與 Codex 實際調用的請求格式不同，百鍊網關可能因此返回 400 Bad request 並提示“檢查被拒”，工具據此顯示“不支援國內模型”。此提示僅代表健全狀態檢查探測未通過，並不代表百鍊不支援國內模型，也不影響 Codex 的實際使用。

說明：百鍊支援通過 Codex 使用 qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash、glm-5 等國內模型，配置方式詳見上文配置接入憑證。

解決方案：建議參照上文配置接入憑證，直接在~/.codex/config.toml中完成配置，無需依賴第三方工具的健全狀態檢查結果；配置完成後參照驗證配置啟動 Codex，若能正常進入對話介面即表示可正常使用國內模型。

報錯 wire_api 配置問題怎麼辦？

原因：Codex 新版本不再支援 wire_api = "chat" 配置。根據版本不同，可能出現以下報錯：

wire_api = "chat" is no longer supported
unknown configuration field wire_api

解決方案：

報錯 wire_api = "chat" is no longer supported：將設定檔中的 wire_api 改為 responses，並確認 base_url 配置正確。詳見上文配置接入憑證中對應方案的配置樣本。
報錯 unknown configuration field wire_api：從設定檔 ~/.codex/config.toml 的對應 provider 節中刪除 wire_api 欄位。

報錯 unexpected status 401 Unauthorized 怎麼辦？

原因：

誤用了其他方案的 API Key（Token Plan 團隊版、Coding Plan 和隨用隨付的 API Key 互不相通）
訂閱到期
API Key 複製不完整、有空格或拼字錯誤

解決方案：

確認使用的是所選方案對應的專屬 API Key。
前往對應方案的管理頁面確認訂閱是否到期。
重新複製 API Key，確保完整且無空格。
如以上均正常仍報錯，可在對應管理頁面重設 API Key，重設後請使用新 API Key 進行配置。

報錯 unexpected status 404 Not Found 怎麼辦？

原因：設定檔中的base_url或wire_api填寫錯誤。

解決方案：確認base_url和wire_api與所選方案的配置一致。參見上文配置接入憑證中對應方案的配置樣本。

報錯 stream disconnected before completion: stream closed before response.completed 怎麼辦？

原因：Codex 與服務端的流式串連在響應完成前斷開。常見於以下情境：

對話線程過長，Codex 觸發上下文壓縮時請求失敗
網路不穩定，SSE 或 WebSocket 串連中途斷開
服務端過載或觸發限流，提前終止串連

解決方案：

開啟新的對話線程，避免單個線程積累過多上下文。
檢查網路連接是否穩定，關閉 VPN 或代理後重試。
等待一段時間後重試，Codex 內建了自動重試機制，多數情況下重試可恢複。