Claude Code GitHub連携完全ガイド｜install-github-appでAI開発環境を構築

Claude CodeとGitHubを連携させることで、AI駆動の開発環境を構築できます。リポジトリ操作、Issue管理、PRの作成・レビューまで、開発ワークフロー全体をAIがサポートします。

この記事では、/install-github-appコマンドを使った簡単セットアップから、手動設定、トラブルシューティングまで詳しく解説します。

GitHub連携でできること

Claude CodeとGitHubを連携すると、以下のことが可能になります。

リポジトリ操作の効率化

• コミット・プッシュの自動化: 変更内容を説明するだけで適切なコミットメッセージを生成
• ブランチ管理: 機能ブランチの作成からマージまでをサポート
• 差分確認: 変更内容の確認と説明

Issue/PR連携

• Issue対応: Issueの内容を理解し、修正コードを提案
• PR作成: 実装内容を説明するだけで完全なPRを作成
• PR説明文の自動生成: 変更内容を分析して説明文を作成

コードレビュー自動化

• レビューコメント: セキュリティ、パフォーマンス、コーディング規約の観点からレビュー
• 修正提案: 問題点の指摘と具体的な修正案の提示
• @claudeメンション: PRやIssueで@claudeと呼びかけるだけでAIが応答

前提条件

GitHub連携を始める前に、以下の環境を準備してください。

1. Node.js

Claude Codeの実行にはNode.js 18以上が必要です。

# バージョン確認
node --version
# v18.0.0以上であることを確認

2. Claude Codeのインストール

# npmでグローバルインストール
npm install -g @anthropic-ai/claude-code

# インストール確認
claude --version

3. GitHub CLI (gh)のインストール

GitHub連携にはghコマンドが必須です。

macOS:

brew install gh

Windows:

winget install GitHub.cli

Linux (Ubuntu/Debian):

sudo apt install gh

4. GitHub CLIへのログイン

重要: この手順を忘れると連携に失敗します。

gh auth login

対話形式で以下を選択：

1. GitHub.comを選択
2. HTTPSを選択
3. Login with a web browserを選択
4. 表示されるコードをコピーし、ブラウザで認証

認証完了後、確認：

gh auth status
# ✓ Logged in to github.com account XXX

/install-github-appによるセットアップ（推奨）

最も簡単なセットアップ方法は、Claude Code内蔵のコマンドを使用することです。

手順

ステップ1: Claude Codeを起動

claude

ステップ2: インストールコマンドを実行

/install-github-app

ステップ3: リポジトリを選択

コマンド実行後、連携するリポジトリの一覧が表示されます。矢印キーで選択してEnterを押します。

ステップ4: ブラウザでGitHub Appをインストール

自動的にブラウザが開き、Claude GitHub Appのインストール画面が表示されます。

1. インストール先のアカウント/組織を選択
2. アクセスするリポジトリを選択（「All repositories」または特定のリポジトリ）
3. 「Install」をクリック

ステップ5: APIキーの設定

ターミナルに戻り、Enterを押すと以下のオプションが表示されます：

• 現在のAPIキーを使用: Claude Codeで使用中のAPIキーをそのまま使用
• 新しいAPIキーを作成: 別のAPIキーを設定

選択後、自動的にGitHubのSecretsにANTHROPIC_API_KEYが設定されます。

ステップ6: PRが自動作成される

.github/workflows/claude.ymlが追加されたPRが自動作成されます。このPRをマージして設定完了です。

手動セットアップ

/install-github-appコマンドが失敗する場合や、より詳細にコントロールしたい場合は手動でセットアップできます。

ステップ1: GitHub Appのインストール

1. https://github.com/apps/claudeにアクセス
2. 「Install」をクリック
3. インストール先のアカウント/組織を選択
4. リポジトリの選択（「All repositories」または特定のリポジトリ）
5. 「Install」をクリック

ステップ2: APIキーをGitHub Secretsに追加

Anthropic API（従量課金）の場合:

1. GitHubでリポジトリを開く
2. 「Settings」→「Secrets and variables」→「Actions」
3. 「New repository secret」をクリック
4. 設定値：
   1. Name: ANTHROPIC_API_KEY
   2. Value: Anthropic Consoleで取得したAPIキー

Max Subscription（定額）の場合:

まず、Claude Codeでトークンを発行：

claude setup-token

表示されるURLをブラウザで開き、「承認する」をクリック。発行されたトークン（skで始まる文字列）をコピー。

GitHub Secretsに追加：

• Name: CLAUDE_CODE_OAUTH_TOKEN
• Value: 発行されたトークン

ステップ3: ワークフローファイルの作成

リポジトリに.github/workflows/claude.ymlを作成：

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude'))
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude Code
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # Max Subscriptionの場合は以下を使用
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

GitHub Appの権限と機能

Claude GitHub Appには以下の権限が付与されます。

注意: GitHub Appのインストールにはリポジトリの管理者権限が必要です。

GitHub連携の活用例

例1: コミットメッセージの自動生成

claude
> git add .
> この変更内容を説明して、適切なコミットメッセージを提案して

例2: PRの作成

claude
> この機能実装が完了しました。PRを作成してください。
> タイトルと説明文を日本語で書いてください。

例3: @claudeメンションでコードレビュー

GitHubのPRコメントで：

@claude このPRをレビューしてください。
特に以下の点を重点的にチェックしてください：
- セキュリティリスク
- パフォーマンスへの影響
- エラーハンドリング

例4: Issueからの自動修正

GitHubのIssueで：

@claude このバグを修正するPRを作成してください。

## 問題
ログイン時にエラーが発生する

## 再現手順
1. ログインページにアクセス
2. 認証情報を入力
3. 送信ボタンをクリック

トラブルシューティング

gh auth loginを忘れている

症状:

Error: gh: command not found
または
Error: You are not logged in to any GitHub hosts

解決策:

# GitHub CLIをインストール
brew install gh  # macOSの場合

# ログイン
gh auth login

# 確認
gh auth status

/install-github-appが失敗する

症状:

Error: Failed to install GitHub App

解決策:

1. gh auth statusを確認

gh auth status

• 再ログイン

gh auth logout
gh auth login

• 権限の確認
  • リポジトリの管理者権限があるか確認
  • 組織のリポジトリの場合、組織の管理者に相談

GitHub Appの権限エラー

症状:

Error: Resource not accessible by integration

解決策:

1. GitHub Apps設定にアクセス
2. 「Claude」を選択
3. 「Repository access」で対象リポジトリが含まれているか確認
4. 必要に応じてリポジトリを追加

APIキーのエラー

症状:

Error: Invalid API key

解決策:

1. GitHub Secretsの設定を確認
   1. リポジトリ →「Settings」→「Secrets and variables」→「Actions」
2. シークレット名が正しいか確認
   1. API従量課金: ANTHROPIC_API_KEY
   2. Max Subscription: CLAUDE_CODE_OAUTH_TOKEN
3. APIキーの有効性を確認

@claudeに反応しない

症状: PRやIssueで@claudeとコメントしても反応がない

解決策:

1. ワークフローファイルの確認
   1. .github/workflows/claude.ymlが存在するか
   2. 構文エラーがないか
2. Actionsの実行履歴を確認
   1. リポジトリ →「Actions」タブ
   2. ワークフローが実行されているか確認
3. トリガー条件の確認
   1. @claudeの前後にスペースがあるか
   2. /claudeではなく@claudeと記載しているか

GitHub Actionsとの組み合わせ

より高度な自動化（自動レビュー、CI/CD連携）については、Claude Code GitHub Actions完全ガイドで詳しく解説しています。

まとめ

Claude CodeとGitHubの連携により：

• 開発効率の向上: git操作、PR作成、レビューをAIがサポート
• ワークフローの自動化: @claudeメンションで即座にAIが応答
• コード品質の向上: AIによる一貫したコードレビュー

セットアップは/install-github-appコマンド1つで完了します。まだGitHub連携を設定していない方は、ぜひ試してみてください。

参考リンク

• Claude GitHub App
• Claude Code GitHub Actions 公式ドキュメント
• GitHub CLI 公式サイト
• Anthropic Console