インストール

前提条件

Claude Code Actionをインストールする前に、以下を確認してください：

GitHubリポジトリ
リポジトリ管理者権限
Claude Code CLIへのアクセス
Anthropic APIキーまたはClaude Code OAuthトークン

クイックインストール（推奨）

Claude Code Actionをインストールする最速の方法は、Claude Code CLIを使用することです：

1. Claude Codeを開く

claude

2. インストールコマンドを実行

/install-github-app

このコマンドは以下をガイドします：

Claude GitHub Appのインストール
必要なシークレットの設定
ワークフローファイルの設定

手動インストール

手動でセットアップする場合、またはより詳細な制御が必要な場合：

1. Claude GitHub Appをインストール

https://github.com/apps/claudeにアクセスして、リポジトリにアプリをインストールします。

2. 認証を設定

リポジトリに以下のシークレットのいずれかを追加します：

オプションA: Anthropic APIキー（推奨）

リポジトリの設定に移動
Secrets and variables → Actionsに移動
New repository secretをクリック
名前：ANTHROPIC_API_KEY
値：あなたのAnthropic APIキー

オプションB: Claude Code OAuthトークン

リポジトリの設定に移動
Secrets and variables → Actionsに移動
New repository secretをクリック
名前：CLAUDE_CODE_OAUTH_TOKEN
値：あなたのOAuthトークン

3. ワークフローファイルを作成

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

name: Claude Code Action

on:
  issues:
    types: [opened, labeled]
  pull_request:
    types: [opened, labeled, synchronize]
  issue_comment:
    types: [created]

permissions:
  contents: write
  issues: write
  pull-requests: write

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # または、OAuthトークンを使用：
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

4. コミットしてプッシュ

git add .github/workflows/claude.yml
git commit -m "Add Claude Code Action workflow"
git push

代替認証方法

Amazon Bedrock

- uses: anthropics/claude-code-action@v1
  with:
    aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }}
    aws_secret_access_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    aws_region: us-east-1

Google Vertex AI

- uses: anthropics/claude-code-action@v1
  with:
    gcp_project_id: ${{ secrets.GCP_PROJECT_ID }}
    gcp_service_account_key: ${{ secrets.GCP_SERVICE_ACCOUNT_KEY }}
    gcp_region: us-central1

カスタムGitHub Appのセットアップ（上級）

カスタムGitHub Appが必要な組織の場合：

1. GitHub Appを作成

GitHub設定 → Developer settings → GitHub Appsに移動
New GitHub Appをクリック
最小限の権限を設定：
- Contents: Read & Write
- Issues: Read & Write
- Pull requests: Read & Write

2. プライベートキーを生成

GitHub Appの設定で
Private keysまでスクロール
Generate a private keyをクリック
.pemファイルをダウンロードして保護

3. リポジトリにAppをインストール

GitHub Appの設定に移動
Install Appをクリック
対象リポジトリを選択

4. シークレットを追加

リポジトリに以下のシークレットを追加：

APP_ID: あなたのGitHub App ID
APP_PRIVATE_KEY: .pemファイルの内容

5. ワークフローを更新

- uses: anthropics/claude-code-action@v1
  with:
    github_app_id: ${{ secrets.APP_ID }}
    github_app_private_key: ${{ secrets.APP_PRIVATE_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

検証

インストール後、以下でアクションをテストします：

新しいイシューまたはプルリクエストを作成
claudeラベルを追加（ラベルベースのトリガーを使用している場合）
Actionsタブでワークフロー実行を確認

セキュリティベストプラクティス

APIキーをリポジトリに直接コミットしない
すべての機密情報にGitHub Actionsシークレットを使用
APIキーとトークンを定期的にローテーション
ワークフロー出力で機密変数をログに記録しない
GitHub Appの権限を定期的に確認