GHgithubguide.jp

🟣 Claude Code連携

Claude CodeでGitHubを使う

💡 「使い方」は操作を覚えることではなく確認する側に回ること／最初の接続設定は1回だけ／秘密情報の混入・merge判断・公開判断は人間の役目

このサイトはGitHub公式サイトではありません。GitHubの基本的な使い方や、Codex・ChatGPT時代のコード管理を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではGitHub公式情報も確認してください。

🤖 Claude Codeの担当 / 👤 人間の担当

🤖Claude Codeが自動でやること
  • ファイルの読み込みと編集
  • 変更内容のcommit
  • branchの作成
  • GitHubへのpush
  • （設定によっては）PR作成
👤人間が引き続き担うこと
  • 変更内容が意図通りかの最終確認
  • Pull Requestのmerge判断
  • 秘密情報が含まれていないかの確認
  • 本番反映のタイミング判断

👤 Claude Codeは「招待されたcollaborator」ではない

GitHubのprivateリポジトリは「自分と招待した人（collaborator）だけが見られる」設定です。ここで初心者がよく迷うのが、「Claude Codeを招待する必要があるのか」という点です。答えは不要です。

Claude Codeは、あなたのGitHubアカウントに対して発行された認証（トークンやSSHキー）を使って、「あなた自身として」リポジトリを操作します。collaborator一覧にClaude Codeが表示されることはなく、commitやpushの記録も「あなたの操作」として残ります。つまり、外部の人にリポジトリを見せる時のような「招待」の手続きは、AIツールには当てはまりません。

このことが実務的に意味するのは、AI連携で管理すべきは「誰を招待するか」ではなく「どの認証情報に、どこまでの権限を与えるか」だということです。次の接続設定で発行する認証情報の権限範囲を必要最小限にすることが、collaborator管理の代わりの安全対策になります。招待の仕組み自体は「招待する人」って誰のこと？で詳しく整理しています。

🔧 最初の接続設定（最初の1回だけ）

  1. 1
    GitHubアカウントを用意する
    まだの場合はGitHubアカウントの基本を参考に作成
  2. 2
    認証方法を設定する
    GitHub CLI（gh auth login）またはSSHキー・個人アクセストークンで認証
  3. 3
    作業対象のリポジトリをcloneする
    Claude Codeに作業してほしいリポジトリを事前に手元へ
  4. 4
    権限の範囲を意識する
    commitまでか、pushまでか、PR作成・mergeまでか

この4つを一度済ませれば、以降の日常作業では意識する必要はほぼありません。

✅ 実際に確認すべき4つのポイント

📁
変更ファイルの範囲依頼した範囲外のファイルが変わっていないか（diff確認）
🔑
秘密情報の混入APIキーや.envが差分に含まれていないか（Secrets注意）
🌿
branchとmainmainブランチへ直接反映されていないか
🌐
公開後の表示公開URLを直接開いて意図通りか確認
⚠️
Claude CodeにGitHub操作を任せる時の注意
  • 個人アクセストークンやSSHキーの秘密鍵は、会話やコード内に直接書き込まない
  • mainブランチへの直接pushを避け、branchとPull Requestを経由する
  • 権限を必要以上に広げない（自動mergeまで許可するかは重要度に応じて判断）
  • PRのmergeと、公開サイトへの反映は別作業の場合がある点に注意

関連ページ

FAQ

Claude Codeに任せきりで本当に大丈夫ですか？

作業自体は任せて問題ありませんが、Pull Requestのmerge判断や、公開前の最終確認は人間が行う運用をおすすめします。特に本番環境への反映や、秘密情報が関わる作業は、必ず差分を確認してから進めてください。

Gitのコマンドを覚える必要はありますか？

Claude Codeに操作を任せる場合、コマンドを暗記する必要はほとんどありません。ただし、GitHub画面上での「差分の見方」「Pull Requestの読み方」は知っておくと、確認作業がスムーズになります。

CodexとClaude Code、GitHubとの連携に違いはありますか？

どちらもGitHubへのcommit・push・PR作成を自動化できる点は共通していますが、対応する認証方法や設定項目は異なる場合があります。詳細は各ツールの公式ドキュメントで確認してください。

接続設定でつまずいた場合はどうすればよいですか？

認証エラーの多くは、トークンの権限範囲や有効期限に関係しています。まずはGitHub CLIで gh auth status を実行し、認証状態を確認するところから始めてください。