🎃

Codex CLI 完全ガイド：全オプション徹底解説

に公開
AI
AIエージェント
Vibe Coding
Codex
Codex CLI
tech

Codex CLI オプション一覧

共通設定

  • -c / --config key=value: ~/.codex/config.toml の値を上書き。ドット区切りキーや TOML/JSON 形式をサポートし、複数指定可。

codex（対話型 TUI）

  • 位置引数 PROMPT: セッション開始時の初期プロンプト。
  • -i / --image FILE[,…]: 初回メッセージに添付する画像を追加。
  • -m / --model ID: 利用モデルを指定。
  • --oss: ローカル OSS プロバイダを選択（model_provider=oss 相当）。
  • -p / --profile NAME: config.toml のプロファイルを読み込む。
  • -s / --sandbox {read-only|workspace-write|danger-full-access}: サンドボックスモード。
  • -a / --ask-for-approval {untrusted|on-failure|on-request|never}: コマンド実行時の承認ポリシー。
  • --full-auto: workspace-write + on-failure をまとめて有効化。
  • --dangerously-bypass-approvals-and-sandbox（別名 --yolo）: サンドボックスと承認を完全無効化（危険）。
  • -C / --cd DIR: 作業ルートを指定。
  • --search: Web 検索ツールを有効化。

codex resume

  • SESSION_ID（任意）: 再開するセッション UUID。
  • --last: 最新のセッションを picker なしで再開（ID 指定とは排他）。
  • その他のフラグは codex と同一。

codex exec（非対話実行）

  • PROMPT（任意）: 初期指示。- 指定で標準入力から読込。
  • -i / --image FILE[,…]: 初期画像添付。
  • -m / --model ID, --oss, -p / --profile, -s / --sandbox, --full-auto, --dangerously-bypass-approvals-and-sandbox, -C / --cd: codex と同様。
  • --skip-git-repo-check: Git リポジトリ外でも実行。
  • --output-schema FILE: 最終応答の JSON Schema を指定。
  • --color {always|never|auto}: 出力のカラー設定。
  • --json（別名 --experimental-json）: イベントを JSONL で出力。
  • --include-plan-tool: プラン生成ツールを常に組み込み。
  • --output-last-message FILE: 最終メッセージをファイルへ保存。

codex exec resume

  • SESSION_ID（任意）: 再開対象。
  • --last: 最新セッションを選択（ID 指定と排他）。
  • PROMPT（任意）: 再開直後に送る追加プロンプト。

codex completion

  • --shell {bash|elvish|fish|powershell|zsh}: 補完スクリプト生成対象（既定 bash）。

codex login

  • --api-key KEY: API キーでログイン。
  • --experimental_use-device-code: デバイスコードフローを試用（実験的／非推奨）。
  • --experimental_issuer URL: OAuth issuer をカスタム指定（実験的）。
  • --experimental_client-id CLIENT_ID: OAuth クライアント ID を上書き（実験的）。
  • サブコマンド status: 現在の認証状態を表示。

codex logout

  • 追加オプションなし（-c のみ利用可能）。

codex apply <TASK_ID>

  • Hosted タスクの最新差分を適用。-c で設定上書きが可能。

codex debug seatbelt|landlock

  • --full-auto: サンドボックス内でフルオート設定を適用。
  • 位置引数: サンドボックス下で実行するコマンド全体。

codex mcp（実験機能）

  • list [--json]: 登録 MCP サーバーを一覧表示。
  • get <NAME> [--json]: 指定サーバー詳細を表示。
  • add <NAME> [--env KEY=VALUE …] -- COMMAND…: MCP サーバー起動設定を追加。
  • remove <NAME>: 設定を削除。
  • すべて -c 上書きに対応。

codex mcp-server / codex app-server

  • 追加フラグなし（-c のみ）。

codex cloud（クラウドタスク TUI）

  • 追加フラグなし（-c のみ）。挙動は環境変数 CODEX_CLOUD_TASKS_* で制御。

内部・隠しサブコマンド

  • codex generate-ts --out DIR [--prettier PATH]: TypeScript バインディング生成。
  • codex responses-api-proxy [--port PORT] [--server-info FILE] [--http-shutdown]: Responses API プロキシ。

値一覧リファレンス

  • サンドボックス: read-only / workspace-write / danger-full-access
  • 承認ポリシー: untrusted / on-failure / on-request / never
  • カラー設定: always / never / auto

Discussion