Codex
対応する Node.js LTS を入れ、Codex をインストールし、専用 Key を作成します。次に API Keys -> Use key が生成したバージョン対応の config.toml と auth.json を標準 .codex に保存し、変更後は Codex を完全に終了して再起動します。
開始前
現在の公式配布元から提供されるクライアント版だけをインストールしてください。ローカル設定を変更する前にコンソールで専用 API Key を作成し、個人用、共有用、または本番デプロイ用の Key を使い回さないでください。
Windows、macOS、Linux
- Windows: 現在の Windows インストーラーまたは PowerShell 手順を使い、設定変更後はすべてのクライアントプロセスを終了します。
- macOS: CPU に合う署名済みアプリまたは公式ターミナルインストーラーを使います。ホームディレクトリの設定はその macOS ユーザーに属します。
- Linux / WSL: ディストリビューションまたは公式 CLI の最新手順に従います。WSL は Windows プロファイルではなく Linux のホームディレクトリを読みます。
モデルを選ぶ
専用 Key で GET /v1/models を呼び、返された data[].id を一つ選びます。Key ごとの一覧が正であり、以前の設定、記事、クライアントの選択肢はアクセス保証ではありません。
設定
bash
npm install -g @openai/codex
codex --versiontoml
model_provider = "OpenAI"
model = "your-console-model"
[model_providers.OpenAI]
base_url = "https://ai.tavonilo.com"
wire_api = "responses"確認
Key を /v1/models で確認し、機密を含まない小さなリクエストを 1 回実行します。サポートには時刻、ルート、モデル、HTTP 状態、request ID だけを残してください。タイムアウトは課金対象の生成が未処理である証拠ではないため、長い生成や画像リクエストを無条件に再送しないでください。
安全な復旧
- 401: 不完全、失効、または誤った Key を置き換えます。サポート依頼に Key を貼り付けないでください。
- 403: Key のグループ、モデル表示、残高、ルート権限を確認します。
- 404: ここに示す Base URL を使い、完全な endpoint や二重の /v1 を設定しません。
- 429: 作業をキューイングし、ある場合は Retry-After に従います。バッチを並列再送しないでください。
- 5xx / timeout: 安全に再試行できる操作だけを限定して再試行します。時刻、route、model、HTTP status、request ID を匿名化ログに残します。
認証情報の境界
端末またはワークロードごとに Key を分けます。API Key、auth.json、完全な非公開プロンプト、パスワード、認証コード、決済情報をサポートへ送らないでください。漏えいが疑われた Key は直ちに無効化して置き換えます。