Codex CLI のよく使うコマンドとセッション操作のクイックリファレンス

Codex CLI は更新頻度が高く、記事は現在のバイナリのヘルプテキストの代わりにはならない。まずトップレベルのヘルプでサブコマンドを確認し、その後 specific なサブコマンドに対して --help を実行する。

厳格な設定モードは、無効化されたフィールドやスペルミスの設定フィールドの発見に適しているが、アップグレードの影響はまず非本番ワークスペースで検証すべきである。

サブコマンドなしで codex を実行するとインタラクティブ画面に入る。-C で作業ルートディレクトリを指定、-m で一時的にモデルを選択、-i で画像を添付。これらのパラメータは今回の呼び出しにしか適用されない。

追加の書き込み可能ディレクトリは --add-dir で明示的に指定し、隣接ディレクトリ1つにアクセスするためにサンドボックス全体を広げないこと。

resume は既存セッションを続きから再開しコンテキストを維持する。fork は履歴セッションから新しい作業方向を作り出す。どちらも --last で最近のセッションを素早く選択できる。引数なしの場合はセレクタを使う方が確実。

再開前には現在のリポジトリとブランチを確認すること。履歴コンテキストは作業ツリーが前回と完全に同一であることを保証してくれない。

-c は TOML 値を受け取り、config.toml のトップレベルまたはネストされたフィールドを上書きできる。一回限りの上書きは仮説検証に適しており、有効と確認できてから永続設定に書き込むか判断する。

サンドボックスと承認には専用パラメータがあり、-s と -a を優先して使用する。汎用の -c よりコマンドの意図が明確になる。

codex exec は非インタラクティブ呼び出し向けで、引数または標準入力からタスクを読み取れる。codex review は現在のリポジトリの差分を対象とし、未コミット内容、基準ブランチとの差分、単一コミットをレビューできる。

自動化時は必ず終了コードをチェックし、JSONL イベントと最終テキストを分けて保存する。自然言語で「成功」を検索してタスク状態を判断してはいけない。

completion は shell に基づいて補完スクリプトを生成する。具体的な読み込み方法は shell が決定する。update は自己更新をサポートするインストールをアップグレードするためのもので、パッケージマネージャで管理されている場合は同じアップグレードチャネルを維持すべきである。

doctor はインストール、設定、認証、実行環境をチェックする。レポートを共有する前にも内容を自分で確認し、パスや組織情報を公開チケットに送信しないようにする。