Codex CLI

概要

種類: コーディングツール主要パス: OpenAI Responses（高度なオプション経路）サポート信頼度: モデル/パスの制限ありでサポート

OpenAI Codexは、ターミナル上でコードを読み取り、修正し、実行する軽量なコーディングエージェントとして機能するオープンソースのコマンドラインツール（CLI）です。GPTモデルに基づいて構築され、コード生成に最適化されています。 TokenLab向けに、Codex CLIは/v1/responsesを使用できますが、これは上級の互換性経路として扱うべきです。Responses専用の一部機能は、すべてのモデルやルートで保証されるわけではありません。 Codex CLI のリモート圧縮は POST /v1/responses/compact でサポートされています。Codex は /compact と自動圧縮で現在のセッションの model を body.model に送るため、圧縮に使うモデルを Responses 経路で利用可能にしてください。/v1/compact は設定しないでください。

システム要件

OS: macOS、Linux（公式サポート）、Windows は WSL 経由
Node.js: バージョン18以上
npm: バージョン10.x.x以上

インストール

npm install -g @openai/codex

インストール確認:

codex --version

設定

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

一時的（現在のセッション）:

export OPENAI_API_KEY="sk-your-tokenlab-key"

恒久的な設定: ~/.bashrc, ~/.zshrc, または ~/.bash_profile に追加:

export OPENAI_API_KEY="sk-your-tokenlab-key"

その後リロード:

source ~/.zshrc  # or source ~/.bashrc

ステップ2: config.toml を設定

~/.codex/config.toml を編集:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

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

[features]
fast_mode = true

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

configファイルが存在しない場合は、一度codexを実行して生成し、その後ファイルを編集してください。config.tomlを変更したら、プロバイダ設定が再読み込みされるようにCodexを完全に再起動してください。

Codexはカスタムプロバイダ向けのchat/completionsサポートを廃止しつつあります。TokenLabでは意図的に古い互換経路を使用していない限り、wire_api = "responses"を維持してください。

TokenLab は未知の Responses フィールドを best-effort で転送し、リクエストを Chat Completions へ暗黙にダウングレードしません。フィールドや組み合わせへの対応可否は、選択された upstream が判断します。

基本的な使い方

対話モードを開始:

codex

直接コマンド:

codex "Fix the bug in main.py line 42"

モデルを指定:

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

推奨モデル

モデル	最適用途
`gpt-5.6-sol`	コーディングと推論のデフォルトとして最適
`gpt-5-mini`	コーディングワークフロー向けの高速で安価なフォールバック
`claude-sonnet-4-6`	コードレビュー、ドキュメント作成
`deepseek-r1`	アルゴリズム設計、推論

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

コマンド	説明
`/help`	ヘルプを表示
`/exit` or `Ctrl+C`	終了
`/clear`	会話をクリア
`/config`	設定を表示
`/model <name>`	モデルを切り替え
`/tokens`	トークン使用量を表示

設定の確認

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

よくあるユースケース

コードレビュー:

git diff | codex "Review these code changes"

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

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

エラー修正:

codex "Fix the TypeScript errors in src/components/"

コードの説明:

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

トラブルシューティング

接続エラー

config.toml の base_url が正確に https://api.tokenlab.sh/v1 であることを確認してください
ネットワーク接続を確認してください
プロキシの干渉がないことを確認してください

認証に失敗しました

~/.codex/config.toml に env_key = "OPENAI_API_KEY" が存在することを確認してください
OPENAI_API_KEY 環境変数が設定されていることを確認してください
キーが sk- で始まっていることを確認してください
TokenLabダッシュボードでキーが有効であることを確認してください

モデルが見つかりません

モデル名が完全に一致しているか確認してください
モデルの可用性を tokenlab.sh/en/models で確認してください

Responses ネイティブフィールドが拒否されました

一部のフィールドは、TokenLabが選択されたモデルとルートでその動作を保証できる場合にのみ/v1/responsesで利用可能です
unsupported_request_field が表示された場合、そのフィールドを削除するか、それに依存しないワークフローに切り替えてください

/compact または自動圧縮が失敗する

Codex CLI は /v1/compact ではなく POST /v1/responses/compact を呼び出します
圧縮リクエストは現在のセッションの model を使用するため、そのモデルは Responses 経路で利用可能である必要があります
wire_api = "responses" と base_url = "https://api.tokenlab.sh/v1" を維持してください

互換性マトリクス

コーディングツール

ネイティブ SDK

フレームワークとプラットフォーム

チャットアプリ

概要

システム要件

インストール

設定

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

ステップ2: config.toml を設定

基本的な使い方

推奨モデル

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

設定の確認

よくあるユースケース

トラブルシューティング

​概要

​システム要件

​インストール

​設定

​ステップ1: APIキーを設定

​ステップ2: config.toml を設定

​基本的な使い方

​推奨モデル

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

​設定の確認

​よくあるユースケース

​トラブルシューティング

概要

システム要件

インストール

設定

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

ステップ2: config.toml を設定

基本的な使い方

推奨モデル

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

設定の確認

よくあるユースケース

トラブルシューティング