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の活用パターン

Issueからの自動コード修正

バグ報告Issueからの修正フロー

1. Issueを確認

> Issue #123の内容を確認して

2. 関連コードを探す

> このバグに関連するコードを探して

3. 修正を実装

> このバグを修正して、テストも追加して

4. PRを作成

> この修正をIssue #123にリンクしたPRとして作成して

機能リクエストIssueからの実装フロー

1. 要件を確認

> Issue #456の機能要件を整理して

2. 実装計画を立てる

> この機能の実装計画を作成して

3. 実装

> 計画に従って実装して

4. 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

解決策:

1. Gitリポジトリ内で実行しているか確認
2. gh auth statusで認証状態を確認
3. リポジトリへのアクセス権限を確認

@claudeに反応しない

症状: Issueで@claudeとメンションしても反応がない

解決策:

1. GitHub Appがインストールされているか確認
2. .github/workflows/claude.ymlが存在するか確認
3. ActionsタブでWorkflowが実行されているか確認

まとめ

Claude CodeでGitHub Issueを操作すれば：

• Issue管理の効率化: 自然言語でIssue操作
• バグ修正の自動化: Issueから直接コード修正
• チーム連携の向上: @claudeメンションで即座に対応

日常的なIssue管理をAIに任せて、開発に集中しましょう。

参考リンク

• Claude Code GitHub連携ガイド
• GitHub CLI Issue コマンド
• Claude Code MCP設定ガイド