CodexのDiffとは?AIが変更したコードを安全に確認する方法

Codexに「広告費と成果件数からCPAを計算する機能を追加してください」と頼むと、AIが既存のコードを調べてファイルを書き換えてくれます。ただ、「修正が完了しました」という報告だけでは、どのファイルの何が変わったのかまでは分かりません。既存のCTRやCPCの計算まで変わっていないか、関係のないファイルを書き換えていないかを確かめる方法として調べたのが、Diff(ディフ)です。

この記事では、Diffの見方と、Codexが変更したコードを確認する手順を整理します。

この記事で分かること

  • Diffの意味と基本的な見方
  • CodexとGitで変更内容を確認する方法
  • 意図しない変更を見つけたときの対応と注意点
目次

Diffとは

Diffは、変更前と変更後のファイルを比べて、どこが追加・削除されたかを表示する仕組みです。たとえば、クリック数が0件のときにエラーにならないよう、CPCの計算を直してもらった場合は次のように表示されます。

@@ -1,2 +1,4 @@
 def calculate_cpc(cost, clicks):
+    if clicks == 0:
+        return None
     return cost / clicks
表示意味
行頭の +追加された行
行頭の –削除された行
記号のない行変更箇所の前後にあるコード
@@ 〜 @@変更された範囲の位置

ファイル全体を読み直さなくても、変わった部分だけを中心に確認できるのが利点です。なお、画面での見た目は使うツールによって異なります。

CodexとGitで変更を確認する方法

OpenAIの公式ドキュメントによると、Codex CLIでは「/diff」と入力すると作業中のフォルダの差分を表示できます。まだGitに登録されていない新しいファイルも含まれるため、コミットやテストの前にCodexの変更を確かめる用途に向いています。

Gitのコマンドで確認する場合は、主に次の3つを使います。いずれもGitで管理しているプロジェクトが前提です。

コマンド分かること
git statusどのファイルが変更・新規作成されたか
git diff –statファイルごとの変更行数(規模の概要)
git diff変更されたコードの中身

通常のgit diffには、新しく作られた未登録のファイルが表示されないことがあります。そのため、最初にgit statusで変更ファイルの一覧を見るのが基本です。

確認の手順

CPA計算機能の追加を頼んだ場合を例に、確認の順番を整理します。

1. 変更ファイルが依頼と合っているか

git statusで、計算処理のファイルとテストのファイルだけが変わっているかを見ます。データ取得のファイルまで変わっていたら理由を調べます。関係なさそうな変更が必ず間違いとは限りませんが、確認は必要です。

2. 変更の規模と中身

git diff –statで規模を見ます。CPAを足すだけなのに数十ファイルが変わっていれば、頼んでいない書き換えまで行われている可能性があります。次にgit diffで中身を見て、追加された計算式だけでなく、成果件数が0件のときの扱いや、既存のCTR・CPCの計算が変わっていないかを確認します。

3. Codexに変更理由を説明してもらう

コードの意味が分からないときは、Codexに説明を頼みます。

今回の変更内容を、実際の差分を根拠に説明してください。
1. 変更したファイルと内容
2. 変更が必要だった理由
3. 既存機能への影響
4. 計画外の変更
5. 未確認の事項

ただし、AIの説明だけで確認を終えず、説明と実際の差分が一致しているかを見比べます。

4. テストを実行する

Diffは「何が変わったか」を見る仕組みで、「正しく動くか」はテストで確かめます。たとえば、広告費10,000円・成果5件でCPAが2,000円になるか、成果0件でエラーにならないか、既存のCTRやCPCの結果が変わっていないか、といった条件です。

意図しない変更があったとき

CPAの追加だけを頼んだのにCPCの計算式も変わっていた場合は、すぐに採用せず、まず理由を聞きます。その際、「現時点では追加の修正を行わないでください」と添えておくと、説明の途中で別の書き換えが進むのを防げます。

不要な変更を取り消すときは注意が必要です。たとえばgit restoreは、指定したファイルのまだ記録していない変更をまとめて元に戻すため、AIの変更だけでなく自分で行った変更まで消える可能性があります。取り消す前に差分を確認し、残したい変更を保存しておきます。Codexに頼む前の状態をコミットしておくと、比べる基準がはっきりし、戻すのも簡単になります。

Diffだけでは分からないこと

Diffでコードが正しそうに見えても、実行するとエラーになることがあります。外部APIの仕様変更や、データベースの中身への影響も、コードの差分だけでは判断できません。広告費や売上などの数値を扱うシステムでは、テスト、実際の動作確認、計算結果の検証、Gitやバックアップによる復旧の準備と組み合わせます。

※記事作成時点(2026年11月)の情報です。Codexの機能や画面は変わることがあるため、最新の情報はOpenAIの公式ドキュメントをご確認ください。

まとめ

Diffは、AIが変更したコードの「どこが変わったか」を確かめるための仕組みです。変更ファイルの一覧、変更の規模、中身の順に見ていくと、頼んでいない書き換えに気づきやすくなります。

AIにコードを書かせることと、書かれたコードを確認することは別の仕事です。Diffで変更を確かめ、テストで動きを確かめてから採用する、という順番を基本にしようと考えています。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次