Claude Code GitHub Issue活用術
Claude CodeとGitHubを連携すれば、Issue管理をAIに任せることができます。Issueの作成、対応、クローズまで、開発ワークフローを大幅に効率化しましょう。
この記事では、Claude CodeでGitHub Issueを操作する具体的な方法を解説します。
Claude CodeでできるIssue操作
Claude Codeを使えば、以下のIssue操作が可能です。
基本操作
- Issue一覧の取得: オープン/クローズ状態でフィルタリング
- Issue作成: タイトル、本文、ラベル、担当者を指定
- Issue更新: 内容の編集、ステータス変更
- コメント追加: Issueへのコメント投稿
- Issue検索: キーワードやラベルで検索
高度な操作
- Issueからコード修正: バグ報告を読み取り、修正コードを提案
- PR自動作成: Issueに対応するPRを自動生成
- 関連Issue検索: 類似したIssueを検索
前提条件
Claude CodeでGitHub Issueを操作するには、以下の準備が必要です。
1. GitHub CLIのセットアップ
# GitHub CLIのインストール（macOS）
brew install gh
# ログイン
gh auth login
2. GitHub連携の有効化
Claude Code内で以下のコマンドを実行：
/install-github-app
詳細はClaude Code GitHub連携ガイドを参照してください。
Issue操作の実践例
例1: Issue一覧を確認する
コマンド:
> このリポジトリのオープンなIssueを一覧表示して
結果: Claude Codeがgh issue listを実行し、Issue一覧を表示します。
例2: 新しいIssueを作成する
コマンド:
> 新しいIssueを作成して
タイトル: ログイン画面のバグ修正
本文: ログインボタンをクリックしても反応しない問題が発生しています。
ラベル: bug, priority-high
結果: Claude Codeが以下のコマンドを実行：
gh issue create --title "ログイン画面のバグ修正" --body "ログインボタンをクリックしても反応しない問題が発生しています。" --label "bug,priority-high"
例3: Issueの内容を確認する
コマンド:
> Issue #42の内容を確認して
結果: Claude Codeがgh issue view 42を実行し、Issueの詳細を表示します。
例4: Issueにコメントを追加する
コマンド:
> Issue #42に「調査を開始しました」とコメントして
結果:
gh issue comment 42 --body "調査を開始しました"
例5: Issueをクローズする
コマンド:
> Issue #42を「修正完了」のコメント付きでクローズして
結果:
gh issue close 42 --comment "修正完了"
@claudeメンションでIssue対応
GitHub Appを連携していれば、Issue内で@claudeとメンションするだけでAIが応答します。
Issue内でのメンション例
Issueコメント:
@claude このバグの原因を調査して、修正方法を提案してください。
Claudeの応答:
- コードベースを分析
- バグの原因を特定
- 修正コードを提案
- 必要に応じてPRを作成
@claudeの活用パターン
メンション内容 | Claudeの動作 |
|---|---|
| コード修正とPR作成 |
| コードベース分析と原因特定 |
| 実装案の提示 |
| 関連ファイルの検索 |
Issueからの自動コード修正
バグ報告Issueからの修正フロー
- Issueを確認
> Issue #123の内容を確認して
- 関連コードを探す
> このバグに関連するコードを探して
- 修正を実装
> このバグを修正して、テストも追加して
- PRを作成
> この修正をIssue #123にリンクしたPRとして作成して
機能リクエストIssueからの実装フロー
- 要件を確認
> Issue #456の機能要件を整理して
- 実装計画を立てる
> この機能の実装計画を作成して
- 実装
> 計画に従って実装して
- PRを作成
> この実装をIssue #456にリンクしたPRとして作成して
Issue管理のベストプラクティス
1. ラベルを活用する
> 優先度「high」のラベルが付いたIssueを一覧表示して
2. マイルストーンで管理
> v1.0マイルストーンのIssue進捗を確認して
3. 担当者を割り当て
> Issue #42の担当者を@usernameに設定して
4. テンプレートを活用
Issueテンプレートを用意しておくと、Claude Codeがより正確にIssueを作成できます。
トラブルシューティング
Issue操作ができない
症状:
Error: Could not resolve to a Repository
解決策:
- Gitリポジトリ内で実行しているか確認
gh auth statusで認証状態を確認- リポジトリへのアクセス権限を確認
@claudeに反応しない
症状: Issueで@claudeとメンションしても反応がない
解決策:
- GitHub Appがインストールされているか確認
.github/workflows/claude.ymlが存在するか確認- ActionsタブでWorkflowが実行されているか確認
まとめ
Claude CodeでGitHub Issueを操作すれば：
- Issue管理の効率化: 自然言語でIssue操作
- バグ修正の自動化: Issueから直接コード修正
- チーム連携の向上: @claudeメンションで即座に対応
日常的なIssue管理をAIに任せて、開発に集中しましょう。