Installation

Erfahren Sie, wie Sie Claude Code Action in Ihrem Repository installieren und einrichten.

Voraussetzungen

Bevor Sie Claude Code Action installieren, stellen Sie sicher, dass Sie Folgendes haben:

  • Ein GitHub-Repository
  • Repository-Administratorberechtigungen
  • Zugriff auf Claude Code CLI
  • Einen Anthropic API-Schlüssel oder Claude Code OAuth-Token

Schnellinstallation (Empfohlen)

Der schnellste Weg, Claude Code Action zu installieren, ist die Verwendung der Claude Code CLI:

1. Claude Code öffnen

claude

2. Installationsbefehl ausführen

/install-github-app

Dieser Befehl führt Sie durch:

  • Installation der Claude GitHub App
  • Einrichtung der erforderlichen Secrets
  • Konfiguration Ihrer Workflow-Datei

Manuelle Installation

Wenn Sie es vorziehen, manuell einzurichten oder mehr Kontrolle benötigen:

1. Claude GitHub App installieren

Besuchen Sie https://github.com/apps/claude und installieren Sie die App in Ihrem Repository.

2. Authentifizierung einrichten

Fügen Sie eines der folgenden Secrets zu Ihrem Repository hinzu:

Option A: Anthropic API-Schlüssel (Empfohlen)

  1. Gehen Sie zu Ihren Repository-Einstellungen
  2. Navigieren Sie zu Secrets and variables → Actions
  3. Klicken Sie auf New repository secret
  4. Name: ANTHROPIC_API_KEY
  5. Wert: Ihr Anthropic API-Schlüssel

Option B: Claude Code OAuth-Token

  1. Gehen Sie zu Ihren Repository-Einstellungen
  2. Navigieren Sie zu Secrets and variables → Actions
  3. Klicken Sie auf New repository secret
  4. Name: CLAUDE_CODE_OAUTH_TOKEN
  5. Wert: Ihr OAuth-Token

3. Workflow-Datei erstellen

Erstellen Sie .github/workflows/claude.yml in Ihrem Repository:

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 }}
          # Oder OAuth-Token verwenden:
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

4. Committen und Pushen

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

Alternative Authentifizierungsmethoden

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

Benutzerdefinierte GitHub App-Einrichtung (Erweitert)

Für Organisationen, die eine benutzerdefinierte GitHub App benötigen:

1. GitHub App erstellen

  1. Gehen Sie zu GitHub-Einstellungen → Developer settings → GitHub Apps
  2. Klicken Sie auf New GitHub App
  3. Konfigurieren Sie Mindestberechtigungen:
    • Contents: Read & Write
    • Issues: Read & Write
    • Pull requests: Read & Write

2. Private Key generieren

  1. In Ihren GitHub App-Einstellungen
  2. Scrollen Sie zu Private keys
  3. Klicken Sie auf Generate a private key
  4. Laden Sie die .pem-Datei herunter und sichern Sie sie

3. App im Repository installieren

  1. Gehen Sie zu Ihren GitHub App-Einstellungen
  2. Klicken Sie auf Install App
  3. Wählen Sie Ziel-Repositories aus

4. Secrets hinzufügen

Fügen Sie diese Secrets zu Ihrem Repository hinzu:

  • APP_ID: Ihre GitHub App-ID
  • APP_PRIVATE_KEY: Inhalt der .pem-Datei

5. Workflow aktualisieren

- 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 }}

Überprüfung

Nach der Installation testen Sie die Action, indem Sie:

  1. Ein neues Issue oder Pull Request erstellen
  2. Das Label claude hinzufügen (bei labelbasierten Triggern)
  3. Den Actions-Tab auf Workflow-Läufe überprüfen

Sicherheits-Best-Practices

  • Committen Sie niemals API-Schlüssel direkt in Ihr Repository
  • Verwenden Sie GitHub Actions Secrets für alle sensiblen Werte
  • Rotieren Sie API-Schlüssel und Tokens regelmäßig
  • Vermeiden Sie das Protokollieren sensibler Variablen in Workflow-Ausgaben
  • Überprüfen Sie GitHub App-Berechtigungen regelmäßig

Fehlerbehebung

Action wird nicht ausgelöst

  • Überprüfen Sie, ob die Workflow-Datei in .github/workflows/ liegt
  • Prüfen Sie, ob erforderliche Secrets gesetzt sind
  • Stellen Sie sicher, dass die GitHub App im Repository installiert ist
  • Überprüfen Sie Workflow-Triggerbedingungen

Authentifizierungsfehler

  • Bestätigen Sie, dass der API-Schlüssel gültig und aktiv ist
  • Prüfen Sie, ob die Secret-Namen mit der Workflow-Konfiguration übereinstimmen
  • Überprüfen Sie, ob die GitHub App die erforderlichen Berechtigungen hat

Berechtigungsfehler

  • Stellen Sie sicher, dass der Workflow die Berechtigung contents: write hat
  • Überprüfen Sie, ob die GitHub App den erforderlichen Repository-Zugriff hat
  • Prüfen Sie Beschränkungen auf Organisationsebene

Nächste Schritte