Command line options

概要

Codex CLI のコマンドとグローバルフラグの索引。CLI は既定値の多くを ~/.codex/config.toml から継承し、コマンドラインで渡した -c key=value の上書きがその呼び出しで優先する。

仕様

グローバルフラグ

基底の codex コマンドに適用される。多くはサブコマンドにも伝播するが例外がある（codex exec --oss ... のようにサブコマンド側のヘルプに従う）。

コマンド一覧と成熟度

Maturity ラベル（Experimental / Beta / Stable）は Feature Maturity の定義に従う。

主なコマンドの詳細

• codex（対話）: サブコマンド無しで TUI を起動する。グローバルフラグと画像添付を受け付ける。web search は既定で cached モードで、--search でライブに切り替える。低摩擦なローカル作業には --sandbox workspace-write --ask-for-approval on-request
  • --remote ws://host:port / wss://host:port で codex app-server --listen ws://IP:PORT に接続する。ローカル Unix socket は --remote unix://（既定）か --remote unix://PATH
• codex app-server: 主に開発・デバッグ用で、予告なく変わりうる。--listen stdio:// が既定の JSONL-over-stdio（--stdio はそのエイリアス）。--listen ws://IP:PORT で WebSocket。サーバーが受け付ける listen URL は ws://。クライアントが wss:// で繋ぐ場合は TLS 終端かセキュアプロキシを使う。--listen unix:// または --listen unix:///absolute/path.sock。クライアントバインディング用のスキーマ生成では --experimental で gated なフィールドとメソッドを含められる
  • --code-mode-host wss://... でローカルホストを起動せずリモートの Code Mode ホストに接続する。この outbound 接続は --listen とは別で、app-server プロセス内の全スレッドで共有される。ws:// は localhost か SSH フォワードされたホストにのみ使う
• codex remote-control: フォアグラウンドで remote control を開始する。start / stop でデーモンを管理し、pair で短命な手動ペアリングコードを出す。--json で機械可読出力（pair の JSON には pairingCode、manualPairingCode、environmentId、expiresAt）。ローカルのプロトコルクライアントを作る用途では codex app-server --listen の代わりにはならない
• codex apply: 認証済みで、そのチャットへのアクセス権が必要。パッチしたファイルを出力し、git apply が失敗すると非ゼロで終了する
• codex review: レビュー対象をちょうど 1 つ選ぶか、カスタム指示をプロンプトとして渡す。--uncommitted、--base、--commit、カスタム PROMPT は互いに競合する。--title は --commit とだけ併用する
• codex archive / codex unarchive / codex delete: セッション ID または名前で指定する。セッション ID が名前より優先される。--force はセッション UUID とのみ使える。名前付きセッションは、曖昧な名前を誤削除しないよう常に確認を求める
• codex cloud list: プレーンテキストではタスク URL と状態を出力する。--json の payload は tasks 配列と任意の cursor。各タスクは id、url、title、status、updated_at、environment_id、environment_label、summary、is_review、attempt_total を含む
• codex features: $CODEX_HOME/config.toml のフィーチャーフラグを管理する。enable / disable は将来のセッションにも効くよう永続化する。features サブコマンドは --profile を受け付けない
• codex execpolicy: check が 1 個以上の --rules を受け取り、最も厳しい判定と一致したルールを JSON で出す。--pretty で整形。このコマンドは現在 preview
• codex login: フラグ無しでは ChatGPT OAuth のためにブラウザを開く。codex login status は資格情報があるとき 0 で終了する
• codex mcp: add は stdio と streamable HTTP の両方に対応。OAuth の login / logout は streamable HTTP サーバー、かつサーバーが OAuth に対応している場合にのみ動く
• codex plugin marketplace add: owner/repo や owner/repo@ref の GitHub 短縮形、HTTP(S) の Git URL、SSH の Git URL、ローカルのマーケットプレイスルートを受け付ける。--ref で Git ref を固定、--sparse PATH の繰り返しで Git ベースのリポジトリを sparse checkout する
• codex resume: --last は現在の作業ディレクトリにスコープされる。--all で全体から探す。作業ディレクトリがセッションの保存ディレクトリと異なる場合はどちらを使うか尋ねる。tui.resume_cwd を "current" または "session" にすると尋ねずに済む。明示的な --cd（-C）は tui.resume_cwd より優先する
• codex fork: 既定でセッションピッカーを開く。--last で直近をフォークする。ディレクトリが異なる場合の扱いは codex resume と同じ
• codex update: debug ビルドではリリースビルドを入れるよう促すメッセージを出す

フラグの組み合わせに関する指針

• ワークスペース内で完結する無人のローカル作業には --sandbox workspace-write を使い、専用のサンドボックス VM の中でない限り --dangerously-bypass-approvals-and-sandbox は避ける
• 書き込み可能ディレクトリを増やしたいときは --sandbox danger-full-access を強いるのではなく --add-dir を使う
• CI では --json と --output-last-message を組み合わせて、機械可読な進捗と最終的な自然言語の要約の両方を得る

対話モードのショートカット

設定

codex --sandbox workspace-write --ask-for-approval on-request
codex --model gpt-5.6-terra -C ./services/payments
codex resume --last
codex exec --json --output-last-message out.txt "Run the tests"
codex completion zsh > "${fpath[1]}/_codex"

関連

• facts/codex/slash-commands.md
• facts/codex/config-basics.md
• facts/codex/non-interactive-mode.md
• facts/codex/sandbox.md
• facts/codex/approvals-and-security.md
• facts/codex/mcp.md
• facts/codex/plugins.md
• facts/codex/models.md