MENU

Codexの変更をGitで確認する方法|未追跡・未ステージ・ステージ済みを見落とさない

Codexが修正したコードを確認するときは、変更したという説明を読むだけでなく、Gitが把握しているファイル全体を見ます。通常の git diff が空でも、ステージ済みの変更や未追跡の新規ファイルが残っている場合があります。

最初に変更ファイルの一覧を取り、未ステージとステージ済みの差分を別々に確認し、新規ファイルは中身を開いて読みます。この三つを分けると、「差分を見たつもりで一部を見落とす」ことを減らせます。S1S2

目次

作業前の状態がないと、誰が変えたかは判断できない

Gitの変更一覧には、自分の手作業やツールが生成した変更も含まれます。Codexが編集する前に、未保存のファイルを保存し、作業中の差分と新規ファイルを確認しておくことが大切です。

すでに修正が終わっている場合も、変更一覧のすべてをCodex由来と決めないでください。作業前にあった差分、今回の依頼内容、Codexの報告を照合します。Gitだけで、未コミットの各行を誰が書いたかまで確定できるわけではありません。

次は、Git管理された対象プロジェクトで変更の状態を調べる例です。--no-optional-locks は、状態確認に伴う任意のロックを避ける指定です。S1

git --no-optional-locks status --short --untracked-files=all

短い形式では、ファイル名の前の二列を見ます。通常の変更では左側がインデックス、右側が作業ツリーの状態を表します。次は表示の説明用の架空例です。S1

 M app/Services/PriceService.php
M  tests/Feature/PriceTest.php
MM composer.json
?? tests/Feature/PriceBoundaryTest.php
表示 この例で分かること 次の確認
右側だけM 未ステージの変更がある 通常のdiff
左側だけM ステージ済みの変更がある cachedのdiff
MM ステージ済みと、その後の変更がある 両方のdiff
?? まだGitが追跡していない 新規ファイルを直接読む

競合中などは表示の意味が異なります。競合が残っていたら、通常のレビューを進める前に、元の作業状態と解決方針を確認してください。

未ステージとステージ済みの差分を両方読む

最初は変更の件数とファイルをつかみ、その後で行単位の差分へ進みます。以下では、ページャー、外部diff、テキスト変換を使わずに表示する指定を付けています。差分の中身を確認するコマンドで、ステージングやコミットの操作ではありません。S2

git --no-pager diff --no-ext-diff --no-textconv --stat
git --no-pager diff --no-ext-diff --no-textconv --cached --stat

--stat だけではコードの内容は分かりません。次に両方の差分を読みます。

git --no-pager diff --no-ext-diff --no-textconv --
git --no-pager diff --no-ext-diff --no-textconv --cached --

通常のdiffは作業ツリーとインデックス、--cached はインデックスと現在のコミットを比較します。インデックスは、コミットする内容を準備する領域です。MM のファイルでは、この二つを片方だけ見ても全体を確認したことになりません。S2

変更行数が多い場合は、改行コード、整形、生成物の更新などが混ざっていないかも確認します。見た目を整えただけだという説明でも、差分を消して扱う前に、仕様変更と本当に分けられるかを確かめてください。

新規ファイルと、Gitが無視するファイルを別に扱う

未追跡ファイルの一覧だけなら、次のコマンドでも確認できます。--exclude-standard は、標準の除外設定を適用する指定です。S3

git ls-files --others --exclude-standard

表示されたファイルは、エディターで開いて内容を読みます。通常のdiffに出すためだけに、すべてをステージする必要はありません。不要なログや、意図しない設定ファイルが混ざっていないかも見ます。

この一覧は、無視されたファイルを含むディスク全体の棚卸しではありません。.gitignore の対象やGit管理外の別フォルダに変更があれば、Gitの差分だけでは確認できません。Codexへ、変更した場所、生成したもの、実行したコマンドも報告してもらい、作業範囲と照合します。

秘密情報を探す場合も、差分や設定を丸ごと外部へ送る方法は避けます。顧客コードを扱ってよいかは、差分を小さくすれば自動的に解決する問題ではありません。

意図した変更かを、ファイルの役割で判断する

次の表は、PHP・Laravel・WordPressの改修で確認する観点の例です。ファイルの変更が多いこと自体より、依頼に必要な理由を説明できるかを見ます。

変更されたもの 確認したいこと
PHPの処理 入出力、認可、入力検証などが目的に沿うか
テスト 不具合を見つける条件が残り、期待値を都合よく変えていないか
composer.json・lock 依存更新が必要か、依頼外の更新がないか
設定・DB変更 実行時の影響と、戻せる範囲が明確か
生成物・大量の整形 再生成の理由と方法を説明できるか

コード自体の検証方法は、AIを使うPHP・WordPress改修の確認手順で整理しています。本稿のGit確認は、その検証へ進む前に、確認対象を漏らさず把握するためのものです。

Codexのレビューにも、対象範囲を指定する

公式資料では、IDE拡張の /review から、基準ブランチとの差分または未コミットの変更を選ぶ手順が案内されています。Gitリポジトリ内のプロジェクトが対象で、画面や選択肢は利用する版によって確認が必要です。S4

たとえば、次のようにレビューの対象と観点を伝えます。

いまは変更せず、確認だけ行ってください。
未ステージ・ステージ済み・未追跡の対象ファイルを分けて確認してください。

目的は、料金計算の境界値を修正することです。
入力検証、既存の丸め規則、テストの期待値に意図しない変更がないか見てください。
指摘には、根拠のファイル、問題になる入力、未確認の点を含めてください。

これはレビュー依頼の架空例です。Codexの報告とGitの一覧を照合し、レビューされていないファイルがあれば追加で確認します。指摘がないことを、テスト成功や不具合がない証明にはしません。

戻すときは、自分の作業まで捨てない

差分に問題が見つかったら、修正し直すのか、今回の変更だけを取り消すのかを決めます。取り消す前に、未ステージ、ステージ済み、新規ファイルを含めて、戻す対象と残す内容の控えを用意します。

エディターやCodexの取り消し操作も、表示中の一部分だけを戻すのか、ファイル全体なのかを確認してください。作業前からの変更が混ざっている場合は、一括の「すべて元に戻す」を選ぶと、自分の作業も失うおそれがあります。

コードを戻しても、実行したDB変更、送信したメール、外部APIへの更新までは戻りません。Gitによる復旧と、アプリが起こした副作用の復旧を別に整理します。テストを行う場合も、接続先と実行内容を先に確認してください。

確認日:2026年11月23日。Git 2系の公式仕様と、現行Codex IDE拡張のレビュー案内を照合しています。コマンド例はシェル構文のみを確認し、実プロジェクトでの変更・取り消し・各OSの画面操作を再現した結果ではありません。Mac・Windowsとも、同じGitリポジトリで確認していることと、未保存ファイルの有無を確かめてください。

出典

  1. https://git-scm.com/docs/git-status Git「git-status」(確認日: 2026-11-23) ↩1 ↩2 ↩3
  2. https://git-scm.com/docs/git-diff Git「git-diff」(確認日: 2026-11-23) ↩1 ↩2 ↩3
  3. https://git-scm.com/docs/git-ls-files Git「git-ls-files」(確認日: 2026-11-23) ↩1
  4. https://learn.chatgpt.com/docs/code-review OpenAI「Code review」(確認日: 2026-11-23) ↩1
よかったらシェアしてね!
  • URLをコピーしました!
目次