Claude Code GitHub Actions

Claude Code GitHub Actions porta l’automazione basata su AI al tuo flusso di lavoro GitHub. Con una semplice menzione @claude in qualsiasi PR o issue, Claude può analizzare il tuo codice, creare pull request, implementare funzionalità e correggere bug - tutto seguendo gli standard del tuo progetto.

Claude Code GitHub Actions è attualmente in beta. Le funzionalità e la funzionalità potrebbero evolversi mentre raffiniamo l’esperienza.

Claude Code GitHub Actions è costruito sopra il Claude Code SDK, che abilita l’integrazione programmatica di Claude Code nelle tue applicazioni. Puoi usare l’SDK per costruire flussi di lavoro di automazione personalizzati oltre GitHub Actions.

Perché usare Claude Code GitHub Actions?

Creazione istantanea di PR: Descrivi quello che ti serve, e Claude crea una PR completa con tutte le modifiche necessarie
Implementazione automatizzata del codice: Trasforma le issue in codice funzionante con un singolo comando
Segue i tuoi standard: Claude rispetta le tue linee guida CLAUDE.md e i pattern di codice esistenti
Configurazione semplice: Inizia in pochi minuti con il nostro installer e la chiave API
Sicuro per impostazione predefinita: Il tuo codice rimane sui runner di Github

Cosa può fare Claude?

Claude Code fornisce potenti GitHub Actions che trasformano il modo in cui lavori con il codice:

Claude Code Action

Questa GitHub Action ti permette di eseguire Claude Code all’interno dei tuoi flussi di lavoro GitHub Actions. Puoi usarla per costruire qualsiasi flusso di lavoro personalizzato sopra Claude Code.

Visualizza repository →

Claude Code Action (Base)

La fondazione per costruire flussi di lavoro GitHub personalizzati con Claude. Questo framework estensibile ti dà accesso completo alle capacità di Claude per creare automazione su misura.

Visualizza repository →

Configurazione

Configurazione rapida

Il modo più semplice per configurare questa action è attraverso Claude Code nel terminale. Apri semplicemente claude ed esegui /install-github-app.

Questo comando ti guiderà attraverso la configurazione dell’app GitHub e dei segreti richiesti.

Devi essere un amministratore del repository per installare l’app GitHub e aggiungere segreti
Questo metodo di avvio rapido è disponibile solo per gli utenti diretti dell’API Anthropic. Se stai usando AWS Bedrock o Google Vertex AI, consulta la sezione Uso con AWS Bedrock & Google Vertex AI.

Configurazione manuale

Se il comando /install-github-app fallisce o preferisci la configurazione manuale, segui queste istruzioni di configurazione manuale:

Installa l’app GitHub Claude nel tuo repository: https://github.com/apps/claude
Aggiungi ANTHROPIC_API_KEY ai segreti del tuo repository (Scopri come usare i segreti in GitHub Actions)
Copia il file del flusso di lavoro da examples/claude.yml nella directory .github/workflows/ del tuo repository

Dopo aver completato la configurazione rapida o manuale, testa l’action taggando @claude in un commento di issue o PR!

Esempi di casi d’uso

Claude Code GitHub Actions può aiutarti con una varietà di compiti. Per esempi completi e funzionanti, vedi la directory examples.

Trasforma le issue in PR

In un commento di issue:

@claude implementa questa funzionalità basata sulla descrizione dell'issue

Claude analizzerà l’issue, scriverà il codice e creerà una PR per la revisione.

Ottieni aiuto per l’implementazione

In un commento di PR:

@claude come dovrei implementare l'autenticazione utente per questo endpoint?

Claude analizzerà il tuo codice e fornirà una guida specifica per l’implementazione.

Correggi i bug rapidamente

In un’issue:

@claude correggi il TypeError nel componente dashboard utente

Claude localizzerà il bug, implementerà una correzione e creerà una PR.

Migliori pratiche

Configurazione CLAUDE.md

Crea un file CLAUDE.md nella radice del tuo repository per definire linee guida di stile del codice, criteri di revisione, regole specifiche del progetto e pattern preferiti. Questo file guida la comprensione di Claude degli standard del tuo progetto.

Considerazioni sulla sicurezza

Non committare mai le chiavi API direttamente nel tuo repository!

Usa sempre GitHub Secrets per le chiavi API:

Aggiungi la tua chiave API come segreto del repository chiamato ANTHROPIC_API_KEY
Referenziala nei flussi di lavoro: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
Limita i permessi dell’action solo a quello che è necessario
Rivedi i suggerimenti di Claude prima del merge

Usa sempre GitHub Secrets (es. ${{ secrets.ANTHROPIC_API_KEY }}) piuttosto che codificare direttamente le chiavi API nei tuoi file di flusso di lavoro.

Ottimizzazione delle prestazioni

Usa template di issue per fornire contesto, mantieni il tuo CLAUDE.md conciso e focalizzato, e configura timeout appropriati per i tuoi flussi di lavoro.

Costi CI

Quando usi Claude Code GitHub Actions, sii consapevole dei costi associati:

Costi GitHub Actions:

Claude Code funziona su runner ospitati da GitHub, che consumano i tuoi minuti GitHub Actions
Vedi la documentazione di fatturazione di GitHub per prezzi dettagliati e limiti di minuti

Costi API:

Ogni interazione con Claude consume token API basati sulla lunghezza di prompt e risposte
L’uso dei token varia in base alla complessità del compito e alla dimensione del codebase
Vedi la pagina dei prezzi di Claude per le tariffe attuali dei token

Suggerimenti per l’ottimizzazione dei costi:

Usa comandi @claude specifici per ridurre chiamate API non necessarie
Configura limiti max_turns appropriati per prevenire iterazioni eccessive
Imposta timeout_minutes ragionevoli per evitare flussi di lavoro fuori controllo
Considera l’uso dei controlli di concorrenza di GitHub per limitare le esecuzioni parallele

Esempi di configurazione

Per configurazioni di flusso di lavoro pronte all’uso per diversi casi d’uso, inclusi:

Configurazione di flusso di lavoro di base per commenti di issue e PR
Revisioni automatizzate del codice su pull request
Implementazioni personalizzate per esigenze specifiche

Visita la directory examples nel repository Claude Code Action.

Il repository degli esempi include flussi di lavoro completi e testati che puoi copiare direttamente nella tua directory .github/workflows/.

Uso con AWS Bedrock & Google Vertex AI

Per ambienti enterprise, puoi usare Claude Code GitHub Actions con la tua infrastruttura cloud. Questo approccio ti dà controllo sulla residenza dei dati e sulla fatturazione mantenendo la stessa funzionalità.

Prerequisiti

Prima di configurare Claude Code GitHub Actions con provider cloud, hai bisogno di:

Per Google Cloud Vertex AI:

Un Progetto Google Cloud con Vertex AI abilitato
Workload Identity Federation configurato per GitHub Actions
Un account di servizio con i permessi richiesti
Un’App GitHub (raccomandato) o usa il GITHUB_TOKEN predefinito

Per AWS Bedrock:

Un account AWS con Amazon Bedrock abilitato
Provider di Identità OIDC GitHub configurato in AWS
Un ruolo IAM con permessi Bedrock
Un’App GitHub (raccomandato) o usa il GITHUB_TOKEN predefinito

Crea un'App GitHub personalizzata (Raccomandato per Provider 3P)

Per il miglior controllo e sicurezza quando usi provider 3P come Vertex AI o Bedrock, raccomandiamo di creare la tua App GitHub:

Vai su https://github.com/settings/apps/new
Compila le informazioni di base:
- Nome App GitHub: Scegli un nome unico (es. “YourOrg Claude Assistant”)
- URL Homepage: Il sito web della tua organizzazione o l’URL del repository
Configura le impostazioni dell’app:
- Webhooks: Deseleziona “Active” (non necessario per questa integrazione)
Imposta i permessi richiesti:
- Permessi Repository:
  - Contents: Read & Write
  - Issues: Read & Write
  - Pull requests: Read & Write
Clicca “Create GitHub App”
Dopo la creazione, clicca “Generate a private key” e salva il file .pem scaricato
Annota il tuo App ID dalla pagina delle impostazioni dell’app
Installa l’app nel tuo repository:
- Dalla pagina delle impostazioni della tua app, clicca “Install App” nella barra laterale sinistra
- Seleziona il tuo account o organizzazione
- Scegli “Only select repositories” e seleziona il repository specifico
- Clicca “Install”
Aggiungi la chiave privata come segreto al tuo repository:
- Vai su Settings del tuo repository → Secrets and variables → Actions
- Crea un nuovo segreto chiamato APP_PRIVATE_KEY con il contenuto del file .pem
Aggiungi l’App ID come segreto:

Crea un nuovo segreto chiamato APP_ID con l’ID della tua App GitHub

Questa app sarà usata con l’action actions/create-github-app-token per generare token di autenticazione nei tuoi flussi di lavoro.

Alternativa per API Anthropic o se non vuoi configurare la tua app Github: Usa l’app ufficiale Anthropic:

Installa da: https://github.com/apps/claude
Nessuna configurazione aggiuntiva necessaria per l’autenticazione

Configura l'autenticazione del provider cloud

Scegli il tuo provider cloud e configura l’autenticazione sicura:

AWS Bedrock

Google Vertex AI

Aggiungi Segreti Richiesti

Aggiungi i seguenti segreti al tuo repository (Settings → Secrets and variables → Actions):

Per API Anthropic (Diretta):

Per Autenticazione API:
- ANTHROPIC_API_KEY: La tua chiave API Anthropic da console.anthropic.com
Per App GitHub (se usi la tua app):
- APP_ID: L’ID della tua App GitHub
- APP_PRIVATE_KEY: Il contenuto della chiave privata (.pem)

Per Google Cloud Vertex AI

Per Autenticazione GCP:
- GCP_WORKLOAD_IDENTITY_PROVIDER
- GCP_SERVICE_ACCOUNT
Per App GitHub (se usi la tua app):
- APP_ID: L’ID della tua App GitHub
- APP_PRIVATE_KEY: Il contenuto della chiave privata (.pem)

Per AWS Bedrock

Per Autenticazione AWS:
- AWS_ROLE_TO_ASSUME
Per App GitHub (se usi la tua app):
- APP_ID: L’ID della tua App GitHub
- APP_PRIVATE_KEY: Il contenuto della chiave privata (.pem)

Crea file di flusso di lavoro

Crea file di flusso di lavoro GitHub Actions che si integrano con il tuo provider cloud. Gli esempi sotto mostrano configurazioni complete sia per AWS Bedrock che per Google Vertex AI:

Flusso di lavoro AWS Bedrock

Prerequisiti:

Accesso AWS Bedrock abilitato con permessi modello Claude
GitHub configurato come provider di identità OIDC in AWS
Ruolo IAM con permessi Bedrock che si fida di GitHub Actions

Segreti GitHub richiesti:

Nome Segreto	Descrizione
`AWS_ROLE_TO_ASSUME`	ARN del ruolo IAM per l’accesso Bedrock
`APP_ID`	L’ID della tua App GitHub (dalle impostazioni dell’app)
`APP_PRIVATE_KEY`	La chiave privata che hai generato per la tua App GitHub

name: Claude PR Action 

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write 

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    env:
      AWS_REGION: us-west-2
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Configure AWS Credentials (OIDC)
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          aws-region: us-west-2

      - uses: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          model: "us.anthropic.claude-3-7-sonnet-20250219-v1:0"

Il formato ID modello per Bedrock include il prefisso regione (es. us.anthropic.claude...) e il suffisso versione.

Flusso di lavoro Google Vertex AI

Prerequisiti:

API Vertex AI abilitata nel tuo progetto GCP
Workload Identity Federation configurato per GitHub
Account di servizio con permessi Vertex AI

Segreti GitHub richiesti:

Nome Segreto	Descrizione
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Nome risorsa provider workload identity
`GCP_SERVICE_ACCOUNT`	Email account di servizio con accesso Vertex AI
`APP_ID`	L’ID della tua App GitHub (dalle impostazioni dell’app)
`APP_PRIVATE_KEY`	La chiave privata che hai generato per la tua App GitHub

name: Claude PR Action

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write  

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Authenticate to Google Cloud
        id: auth
        uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
      
      - uses: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_vertex: "true"
          model: "claude-3-7-sonnet@20250219"
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5
          VERTEX_REGION_CLAUDE_3_7_SONNET: us-east5

L’ID progetto viene automaticamente recuperato dal passaggio di autenticazione Google Cloud, quindi non devi codificarlo direttamente.

Risoluzione dei problemi

Claude non risponde ai comandi @claude

Verifica che l’App GitHub sia installata correttamente, controlla che i flussi di lavoro siano abilitati, assicurati che la chiave API sia impostata nei segreti del repository e conferma che il commento contenga @claude (non /claude).

CI non in esecuzione sui commit di Claude

Assicurati di usare l’App GitHub o app personalizzata (non l’utente Actions), controlla che i trigger del flusso di lavoro includano gli eventi necessari e verifica che i permessi dell’app includano i trigger CI.

Errori di autenticazione

Conferma che la chiave API sia valida e abbia permessi sufficienti. Per Bedrock/Vertex, controlla la configurazione delle credenziali e assicurati che i segreti siano nominati correttamente nei flussi di lavoro.

Configurazione avanzata

Parametri dell’action

La Claude Code Action supporta questi parametri chiave:

Parametro	Descrizione	Richiesto
`prompt`	Il prompt da inviare a Claude	Sì*
`prompt_file`	Percorso al file contenente il prompt	Sì*
`anthropic_api_key`	Chiave API Anthropic	Sì**
`max_turns`	Massimo turni di conversazione	No
`timeout_minutes`	Timeout di esecuzione	No

*Richiesto prompt o prompt_file
**Richiesto per API Anthropic diretta, non per Bedrock/Vertex

Metodi di integrazione alternativi

Mentre il comando /install-github-app è l’approccio raccomandato, puoi anche:

App GitHub Personalizzata: Per organizzazioni che necessitano di nomi utente brandizzati o flussi di autenticazione personalizzati. Crea la tua App GitHub con i permessi richiesti (contents, issues, pull requests) e usa l’action actions/create-github-app-token per generare token nei tuoi flussi di lavoro.
GitHub Actions Manuali: Configurazione diretta del flusso di lavoro per massima flessibilità
Configurazione MCP: Caricamento dinamico di server Model Context Protocol

Vedi il repository Claude Code Action per documentazione dettagliata.

Personalizzazione del comportamento di Claude

Puoi configurare il comportamento di Claude in due modi:

CLAUDE.md: Definisci standard di codifica, criteri di revisione e regole specifiche del progetto in un file CLAUDE.md alla radice del tuo repository. Claude seguirà queste linee guida quando crea PR e risponde alle richieste. Dai un’occhiata alla nostra documentazione Memory per maggiori dettagli.
Prompt personalizzati: Usa il parametro prompt nel file del flusso di lavoro per fornire istruzioni specifiche del flusso di lavoro. Questo ti permette di personalizzare il comportamento di Claude per diversi flussi di lavoro o compiti.

Claude seguirà queste linee guida quando crea PR e risponde alle richieste.

Per iniziare

Costruire con Claude

Distribuzione

Amministrazione

Riferimento

Risorse

Claude Code GitHub Actions

Perché usare Claude Code GitHub Actions?

Cosa può fare Claude?

Claude Code Action

Claude Code Action (Base)

Configurazione

Configurazione rapida

Configurazione manuale

Esempi di casi d’uso

Trasforma le issue in PR

Ottieni aiuto per l’implementazione

Correggi i bug rapidamente

Migliori pratiche

Configurazione CLAUDE.md

Considerazioni sulla sicurezza

Ottimizzazione delle prestazioni

Costi CI

Esempi di configurazione

Uso con AWS Bedrock & Google Vertex AI

Prerequisiti

Per Google Cloud Vertex AI:

Per AWS Bedrock:

Per API Anthropic (Diretta):

Per Google Cloud Vertex AI

Per AWS Bedrock

Risoluzione dei problemi

Claude non risponde ai comandi @claude

CI non in esecuzione sui commit di Claude

Errori di autenticazione

Configurazione avanzata

Parametri dell’action

Metodi di integrazione alternativi

Personalizzazione del comportamento di Claude

Per iniziare

Costruire con Claude

Distribuzione

Amministrazione

Riferimento

Risorse

​Perché usare Claude Code GitHub Actions?

​Cosa può fare Claude?

​Claude Code Action

​Claude Code Action (Base)

​Configurazione

​Configurazione rapida

​Configurazione manuale

​Esempi di casi d’uso

​Trasforma le issue in PR

​Ottieni aiuto per l’implementazione

​Correggi i bug rapidamente

​Migliori pratiche

​Configurazione CLAUDE.md

​Considerazioni sulla sicurezza

​Ottimizzazione delle prestazioni

​Costi CI

​Esempi di configurazione

​Uso con AWS Bedrock & Google Vertex AI

​Prerequisiti

​Per Google Cloud Vertex AI:

​Per AWS Bedrock:

​Per API Anthropic (Diretta):

​Per Google Cloud Vertex AI

​Per AWS Bedrock

​Risoluzione dei problemi

​Claude non risponde ai comandi @claude

​CI non in esecuzione sui commit di Claude

​Errori di autenticazione

​Configurazione avanzata

​Parametri dell’action

​Metodi di integrazione alternativi

​Personalizzazione del comportamento di Claude

Perché usare Claude Code GitHub Actions?

Cosa può fare Claude?

Claude Code Action

Claude Code Action (Base)

Configurazione

Configurazione rapida

Configurazione manuale

Esempi di casi d’uso

Trasforma le issue in PR

Ottieni aiuto per l’implementazione

Correggi i bug rapidamente

Migliori pratiche

Configurazione CLAUDE.md

Considerazioni sulla sicurezza

Ottimizzazione delle prestazioni

Costi CI

Esempi di configurazione

Uso con AWS Bedrock & Google Vertex AI

Prerequisiti

Per Google Cloud Vertex AI:

Per AWS Bedrock:

Per API Anthropic (Diretta):

Per Google Cloud Vertex AI

Per AWS Bedrock

Risoluzione dei problemi

Claude non risponde ai comandi @claude

CI non in esecuzione sui commit di Claude

Errori di autenticazione

Configurazione avanzata

Parametri dell’action

Metodi di integrazione alternativi

Personalizzazione del comportamento di Claude