基本操作
GitHubのブランチとは
ブランチの役割、mainと作業ブランチの違い、Codex作業でブランチを分ける考え方を整理します。
このページでわかること
- branchは「本体を守ったまま作業する分身」だということ
- mainブランチと作業ブランチの分け方
- branchを分けると何の事故が防げるか
- AI作業でbranchが特に重要になる理由
最初に結論
branchは、リポジトリの中に作る「並行世界」です。本体(main)はそのままに、分身のbranch上で自由に変更を試し、うまくいったらPull Requestで本体に取り込みます。失敗したらbranchごと捨てれば、mainは無傷です。「作業は必ずbranchで、mainには直接触らない」——このルール1つで、GitHubの事故の多くは構造的に起きなくなります。
初心者向け説明
branch名は「何の作業か」が分かる名前にします(例:fix-header-link、add-contact-page)。作業が終わってmergeしたbranchは削除して構いません。branchが本当に価値を発揮するのは、CodexやClaude CodeなどのAIに作業を任せる時です。AIの変更を直接mainに入れると、意図しない変更もそのまま本番の正になってしまいます。AIには必ずbranch上で作業させ、人間がPRの差分を見てからmergeする——これがAI時代のbranch運用の基本形です。
向いている使い方
- mainを安全に保ったまま修正・実験をする
- 複数の作業を並行して進め、それぞれ独立に取り込む
- AIの作業を人間の確認前に本番へ入れない仕組みを作る
注意が必要な使い方
- mainへの直接push(main直push)を習慣にしない
- 1つのbranchに複数の目的の作業を混ぜない
- 古いbranchを放置してどれが最新か分からなくならないようにする
CodexやChatGPTと組み合わせる場合
CodexやClaude Codeに作業を頼む時は「新しいbranchを作って作業して」と指示するか、AI側の標準動作がbranch作成になっているかを確認してください。mainに直接pushする設定のまま任せるのは、確認の機会を自ら手放すことになります。
秘密情報・APIキー・パスワード・個人情報の注意
APIキー、パスワード、秘密鍵、FTP資格情報、DB情報、メール設定、個人情報は、HTML、README、ログ、レポート、GitHubの差分に出さない前提で扱います。
関連ページ
FAQ
GitHubのブランチとはは初心者でも確認できますか?
はい。専門用語を覚える前に、何を確認すればよいかを優先して整理しています。
CodexやChatGPTを使う場合も同じ考え方ですか?
基本は同じです。自動化できる部分が増えても、差分確認、秘密情報確認、公開前確認は人間側で見ます。
秘密情報が混ざったかもしれない時はどうしますか?
commitやpushを急がず、対象ファイル、公開範囲、履歴への混入有無を確認します。必要に応じてキーやパスワードを無効化します。
GitHubの機能や画面は変わりますか?
変わる可能性があります。重要な判断や最新仕様はGitHub側の情報も確認してください。
このカテゴリの親ハブ
関連ページをまとめて確認する場合は、初心者ハブ から読み進められます。
private repository・公開範囲・秘密情報の確認
GitHubでCodex作業やサイト管理を進める時は、private/public、見える人、Secrets、APIキー、GitHub Desktopでの差分確認をセットで見ます。private repositoryでも機密情報をそのまま保存してよいわけではありません。
GitHubリポジトリ全体から見る
このページの内容は、リポジトリ名、公開範囲、private/public、branch、Pull Request、Secrets、GitHub Desktop、Codex連携まで含めて確認すると安全です。
リポジトリ設定の全体像へ戻る
公開範囲、権限、branch、Secrets、Pages、Danger Zoneは、単独ではなくリポジトリ全体の設定として見ます。
GitHub Desktopで差分を見る流れへ戻る
Codex作業後は、報告書だけで判断せず、GitHub DesktopのChangesとDiffを確認してからcommitやpushを判断します。
GitHub Secrets・Actions・PRレビュー・AIコードレビューの確認
branchを切って作業し、PRで差分確認してからmainへ反映する安全な流れを補強します。
GitHubでは、Secrets、Actions、branch、Pull Request、AIコードレビューを分けて確認します。private repoやAIの生成コードだけで安全とは判断せず、公開前に人間がdiff、ログ、設定、データを確認します。
確認する項目
| 項目 | 役割 | 注意点 |
|---|---|---|
| GitHub Secrets | APIキー、token、環境変数をActionsで使う時の保管先 | 値をコードやログに出さない |
| GitHub Actions | テスト、ビルド、デプロイの自動化 | 料金、無料枠、billing、実行時間、Secrets、ログを確認する |
| Actions env | ワークフロー内で使う環境変数 | 公開してよい設定と隠す値を分ける |
| deploy | FTP deployやSSH deployなどの反映作業 | 認証情報をログやYAML本文に出さない |
| Pull Request | branchの差分をmainへ入れる前の確認場所 | diff、レビュー、CI、Secrets混入を確認する |
| AIコードレビュー | CopilotやAIの指摘をレビュー補助に使う | 最終判断は人間が行う |
| 業務データ | CSV、スプレッドシート、顧客情報の扱い | private repoでも安全と断定しない |
公開前チェックリスト
- □ APIキー、token、.env、SSH鍵、DB情報が入っていないか確認した
- □ GitHub Secretsへ入れる値と、リポジトリに置く設定を分けた
- □ GitHub Actionsの料金、無料枠、billing画面を確認した
- □ GitHub ActionsのログにSecretsを出していない
- □ deploy、FTP deploy、SSH deployで使う認証情報をコードに置いていない
- □ branchで作業し、mainへ直接pushしていない
- □ PRのdiffを人間が確認した
- □ AIコードレビューの指摘をそのまま採用していない
- □ CSVやスプレッドシートに個人情報や業務データが入っていないか確認した
- □ 漏洩が疑われる場合はキーを無効化、再発行、履歴確認、影響範囲確認を行う
関連サイト導線
関連サイトはリンク先200を確認したものだけを掲載します。
branchでActionsとAI変更を分けて確認する
AIが作った変更やActions設定の変更は、branchで分けてPRに出すと確認しやすくなります。mainに直接入れる前に、差分、ログ、秘密値、deploy先を見ます。
- 作業単位ごとにbranchを分ける
- Actions設定の変更をPRで読む
- AI生成ファイルをまとめて確認する
- main反映前に戻せる状態を作る