Codex - OpenAI ターミナルアシスタントを Model Studio に接続 - Alibaba Cloud Model Studio

Codex は OpenAI のターミナル AI コーディングアシスタントです。トークンプラン (Team Edition)、コーディングプラン、または従量課金を利用して、Alibaba Cloud Model Studio に接続できます。

Codex のインストール

Node.js (v18.0 以降) をインストールまたはアップデートします。
Codex をインストールします：
```
npm install -g @openai/codex
```
インストールを確認します：
```
codex --version
```

アクセス認証情報の設定

~/.codex/config.toml を編集し、ご利用の課金プランに合わせて OPENAI_API_KEY 環境変数を設定します:

トークンプラン (Team Edition)

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

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 (Team Edition) 専用 API キーを設定します。

macOS

デフォルトのシェルを確認します：
```
echo $SHELL
```

シェルの種類に応じて環境変数を設定します：

Zsh

# YOUR_API_KEY をトークンプラン (Team Edition) の API キーに置き換えます
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# YOUR_API_KEY をトークンプラン (Team Edition) の API キーに置き換えます
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

変更を適用します：
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

環境変数を設定します：

REM YOUR_API_KEY をトークンプラン (Team Edition) の API キーに置き換えます
setx OPENAI_API_KEY "YOUR_API_KEY"

新しい CMD ウィンドウを開いて確認します：
```
echo %OPENAI_API_KEY%
```

PowerShell

環境変数を設定します：

# YOUR_API_KEY をトークンプラン (Team Edition) の API キーに置き換えます
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

新しい PowerShell ウィンドウを開いて確認します：
```
echo $env:OPENAI_API_KEY
```

コーディングプラン

model には、サポートされているモデルを選択します。OPENAI_API_KEY 環境変数を、コーディングプラン専用の API キーに設定します。

Chat/Completions API

コーディングプランでは 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 キーを設定してください。

macOS

デフォルトのシェルを確認します：
```
echo $SHELL
```

シェルの種類に応じて環境変数を設定します：

Zsh

# YOUR_API_KEY をコーディングプランの API キーに置き換えます
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# YOUR_API_KEY をコーディングプランの API キーに置き換えます
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

変更を適用します：
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

環境変数を設定します：

REM YOUR_API_KEY をコーディングプランの API キーに置き換えます
setx OPENAI_API_KEY "YOUR_API_KEY"

新しい CMD ウィンドウを開いて確認します：
```
echo %OPENAI_API_KEY%
```

PowerShell

環境変数を設定します：

# YOUR_API_KEY をコーディングプランの 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://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1。 WorkspaceId を、ワークスペース ID を取得して得られる実際のワークスペース 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 に Model Studio API キーを設定します。

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

環境変数を設定します：

REM YOUR_API_KEY を Model Studio API キーに置き換えます
setx OPENAI_API_KEY "YOUR_API_KEY"

新しい CMD ウィンドウを開いて確認します：
```
echo %OPENAI_API_KEY%
```

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 が正しいことを確認します。
コーディングプラン：古いバージョンにダウングレードします：
```
npm install -g @openai/codex@0.80.0
```

「unexpected status 401 Unauthorized」というエラーが表示された場合の対処法

原因：

API キーの不一致 (トークンプラン、コーディングプラン、従量課金のキーは相互に交換できません)
サブスクリプションの有効期限切れ
API キーのコピーミス (不完全、スペースが含まれている、タイプミスなど)

解決策：

ご利用のプランに適した正しい API キーを使用していることを確認します。
プランの管理ページでサブスクリプションの有効期限を確認します。
余分なスペースを含めずに API キーを再度コピーします。
エラーが解決しない場合は、プランの管理ページで API キーをリセットし、新しいキーで再設定します。

「unexpected status 404 Not Found」というエラーが表示された場合の対処法

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

解決策: base_url と wire_api が、上記のアクセス認証情報を構成するにあるプランの構成と一致することを確認してください。