Codex CLI チートシート: 全コマンドと設定キー完全リファレンス (2026)
codex はインタラクティブセッションを開き、codex exec は CI 向けにヘッドレスで実行します。セッション内で / を入力すると全スラッシュコマンドの一覧が表示され、codex --help または ? でインストール済みバージョンの全コマンドを確認できます。このページはスキャンしやすいリファレンスです。トップレベルコマンド、グローバルフラグ、カテゴリ別スラッシュコマンド、実際に重要な config.toml キー、MCP のセットアップ、サンドボックス/承認モード、そして本当に（短い）キーボードショートカット一覧を扱います。
- Codex CLI はほぼ毎月新しいバージョンをリリースしており、正確なコマンド一覧は変わることがあります。以下の内容はすべて執筆時点の公式ドキュメントと照合済みですが、正確なフラグ名に依存する前に、ご自身のインストール環境で codex --help、/、または ? を実行してください。
このチートシートの対象範囲
これは Codex CLI のみ、つまり codex で実行するターミナルツールに関するものです。ChatGPT デスクトップアプリや VS Code/JetBrains の IDE 拡張機能は対象外です。それらは異なるショートカットセットを備えており、オンラインの一部のページは3つをまとめて扱っているため、その「キーボードショートカット」セクションは誤解を招きます。Codex がまったく初めてなら、まず OpenAI Codex とは何か から始めてください。
名前が紛らわしいので、はっきり述べておく価値のある区別が一つあります。OpenAI Codex（この CLI）は AgentKit（agentkit.best、Codex 内で動作する有料のサードパーティ製アドオン）ではなく、OpenAI 自身の AgentKit（別製品の Agent Builder。OpenAI の 2026-06-03 の廃止告知により、これ自体も縮小されつつあります）でもありません。このページは無料の CLI に関するものです。AgentKit については最後に一度だけ正直に触れます。
必要なものにすぐたどり着けるようにグループ分けしてあります。まずコマンドとフラグ、次に最大のセクション（スラッシュコマンド。日々の操作のほとんどは実際これで行われるため）、続いて config キー、MCP、サンドボックス/承認、最後に正直なショートカット一覧です。
インストール & サインイン - クイックコマンド
Codex CLI はオープンソース（Rust）で、macOS、Linux、Windows のいずれでも1つのスクリプトでインストールできます。
| コマンド | 機能 |
|---|---|
curl -fsSL https://chatgpt.com/codex/install.sh | sh | CLI をインストールします（mac/Linux。Windows では WSL/Git Bash 経由でも動作します）。 |
codex login | ブラウザで ChatGPT アカウントにサインインします。 |
codex login --device-auth | ヘッドレスマシン（SSH 環境、コンテナ）向けのデバイスコードによるサインイン。今回のセッションでは一次情報のページと個別に再確認していません。正確なフラグに依存する前に codex login --help で確認してください。 |
codex logout | サインアウトし、ローカルの認証トークンを削除します。 |
インストールしたら codex --version を実行して正常に動作したことを確認し、次に codex だけを実行して最初のインタラクティブセッションに入ります。プロキシ/企業ネットワークのエッジケースを含む、あらゆるインストール経路の詳細な手順については Codex CLI のインストール方法 をご覧ください。
トップレベル CLI コマンド
codex の直後に直接入力するコマンドです。
| コマンド | 機能 | 例 |
|---|---|---|
codex | 現在のプロジェクトでインタラクティブセッションを開きます。 | codex |
codex exec | TUI なしで1つのプロンプトをヘッドレスに実行します。スクリプトや CI 向けです。 | codex exec "add a health-check route" |
codex resume | 以前のセッションを再度開きます。 | codex resume |
codex login | ChatGPT アカウントにサインインします。 | codex login |
codex mcp | MCP サーバー接続を管理します。 | codex mcp add docs -- npx -y mcp-server-docs |
codex cloud | Codex Cloud のサンドボックスタスクを開いて管理します。 | codex cloud |
codex apply | Codex Cloud タスクが生成した差分をローカルのチェックアウトに適用します。 | codex apply <task-id> |
codex doctor | インストール/設定の診断チェックを行います。サードパーティの情報によれば v0.131.0 前後で追加されたもので、一次ドキュメントではありません。codex --help でお使いのバージョンに存在するか確認してください。 | codex doctor |
codex features enable <flag> | フィーチャーフラグ付きの機能（例: ゴールモード）を有効にします。 | codex features enable goals |
グローバルフラグ（ほとんどのコマンドで有効）
| フラグ | 機能 |
|---|---|
-m, --model | この実行に使うモデルを上書きします。 |
-s, --sandbox | サンドボックスモードを設定します（下のマトリクスを参照）。 |
-a, --ask-for-approval | この実行の承認ポリシーを設定します。 |
-p, --profile | config.toml から名前付きプロファイルを読み込みます。 |
-c, --config key=value | ファイルを編集せずに、1つの設定キーをインラインで上書きします。 |
-i, --image | プロンプトに画像を添付します。 |
--search | この実行でライブのウェブ検索ツールを有効にします。 |
-C, --cd | 別の作業ディレクトリに対して実行します。 |
--add-dir | プロジェクトルート外の追加ディレクトリに読み書きアクセスを付与します。 |
--oss | ホスト型モデルの代わりに、ローカルのオープンウェイトモデルに対して実行します。 |
--local-provider | Codex を自己ホスト/ローカルのモデルプロバイダーに向けます。 |
codex exec を CI/CD で使う
codex exec はパイプライン向けのヘッドレスなエントリーポイントです。典型的な CI 呼び出しは次のとおりです。
codex exec --json --sandbox workspace-write --ephemeral \
--skip-git-repo-check \
"Fix the failing test in tests/auth.spec.ts and summarize the change"| フラグ | 機能 |
|---|---|
--json | TUI 出力の代わりに構造化された JSON イベントを出力します。 |
-o, --output-last-message | 最終メッセージだけをファイルに書き出します。パイプラインのステップで取得しやすくなります。 |
--output-schema | 最終メッセージを、指定した JSON スキーマに一致させます。 |
--ephemeral | 実行後にセッション/履歴を保存しません。 |
--skip-git-repo-check | 作業ディレクトリが git リポジトリ内でなくても実行します。 |
--ignore-rules | この実行では、プロジェクトの通常のルール/lint チェックをスキップします。 |
危険なフラグ - 隔離された CI ランナー専用:
--dangerously-bypass-approvals-and-sandbox（エイリアス--yolo）と--dangerously-bypass-hook-trustは、サンドボックスと承認ゲートを完全に無効化します。本物の認証情報や本番アクセスがあるマシンでは絶対に実行しないでください。使い捨ての隔離された CI コンテナ内でのみ使用してください。
スラッシュコマンド（カテゴリ別）
セッション内で / を入力すると、お使いのバージョンのライブ一覧が表示されます。この表はよく使うものをグループ化したものです。日々もっとも使う5つは /review、/goal、/permissions、/compact、/mcp です。
| コマンド | グループ | 機能 |
|---|---|---|
/clear | セッション & コンテキスト | 新しいコンテキストを開始し、セッションは維持します。 |
/compact | セッション & コンテキスト | コンテキストを手動で圧縮して空きを作ります。 |
/new | セッション & コンテキスト | まったく新しいセッションを開始します。 |
/resume | セッション & コンテキスト | TUI 内から以前のセッションを再度開きます。 |
/rename | セッション & コンテキスト | 現在のセッションの名前を変更します。 |
/archive | セッション & コンテキスト | 現在のセッションをアーカイブします。 |
/delete | セッション & コンテキスト | セッションを削除します。 |
/diff | セッション & コンテキスト | 現在の作業差分を表示します。 |
/copy | セッション & コンテキスト | 直前の応答をクリップボードにコピーします。 |
/status | セッション & コンテキスト | セッションと使用状況のステータスを表示します。 |
/model | モデル・権限 & パーソナリティ | アクティブなモデルを切り替えます。 |
/permissions | モデル・権限 & パーソナリティ | サンドボックス/承認ポリシーをその場で表示・編集します。 |
/personality | モデル・権限 & パーソナリティ | 応答のトーン/スタイルを変更します。 |
/sandbox-add-read-dir | モデル・権限 & パーソナリティ | このセッションで追加ディレクトリへの読み取りアクセスを付与します。 |
/review | レビュー & ゴール | コードレビューのプリセットを実行します（差分、未コミット、特定のコミット、またはカスタム）。 |
/goal | レビュー & ゴール | ゴールモードを開始します。長時間持続する実行ループです。 |
/plan | レビュー & ゴール | Codex が実行を始める前にプランを作成します。 |
/mcp | 拡張 | セッション内から MCP サーバー接続を管理します。 |
/skills | 拡張 | インストール済みの skill を一覧表示・管理します。 |
/hooks | 拡張 | 設定済みの hook を表示します。 |
/apps | 拡張 | 接続済みのアプリ/連携を管理します。 |
/plugins | 拡張 | プラグインマーケットプレイスのインストールを管理します。新しく、サードパーティ由来の構文です。安定性は低いとみなし、実環境で確認してください。 |
/agent | 拡張 | 範囲を限定したサブタスクのために subagent を派遣します。 |
/import | 拡張 | ファイルまたは URL からコンテキストをインポートします。 |
/keymap | インターフェース & ユーティリティ | キーボードショートカットを再割り当てします。 |
/vim | インターフェース & ユーティリティ | 入力の vim 風キーバインドを切り替えます。 |
/theme | インターフェース & ユーティリティ | カラーテーマを変更します。 |
/ide | インターフェース & ユーティリティ | IDE 連携のコマンドです。 |
/raw | インターフェース & ユーティリティ | 通常の解析をバイパスして生の入力を送信します。 |
/experimental | インターフェース & ユーティリティ | 実験的/フィーチャーフラグ付きの挙動を切り替えます（ゴールモードを含む）。 |
/debug-config | インターフェース & ユーティリティ | 有効化された、完全にマージ済みの設定を出力します。 |
/feedback | インターフェース & ユーティリティ | OpenAI にフィードバックを送信します。 |
/exit | インターフェース & ユーティリティ | Codex を終了します。 |
主要な config.toml キー
Codex はデフォルトで ~/.codex/config.toml から設定を読み込みます。日々もっとも重要なのは4つのキーです。
| キー | 値 | 機能 |
|---|---|---|
model | 例: gpt-5.6-terra | 新しいセッションのデフォルトモデルティア。 |
sandbox_mode | read-only / workspace-write（デフォルト） / danger-full-access | デフォルトのファイルシステム/ネットワークアクセスの範囲。 |
approval_policy | untrusted / on-request / never | Codex が行動前に停止して確認すべきタイミング。 |
project_doc_max_bytes | 整数、デフォルト 32768（32 KiB） | AGENTS.md ファイルの合計サイズ上限。超過分は警告なく破棄されます。 |
project_doc_fallback_filenames | ファイル名のリスト | AGENTS.md が見つからない場合に Codex が読み込む代替ファイル。 |
web_search | true/false | ライブのウェブ検索ツールを許可します。 |
model_reasoning_effort | low/medium/high | リクエストごとに費やす推論の深さ。 |
[features] | フラグのテーブル | フィーチャーフラグのブロック。例: ゴールモードには goals = true。 |
優先順位: CLI フラグ > プロジェクト設定 > プロファイル > ユーザー設定。-c key=value フラグは常に優先されます。プロジェクトレベルの config.toml は個人のものより優先されます。AGENTS.md の完全なマージ規則（および 32 KiB 上限の詳細）については Codex 向け AGENTS.md をご覧ください。
MCP - 1つのコマンドでサーバーを接続
CLI からサーバーを追加します。
codex mcp add docs --env API_KEY=$DOCS_KEY -- npx -y mcp-server-docsこれにより、対応するブロックが ~/.codex/config.toml に書き込まれます。
[mcp_servers.docs]
command = "npx"
args = ["-y", "mcp-server-docs"]
env = { API_KEY = "..." }Codex は MCP クライアントのみです。サーバーに接続しますが、サーバーを公開することはありません。追加すると、そのサーバーのツールは次のセッションで自動的に表示されます。タスクの途中で依存する前に、/mcp で接続を確認してください。完全なセットアップガイドは Codex で最初の MCP サーバーを接続する をご覧ください。
サンドボックス & 承認 - クイックマトリクス
| sandbox_mode ↓ / approval_policy → | untrusted | on-request | never |
|---|---|---|---|
| read-only | ほぼすべての操作の前に確認します。 | リスクのある読み取りのみ確認します。 | 確認しません。読み取りのみ可能です。 |
| workspace-write（デフォルト） | サンドボックス外への書き込み前に確認します。 | ワークスペース以上のものが必要なときのみ確認します。 | ワークスペース内では確認なしで自由に書き込みます。 |
| danger-full-access | 破壊的/システムレベルの操作の前に確認します。 | 確認はまれで、主に取り消せない操作のときだけです。 | フルアクセス、確認は一切なし。本当に注意して使用してください。 |
デフォルトのインストール時の挙動は workspace-write + on-request、つまり上の表の中央の行・中央の列です。ほとんどの人は他の8つの組み合わせに触れる必要はありませんが、Codex が予期しない権限を求めてきたときのために、それらが存在することを知っておくと役立ちます。各モードが実際に何を許可するかについては Codex のサンドボックスと承認モードの解説 をご覧ください。
キーボードショートカット（短く正直な一覧）
Codex CLI はホットキーではなくスラッシュコマンドを主体としており、CLI 専用の本当のショートカット一覧は短いものです。もしオンラインのページが十数個以上の「Codex キーボードショートカット」を列挙しているなら、それはおそらくデスクトップアプリや IDE 拡張機能を混ぜ込んでいます。
| キー | 動作 |
|---|---|
Ctrl+C | 現在のターンをキャンセルします。 |
Ctrl+D | Codex を終了します。 |
Ctrl+J | 入力ボックスに改行を挿入します。 |
Ctrl+L | 画面をクリアします。 |
Ctrl+R | 履歴の逆方向検索。バージョン依存（サードパーティ情報によれば ~v0.121.0 以降）。ご自身のインストール環境で確認してください。 |
Esc | 現在のターンを中断します。 |
Esc Esc | 直前の操作を取り消します。 |
Tab | Codex が処理中の間に、フォローアップメッセージをキューに追加します。 |
Enter | メッセージを送信します。 |
別のバインドにしたいですか？ /keymap を実行して再割り当てしてください。
AGENTS.md & Skills - さらに深く知るには
Codex は CLAUDE.md ではなく AGENTS.md からプロジェクトの指示を読み込みます。完全なマージ/上書き規則は Codex 向け AGENTS.md をご覧ください。再利用可能でクロス互換なワークフローは SKILL.md ファイルに置かれます。Codex Skills の解説 をご覧ください。
既製のワークフローを上に追加する
Codex CLI 自体は ChatGPT プラン内で無料です。自分でワークフローを組み立てたくない場合は、AgentKit が ak kit init engineer --target codex --global、続いてセッション内で $ak:cook を実行することで、既製の skill とワークフローを上に追加します。これは有料のアドオンであり、Codex 自体の一部ではありません。AgentKit を見る →
クイックアンサー
自分の正確なバージョンの全コマンドを確認するには？
ターミナルから codex --help を実行するか、セッション内で / を入力してライブのスラッシュコマンド一覧を表示します。
実際に読み込まれた設定を確認するには？
セッション内で /debug-config を実行します。優先順位が適用された後の、完全にマージ済みの設定を出力します。
Codex は設定をどこに保存しますか？
CODEX_HOME の中、デフォルトは ~/.codex で、config.toml、auth.json、history.jsonl を保持します。別のディレクトリを使うには環境変数を他の場所に向けてください。
CLI を更新するには？
今回のセッションでは自己更新のサブコマンドは個別に確認できませんでした。もっとも安全な方法は、インストールスクリプト（curl -fsSL https://chatgpt.com/codex/install.sh | sh）を再実行し、その後 codex --version を確認することです。
他の記事のコマンドがここに載っていないのはなぜですか？
この一覧は、執筆時点で公式ドキュメントで確認・照合されたものを反映しています。Codex はほぼ毎月リリースされるため、新しく追加されたコマンドや名前が変わったフラグは、このページを含むあらゆる静的ページに反映が遅れることがあります。codex --help とご自身のインストール環境での / が常に信頼できる情報源です。
まとめ
インストールし、/ でコマンドを確認し、? または codex --help でショートカットを確認して、このページをブックマークしてください。一覧は頻繁に変わるため、更新のたびに再確認する価値があります。Codex がまったく初めてですか？ まず OpenAI Codex とは何か から始め、次に CLI をインストール してください。