Codex GitHub diff

Codexの変更差分をGitHubで見るには

差分は、Codexがどこをどう変えたかを赤と緑で見る確認画面です。

まず一言でいうと

Codexで作業し、GitHubで確認します

差分は、Codexがどこをどう変えたかを赤と緑で見る確認画面です。

用語一言でいうと何を見るか
Codex作業を頼むAIファイル修正・確認・報告
Git変更履歴の仕組みcommit・branch・差分
GitHub変更を保管して見る場所PR・diff・履歴
PR変更を入れる前の確認場所内容・差分・未確認事項
diffどこが変わったか追加行・削除行・変更ファイル

このページで整理すること

Codexで作業した後に、GitHubやGitで何を確認すればよいかを初心者向けに整理します。GitHub公式やOpenAI公式の案内ではなく、実務で事故を避けるための確認メモとして読んでください。

Codexでできること

GitHub / Gitで確認すること

実際の作業フロー

  1. Codexに作業を頼む対象URL、対象ファイル、やること、やらないことを明確にします。
  2. 変更ファイルを見る作業対象以外のファイルが変わっていないか確認します。
  3. GitHubで差分を見る追加行、削除行、変更理由を確認します。
  4. Secretsや余計なファイルを確認するAPIキー、認証情報、ログ、.env が混ざっていないか見ます。
  5. PR本文を読む未確認事項、停止条件、確認結果を把握します。
  6. 人間がmerge判断するmain直pushや勝手なmerge、本番deployは軽く扱いません。

差分で見つかる問題の種類

差分確認は「間違いを探す」作業ですが、探すものには種類があります。種類を知っていると、見るべき場所が絞れます。

種類差分のどこに現れるか見つけ方
頼んでいない変更変更ファイル一覧依頼した対象と一覧を突き合わせる。最初にやる
意図しない削除削除行(マイナス側)消えた行が本当に不要だったか見る
依頼内容の抜け追加行(プラス側)頼んだ内容が実際に入っているか確認
秘密情報の混入追加行の中身キーやパスワードらしき文字列がないか
巻き込み事故差分に現れない差分では分からない。公開URLで実物を見る

最後の行が重要です。差分は「変更した内容」しか映しません。正しく変更した結果、別の場所の表示が崩れるといった副作用は差分には現れません。差分確認と公開URLでの目視は、どちらも必要で互いの代わりにはなりません。

差分が大きすぎて読めない時

変更が数十ファイルに及ぶと、丁寧に読むこと自体が現実的でなくなります。その場合は読み方を変えます。

最後の項目が本質的な対策です。「確認できる量」が依頼できる量の上限だと考えてください。作れる量ではなく、確かめられる量が基準になります。

差分を読む順番|全行読まない前提で、何を必ず見るか

AIの変更は差分が大きくなりがちで、「全行読む」は現実には続きません。続かない精読より、順番を決めた抜き取りのほうが事故を防ぎます。実際に使っている順番です。

  1. 1. 中身より先に、ファイル一覧だけを見る。「触るはずのないファイルが混ざっていないか」はここで分かります。1行も読まずに検出できる最重要チェックです。
  2. 2. 想定外のファイルがあれば、そこで止める。中身の良し悪しを検討する前に、なぜ触ったのかを確認します。理由が説明できない変更は差し戻します。
  3. 3. 意図したファイルは「削除が混ざっていないか」を先に見る。追加だけのはずの作業に削除行が混ざっているのが、事故の典型です。
  4. 4. 数字・URL・パス・日付だけは1文字単位で精読する。文章の言い回しと違い、ここの1文字ミスはそのまま実害になります。精読の対象をここに絞ります。
  5. 5. 同じ形の変更が大量にある時は、先頭の数件と途中の数件を抜き取る。一括置換系は全件が同じ形のはずなので、抜き取りで形が揃っていれば残りも信用できます。揃っていなければ全件見ます。

意図しない変更の典型と、気づき方

差分レビューで実際に引っかかるのは、凝ったバグより次のような機械的な混入です。それぞれ「どこで気づけるか」が決まっています。

典型何が起きるか気づき方
改行コードの一括変更1文字も変えていないのに全行が差分になる差分の行数がファイルの行数とほぼ同じ。この形を見たら中身でなく改行コードを疑う
フォーマッタの巻き込み依頼と無関係のインデント・空白の変更が大量に入る差分にスペースだけの行が並ぶ。依頼した変更が差分のどこにあるか探せなくなったら、これ
無関係ファイルの巻き込み「ついでに整えました」型の変更が別ファイルに入る手順1のファイル一覧で検出。中身を読む必要はない
削除の混入追加を頼んだのに既存の行が消えている削除行数を見る。追加系の作業で削除が2桁あれば必ず中身を確認
生成物・ロックファイルの混入自動生成されるファイルがコミットに入るファイル一覧に自分で書いた覚えのない名前がある

共通するのは、ほとんどがファイル一覧と行数の形だけで検出できることです。差分レビューの負担が重いと感じたら、読み方をこの型に変えるだけで、かかる時間は減り、見落としも減ります。

やってはいけないこと

差分を見ずに公開やmergeへ進めると、関係ないファイル変更や秘密情報混入に気づけないことがあります。

場面見ることやらないこと
外出先報告書、URL、差分本番deploy
スマホ表示確認、軽い指示merge判断の即決
別PCPR確認、差分確認認証情報の表示
移動中次の指示整理危険ファイル変更

関連ページ

FAQ

Codexにcommitやpushを任せていいですか?

作業範囲やチームルールによります。初心者向けには、まず差分とPRを人間が確認し、main直pushや勝手なmergeを避ける方が安全です。

GitHub Secretsの値をCodexに貼ってもいいですか?

貼らないでください。Secrets、APIキー、トークン、秘密鍵、認証情報は具体値を出さず、必要になった時点で停止条件にします。

スマホでPRをmergeしてもいいですか?

スマホでは差分や報告の確認までに留め、mergeやdeployのような重い判断はPCで落ち着いて確認するのが安全です。

Gitの危険なコマンドも覚える必要がありますか?

初心者ページでは危険なコマンド例を扱いません。戻し作業が必要な時は、対象を確認して別作業として慎重に進めます。

GitHub IssueでCodex作業を管理する

Codex作業をIssueに整理すると、作業依頼、停止条件、PR差分、報告書、未完了タスクをつなげて確認しやすくなります。秘密情報はIssueに書かず、PRや報告書で差分を確認します。

CodexとClaude Codeを勝ち負けではなく使い分ける

CodexとClaude Codeは、どちらが上かではなく、Web制作、GitHub作業、指示書、報告書、安全確認のどこで使うかを分けて考えると実務で扱いやすくなります。

差分がゼロ・差分が出ない時の確認

変更したはずなのに差分が出ない場合、コードの問題ではなく作業場所の問題であることがほとんどです。

「差分が出ない」と「変更されていない」は別なので、まずファイルを直接開いて中身が変わっているかを見るのが最短です。中身が変わっているなら上の4つのどれかです。

Codexに差分を説明させる時の頼み方

差分を自分で読む前に、Codex側に説明させると読む負担が下がります。ただし頼み方で有用性が変わります。

効かないのは「差分を説明して」です。変更内容をなぞった説明が返ってくるだけで、差分を読むのと手間が変わりません。効くのはリスクの観点を指定する形です。

そのうえで、挙がった箇所だけ自分で現物を確認します。指摘が無くても最終確認は人がやる前提は変わりませんが、見る場所の当たりが付くだけで所要時間が大きく減ります。

関連クエリの戻り導線

関連ページからCodex親ハブと勝ちページへ戻す

このページで個別テーマを確認した後は、Codex親ハブ、status、ホームページ制作、Google Drive、GitHub、公開前チェックへ戻ると、Search Consoleで反応している主要テーマを一続きで読めます。