> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code GitHub Actions Verwendung Anleitung

> Claude Code 集成指南 - Ace Data Cloud

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](https://platform.acedata.cloud/documents/claude-messages) gehen und auf die Schaltfläche „Acquire“ klicken, um die benötigten Anmeldeinformationen zu erhalten:

![](https://cdn.acedata.cloud/nyq0xz.png)

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](https://github.com/apps/claude) und installiere die Claude GitHub App in deinem Repository.

![GitHub Claude App Installationsseite](https://cdn.acedata.cloud/ba4b8df66d.png)

Diese App benötigt die folgenden Repository-Berechtigungen:

| Berechtigung      | Ebene             | Beschreibung                        |
| ----------------- | ----------------- | ----------------------------------- |
| **Inhalte**       | Lesen & Schreiben | Ändern von Repository-Dateien       |
| **Issues**        | Lesen & Schreiben | Auf Issues reagieren                |
| **Pull Requests** | Lesen & Schreiben | PRs 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 **Settings** → **Secrets and variables** → **Actions** 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](https://platform.acedata.cloud/console) eingesehen werden.

### Schritt 3: Workflow-Datei erstellen

Erstelle die Datei `.github/workflows/claude.yml` im Repository:

```yaml theme={null}
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:

```yaml theme={null}
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:

```yaml theme={null}
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:

```yaml theme={null}
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

| Parameter           | Beschreibung                                           | Erforderlich |
| ------------------- | ------------------------------------------------------ | ------------ |
| `anthropic_api_key` | API-Schlüssel                                          | Ja           |
| `prompt`            | Anweisung an Claude (Text oder Skill wie `/review`)    | Nein         |
| `claude_args`       | Parameter, die an die Claude Code CLI übergeben werden | Nein         |
| `github_token`      | GitHub-Token                                           | Nein         |
| `trigger_phrase`    | Benutzerdefinierte Auslösesätze (Standard `@claude`)   | Nein         |

### Häufig verwendete Parameter für claude\_args

```yaml theme={null}
claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
```

| Parameter         | Beschreibung                               |
| ----------------- | ------------------------------------------ |
| `--max-turns`     | Maximale Dialogrunden (Standard 10)        |
| `--model`         | Verwendetes Modell                         |
| `--mcp-config`    | Pfad zur MCP-Konfigurationsdatei           |
| `--allowed-tools` | Erlaubte Werkzeuge (durch Kommas getrennt) |
| `--debug`         | Debug-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](https://platform.acedata.cloud/console) an, um das aktuelle Kontingent und die Nutzung Ihres Kontos einzusehen.

## Mehr erfahren

* 📖 [Claude Code GitHub Actions offizielle Dokumentation](https://code.claude.com/docs/en/github-actions)
* 📂 [claude-code-action Repository](https://github.com/anthropics/claude-code-action)
* 📋 [Workflow-Beispiele](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [AceData Cloud Claude Code-Dienst](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Bei Fragen wenden Sie sich bitte über den Kundenservice der Plattform an uns.