Claude GitHub連携の4つの方法｜設定手順・注意点を解説

「GitHubにあるプログラムをClaudeに見せたい」「プルリクエストの作成やレビューをClaudeに任せたい」と考えて調べると、連携の方法がいくつも出てきて迷うことがあります。

実は、ClaudeとGitHubの連携は1種類ではありません。チャットに読ませる、Claude Codeで手元のgit操作を任せる、クラウドで動かす、GitHub Actionsで自動化するなど、目的によって使う仕組みも設定する場所も違います。Anthropicの公式ドキュメントでも、これらは別々のページで説明されています。

この記事では、連携の方法を4つに分けて整理し、それぞれの設定手順、使えるプラン、費用、権限の注意点を解説します。内容は2026年10月時点の公式情報をもとにしています。画面の表記や提供状況は変わることがあるため、設定の前に公式ページもあわせて確認してください。

ClaudeとGitHubの連携の全体像

GitHubは、プログラムやWebサイトのファイルを保管し、変更の履歴を管理するサービスです。ClaudeとGitHubをつなぐと、保管してあるコードをClaudeに読ませたり、変更の提案を出してもらったり、変更を自動で下書きしてもらったりできます。

連携の方法は、おもに次の4つに分けられます。

上から順に、できることが増える代わりに、権限の設定と費用の管理が必要になります。まずは「読ませるだけ」から始め、必要になったら次の方法に進むのが安全です。

どれを選べばいいか

迷ったときは、やりたいことから選ぶと決めやすくなります。

チャットでGitHubのコードを読ませる

いちばん手軽なのが、ClaudeのチャットやプロジェクトにGitHubのリポジトリを追加する方法です。コマンドもインストールも要りません。ブラウザやアプリの画面から、読ませたいファイルを選ぶだけです。

チャットに追加する手順

公式ヘルプの手順は次のとおりです。GitHubにまだログインしていない場合は、GitHubのログイン画面に移ります。

1. チャットを開くClaudeで新しいチャットを開きます。
2. 「Add from GitHub」を選ぶ入力欄の左下の「+」ボタンを押し、メニューから「Add from GitHub」を選びます。
3. ファイルとフォルダを選ぶリポジトリのファイルブラウザが開くので、読ませたいファイルやフォルダを選びます。
4. 質問を送るメッセージを送ると、Claudeが選んだファイルを読み込んで答えます。

プロジェクトに追加する手順

同じリポジトリについて何度も質問するなら、「プロジェクト」に追加しておくと便利です。プロジェクトの知識（ナレッジ）として保存されるので、毎回選び直す必要がありません。

1. プロジェクトを開く対象のプロジェクトを開き、「プロジェクトの知識」欄の右上にある「+」を押します。
2. 「GitHub」を選ぶメニューから「GitHub」を選びます。
3. リポジトリを探すアクセスできるリポジトリを検索するか、リポジトリのURLを貼り付けます。
4. ファイルを選んで追加するファイルブラウザで必要なファイルとフォルダを選ぶと、プロジェクトの知識に追加されます。

読み込まれる範囲と、できないこと

このGitHub連携で取り込まれるのは、指定したブランチにあるファイルの名前と内容だけです。コミットの履歴、プルリクエスト、Issueなどの情報は取得されません。また、チャットのこの連携から、GitHubのコードを書き換えることはありません。

会社のGitHub（SSO）で表示されないとき

SSO（シングルサインオン）を使っている組織の非公開リポジトリは、連携が「接続済み」と表示されていても、一覧に出てこないことがあります。公式ヘルプでは、GitHubの「github.com/settings/applications」で「Claude」を開き、「Organization access」から該当する組織の「Grant」を押すよう案内されています。ボタンが「Request」と表示される場合は、組織の管理者の承認が必要です。

なお、このヘルプには、チャットの連携を使えるプランの記載がありません。コネクタ（外部サービスとのつなぎ込み）の画面から、自分のプランで利用できるかを確認してください。

Claude Codeでコミットやプルリクエストを任せる

コードを実際に書き換えたい場合は、Claude Codeを使います。Claude Codeは、パソコン上のプロジェクトのフォルダでClaudeに作業を任せるツールです。ファイルの修正からコミット（変更の記録）、プルリクエスト（変更をチームに確認してもらう依頼）まで、日本語で頼めます。

プルリクエストの作成を頼む

公式ドキュメントには、次のように書かれています。「create a pr for my changes」のように直接頼むか、変更内容の要約から順に進めることができます。

1. 変更内容をまとめてもらう「認証まわりに加えた変更を要約して」のように頼みます。
2. プルリクエストを作ってもらう「PRを作って」と頼みます。
3. 説明文を整える「セキュリティの改善点がわかるように説明文を補って」のように、内容を直してもらいます。

プルリクエストの作成では、GitHubの公式コマンド「gh」が使われることがあります。公式ドキュメントも、Claudeがgh pr createで作ったプルリクエストと会話を紐づけると説明しています。事前にghを入れ、gh auth loginでログインしておくと、すぐに使えます。

あとから会話を探す

プルリクエストの指摘を直すときは、作成したときの会話に戻れると便利です。claude --from-pr 1234のように番号を指定すると、そのプルリクエストに紐づいた会話の一覧が開きます。

コミットに付く表記を変える

Claude Codeが作ったコミットやプルリクエストの説明には、Claudeが関わったことを示す表記が付きます。設定ファイルのattributionという項目で、この表記を変えたり、非表示にしたりできます。社内のルールで表記をそろえたいときは、設定を確認してください。

クラウドでGitHubのリポジトリを動かす

「クラウドセッション」は、Claude Codeの作業を手元のパソコンではなく、Anthropicが用意したクラウド上で動かす仕組みです。GitHubのリポジトリを読み込んで修正し、ブランチ（作業用の枝）を作ってGitHubに送ります。パソコンを閉じても作業が続き、スマホから確認することもできます。

使えるプランと料金

公式ドキュメントによると、クラウドセッションはPro・Max・Teamで使え、Enterpriseではプレミアム席などのユーザーが対象です。無料プランは対象外です。クラウドの仮想マシンに別途の料金はかからず、利用量は、ほかのClaudeやClaude Codeの利用と同じプランの上限に含まれます。

GitHubをつなぐ2つの方法

非公開リポジトリを使うには、GitHubのアカウントか組織に「Claude GitHub App」を入れておく必要があります。組織のGitHubでは、オーナーの承認が必要なことがあります。

ブラウザから始める手順

1. claude.ai/codeを開くClaudeのアカウントでログインします。
2. GitHubにサインインする表示に従ってGitHubの認証画面で許可します。非公開リポジトリを使う場合は、Claude GitHub Appも入れます。
3. 環境を作るProとMaxでは「Default」という環境が自動で作られます。TeamとEnterpriseでは、作成画面で「Create & finish」を押します。
4. リポジトリを選んで依頼する入力欄の下でリポジトリとブランチを選び、やりたいことを具体的に書いて送ります。
5. 差分を見てプルリクエストを作る変更を確認し、画面上部の「Create PR」でプルリクエストを作ります。

手元のターミナルからは、claude --cloud "認証のバグを直して"のように頼むこともできます。クラウドは、手元のフォルダではなくGitHubにあるリポジトリを取得して作業します。公式ドキュメントでも、手元にコミットがある場合は先にプッシュ（GitHubへの送信）しておくよう案内されています。

Auto-fix：CIの失敗やレビューに自動で対応する

クラウドセッションには、プルリクエストを見張って、テスト（CI）の失敗やレビューのコメントに自動で対応する「Auto-fix」があります。Claudeが原因を調べ、直し方が明確なら修正を送ります。解釈が分かれる指摘は、実行前に確認を求められます。

Team・Enterpriseの場合

TeamとEnterpriseでは、組織の管理画面の設定が先に必要です。「GitHubのコネクタ」をオーナーが有効にするまでは、利用者の画面に「GitHub access is required」と表示されます。さらに「Quick setup」という設定をオーナーが有効にすると、利用者は/web-setupを使えるようになります。社内のGitHub Enterprise Server（自社で運用するGitHub）も、TeamとEnterpriseで利用できます。

GitHub Actionsで@claudeを使う

GitHub Actionsは、GitHubの中で決まった処理を自動で動かす仕組みです。Claude Code GitHub Actionsを入れると、IssueやプルリクエストのコメントでClaudeを呼び出せるようになります。

たとえば「@claude このIssueの内容をもとに機能を実装して」とコメントすると、Claudeがコードを調べ、変更を作り、結果をコメントで知らせます。公式ドキュメントには、次の例が載っています。

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component

設定の手順

設定には、リポジトリの管理者権限が必要です。方法は2通りあります。

/install-github-appが使えるのは、github.comのリポジトリだけです。GitLabやBitbucketでは使えません。また、先にGitHub CLI（gh）を入れてgh auth loginでログインしておく必要があります。

認証に使う情報

ワークフローがClaudeを動かすために、次のどちらかをリポジトリの「シークレット」に登録します。

複数のリポジトリで共有するなら、公式ドキュメントはAPIキーを勧めています。OAuthトークンは、コマンドを実行した個人の契約に紐づくためです。

費用の考え方

1回の実行で、2種類の費用がかかります。ひとつはGitHubの実行環境を使うことで消費する「GitHub Actionsの分数」、もうひとつは「APIのトークン」（プロンプトと回答の長さ、作業の複雑さ、コードの量で変わる）です。OAuthトークンを使う場合は、APIの課金ではなく契約プランの利用枠を使います。

公式ドキュメントでは、費用を抑える方法として、次の点が挙げられています。

• 「@claude」への依頼を具体的に書く
• Issueのテンプレートで、必要な情報を最初にそろえる
• CLAUDE.md（プロジェクトのルールを書くファイル）を簡潔にする。Claudeは毎回これを読む
• --max-turnsで作業の往復回数に上限を付ける
• ワークフローにタイムアウトを設定し、同時実行を制限する

誰が呼び出せるか

公式ドキュメントによると、Claudeを起動できるのは、リポジトリへの書き込み権限を持つユーザーに限られます。また、ボットからの起動は、許可リスト（allowed_bots）に入れない限り拒否されます。ループを防ぐための仕組みです。

Code Reviewでプルリクエストを自動レビューする

Code Reviewは、GitHubのプルリクエストを、Anthropicのクラウド上で複数のエージェントが分担して調べ、問題のある行にコメントを付ける機能です。自分でワークフローを書く必要はありません。

使えるプランと、課金のされ方

公式ドキュメントでは、Code ReviewはTeamとEnterprise向けの研究プレビュー（試験的な提供）とされています。Zero Data Retention（データを保持しない契約）やHIPAAの設定を使っている組織では使えません。ほかのプランでは、手元で/code-reviewコマンドを使って差分を確認できます。

料金は、使ったトークンに応じた従量課金です。公式ドキュメントによると、1回のレビューの平均は15〜25ドルで、プルリクエストの大きさやコードの複雑さによって変わります。この費用は、プランに含まれる利用量とは別に「追加の使用量（usage credits）」から請求されます。

設定の手順（組織のオーナー）

1. 管理画面を開くclaude.ai/admin-settings/claude-codeで、Code Reviewの項目を探します。Claude組織のオーナー権限と、GitHub組織にアプリを入れる権限が必要です。
2. Claude GitHub Appを入れる「Setup」を押し、レビューしたいリポジトリを持つGitHub組織を選んでアプリを導入します。
3. 対象のリポジトリを選ぶCode Reviewを有効にするリポジトリを選びます。あとから追加もできます。
4. レビューのタイミングを決めるリポジトリごとに「Review Behavior」を選びます。

Manualでは、プルリクエストに@claude reviewとコメントすると1回だけレビューが始まります。@claude review alwaysとすると、以降のプッシュでもレビューされます。月の支出に上限を設定することもできます。

指摘の見方と、ルールの伝え方

指摘には、重要度のマークが付きます。🔴は「マージ前に直すべき不具合」、🟡は「軽い指摘」、🟣は「このプルリクエストより前からある不具合」です。なお、Code Reviewのチェックは常に「中立」で完了し、マージを止めることはありません。

レビューの観点は、リポジトリに置くCLAUDE.mdとREVIEW.mdで調整できます。REVIEW.mdはレビュー専用の指示を書くファイルで、重要度の基準、指摘の数の上限、見なくてよいファイルなどを自由に書けます。

安全に使うための権限と設定

GitHubとつなぐということは、Claudeにリポジトリを読み書きできる権限を渡すということです。導入前に、次の点を確認しておきましょう。

Claude GitHub Appの権限

公式ドキュメントによると、Claude GitHub Appは、GitHubと連携するClaudeのすべての機能（GitHub Actions、Code Review、クラウドのAuto-fixなど）で共通です。そのため、導入時に次の権限をまとめて許可します。

GitHubは、権限の一部だけを選んで許可する形をとれません。GitHub Actionsだけを使いたく、権限を最小限にしたい場合は、Contents・Issues・Pull requestsだけを持つ自社専用のGitHub Appを作る方法が案内されています。ただし、その場合はCode Reviewとクラウドのauto-fixは使えません。

導入時の確認事項

クラウドの接続を外すとき

クラウドセッションのGitHub接続は、claude.ai/customize/connectorsで解除できます。解除すると、ブラウザで接続した場合も/web-setupで接続した場合も、クラウドからGitHubを使えなくなります。手元のghのログインは、そのまま残ります。トークン自体を無効にするには、GitHub側で取り消す必要があります。

社内で使うときは、どのリポジトリを連携してよいか、誰が管理者になるか、費用の上限をいくらにするかを先に決めておくと、あとで困りにくくなります。

よくある質問

まとめ

連携は、読ませるだけの段階から始め、効果を確かめながら範囲を広げるのが安全です。社内のGitHubとつなぐ場合は、権限の範囲や費用の上限、プルリクエストの確認の流れを先に決めておくと、安心して続けられます。

INTERCREATE JAPANでは、Claude CodeやGitHubとの連携を、社内で使い続けられる形で導入するところまでお手伝いしています。