Codex CLIの仕組みを理解する：タスクから差分確認まで

Codex CLIはターミナルからローカルのリポジトリを調査・編集し、コマンドを実行できます。codex をプロジェクトで起動し、依頼に沿って作業した後、テストと差分を人が確認する流れです。正しさを自動で保証するものではありません。公式のCodex CLIガイドも、作業範囲と権限を自分で選ぶ使い方を説明しています。

作業場所と設定を確認する

開始前に対象リポジトリのルートにいることを確認します。/status はセッション設定、/model はモデルと推論設定、/permissions は許可範囲を確認するコマンドです。意図しないディレクトリで起動すると、必要なファイルやプロジェクト指示を見落とす場合があります。

依頼を検証可能にする

症状、対象、制約、成功条件を伝えます。例：「プロフィール保存で言語が失われる。APIは変えずに修正し、関連テストを実行する」。広い変更は先に計画を求め、認識が合ってから編集に進みます。

変更を小さく保つ

Gitで作業前の状態を記録し、変更後はテスト結果と差分を見比べます。失敗したテストが既存の問題か今回の回帰かも切り分けます。

権限と実行結果を見る

Codexは選択したサンドボックスと権限の範囲でファイルやコマンドを扱います。削除や公開など影響の大きい操作では、対象とコマンドを確認します。作業後は指定したテストの出力と差分を読み、生成物や秘密情報が紛れていないか確認します。/review は補助に使えますが、最終確認の代わりにはなりません。公式のベストプラクティスも、成功条件、テスト、レビューを勧めています。