GitHub Desktop × Codex
GitHub DesktopとGitHub Webの違い
GitHub Desktopは手元の変更を見るアプリ、GitHub WebはブラウザでリポジトリやPR、Settingsを見る画面です。
このページで整理すること
- DesktopとWebの役割の違い
- 差分、commit、pushの見る場所
- PRやSettingsの見る場所
- Secrets確認の考え方
- 初心者が迷いやすい場面
GitHub Desktopで見る場所
GitHub Desktopは、手元の変更ファイル、差分、commitメッセージ、branch、push前の状態を画面で確認するために使えます。万能な安全装置ではないため、commitやpushの前に人間が内容を読みます。
| 場所 | 一言でいうと | 見ること |
|---|---|---|
| Changes | 変更中のファイル一覧 | 何が変わったか |
| Diff | 変更の中身 | 追加・削除された行 |
| Summary | commitメッセージ | 変更内容のメモ |
| Branch | 作業場所 | mainか作業branchか |
| Push | GitHubへ送る操作 | 送る前に最終確認 |
Codexと使う時の注意点
- Codexで修正した内容を報告書で読む
- GitHub DesktopでChangesを開き変更ファイルを見る
- Diffで追加・削除された行を確認する
- 秘密情報や想定外ファイルがないか確認する
- commitするか判断する
- pushやPRは公開範囲とbranchを確認してから進める
commit / push 前に確認すること
| 確認項目 | 見ること | 止める条件 |
|---|---|---|
| Desktop | 手元の変更と差分 | Web側のPRを見忘れる |
| GitHub Web | PR、Settings、リポジトリ全体 | 手元の未commit差分を見落とす |
| 両方 | 報告書と差分の照合 | 片方だけで判断する |
やってはいけないこと
- GitHub Desktopの操作を万能扱いしない
- commitやpushを軽作業扱いしない
- main直pushや強制pushをすすめない
- APIキー、パスワード、トークン、秘密鍵の実値を書かない
- GitHub Secretsの実値を書かない
- repository削除やDanger Zone操作をすすめない
- 事故が起きない、完全に安全、と保証しない
どちらを使うかは作業で決まる
デスクトップアプリとブラウザは、優劣ではなく向く作業が違います。
| やること | 向いている | 理由 |
|---|---|---|
| 変更の差分を細かく見る | デスクトップ | ファイル単位で追いやすい |
| 手元のファイルを直す | デスクトップ | 編集と同じ環境で完結する |
| 他の人の変更を確認する | ブラウザ | コメントのやり取りができる |
| 設定や権限を変える | ブラウザ | 設定画面はブラウザ側にある |
| 外出先で内容だけ見る | ブラウザ | 環境を用意しなくてよい |
迷ったら「手元のファイルを触るか」で分けてください。触るならデスクトップ、見るだけならブラウザです。
AIに作業させた変更を確認する時
AIが変更した内容を確認する場合、デスクトップで差分を見てから、ブラウザで反映するのが安全です。
- デスクトップで、変更されたファイルの一覧を見る
- 頼んでいないファイルが含まれていないか確認する
- 差分を見て、意図した変更か確かめる
- 問題なければ反映する
- ブラウザ側で、他の人が見られる状態を確認する
2番目を飛ばさないでください。指示に範囲を書いていないと、関連する箇所もまとめて直されることがあります。件数が想定より多い時は、その時点で止めてください。
どちらを使うか迷った時の分かれ目
機能の比較より、作業の内容で選ぶほうが早く決まります。
- ファイルを1つ直すだけ — ブラウザで足ります。手元に取ってくる必要はありません
- 複数のファイルをまとめて直す — 手元のアプリ。ブラウザだと1つずつになります
- 動かして確かめる必要がある — 手元。ブラウザでは実行できません
- 他人の変更を読むだけ — ブラウザ。差分が見やすく表示されます
3番目が実質的な分かれ目です。変更を保存する前に動作を確かめたいなら、手元に取ってくる必要があります。逆に、確かめずに済む修正（誤字の訂正、説明文の追記）はブラウザのほうが速く終わります。
同じ作業でも、画面によって事故りやすさが違う
どちらでも同じことができる場面は多いのですが、間違えた時の気づきやすさが違います。作業の性質で選ぶと安全です。
| 作業 | 向いている画面 | 理由 |
|---|---|---|
| 変更内容の確認 | どちらでも可 | 差分の見え方は大きく変わらない |
| 大量のファイルを一度に扱う | デスクトップ | 手元のファイルと突き合わせながら進められる |
| 他の人の変更をレビュー | ブラウザ | コメントや承認の流れが画面に揃っている |
| 公開範囲・削除などの設定変更 | ブラウザ | 確認の手順が挟まる。設定変更は必ずこちらで |
| 外出先での確認だけ | ブラウザ | 何も入れずに見られる |
迷った時の原則は、「取り消せない操作はブラウザ側で」です。確認の画面が挟まるぶん、うっかりが減ります。
AIに作業させた変更を確認する時
AIに変更を任せた場合、確認の観点は「コードが正しいか」より先に「頼んでいないものが混ざっていないか」です。この用途ではデスクトップ側が向きます。
- 変更されたファイルの一覧をまず見る：中身より先に、想定した範囲に収まっているかを確認します。設定ファイルや環境ファイルが混ざっていたら、そこで止めます
- 差分の量を見る：小さな修正を頼んだのに数百行動いていたら、整形が走った可能性があります。意図した変更と区別がつかなくなるので、いったん戻して頼み直すほうが早いです
- 秘密情報が入っていないか：キーや接続情報が差分に出ていないかを確認します。AIが設定例として実物を書き込むことがあります
この3点を通してから、初めて内容の正しさを見ます。順番を逆にすると、混入に気づかないまま反映してしまいます。
関連ページ
FAQ
Codexの報告書だけ見れば十分ですか？
十分ではありません。報告書とGitHub Desktopの差分を見比べ、想定外ファイルや秘密情報がないか確認します。
commitは保存だから軽く押してよいですか？
履歴に残る操作なので、変更ファイル、差分、秘密情報、branchを確認してから判断します。
pushはいつ行いますか？
commit後、公開範囲やbranch、PRの流れを確認してから人間が判断します。
Secretsの値を差分で見つけたらどうしますか？
commitやpushを止め、実値を本文や履歴に残さない方法を確認します。