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

Codex は、OpenAI のターミナル AI コーディングアシスタントです。Token Plan Personal Edition、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 環境変数を設定します：

モデルメタデータの設定

qwen3.8-max などのカスタムモデルを使用する場合は、Codex がモデルのコンテキストウィンドウ、推論深度、その他のパラメーターを正しく認識できるように、モデルメタデータファイルを設定する必要があります。

次の内容で ~/.codex/model-catalog.local.json ファイルを作成します：

{
  "models": [
    {
      "slug": "qwen3.8-max",
      "display_name": "qwen3.8-max",
      "description": "DashScope model: qwen3.8-max",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": ["text", "image"],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 1,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    }  ]
}

メタデータファイルを参照するため、次の行を ~/.codex/config.toml に追加します：

model_catalog_json = "~/.codex/model-catalog.local.json"

Token Plan Personal Edition

model には、対応モデルを選択します。OPENAI_API_KEY 環境変数には、Token Plan Personal Edition 専用の API キーを設定します。

Responses API

選択したモデルが Responses API をサポートしている場合は、最新バージョンの Codex を使用できます。

model_provider = "Model_Studio_Token_Plan_Personal"
model = "qwen3.8-max"
[model_providers.Model_Studio_Token_Plan_Personal]
name = "Model_Studio_Token_Plan_Personal"
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 が必要です。0.80.0 などの古いバージョンの Codex をインストールします：

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Token_Plan_Personal"
model = "glm-5"
[model_providers.Model_Studio_Token_Plan_Personal]
name = "Model_Studio_Token_Plan_Personal"
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 Personal Edition 専用の API キーを設定します。

macOS

デフォルトシェルを確認します：

echo $SHELL

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

Zsh

# YOUR_API_KEY を Token Plan Personal Edition の API キーに置き換えます
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# YOUR_API_KEY を Token Plan Personal 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 を Token Plan Personal Edition の API キーに置き換えます
setx OPENAI_API_KEY "YOUR_API_KEY"

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

echo %OPENAI_API_KEY%

PowerShell

環境変数を設定します：

# YOUR_API_KEY を Token Plan Personal Edition の API キーに置き換えます
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

新しい PowerShell ウィンドウを開いて確認します：

echo $env:OPENAI_API_KEY

Token Plan Team Edition

model には、対応モデルを選択します。OPENAI_API_KEY 環境変数には、Token Plan Team Edition 専用の API キーを設定します。

Responses API

選択したモデルが Responses API をサポートしている場合は、最新バージョンの Codex を使用できます。

model_provider = "Model_Studio_Token_Plan"
model = "qwen3.8-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 が必要です。0.80.0 などの古いバージョンの Codex をインストールします：

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 を 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

環境変数を設定します：

REM YOUR_API_KEY を Token Plan Team Edition の API キーに置き換えます
setx OPENAI_API_KEY "YOUR_API_KEY"

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

echo %OPENAI_API_KEY%

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 のみをサポートします。0.80.0 などの古いバージョンの Codex をインストールします：

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 を 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

環境変数を設定します：

REM YOUR_API_KEY を Coding Plan の API キーに置き換えます
setx OPENAI_API_KEY "YOUR_API_KEY"

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

echo %OPENAI_API_KEY%

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 キーは選択したリージョンと一致している必要があります。URL 内の {WorkspaceId} は、実際のワークスペース ID に置き換えてください：

中国北部 2 (北京)：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
シンガポール：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

従量課金は Responses API と Chat/Completions API の両方をサポートします。モデルに応じて選択してください：

Responses API

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 をインストールします：

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

チャットインターフェイスが起動すれば、設定は正しい状態です。

よくある質問

サードパーティツールで「domestic models not supported」または「check rejected / Bad request (400)」と表示された場合はどうすればよいですか？

原因：一部のサードパーティ管理ツール (CC-Switch など) は、プロバイダーの切り替え時に「ヘルスチェック / 接続テスト」のプローブリクエストを送信します。このプローブの形式は Codex が実際に使用するリクエスト形式と異なるため、Model Studio のゲートウェイが 400 不正なリクエストで拒否し、ツール側で「domestic models not supported」と報告される場合があります。このメッセージはヘルスチェックのプローブが失敗したことを示すだけであり、Model Studio が国内モデルをサポートしていないことを意味するものではなく、実際の Codex の利用にも影響しません。

注：Model Studio は Codex を通じて中国本土のモデルを使用できます。設定の詳細については、上記のアクセス認証情報の設定をご参照ください。

解決策：サードパーティツールのヘルスチェック結果に依存せず、~/.codex/config.toml で「アクセス認証情報の設定」に記載のとおり Codex を直接設定します。設定後は、設定の検証に記載のとおり 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 の該当するプロバイダーセクションから wire_api の行を削除します。

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

原因：

API キーの不一致 (Token Plan、Coding Plan、従量課金のキーは相互に使用できません)
サブスクリプションの有効期限切れ
API キーのコピーが不正確 (不完全、スペースを含む、またはタイポがある)

解決策：

プランに対応する正しい API キーを使用していることを確認します。
プランの管理ページで、サブスクリプションの有効期限を確認します。
余分なスペースが入らないように、API キーを再度コピーします。
問題が解決しない場合は、プランの管理ページで API キーをリセットし、新しいキーで再設定します。

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

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

解決策：base_url と wire_api が、上記のアクセス認証情報の設定にあるプランの設定と一致していることを確認します。

エラー「stream disconnected before completion: stream closed before response.completed」が発生した場合はどうすればよいですか？

原因：応答が完了する前に、Codex とサーバー間のストリーム接続が中断されました。これは、主に次の状況で発生します：

会話スレッドが長すぎて、コンテキストのコンパクションのリクエストが失敗する
不安定なネットワークにより、SSE または WebSocket 接続がストリームの途中で切断される
サーバーの過負荷またはレート制限により、接続が早期に終了する

解決策：

1 つのスレッドにコンテキストが過剰に蓄積しないように、新しい会話スレッドを開始します。
ネットワーク接続を確認してください。VPN またはプロキシを無効化し、リトライしてください。
時間をおいてリトライしてください。Codex には組み込みのリトライメカニズムがあり、ほとんどの一時的な障害は自動的に解消されます。