コーディングツール

Codex CLI

TokenLab APIを使用するようにOpenAI Codex CLIを設定する

エージェントにセットアップさせる

コンピュータ上で既に実行されているエージェントにこのタスクをコピーしてください:

Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/ja/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

概要

Codex CLIは/v1/responsesを通じてTokenLabに接続できます。選択されたモデルは、tokenlab.accepted_request_formatsにopenai_responsesが記載されている必要があります。機能はモデルによって異なる場合があります。

リモートコンパクションはPOST /v1/responses/compactを使用します。Codexは現在のセッションモデルをbody.modelで送信するため、そのモデルもResponsesをサポートしている必要があります。/v1/compactは設定しないでください。

システム要件

macOS、Linux、またはWindowsについては、公式CLIインストールガイドを使用してください。ネイティブWindowsとWSLは個別の環境です。Windowsガイドに従ってください。以下のnpmコマンドはインストールオプションの1つであり、ネイティブバイナリの要件ではありません。

インストール

npm install -g @openai/codex@0.163.0

インストールの確認:

codex --version

設定

ステップ1: APIキーの設定

コマンド履歴にキーを残さずにTOKENLAB_API_KEYを設定するには、macOS、Linux、WSL、またはWindows PowerShell向けのクイックスタートのターミナル手順を使用してください。そのターミナルからCodexを起動します。継続的に使用する場合は、ローカルのシークレットマネージャーを使用してください。シェルプロファイルに平文のキーを追記しないでください。

ステップ2: tokenlab.config.tomlの設定

Codex 0.163.0(2026-10-18テスト済み)では、アクティブなCODEX_HOME(通常は~/.codex)にある個別のtokenlab.config.tomlを使用します。その名前が使用されていない場合にのみ作成するか、既存のTokenLabプロファイルを編集する前にバックアップしてください。以下のプロファイルはcodex --profile tokenlabで明示的に読み込まれ、デフォルトのconfig.toml、auth.json、アカウント、およびパーミッションポリシーは変更されません。レガシーな[profiles.tokenlab]テーブルは使用しないでください。通常のセットアップに戻るには、プロファイルなしで起動します。公式プロファイル設定を参照してください。

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

このWebSocketモードは、Codexクライアント向けのResponses-over-WebSocketブリッジです。公式のresponse.createイベントのみを受け付けます。streamは暗黙的であり、このトランスポートではbackgroundおよびresponse.cancelは利用できません。これはOpenAI Realtime APIではなく、session.update、conversation.item.*、input_audio_buffer.*、バイナリオーディオ、またはネストされたRealtimeのresponse.create.responseエンベロープは受け付けません。

選択した設定ファイルが存在しない場合は作成してください。編集後、以下の一致するコマンドで新しいセッションを開始してください。

現在のCodexはwire_api = "responses"を使用します。chat/completionsは設定しないでください。env_keyが使用されるよう、このカスタムプロバイダーではrequires_openai_authを未設定またはfalseのままにしてください。

ResponsesリクエストはChat Completionsに変換されません。オプションのフィールドおよび将来のフィールドは、選択したモデルによって異なります。

基本的な使い方

対話モードを開始:

codex --profile tokenlab

直接コマンド実行:

codex --profile tokenlab "Fix the bug in main.py line 42"

モデルの指定:

codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"

モデルの選択

現在tokenlab.accepted_request_formatsにopenai_responsesが記載されているモデルを使用してください。自身のコーディングタスクで候補を比較し、モデルページで最新の価格を確認してください。

インタラクティブコマンド

コマンド説明
/helpヘルプを表示
/exit または Ctrl+C終了
/clear会話をクリア
/statusアクティブなモデル、パーミッション、トークン使用量を表示
/model <name>モデルを切り替え

設定の確認

値を出力せずに環境変数が設定されているかどうかを確認します。この確認ではキーの検証は行われません:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Codexを起動し、/statusを実行してアクティブなモデルとパーミッションを確認します。プロファイルを使用している場合は、同じプロファイルで起動してください。公式statusコマンドを参照してください。

実際のリクエストを実行する準備ができたら、以下のコマンドを実行します。これにはTokenLabの残高が使用されます。返答およびリクエストの一致するレコードを確認してください。環境の確認や起動の成功だけでは、リクエストが成功したことの証明にはなりません。

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

一般的なユースケース

コードレビュー:

git diff | codex --profile tokenlab "Review these code changes"

コミットメッセージの生成:

git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"

エラーの修正:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

コードの説明:

cat main.py | codex --profile tokenlab "Explain what this code does"

同じエージェントでの画像および動画の生成

CodexはTokenLab MCPサーバーを使用して、画像や短い動画を作成することもできます。各生成は同じTokenLab残高から支払われます。TOKENLAB_API_KEYが設定されているターミナルで以下を実行してください:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

このコマンドはベースのconfig.tomlにサーバーを追加します。Codexはtokenlab.config.tomlプロファイル下でもそのファイルを読み込むため、--profile tokenlabの有無にかかわらずツールが動作します。codex mcp listを実行してtokenlabが表示されていることを確認してください。その後、以下を試してください:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_videoはタスクIDを返します。エージェントは動画の準備ができるまでget_task_statusを呼び出します。

トラブルシューティング

このページの内容