Codex CLI
OpenAIのターミナルコーディングAgent

4 つのインストール方法（2026-10-20 時点の公式ドキュメント）

2026-10-20 時点で、OpenAI 公式の Codex CLI ドキュメントは 4 つのインストール方法を挙げています。macOS と Linux はスタンドアロンインストーラー、Windows は新しく開いた PowerShell ウィンドウでスタンドアロンインストーラーを実行し、ほかに npm または Homebrew も使えます。更新するときは同じインストールコマンドをもう一度実行し、Homebrew では brew upgrade --cask codex を使います。

インストール後はプロジェクトのディレクトリで codex を実行し、初回起動時に Sign in with ChatGPT か別のサインイン方法を選んで、やりたいことを一文で伝えれば始められます。公式は、変更を元に戻せるようタスクの前後で Git のチェックポイントを作ることを勧めています。

• macOS / Linux：curl -fsSL https://chatgpt.com/codex/install.sh | sh
• Windows（PowerShell）：powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
• npm：npm install -g @openai/codex
• Homebrew：brew install --cask codex
• WSL：公式ドキュメントによると、WSL1 のサポートは Codex 0.114 までで、0.115 から Linux サンドボックスが bubblewrap に移行したため WSL2 を使います。

2 つのサインイン方法と公式の利用上限

公式の認証ドキュメントによると、Codex CLI のサインインは 2 通りで、ChatGPT でサインインするとサブスクリプションの枠を使い、API キーでサインインすると使った分だけ課金されます。API キーはパイプで codex login --with-api-key に渡せ、codex login status で現在の認証方法を確認できます。ログイン情報は ~/.codex/auth.json か OS の認証情報ストアにキャッシュされ、CLI と IDE 拡張機能は同じログインキャッシュを共有します。

ChatGPT でサインインした場合はプランの上限がかかります。OpenAI の料金ページ（2026-10-20 時点）は Plus と Standard Business のローカルメッセージ数を 5 時間あたりの目安で示し、Pro プランには現在 5 時間の上限がないこと、週ごとの上限がかかる場合もあることを明記しています。セッション中に /status と入力すると残りの枠を確認できます。OpenAI の API キーでサインインした場合、Codex は ChatGPT プランの枠ではなく OpenAI 公式価格（標準の API 料金）で課金します。

QCode の API キーで Codex CLI を接続する

QCode ドキュメントの Codex 手順は OpenAI Responses プロトコルを使います。ユーザーレベルの設定ファイル ~/.codex/config.toml にカスタムの model provider（名前は自由）を追加し、model_provider をそれに向けたうえで、次の項目を設定します。QCode に登録したら、ダッシュボードで cr_ で始まる API キーを作成すれば準備完了です。

この接続は GPT モデル専用です。QCode ドキュメントの概要には、Codex が使う Responses エンドポイントは Claude と中国系モデルには対応しないと書かれています。claude-sonnet-5-5 や claude-opus-5-5 などの Claude モデルは、同じキーで Claude Code を設定して使ってください。トークン単位で課金され、各モデルの単価は /models に掲載しています。

• base_url：https://api.qcode.cc/openai（QCode ドキュメントではこのアドレスであることが必須）。アジアの予備の接続先として https://asia.qcode.cc/openai もあります。
• wire_api は responses、requires_openai_auth は true にします。OpenAI 公式ドキュメントによると、現在の Codex は wire_api = chat にも Chat Completions のみのエンドポイントにも対応していません。
• どちらか一方を選びます。環境変数を使うなら requires_openai_auth を外して env_key = "QCODE_API_KEY"（名前は自由）を書き、その変数を export します。ファイルを使うなら requires_openai_auth = true のまま ~/.codex/auth.json にキーを書き、権限を 600 にします。ドキュメントによると requires_openai_auth = true のとき Codex は env_key を無視します。
• model：QCode ドキュメントに載っている GPT モデル（gpt-6-sol、gpt-6.1-sol、gpt-6-astra、gpt-5.6-terra、gpt-5.6-sol など）。model_reasoning_effort は low、medium、high から選べます。
• 手作業が面倒なら、QCode ドキュメントのワンライン設定スクリプトも使えます：curl -fsSL https://qcode.cc/install/codex.sh | bash（Windows は irm https://qcode.cc/install/codex.ps1 | iex）。CLI のインストール、~/.codex への設定の書き込み、接続確認までを行います。

よくあるエラーと対処

まず codex doctor を実行しましょう。公式ドキュメントによると、インストール、設定、認証、ランタイム、Git、ターミナルなどの状態を確認するローカル診断レポートを生成します。セッション内では /status で現在のモデル、承認ポリシー、残りのコンテキストを確認し、/debug-config で各設定レイヤーの適用状況を表示できます。

• 401 や API キーが無効と表示される場合：キーが cr_ で始まり、余分な空白や改行がないか確認します。環境変数を使う場合は、変数名が config.toml の env_key と完全に一致している必要があります。そのうえで QCode のダッシュボードでキーの状態を確認してください。
• 接続タイムアウトやネットワークエラー：base_url が https://api.qcode.cc/openai になっているか確認し、curl -I https://api.qcode.cc で疎通を試し、メインのアドレスが応答しない場合は https://asia.qcode.cc/openai を試します。
• 設定を変えても反映されない：OpenAI 公式ドキュメントによると、プロジェクト内の .codex/config.toml では model_provider や model_providers などのキーが無視されるため、provider はユーザーレベルの ~/.codex/config.toml に書く必要があります。
• profile のエラー：Codex 0.134.0 以降、--profile は config.toml の [profiles.名前] テーブルを読まなくなり、トップレベルの profile セレクターもサポート対象外になりました。設定は別ファイルの ~/.codex/名前.config.toml に移します。
• モデルが使えない：公式ドキュメントによると、GPT-5.3-Codex-Spark は 2026-09-14 に提供終了し、gpt-5.4 は 2026-08-31 に ChatGPT サインインの Codex から外れました（GPT-5.5 の終了は上のモデルカードを参照）。スクリプトや設定の古いモデル名は置き換えてください。
• npm のグローバルインストールで EACCES が出る：QCode ドキュメントは npm のグローバルディレクトリをユーザーディレクトリに変える方法を勧めています。上記の公式スタンドアロンインストーラーを使うこともできます。