Codex - Alibaba Cloud Model Studio - Alibaba Cloud ドキュメントセンター

Codex は OpenAI が開発したターミナル向け AI コーディングアシスタントです。Token Plan (Team Edition)、Coding Plan、または従量課金のいずれかの課金プランを介して Alibaba Cloud Model Studio に接続できます。

Codex のインストール

Node.js（v18.0 以降）をインストールまたは更新します。
ターミナルで次のコマンドを実行し、Codex をインストールします。
```
npm install -g @openai/codex
```
インストールを確認するには、次のコマンドを実行します。
```
codex --version
```

アクセス認証情報の設定

接続するには、設定ファイル ~/.codex/config.toml を編集し、環境変数 OPENAI_API_KEY を設定します。選択した課金プランに基づき、対応する値を置き換えてください。Alibaba Cloud Model Studio では、以下の 3 種類の課金プランを提供しています。

Token Plan (Team Edition)

model には、サポートされているモデルを選択します。OPENAI_API_KEY 環境変数には、Token Plan (Team Edition) 専用の API キーを設定します。

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"

環境変数の設定

Token Plan (Team Edition) 専用の API キーを OPENAI_API_KEY 環境変数に設定します。

macOS

ターミナルで次のコマンドを実行し、デフォルトのシェルタイプを確認します。
```
echo $SHELL
```

シェルタイプに応じて、環境変数を設定します。

Zsh

# YOUR_API_KEY を Token Plan (Team Edition) の API キーに置き換えてください
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# YOUR_API_KEY を Token Plan (Team Edition) の API キーに置き換えてください
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 (Team Edition) の API キーに置き換えてください
setx OPENAI_API_KEY "YOUR_API_KEY"

新しい CMD ウィンドウを開き、次のコマンドを実行して環境変数が設定されたことを確認します。
```
echo %OPENAI_API_KEY%
```

PowerShell

PowerShell で次のコマンドを実行し、環境変数を設定します。

# YOUR_API_KEY を Token Plan (Team Edition) の API キーに置き換えてください
[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 キーを設定します。

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"

環境変数の設定

Coding Plan 専用の API キーを OPENAI_API_KEY 環境変数に設定します。

macOS

ターミナルで次のコマンドを実行し、デフォルトのシェルタイプを確認します。
```
echo $SHELL
```

シェルタイプに応じて、環境変数を設定します。

Zsh

# YOUR_API_KEY を Coding Plan の API キーに置き換えてください
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# YOUR_API_KEY を Coding Plan の API キーに置き換えてください
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 キーに置き換えてください
setx OPENAI_API_KEY "YOUR_API_KEY"

新しい CMD ウィンドウを開き、次のコマンドを実行して環境変数が設定されたことを確認します。
```
echo %OPENAI_API_KEY%
```

PowerShell

PowerShell で次のコマンドを実行し、環境変数を設定します。

# YOUR_API_KEY を Coding Plan の API キーに置き換えてください
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

新しい PowerShell ウィンドウを開き、次のコマンドを実行して環境変数が設定されたことを確認します。
```
echo $env:OPENAI_API_KEY
```

従量課金

OPENAI_API_KEY 環境変数には、Model Studio API キーを設定します。利用可能なモデルについては、サポートされているモデルをご参照ください。

base_url はリージョンに基づいて設定してください。API キーは選択したリージョンに対応している必要があります。

中国北部 2 (北京)：https://dashscope.aliyuncs.com/compatible-mode/v1
シンガポール：https://dashscope-intl.aliyuncs.com/compatible-mode/v1

従量課金では、Responses API および Chat/Completions API の両方がサポートされています。使用するモデルに応じて適切な 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"

環境変数の設定

Model Studio API キーを OPENAI_API_KEY 環境変数に設定します。

macOS

ターミナルで次のコマンドを実行し、デフォルトのシェルタイプを確認します。
```
echo $SHELL
```

シェルタイプに応じて、環境変数を設定します。

Zsh

# YOUR_API_KEY を Model Studio API キーに置き換えてください
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# YOUR_API_KEY を Model Studio API キーに置き換えてください
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

次のコマンドを実行して、環境変数を適用します。
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

CMD で次のコマンドを実行し、環境変数を設定します。

REM YOUR_API_KEY を Model Studio API キーに置き換えてください
setx OPENAI_API_KEY "YOUR_API_KEY"

新しい CMD ウィンドウを開き、次のコマンドを実行して環境変数が設定されたことを確認します。
```
echo %OPENAI_API_KEY%
```

PowerShell

PowerShell で次のコマンドを実行し、環境変数を設定します。

# YOUR_API_KEY を Model Studio API キーに置き換えてください
[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 (Team Edition) または従量課金の場合：wire_api を responses に変更し、base_url が正しく設定されていることを確認してください。
Coding Plan の場合：次のコマンドを実行して、古いバージョンにスペックダウンしてください。
```
npm install -g @openai/codex@0.80.0
```

「unexpected status 401 Unauthorized」というエラーが発生した場合はどうすればよいですか？

原因：

異なる課金プランの API キーを使用している（Token Plan (Team Edition)、Coding Plan、従量課金の API キーは相互に交換できません）
サブスクリプションの期限が切れている
API キーが不完全にコピーされた、スペースが含まれている、またはタイポがある

解決方法：

選択した課金プラン専用の API キーを使用していることを確認してください。
選択した課金プランの管理ページにアクセスし、サブスクリプションの有効期限を確認してください。
API キーを再度コピーし、完全でスペースが含まれていないことを確認してください。
上記を確認してもエラーが解消しない場合は、選択した課金プランの管理ページで API キーをリセットしてください。リセット後は、新しい API キーを使用して設定を行ってください。

「unexpected status 404 Not Found」というエラーが発生した場合はどうすればよいですか？

原因：設定ファイル内の base_url または wire_api が正しくありません。

解決方法：base_url および wire_api が選択した課金プランの設定と一致していることを確認してください。各プランの設定例については、上記の「アクセス認証情報の設定」をご参照ください。