---
title: Claude Code GitHub Actions | RunAPI
description: Claude Code GitHub Actions mit einem RunAPI-Secret, Modell, Berechtigungen,
  Auslösern und einem minimalen Workflow konfigurieren.
url: https://runapi.ai/de/docs/resources/tool-integrations/claude-code-github-actions.md
canonical: https://runapi.ai/de/docs/resources/tool-integrations/claude-code-github-actions
locale: de
---

> HTML-Version: https://runapi.ai/de/docs/resources/tool-integrations/claude-code-github-actions
> Website-Index für KI-Agenten: https://runapi.ai/llms.txt

# Claude Code GitHub Actions

## Übersicht

Die offizielle `anthropics/claude-code-action` führt Claude Code in einem
GitHub Actions-Workflow aus. Diese Anleitung speichert einen RunAPI-Schlüssel als GitHub
Secret, legt die nicht sensible Basis-URL in den Claude Code-Einstellungen fest, wählt
ein Modell aus und reagiert auf autorisierte `@claude`-Kommentare.

## Bevor Sie beginnen

* Sie benötigen Repository-Administratorzugriff, um die Claude GitHub-App zu installieren,
  Actions-Secrets zu erstellen und einen Workflow hinzuzufügen.
* Erstellen Sie einen Standard-RunAPI-API-Schlüssel gemäß der [Authentifizierungsanleitung](https://runapi.ai/de/docs/guides/authentication.md).
* Kopieren Sie eine Modellkennung, die Anthropic Messages unterstützt, aus dem
  [Modellkatalog](https://runapi.ai/de/models).
* Lesen Sie die [Claude Code GitHub Actions-Einrichtungsanleitung][1] sowie die
  Workflow-Richtlinie Ihrer Organisation.



[1]: https://code.claude.com/docs/en/github-actions

## Installieren

Führen Sie in Claude Code im Ziel-Repository `/install-github-app` aus und folgen Sie den Anweisungen, um die GitHub-App zu installieren. Wenn die Option angeboten wird, eine Anthropic-Berechtigung zu erstellen, stoppen Sie, bevor Sie diese speichern: Diese Anleitung verwendet stattdessen ein RunAPI-Repository- oder Organisationsgeheimnis.

Für die manuelle Einrichtung installieren Sie die [Claude GitHub App][1] und fügen Sie dann den folgenden Workflow zu `.github/workflows/claude.yml` hinzu.



[1]: https://github.com/apps/claude

## RunAPI konfigurieren

Erstellen Sie ein Repository- oder Organisations-Actions-Secret namens
`RUNAPI_API_KEY`. Übergeben Sie es nur über die Secret-Eingabe der Action:

```yaml
anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }}
```

Fügen Sie den Schlüssel nicht in die Workflow-Datei oder das `settings`-JSON der Aktion ein. Die Aktion verarbeitet Einstellungen separat; nur die nicht sensible Basis-URL gehört dorthin.

Der folgende minimale interaktive Workflow reagiert auf neue Issue- und
Pull-Request-Review-Kommentare:

```yaml
name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }}
          settings: |
            {
              "env": {
                "ANTHROPIC_BASE_URL": "https://runapi.ai"
              }
            }
          claude_args: "--model YOUR_RUNAPI_MODEL_ID"
```

### Geheimnisse

GitHub leitet gewöhnliche Actions-Geheimnisse nicht an Workflows weiter, die durch Pull-Requests aus Forks oder Dependabot-Ereignisse ausgelöst werden. Wenn eine Ausführung keine Berechtigung hat, überprüfen Sie die Ereignisquelle, bevor Sie den RunAPI-Schlüssel rotieren. Verwenden Sie GitHubs [Actions-Geheimnisse-Leitfaden][1] für Repository- und Organisationsbereich.



[1]: https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets

### Berechtigungen

* `contents: write` erlaubt der Action, Codeänderungen zu committen.
* `pull-requests: write` und `issues: write` erlauben ihr, die auslösende Unterhaltung zu
  lesen und darauf zu antworten.
* `id-token: write` unterstützt die Standard-GitHub-App-Authentifizierung der Action.
* `actions: read` erlaubt ihr, Workflow-Ergebnisse einzusehen.

Verwenden Sie diese expliziten Berechtigungen anstelle von `write-all`. Entfernen Sie Funktionen, die Ihr Workflow nicht benötigt.

### Auslösende Ereignisse

`issue_comment` umfasst Kommentare in Issues und Pull-Request-
Gesprächen; `pull_request_review_comment` umfasst Kommentare in Diff-
Zeilen. Die Workflow-Datei muss im Standard-Branch vorhanden sein, bevor
`issue_comment` sie auslösen kann. Die Action prüft außerdem, wer den
Run initiiert hat; verwenden Sie das [offizielle Sicherheitsverhalten][1] als maßgebliche Referenz.



[1]: https://code.claude.com/docs/en/github-actions#who-can-trigger-runs

## Ein Modell auswählen

Ersetzen Sie `YOUR_RUNAPI_MODEL_ID` in `claude_args` durch den genauen
Bezeichner aus dem [Modellkatalog](https://runapi.ai/de/models). Wenn Sie die Modellauswahl
außerhalb von `settings.env` halten, ist das vom Workflow gewählte Modell in der
Aktionskonfiguration sichtbar.

## Überprüfen

1.  Bestätigen Sie, dass das Secret `RUNAPI_API_KEY` vorhanden ist, ohne seinen Wert
    auszugeben.
2.  Mergen Sie den Workflow in den Standard-Branch und vergewissern Sie sich, dass Actions
    aktiviert sind.
3.  Fügen Sie von einem Konto mit Repository-Schreibzugriff `@claude describe
    this repository in one sentence` als Issue-Kommentar hinzu.
4.  Öffnen Sie den Workflow-Run, vergewissern Sie sich, dass die Action erfolgreich war, und
    überprüfen Sie, ob Claude im selben Issue antwortet.

## Fehlerbehebung

* **Kein Workflow startet:** Vergewissern Sie sich, dass die Datei sich im Standard-Branch befindet, das Kommentarereignis übereinstimmt und Actions aktiviert sind.
* **Der Job wird übersprungen:** Vergewissern Sie sich, dass der Kommentar `@claude` enthält und der Akteur den erforderlichen Repository-Zugriff hat.
* **Authentifizierung schlägt fehl:** Vergewissern Sie sich, dass der Workflow auf `secrets.RUNAPI_API_KEY` verweist, und rotieren Sie den Schlüssel bei Bedarf über die [Authentifizierungsanleitung](https://runapi.ai/de/docs/guides/authentication.md).
* **Eine Fork-Pull-Request kann den Schlüssel nicht verwenden:** GitHub enthält gewöhnlichen Secrets aus fork-ausgelösten Ausführungen absichtlich vor. Ersetzen Sie das Secret nicht durch einen Literal-Wert.
* **Das Modell ist nicht verfügbar:** Kopieren Sie die genaue Kennung aus dem [Modellkatalog](https://runapi.ai/de/models).
* **Claude-Commits starten keinen weiteren Workflow:** Lesen Sie die offizielle [GitHub-Token-Fehlerbehebung][1] der Action.



[1]: https://code.claude.com/docs/en/github-actions#ci-not-running-on-claudes-commits

## Nächste Schritte

Verwende den [LLM API quickstart](https://runapi.ai/de/docs/guides/llm-api/quickstart.md) für
das Protokollverhalten und die [Anthropic Messages API
Reference](https://runapi.ai/de/docs/api/anthropic/messages.md) für Anfrage-Felder. Für weitere
Trigger und Aktionseingaben verwende die [offiziellen Beispiele][1] und die
[Konfigurationsreferenz][2].



[1]: https://github.com/anthropics/claude-code-action/tree/main/examples
[2]: https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md

---

## Mehr von RunAPI

- [Startseite](https://runapi.ai/de/.md)
- [Modellkatalog](https://runapi.ai/de/models.md)
- [Preise](https://runapi.ai/de/pricing.md)
- [Anbieter](https://runapi.ai/de/models)
- [Dokumentation](https://runapi.ai/de/docs/guides)
- [SDKs](https://runapi.ai/de/sdk.md)
- [CLI](https://runapi.ai/de/cli.md)
- [MCP Server](https://runapi.ai/de/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/de/claude-code-vs-cursor.md)
- [Cursor API-Einrichtung](https://runapi.ai/de/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/de/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/de/contact.md)
- [Kontakt](https://runapi.ai/de/contact.md)
- [Bedingungen](https://runapi.ai/de/terms.md)
- [Datenschutz](https://runapi.ai/de/privacy.md)
- [Website-Index für KI-Agenten](https://runapi.ai/llms.txt)

Kontakt: contact@runapi.ai

## Strukturierte Daten

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/de",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/de/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/de",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/deicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "TechArticle",
    "headline": "Claude Code GitHub Actions",
    "description": "Claude Code GitHub Actions mit einem RunAPI-Secret, Modell, Berechtigungen, Auslösern und einem minimalen Workflow konfigurieren.",
    "url": "https://runapi.ai/de/docs/resources/tool-integrations/claude-code-github-actions",
    "mainEntityOfPage": "https://runapi.ai/de/docs/resources/tool-integrations/claude-code-github-actions"
  }
]
```
