Claude Code GitHub Actions

• Code Review: revisione automatica su ogni pull request, senza scrivere un flusso di lavoro
• Claude Code nel cloud: sessioni di Claude Code che vengono eseguite su infrastruttura cloud invece che sulla tua macchina
• Claude Agent SDK: automazione personalizzata al di fuori di GitHub Actions. Il Claude Code GitHub Action è costruito sull’SDK
• GitHub Enterprise Server: Claude Code con GitHub auto-ospitato

​

Setup

• Setup rapido: esegui /install-github-app da Claude Code. Claude Code installa l’app GitHub, aggiunge il tuo secret di autenticazione e prepara la pull request del flusso di lavoro per te
• Setup manuale: installa l’app, aggiungi il secret e copia il file del flusso di lavoro nel tuo repository da solo. Usa questo percorso quando non esegui Claude Code localmente, quando il comando fallisce o quando vuoi il controllo completo dei file di flusso di lavoro

​

Setup rapido

• Se Claude Code ha già una chiave API, la riutilizza e offre di mantenere il secret ANTHROPIC_API_KEY esistente del repository se uno è già impostato
• Altrimenti, scegli tra creare un token di lunga durata con la tua sottoscrizione Claude e incollare una chiave API

• Esegui /install-github-app di nuovo. Quando il repository ha già un claude.yml, seleziona Update workflow file with latest version. Claude Code spinge copie fresche dei file di flusso di lavoro a un nuovo ramo e apre la pull request, come un primo install.
• Aggiungi l’argomento --comment e la riga claude_args dall’esempio del flusso di lavoro di revisione al file archiviato da solo, che mantiene qualsiasi altra modifica che hai fatto ad esso.

​

Setup manuale

​

Configura per un’organizzazione

• Installa l’app GitHub di Claude una volta a livello di organizzazione, scegliendo tutti i repository o un elenco selezionato
• Archivia il secret di autenticazione come secret di Actions a livello di organizzazione in modo che ogni repository non abbia bisogno della sua copia
• Aggiungi il file di flusso di lavoro a ogni repository che dovrebbe eseguire il Claude Code GitHub Action, o definisci il job una volta come flusso di lavoro riutilizzabile che ogni repository chiama

• anthropic_federation_rule_id: l’ID della regola di federazione, fdrl_...
• anthropic_organization_id: il tuo ID organizzazione Anthropic
• anthropic_service_account_id: l’ID dell’account di servizio, svac_.... Opzionale, poiché la regola di federazione che crei nella Console già mira a un account di servizio
• anthropic_workspace_id: l’ID dell’area di lavoro, wrkspc_.... Opzionale quando la regola di federazione mira a un’unica area di lavoro

​

Disinstalla

• File di flusso di lavoro: elimina i flussi di lavoro che usano anthropics/claude-code-action da .github/workflows/. Se hai usato lo setup rapido, cerca claude.yml e, se hai selezionato il flusso di lavoro di revisione, claude-code-review.yml. Con i flussi di lavoro eliminati, il Claude Code GitHub Action non viene più eseguito
• Secret: elimina il secret ANTHROPIC_API_KEY o CLAUDE_CODE_OAUTH_TOKEN dal repository e dai secret di Actions a livello di organizzazione se l’hai condiviso tra repository. Se elimini un secret, le credenziali che conteneva rimangono valide. Per ritirare completamente una chiave API, elimina anche la chiave nella Claude Console
• App GitHub: disinstalla l’app GitHub di Claude nelle impostazioni del tuo repository o organizzazione sotto GitHub Apps, ma solo se non la usi per un’altra funzionalità Claude, come Code Review o web auto-fix

​

Autorizzazioni dell’app GitHub

​

Modalità interattiva e automazione

• Modalità interattiva: quando il flusso di lavoro non fornisce alcun input prompt, Claude attende la frase trigger, @claude per impostazione predefinita, in un commento di issue o pull request, in una revisione di pull request o nel corpo o titolo di un issue appena aperto, quindi risponde a quella richiesta. L’avanzamento e i risultati appaiono come commento sull’issue o PR che ha attivato.
• Modalità automazione: quando il flusso di lavoro fornisce un input prompt, Claude viene eseguito senza attendere una menzione, soggetto solo ai controlli su chi può attivare le esecuzioni. Per impostazione predefinita, i risultati appaiono nel log di esecuzione del flusso di lavoro piuttosto che in un commento. Claude può pubblicare sull’issue o pull request quando il prompt lo dirige e ha uno strumento che può pubblicare, come nell’esempio di code-review.

​

Chi può attivare le esecuzioni

• Accesso in scrittura: su eventi di issue e pull request, l’utente che attiva deve avere accesso in scrittura al repository. Per consentire utenti specifici senza accesso in scrittura, imposta allowed_non_write_users e passa il tuo input github_token. Gli eventi che nessun utente crea, come un trigger schedule, saltano questo controllo.
• Attore umano: su ogni evento, il Claude Code GitHub Action rifiuta un attore bot a meno che non lo elenchi in allowed_bots, che impedisce ai bot di attivare Claude in un ciclo. Questo controllo si applica anche alle esecuzioni programmate, che GitHub attribuisce a un utente del repository, di solito quello che ha modificato per ultimo il programma cron del flusso di lavoro. Se quell’utente è un bot, elencalo in allowed_bots.

​

Casi d’uso di esempio

​

Rispondi alle menzioni @claude

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

• id-token: write: richiesto per l’autenticazione dell’app GitHub predefinita del Claude Code GitHub Action
• actions: read: consente a Claude di leggere i risultati CI su PR
• actions/checkout: fornisce a Claude una copia locale del repository su cui lavorare
• if: impedisce ai runner di avviarsi su commenti che non menzionano @claude. Il Claude Code GitHub Action controlla anche la frase trigger stessa prima di rispondere

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component

​

Esegui una skill

• Per una skill nella directory .claude/skills/ del tuo repository, esegui actions/checkout prima del passo anthropics/claude-code-action in modo che i file della skill siano disponibili sul runner, quindi passa /skill-name come prompt.
• Per una skill inclusa in un plugin, installa il plugin con gli input plugin_marketplaces e plugins, quindi passa lo /plugin-name:skill-name con namespace come prompt. L’input plugins accetta plugin-name@marketplace-name, dove il nome del marketplace proviene dal manifesto del marketplace stesso piuttosto che dall’URL del suo repository.

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

• --comment: Claude pubblica la sua revisione sulla pull request, come commento inline su ogni problema che trova o come un commento di riepilogo quando non ne trova nessuno. Senza di esso, Claude non pubblica nulla e leggi i risultati nel log di esecuzione del flusso di lavoro.
• claude_args: mantieni questa riga anche se il frontmatter allowed-tools della skill stessa nomina lo stesso strumento, perché il Claude Code GitHub Action avvia il server MCP che pubblica commenti inline solo quando --allowedTools in claude_args lo nomina.

​

Esegui su una pianificazione

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: |
            --model claude-opus-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

​

Best practice

​

Definisci gli standard del progetto in CLAUDE.md

​

Proteggi le tue credenziali

​

Gestisci i costi

• Minuti di GitHub Actions: il Claude Code GitHub Action viene eseguito su runner ospitati da GitHub, che consumano i tuoi minuti di GitHub Actions. Vedi la documentazione sulla fatturazione di GitHub per i prezzi e i limiti di minuti.
• Token API: ogni interazione consuma token in base alla lunghezza dei prompt e delle risposte, alla complessità dell’attività e alla dimensione della codebase. Vedi la pagina dei prezzi di Claude per i tassi di token attuali. Se ti autentichi con un token OAuth, le esecuzioni usano la tua sottoscrizione Claude invece della fatturazione API.

• Scrivi richieste specifiche @claude in modo che Claude abbia bisogno di meno turni per finire
• Usa template di issue per fornire contesto in anticipo
• Mantieni il tuo CLAUDE.md conciso, poiché Claude lo legge su ogni esecuzione
• Imposta --max-turns in claude_args per limitare le iterazioni
• Imposta timeout a livello di flusso di lavoro per evitare job fuori controllo
• Usa i controlli di concorrenza di GitHub per limitare le esecuzioni parallele

​

Usa un provider cloud

• Amazon Bedrock: use_bedrock: "true"
• Google Cloud’s Agent Platform: use_vertex: "true"
• Microsoft Foundry: use_foundry: "true"

​

Troubleshooting

​

Claude non risponde ai comandi @claude

• Verifica che l’app GitHub sia installata sul repository
• Controlla che i flussi di lavoro siano abilitati per il repository
• Assicurati che la tua chiave API o token OAuth sia impostato nei secret del repository
• Conferma che il commento contenga @claude come parola completa, non /claude o @claude-bot
• Conferma che l’utente che commenta ha accesso in scrittura al repository. Vedi Chi può attivare le esecuzioni per le eccezioni

​

CI non in esecuzione sui commit di Claude

• GitHub non attiva i flussi di lavoro sui commit effettuati con il GITHUB_TOKEN predefinito. Se passi github_token: ${{ secrets.GITHUB_TOKEN }} al Claude Code GitHub Action, rimuovilo in modo che si autentichi come l’app GitHub di Claude, o passa un token di app personalizzato invece
• Controlla che i trigger del flusso di lavoro CI includano gli eventi che i push di Claude producono, come push o pull_request

​

Errori di autenticazione

• Conferma che la chiave API o il token OAuth sia valido testando localmente con claude prima di eseguire il debug del flusso di lavoro
• Per Bedrock, Agent Platform e Foundry, vedi la sezione troubleshooting della pagina del provider cloud

​

Configurazione avanzata

​

Parametri dell’action

​

Passa argomenti CLI

claude_args: "--max-turns 5 --model claude-sonnet-5 --mcp-config /path/to/config.json"

• --max-turns: limita il numero di turni di conversazione
• --model: modello da usare, ad esempio claude-sonnet-5. Senza questo argomento, il Claude Code GitHub Action usa il modello predefinito di Claude Code
• --mcp-config: percorso alla configurazione MCP
• --allowedTools: elenco separato da virgole degli strumenti consentiti. L’alias --allowed-tools funziona anche
• --debug: abilita l’output di debug

​

Aggiorna dalla versione beta

1. Cambia @beta a @v1 nella riga uses
2. Rimuovi l’input mode, poiché il Claude Code GitHub Action ora rileva la modalità automaticamente
3. Sostituisci direct_prompt con prompt
4. Sposta le opzioni CLI come max_turns e model in claude_args. custom_instructions non ha un flag con lo stesso nome e diventa --append-system-prompt

​

Cosa c’è dopo

• Usa Claude Code GitHub Actions con provider cloud: instrada l’inferenza attraverso Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
• Riferimento di configurazione: l’elenco completo degli input dell’action
• Directory degli esempi: flussi di lavoro pronti all’uso per più scenari
• Code Review: revisione automatica della pull request senza mantenere un file di flusso di lavoro