Zum Hauptinhalt springen
Claude Code ist ein von Anthropic entwickeltes Agentic Coding Tool, das auch als einer der stärksten Programmier-Agenten der Welt bezeichnet wird. Claude Code GitHub Actions kann die KI-Programmierfähigkeiten in deinen GitHub-Workflow integrieren. Du musst nur in PR oder Issue @claude verwenden, um Claude automatisch den Code analysieren, PRs erstellen, Funktionen implementieren und Bugs beheben zu lassen. Dieses Dokument beschreibt hauptsächlich, wie man über den Proxy-Service von AceData Cloud Claude Code GitHub Actions konfiguriert und verwendet.

Antragsprozess

Um Claude Code zu verwenden, kannst du zunächst zur Claude Messages Service-Seite gehen und auf die Schaltfläche „Acquire“ klicken, um die benötigten Anmeldeinformationen zu erhalten: Wenn du noch nicht angemeldet oder registriert bist, wirst du automatisch zur Anmeldeseite weitergeleitet, um dich zu registrieren und anzumelden. Nach der Anmeldung wirst du automatisch zur aktuellen Seite zurückgeleitet. Bei der ersten Antragstellung gibt es ein kostenloses Kontingent, mit dem du die Claude Code-Dienste kostenlos ausprobieren kannst.

Funktionen

  • Sofortige Erstellung von PRs: Beschreibe die Anforderungen, Claude erstellt automatisch einen vollständigen Pull Request.
  • Automatische Implementierung von Code: Verwende @claude in einem Issue, um das Issue in ausführbaren Code umzuwandeln.
  • Einhaltung der Projektstandards: Liest automatisch CLAUDE.md und hält sich an deinen Code-Stil und die Projektstandards.
  • Sicher und zuverlässig: Der Code wird auf dem GitHub Runner ausgeführt, die Datensicherheit ist gewährleistet.

Konfigurationsschritte

Schritt 1: Claude GitHub App installieren

Gehe zu https://github.com/apps/claude und installiere die Claude GitHub App in deinem Repository. GitHub Claude App Installationsseite Diese App benötigt die folgenden Repository-Berechtigungen:
BerechtigungEbeneBeschreibung
InhalteLesen & SchreibenÄndern von Repository-Dateien
IssuesLesen & SchreibenAuf Issues reagieren
Pull RequestsLesen & SchreibenPRs erstellen und Änderungen pushen

Schritt 2: API-Schlüssel hinzufügen

Füge den API-Schlüssel von AceData Cloud als Repository-Secret hinzu:
  1. Gehe zu SettingsSecrets and variablesActions im Repository.
  2. Klicke auf New repository secret.
  3. Gib bei Name ANTHROPIC_API_KEY ein und füge den API-Token ein, den du bei AceData Cloud erhalten hast.
  4. Klicke auf Add secret, um zu speichern.
Hinweis: Der API-Token kann im AceData Cloud Dashboard eingesehen werden.

Schritt 3: Workflow-Datei erstellen

Erstelle die Datei .github/workflows/claude.yml im Repository:
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
Wenn du den Proxy-API-Endpunkt von AceData Cloud verwenden möchtest, musst du auch Umgebungsvariablen im Workflow festlegen:
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Verwendung

Verwendung in Issue oder PR-Kommentaren

Nach der Konfiguration kannst du in jedem Kommentar zu einem Issue oder PR @claude verwenden, und Claude wird automatisch antworten:
@claude Implementiere die Funktion basierend auf der Beschreibung dieses Issues.
@claude Überprüfe die Sicherheit des Codes in diesem PR.
@claude Behebe den TypeError im User-Dashboard-Komponenten.
@claude Wie sollte die Benutzerauthentifizierung für diesen Endpunkt implementiert werden?

Automatische Codeüberprüfung

Erstelle einen Workflow, der automatisch eine Codeüberprüfung durchführt, wenn ein PR geöffnet wird:
name: Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Zeitgesteuerte Automatisierung

Erstelle eine automatisierte Aufgabe, die regelmäßig ausgeführt wird:
name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Erstelle eine Zusammenfassung der Commits von gestern und einen Bericht über offene Issues."
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Action-Parameterbeschreibung

ParameterBeschreibungErforderlich
anthropic_api_keyAPI-SchlüsselJa
promptAnweisung an Claude (Text oder Skill wie /review)Nein
claude_argsParameter, die an die Claude Code CLI übergeben werdenNein
github_tokenGitHub-TokenNein
trigger_phraseBenutzerdefinierte Auslösesätze (Standard @claude)Nein

Häufig verwendete Parameter für claude_args

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
ParameterBeschreibung
--max-turnsMaximale Dialogrunden (Standard 10)
--modelVerwendetes Modell
--mcp-configPfad zur MCP-Konfigurationsdatei
--allowed-toolsErlaubte Werkzeuge (durch Kommas getrennt)
--debugDebug-Ausgabe aktivieren

Beste Praktiken

Konfiguration von CLAUDE.md

Erstelle eine CLAUDE.md-Datei im Stammverzeichnis des Repositories, um Richtlinien für den Code-Stil, Überprüfungsstandards und Projektstandards festzulegen. Claude wird diese Regeln automatisch befolgen.

Sicherheitsvorkehrungen

  • Schreibe niemals den API-Schlüssel direkt in die Workflow-Datei.
  • Verwende immer GitHub Secrets (z. B. ${{ secrets.ANTHROPIC_API_KEY }}).
  • Beschränke die Berechtigungen der Action auf das notwendige Minimum.
  • Überprüfe die Vorschläge von Claude manuell, bevor du sie zusammenführst.

Kostenkontrolle

  • Verwende klare @claude-Anweisungen, um unnötige API-Aufrufe zu reduzieren.
  • Setze angemessene --max-turns-Grenzen für die Dialogrunden.
  • Lege Zeitlimits auf Workflow-Ebene fest.
  • Verwende die Parallelitätskontrolle von GitHub, um die Anzahl der gleichzeitigen Ausführungen zu begrenzen.

Häufig gestellte Fragen

Claude reagiert nicht auf den @claude-Befehl?

  1. Stelle sicher, dass die Claude GitHub App korrekt installiert ist.
  2. Überprüfe, ob der Workflow aktiviert ist.
  3. Stelle sicher, dass der API-Schlüssel als Repository-Secret festgelegt ist.
  4. Stelle sicher, dass im Kommentar @claude verwendet wird (nicht /claude).

Authentifizierungsfehler?

  1. Bestätigen Sie, dass der API-Schlüssel gültig ist und über ausreichende Berechtigungen verfügt.
  2. Überprüfen Sie, ob der Secret-Name korrekt ist (ANTHROPIC_API_KEY).
  3. Wenn ANTHROPIC_BASE_URL verwendet wird, bestätigen Sie, dass die URL korrekt ist.

Wie kann ich das verbleibende Kontingent einsehen?

Melden Sie sich bei der AceData Cloud-Konsole an, um das aktuelle Kontingent und die Nutzung Ihres Kontos einzusehen.

Mehr erfahren