Claude Code GitHub Actionsの公式導入手順

【結論】解決策 / 実行コマンド

GitHub ActionsへClaude Codeを組み込む場合は、CLIを手動インストールするよりAnthropic公式のanthropics/claude-code-actionを利用する方法が標準です。

ローカルのClaude Codeで/install-github-appを実行すると、GitHub App、ワークフロー、シークレット設定を対話的に導入できます。

# ターミナルで実行：対象リポジトリでClaude Codeを起動
cd ~/projects/my-repo && claude
# 起動後のセッション内で実行：公式GitHub連携をセットアップ
/install-github-app

具体的な手順・設定方法

1. GitHub Appに対象リポジトリへの必要最小限の権限だけを許可します。

2. リポジトリまたはOrganizationのSecretsへAnthropic APIキーを登録します。

3. 最初は読み取り中心のPRレビューから始め、書き込み権限は必要になってから追加します。

実践プロンプト / 活用テクニック

# .github/workflows/claude.yml に記載
name: Claude
on:
  issue_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
      issues: write
      id-token: write
    steps:
      # 公式Actionを実行
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

注意点・よくあるエラーと対処法

プロンプトに「確認不要」と書くだけではヘッドレス実行の権限設計になりません。

fork由来PRではSecretsが渡らないなど、GitHubのセキュリティ仕様を考慮してください。

AIに自動コミットさせる前に、対象パス、許可コマンド、最大実行時間、レビュー条件を限定してください。