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.6-plus）

qwen3.6-plus 支援 Responses API，可使用最新版 Codex。

model_provider = "Model_Studio_Token_Plan"
model = "qwen3.6-plus"
[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.6-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://dashscope-intl.aliyuncs.com/compatible-mode/v1

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

Responses API

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

model_provider = "Model_Studio"
model = "qwen3.6-plus"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://dashscope-intl.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://dashscope-intl.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

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

常見問題

報錯 wire_api = chat is no longer supported 怎麼辦？

原因：Codex 新版本使用 Responses API，不支援wire_api = "chat"配置。

解決方案：

Token Plan 團隊版或隨用隨付：將wire_api改為responses，並確認base_url配置正確。
Coding Plan：執行以下命令降級到舊版本：
```
npm install -g @openai/codex@0.80.0
```

報錯 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與所選方案的配置一致。參見上文配置接入憑證中對應方案的配置樣本。