Claude Codeはターミナルから操作するAIコーディングツールですが、GitHubと連携することで「コードを書く→コミット→プッシュ→PR作成」までをAIに任せることができます。
この記事では、Claude CodeとGitHubを連携する手順と、実際の活用方法を解説します。
事前準備
連携前に以下が揃っていることを確認してください。
- GitHubアカウント
- Claude Code（
npm install -g @anthropic-ai/claude-code） - Git（
git --versionで確認） - ローカルにクローン済みのリポジトリ、またはこれから作成するもの
Claude CodeはNode.js 18以上が必要です。node -v でバージョンを確認してください。
GitHub CLIのインストールと認証
Claude CodeはGitHub操作に GitHub CLI（gh）を活用します。まずインストールと認証を行います。
GitHub CLIのインストール
# macOS（Homebrew）
brew install gh
# Windows（winget）
winget install --id GitHub.cli
# Ubuntu / Debian
sudo apt install ghGitHubへのログイン
gh auth loginコマンドを実行すると対話形式でセットアップが進みます。
| 質問 | 選ぶもの |
|---|---|
| What account do you want to log into? | GitHub.com |
| What is your preferred protocol? | HTTPS（推奨） |
| How would you like to authenticate? | Login with a web browser |
ブラウザが開くので、表示されたワンタイムコードを入力して認証を完了します。
認証完了後は gh auth status で接続状態を確認できます。Logged in to github.com と表示されれば成功です。
Claude Codeを起動してGitHubを操作する
認証が済んだら、プロジェクトフォルダで Claude Code を起動します。
cd your-project
claudeあとはチャット形式で指示を出すだけです。以下に代表的な操作例を紹介します。
コミット＆プッシュ
変更内容をコミットしてmainブランチにプッシュしてくださいClaude Code が git diff で変更内容を確認し、適切なコミットメッセージを提案してからコミット・プッシュまで実行します。
プルリクエストの作成
今の変更でプルリクエストを作成してください。タイトルと説明文も考えてください内部で gh pr create コマンドを使い、変更内容を読み取ったうえで PR のタイトル・説明文を自動生成します。
Gitの基本操作をClaude Codeに任せる
Claude Codeは自然言語の指示をGitコマンドに変換して実行します。覚えておくと便利な指示パターンを紹介します。
| やりたいこと | Claude Codeへの指示例 |
|---|---|
| 現在の変更を確認 | 変更差分を見せてください |
| 新しいブランチを作成 | feature/login-formというブランチを作って切り替えてください |
| 特定のコミットに戻す | 1つ前のコミットに戻してください |
| コンフリクトの解消 | マージコンフリクトを解消してください |
| PRのレビュー確認 | PR #5 のレビューコメントを確認して修正してください |
| リリースノートの作成 | 前回タグからの変更をまとめてリリースノートを作ってください |
CLAUDE.mdでプロジェクトの設定を共有する
プロジェクトのルートに CLAUDE.md ファイルを置くと、Claude Codeが毎回読み込むプロジェクト固有の設定を記述できます。チームで使う場合は、このファイルをGitで管理すると全員が同じ設定で利用できます。
# CLAUDE.md の記述例
## プロジェクト概要
ECサイトのバックエンドAPI（Node.js + Express）
## コーディング規約
- インデント: スペース2つ
- コミットメッセージ: Conventional Commits 形式
- PRは必ずdevelopブランチに向けて作成する
## よく使うコマンド
- 開発サーバー起動: npm run dev
- テスト実行: npm test
- ビルド: npm run buildCLAUDE.md はGitHubにコミットしてチームで共有しましょう。新メンバーがClaude Codeを使い始めるときのオンボーディングにも役立ちます。
CLAUDE.md は毎回読み込まれるので、長くなるほど1回あたりのトークン消費が増えます。あれもこれもと書き足したくなりますが、プロジェクト固有で、かつ実際に守ってほしいルールに絞っておくのがおすすめです。
GitHub上で@claudeメンションを使う
ここまではローカルのターミナルからの操作でしたが、GitHub上のIssueやPRに @claude とメンションして作業を依頼することもできます。
Claude Codeで次のコマンドを実行すると、GitHub Appのインストールとワークフローの準備をまとめて行ってくれます。
/install-github-app事前に GitHub CLI のインストールと gh auth login が済んでいる必要があります。実行すると、Claude GitHub Appのインストール、認証情報のリポジトリシークレットへの登録、ワークフローファイルを含むプルリクエストの作成まで進みます。作成されたPRをマージすると、そのリポジトリで @claude が使えるようになります。
@claude このIssueの内容で機能を実装してください
@claude ユーザーダッシュボードのTypeErrorを直してくださいClaudeが同じIssueやPRにコメントを返し、作業の進行に合わせて更新していきます。セットアップにはリポジトリの管理者権限が必要です。
この仕組みはGitHub Actions上で動くため、実行時間ぶんのActions分数を消費します。またメンションできるのは、原則としてそのリポジトリへの書き込み権限を持つユーザーに限られます。
注意点
APIキーやパスワードなどは .gitignore や .env で管理し、絶対にコミットしないでください。AIに任せる場合ほど、コミット対象の確認は自分の目でも行う習慣をつけておくと安全です。
- 大きな変更は一度に任せず、小さな単位で確認しながら進めるのがおすすめ
- 本番ブランチへの直接プッシュを避けたい場合は、GitHub側でブランチ保護ルールを設定しておくと安心
ghコマンドの権限はリポジトリの操作に限定されるよう、OAuthスコープを確認しておく
権限モードを理解しておく
Claude Codeはツールの種類ごとに承認の要否が分かれています。既定の動作は次のとおりです。
| 操作の種類 | 例 | 承認 |
|---|---|---|
| 読み取り専用 | ファイル読み込み、検索 | 不要（作業ディレクトリ内） |
| Bashコマンド | git commit、git push など |
必要（一部の読み取り専用コマンドを除く） |
| ファイルの変更 | ファイルの編集・作成 | 必要 |
つまり、既定の状態ではコミットやプッシュの前に必ず確認が入ります。一方で、承認の求め方を変える権限モードがいくつか用意されており、自動承認寄りのモードを選ぶと確認なしで実行されます。
自動承認寄りのモード（acceptEdits、auto、bypassPermissions など）を使うと、コミットやプッシュが確認なしで実行されることがあります。特に bypassPermissions は確認をほぼ飛ばすため、本番リポジトリでの常用は避けてください。ブランチ保護ルールと併用すると、事故が起きても被害を抑えられます。
よくある質問
Claude Codeは確認なしでコミットやプッシュをしてしまいますか？
既定の設定では確認が入ります。Claude Codeはツールの種類ごとに承認の要否を分けており、git commit や git push のようなBashコマンドは実行前に承認を求める設定が既定です。ただし自動承認寄りの権限モードに切り替えている場合は確認なしで実行されるため、どのモードで動かしているかは把握しておいてください。
GitHub CLI（gh）は必ず必要ですか？
プルリクエストの作成やIssueの操作など、Gitコマンドだけでは完結しないGitHub側の操作に使われます。コミットやプッシュだけであればGitがあれば動きますが、/install-github-app によるGitHub Actions連携の設定にも必要になるため、入れておくことをおすすめします。
CLAUDE.mdはどこに置けばいいですか？
プロジェクトのルートに置きます。Gitで管理してチームに共有すれば、全員が同じ前提でClaude Codeを使えます。なお毎回読み込まれるため、内容が長くなるほどトークン消費が増える点は意識しておいてください。
ターミナルを開かずにGitHub上だけで使えますか？
使えます。/install-github-app でGitHub Actions連携を設定すると、IssueやPRのコメントで @claude とメンションするだけで作業を依頼できるようになります。ただし初回のセットアップにはローカルのClaude Codeとリポジトリの管理者権限が必要です。
まとめ
Claude CodeとGitHubの連携に必要な手順をまとめます。
| 手順 | 内容 |
|---|---|
| ① | GitHub CLI（gh）をインストール |
| ② | gh auth login でGitHub認証 |
| ③ | プロジェクトフォルダで claude を起動 |
| ④ | 自然言語でコミット・PR・イシュー対応を指示 |
| ⑤ | CLAUDE.md でプロジェクト設定を共有 |
| ⑥ | 必要なら /install-github-app で @claude を有効化 |
一度設定してしまえば、あとは日本語で指示するだけで GitHub の操作が完結します。コードを書く作業と並行してバージョン管理もAIに任せることで、開発のスピードが大きく上がります。ぜひ試してみてください。
