OpenAI Codex CLI コマンド＆設定早見表

OpenAI Codex CLI は、コマンドラインから直接コードベースを調査し、ファイル編集やテスト実行、Codex Cloud のリモートタスク連携、さらに MCP 経由での外部ツール接続を行える OpenAI 公式のターミナルネイティブ・コーディングエージェントです。

この早見表では Codex CLI のサブコマンドとフラグ、サンドボックスおよび承認ポリシー、対話型 TUI スラッシュコマンド、キーボードショートカット、config.toml / AGENTS.md の設定を整理しています。

🔗 関連チートシート: ターミナルAIコーディングCLI比較早見表 · Claude Code CLI 早見表 · Antigravity CLI (agy) 早見表 · AI Agent ハーネス設計早見表

1. インストール・認証・主要CLIコマンド

1.1 インストールと認証

操作	コマンド	備考
npm グローバルインストール	`npm install -g @openai/codex`	クロスプラットフォーム標準インストール
公式インストールスクリプト	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	macOS / Linux 向けワンライナーインストーラ
ブラウザログイン	`codex login`	ChatGPT Plus / Pro / Team アカウントで認証
APIキー認証	`export OPENAI_API_KEY="sk-..."`	ヘッドレスCIやコンテナ環境に最適

1.2 CLI サブコマンドとグローバルフラグ

コマンド / フラグ	説明	使用例
`codex`	カレントディレクトリで対話型 TUI を起動	`codex`
`codex "prompt"`	初期プロンプトを指定して対話セッションを開始	`codex "Debug 500 timeout errors on login"`
`codex exec` / `codex e`	スクリプトやCI向けの非対話型（ヘッドレス）実行	`codex exec "Run all unit tests and fix failures"`
`codex exec --json`	推論過程とファイル編集の構造化 JSON ログをストリーム出力	`codex exec --json "Refactor utils" > run.jsonl`
`codex review`	現在の Git diff に対して非対話型のコードレビューを実行	`codex review`
`codex resume`	セッションピッカーを開く（`~/.codex/sessions/` に保存）	`codex resume` / `codex resume --last` / `codex resume <id>`
`codex apply` / `codex a`	Codex Cloud タスクで生成された diff をローカル作業ツリーへ適用	`codex apply <task_id>`
`codex cloud`	リモートの Codex Cloud タスクを確認・管理	`codex cloud`
`codex mcp`	Model Context Protocol (MCP) サーバー連携を管理	`codex mcp list` / `codex mcp add <name> ...`
`-m, --model <name>`	セッションまたは単発実行で使用するモデルを指定	`codex -m gpt-6.1-sol`
`--strict-config`	`config.toml` の構文とキーを厳密に検証	`codex --strict-config`

2. サンドボックス＆承認ポリシーマトリクス

Codex CLI は権限を2つの直交するレイヤーに分離しています。環境がどこまで変更できるか（--sandbox） と いつユーザーに確認を求めるか（--ask-for-approval） です。

フラグ	指定可能な値	動作と推奨用途
`--sandbox <mode>` (エイリアス `-s`)	`read-only`	読み取り専用: ファイルを変更せずコードの調査・検索のみ許可
	`workspace-write`	ワークスペース書き込み（推奨デフォルト）: 作業ツリー内のみ編集を許可
	`danger-full-access`	無制限アクセス: ファイルシステム・システム全体へのフルアクセス（隔離コンテナ専用）
`--ask-for-approval <policy>`	`on-request`	推奨デフォルト: リスクの高い操作が必要な場合にモデルが確認プロンプトを提示
	`on-failure`	失敗時のみ確認へエスカレーション（サンドボックス昇格確認が必要なら `on-request` を使用）
	`never`	完全サイレント: 対話確認を一切行わない（CI・自動化パイプライン向け）

⚠️ 非推奨・廃止フラグのお知らせ:

--full-auto は v0.128.0 以降非推奨です。サンドボックスと承認ポリシーを明示的に指定してください。 codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"

承認ポリシー untrusted は v0.149.0 で廃止されました。設定を on-request へ移行してください。

3. 対話型 TUI スラッシュコマンド

対話中の codex TUI プロンプトで / を入力すると、コンテキスト、権限、ワークフローを操作できます。

3.1 コンテキスト・モデル・権限管理

コマンド	機能	備考・使い方
`/init`	リポジトリに合わせてカスタマイズされた `AGENTS.md` の雛形を生成	新規プロジェクトで最初に推奨される手順
`/status`	有効なモデル、権限設定、トークン消費量を確認	コンテキスト残容量の監視に利用
`/model`	モデルと Reasoning Effort 段階を対話的に切り替え	再起動せずに推論の深さを調整
`/permissions`	セッション途中でサンドボックスモードと承認ポリシーを変更	状況に応じて権限を厳格化または緩和
`/mcp`	接続済み MCP サーバーの状態確認と管理	外部ツールやDBとの接続疎通を確認

3.2 開発ワークフローとセッション制御

コマンド	機能	備考・使い方
`/plan`	ファイル編集前に実装計画を作成・レビュー	大規模リファクタリング前に設計方針を合意
`/review`	未コミットの変更に対して多角的なコードレビューを実行	バグ、エッジケース、セキュリティリスクを検出
`/diff`	未コミットのファイル変更差分を確認	反映前に行単位の diff を精査
`/fork`	会話スレッドを別チェックポイントへ分岐	メインコンテキストを汚さずに別案を検証
`/compact`	会話履歴を要約してコンテキスト空き容量を回復	長時間のマルチターンセッションでの精度低下を防止
`/copy`	直近の完了レスポンスをクリップボードへコピー	パッチや要約を手早く取り出す
`/title`	現在の会話スレッド名を変更	`codex resume` で過去のセッションを探しやすくする
`/statusline` / `/theme`	フッターのステータス項目や TUI カラーテーマをカスタマイズ	ターミナル表示を好みに合わせて調整
`/prompts:<name>`	カスタム Markdown プロンプトテンプレートを呼び出し	`~/.codex/prompts/<name>.md` を実行

4. ターミナルキーバインド＆入力構文

ショートカット / 構文	アクション	効果・利用シーン
`@<path>`	あいまいファイル参照	ファイル内容をインラインで注入（例: `@src/auth.ts`）
`!<command>`	インラインローカルシェル実行	有効なサンドボックス規則のもとでシェルコマンドを実行（例: `!npm test`）
`Tab`	次のプロンプトをキュー登録	Codex の処理中に次のプロンプト、スラッシュコマンド、`!` コマンドを予約
`Enter`	実行中の割り込み・軌道修正	エージェントが応答生成中に追加の指示を割り込ませる
`Ctrl + G`	外部エディタを開く	`$VISUAL` / `$EDITOR`（Vim、VS Code など）で複数行プロンプトを作成
`Ctrl + R`	プロンプト履歴検索	過去に送信したプロンプトをインクリメンタル逆方向検索
`Ctrl + L`	画面クリア＆再描画	会話状態を保持したままターミナル表示を整理
`Ctrl + O`	最新出力をコピー	`/copy` と同等の操作
`Ctrl + X`	キーボードメニューを開く	キーボードプリセットや拡張メニューへアクセス
`Ctrl + C`	キャンセル / 終了	実行中タスクの中断、または Codex セッションを終了

5. 設定ファイルとメモリ階層（`config.toml` & `AGENTS.md`）

プロジェクト単位の設定はグローバルのユーザー既定値を上書きします。

レイヤー	グローバル範囲（全リポジトリ）	プロジェクト範囲（現在のリポジトリ）	用途
コア設定	`~/.codex/config.toml`	`.codex/config.toml`	デフォルトモデル、サンドボックス、承認ポリシー、ネットワーク切替、MCP
エージェント指示書	`~/.codex/AGENTS.md`	`./AGENTS.md` (リポジトリルート)	ビルド/テストコマンド、コーディング規約、アーキテクチャ方針
カスタムプロンプト	`~/.codex/prompts/*.md`	—	再利用可能な `/prompts:<name>` スラッシュコマンドテンプレート
セッションログ	`~/.codex/sessions/`	—	`codex resume` で復元される永続ログ

最小構成の推奨 `~/.codex/config.toml`

# デフォルトモデル
model = "gpt-6.1-sol"

# デフォルトのサンドボックスと承認ポリシー
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# サンドボックス内の外部ネットワーク通信をデフォルトで制限
network_access = false