@claude in qualsiasi PR o issue, Claude può analizzare il tuo codice, creare pull request, implementare funzionalità e correggere bug - il tutto seguendo gli standard del tuo progetto.
Claude Code GitHub Actions è costruito sulla base dell’Claude
Agent SDK, che consente l’integrazione programmatica di
Claude Code nelle tue applicazioni. Puoi utilizzare l’SDK per creare flussi di lavoro di automazione personalizzati
oltre GitHub Actions.
Claude Opus 4.5 è ora disponibile. Claude Code GitHub Actions utilizza per impostazione predefinita Sonnet. Per utilizzare Opus 4.5, configura il parametro model per utilizzare
claude-opus-4-5-20251101.Perché utilizzare Claude Code GitHub Actions?
- Creazione istantanea di PR: Descrivi quello di cui hai bisogno e Claude crea una PR completa con tutti i cambiamenti necessari
- Implementazione automatica del codice: Trasforma gli issue in codice funzionante con un singolo comando
- Segue i tuoi standard: Claude rispetta le tue linee guida
CLAUDE.mde 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 una potente GitHub Action che trasforma il modo in cui lavori con il codice:Claude Code Action
Questa GitHub Action ti consente di eseguire Claude Code all’interno dei tuoi flussi di lavoro GitHub Actions. Puoi utilizzarla per creare qualsiasi flusso di lavoro personalizzato sulla base di Claude Code. Visualizza repository →Configurazione
Configurazione rapida
Il modo più semplice per configurare questa action è attraverso Claude Code nel terminale. Basta aprire claude ed eseguire/install-github-app.
Questo comando ti guiderà attraverso la configurazione dell’app GitHub e dei secret richiesti.
- Devi essere un amministratore del repository per installare l’app GitHub e aggiungere secret
- L’app GitHub richiederà autorizzazioni di lettura e scrittura per Contents, Issues e Pull requests
- Questo metodo di avvio rapido è disponibile solo per gli utenti diretti dell’API Claude. Se stai utilizzando AWS Bedrock o Google Vertex AI, consulta la sezione Utilizzo con AWS Bedrock e Google Vertex AI.
Configurazione manuale
Se il comando/install-github-app non riesce o preferisci una configurazione manuale, segui queste istruzioni di configurazione manuale:
-
Installa l’app GitHub di Claude nel tuo repository: https://github.com/apps/claude
L’app GitHub di Claude richiede le seguenti autorizzazioni del repository:
- Contents: Lettura e scrittura (per modificare i file del repository)
- Issues: Lettura e scrittura (per rispondere agli issue)
- Pull requests: Lettura e scrittura (per creare PR e spingere i cambiamenti)
- Aggiungi ANTHROPIC_API_KEY ai tuoi secret del repository (Scopri come utilizzare i secret in GitHub Actions)
-
Copia il file del flusso di lavoro da examples/claude.yml nella cartella
.github/workflows/del tuo repository
Aggiornamento dalla versione Beta
Se stai attualmente utilizzando la versione beta di Claude Code GitHub Actions, ti consigliamo di aggiornare i tuoi flussi di lavoro per utilizzare la versione GA. La nuova versione semplifica la configurazione aggiungendo potenti nuove funzionalità come il rilevamento automatico della modalità.Cambiamenti essenziali
Tutti gli utenti beta devono apportare questi cambiamenti ai loro file di flusso di lavoro per eseguire l’upgrade:- Aggiorna la versione dell’action: Cambia
@betaa@v1 - Rimuovi la configurazione della modalità: Elimina
mode: "tag"omode: "agent"(ora rilevata automaticamente) - Aggiorna gli input del prompt: Sostituisci
direct_promptconprompt - Sposta le opzioni CLI: Converti
max_turns,model,custom_instructions, ecc. inclaude_args
Breaking Changes Reference
| Old Beta Input | New v1.0 Input |
|---|---|
mode | (Rimosso - rilevato automaticamente) |
direct_prompt | prompt |
override_prompt | prompt con variabili GitHub |
custom_instructions | claude_args: --append-system-prompt |
max_turns | claude_args: --max-turns |
model | claude_args: --model |
allowed_tools | claude_args: --allowedTools |
disallowed_tools | claude_args: --disallowedTools |
claude_env | settings formato JSON |
Esempio Prima e Dopo
Versione beta:Esempi di casi d’uso
Claude Code GitHub Actions può aiutarti con una varietà di attività. La directory degli esempi contiene flussi di lavoro pronti all’uso per diversi scenari.Flusso di lavoro di base
Utilizzo di skills
Automazione personalizzata con prompt
Casi d’uso comuni
Nei commenti di issue o PR:Best practices
Configurazione CLAUDE.md
Crea un fileCLAUDE.md nella radice del tuo repository per definire le linee guida dello stile di codice, i criteri di revisione, le regole specifiche del progetto e i pattern preferiti. Questo file guida la comprensione di Claude degli standard del tuo progetto.
Considerazioni sulla sicurezza
Per una guida completa sulla sicurezza che include autorizzazioni, autenticazione e best practice, consulta la documentazione sulla sicurezza di Claude Code Action. Utilizza sempre GitHub Secrets per le chiavi API:- Aggiungi la tua chiave API come secret del repository denominato
ANTHROPIC_API_KEY - Fai riferimento ad essa nei flussi di lavoro:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} - Limita le autorizzazioni dell’action solo a ciò che è necessario
- Rivedi i suggerimenti di Claude prima di eseguire il merge
${{ secrets.ANTHROPIC_API_KEY }}) piuttosto che hardcodare le chiavi API direttamente nei tuoi file di flusso di lavoro.
Ottimizzazione delle prestazioni
Utilizza i template di issue per fornire contesto, mantieni il tuoCLAUDE.md conciso e focalizzato, e configura timeout appropriati per i tuoi flussi di lavoro.
Costi CI
Quando utilizzi Claude Code GitHub Actions, tieni presente i costi associati: Costi di GitHub Actions:- Claude Code viene eseguito su runner ospitati da GitHub, che consumano i tuoi minuti di GitHub Actions
- Consulta la documentazione sulla fatturazione di GitHub per i dettagli sui prezzi e i limiti di minuti
- Ogni interazione di Claude consuma token API in base alla lunghezza dei prompt e delle risposte
- L’utilizzo dei token varia in base alla complessità dell’attività e alla dimensione della codebase
- Consulta la pagina dei prezzi di Claude per i tassi di token attuali
- Utilizza comandi specifici
@claudeper ridurre le chiamate API non necessarie - Configura
--max-turnsappropriato inclaude_argsper prevenire iterazioni eccessive - Imposta timeout a livello di flusso di lavoro per evitare job fuori controllo
- Considera l’utilizzo dei controlli di concorrenza di GitHub per limitare le esecuzioni parallele
Esempi di configurazione
Claude Code Action v1 semplifica la configurazione con parametri unificati:- Interfaccia prompt unificata - Utilizza
promptper tutte le istruzioni - Comandi - Prompt precostruiti come
/reviewo/fix - Passthrough CLI - Qualsiasi argomento CLI di Claude Code tramite
claude_args - Trigger flessibili - Funziona con qualsiasi evento GitHub
Utilizzo con AWS Bedrock e Google Vertex AI
Per ambienti aziendali, puoi utilizzare Claude Code GitHub Actions con la tua infrastruttura cloud. Questo approccio ti dà il controllo sulla residenza dei dati e sulla fatturazione mantenendo la stessa funzionalità.Prerequisiti
Prima di configurare Claude Code GitHub Actions con i 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 le autorizzazioni richieste
- Un’app GitHub (consigliato) o utilizza il GITHUB_TOKEN predefinito
Per AWS Bedrock:
- Un account AWS con Amazon Bedrock abilitato
- GitHub OIDC Identity Provider configurato in AWS
- Un ruolo IAM con autorizzazioni Bedrock
- Un’app GitHub (consigliato) o utilizza il GITHUB_TOKEN predefinito
Crea un'app GitHub personalizzata (Consigliato per provider di terze parti)
Per il miglior controllo e sicurezza quando utilizzi provider di terze parti come Vertex AI o Bedrock, ti consigliamo di creare la tua app GitHub:Alternativa per Claude API o se non vuoi configurare la tua app Github: Utilizza l’app ufficiale di Anthropic:
- Vai a https://github.com/settings/apps/new
- Compila le informazioni di base:
- GitHub App name: Scegli un nome univoco (ad es. “YourOrg Claude Assistant”)
- Homepage URL: 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 le autorizzazioni richieste:
- Repository permissions:
- Contents: Read & Write
- Issues: Read & Write
- Pull requests: Read & Write
- Repository permissions:
- Fai clic su “Create GitHub App”
- Dopo la creazione, fai clic su “Generate a private key” e salva il file
.pemscaricato - Annota il tuo App ID dalla pagina delle impostazioni dell’app
- Installa l’app nel tuo repository:
- Dalla pagina delle impostazioni della tua app, fai clic su “Install App” nella barra laterale sinistra
- Seleziona il tuo account o organizzazione
- Scegli “Only select repositories” e seleziona il repository specifico
- Fai clic su “Install”
- Aggiungi la chiave privata come secret al tuo repository:
- Vai a Settings → Secrets and variables → Actions del tuo repository
- Crea un nuovo secret denominato
APP_PRIVATE_KEYcon il contenuto del file.pem
- Aggiungi l’App ID come secret:
- Crea un nuovo secret denominato
APP_IDcon l’ID della tua app GitHub
Questa app verrà utilizzata con l’action actions/create-github-app-token per generare token di autenticazione nei tuoi flussi di lavoro.
- 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
AWS Bedrock
Configura AWS per consentire a GitHub Actions di autenticarsi in modo sicuro senza archiviare le credenziali.
Security Note: Utilizza configurazioni specifiche del repository e concedi solo le autorizzazioni minime richieste.Required Setup:
-
Enable Amazon Bedrock:
- Richiedi l’accesso ai modelli Claude in Amazon Bedrock
- Per i modelli tra regioni, richiedi l’accesso in tutte le regioni richieste
-
Set up GitHub OIDC Identity Provider:
- Provider URL:
https://token.actions.githubusercontent.com - Audience:
sts.amazonaws.com
- Provider URL:
-
Create IAM Role for GitHub Actions:
- Trusted entity type: Web identity
- Identity provider:
token.actions.githubusercontent.com - Permissions:
AmazonBedrockFullAccesspolicy - Configure trust policy for your specific repository
- AWS_ROLE_TO_ASSUME: L’ARN del ruolo IAM che hai creato
Google Vertex AI
Google Vertex AI
Configura Google Cloud per consentire a GitHub Actions di autenticarsi in modo sicuro senza archiviare le credenziali.
Security Note: Utilizza configurazioni specifiche del repository e concedi solo le autorizzazioni minime richieste.Required Setup:
-
Enable APIs nel tuo progetto Google Cloud:
- IAM Credentials API
- Security Token Service (STS) API
- Vertex AI API
-
Create Workload Identity Federation resources:
- Crea un Workload Identity Pool
- Aggiungi un provider OIDC GitHub con:
- Issuer:
https://token.actions.githubusercontent.com - Attribute mappings per repository e owner
- Security recommendation: Utilizza condizioni di attributo specifiche del repository
- Issuer:
-
Create a Service Account:
- Concedi solo il ruolo
Vertex AI User - Security recommendation: Crea un account di servizio dedicato per repository
- Concedi solo il ruolo
-
Configure IAM bindings:
- Consenti al Workload Identity Pool di rappresentare l’account di servizio
- Security recommendation: Utilizza set di principal specifici del repository
- GCP_WORKLOAD_IDENTITY_PROVIDER: Il nome completo della risorsa provider
- GCP_SERVICE_ACCOUNT: L’indirizzo email dell’account di servizio
Aggiungi i Secret Richiesti
Aggiungi i seguenti secret al tuo repository (Settings → Secrets and variables → Actions):
Per Claude API (Direct):
-
Per l’autenticazione API:
ANTHROPIC_API_KEY: La tua chiave API Claude da console.anthropic.com
-
Per GitHub App (se utilizzi la tua app):
APP_ID: L’ID della tua app GitHubAPP_PRIVATE_KEY: Il contenuto della chiave privata (.pem)
Per Google Cloud Vertex AI
-
Per l’autenticazione GCP:
GCP_WORKLOAD_IDENTITY_PROVIDERGCP_SERVICE_ACCOUNT
-
Per GitHub App (se utilizzi la tua app):
APP_ID: L’ID della tua app GitHubAPP_PRIVATE_KEY: Il contenuto della chiave privata (.pem)
Per AWS Bedrock
-
Per l’autenticazione AWS:
AWS_ROLE_TO_ASSUME
-
Per GitHub App (se utilizzi la tua app):
APP_ID: L’ID della tua app GitHubAPP_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 seguenti mostrano configurazioni complete sia per AWS Bedrock che per Google Vertex AI:
AWS Bedrock workflow
AWS Bedrock workflow
Prerequisites:
- Accesso AWS Bedrock abilitato con autorizzazioni per modelli Claude
- GitHub configurato come provider di identità OIDC in AWS
- Ruolo IAM con autorizzazioni Bedrock che si fida di GitHub Actions
| Secret Name | Description |
|---|---|
AWS_ROLE_TO_ASSUME | ARN del ruolo IAM per l’accesso a 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 |
Google Vertex AI workflow
Google Vertex AI workflow
Prerequisites:
- Vertex AI API abilitato nel tuo progetto GCP
- Workload Identity Federation configurato per GitHub
- Account di servizio con autorizzazioni Vertex AI
| Secret Name | Description |
|---|---|
GCP_WORKLOAD_IDENTITY_PROVIDER | Nome della risorsa del provider di identità del carico di lavoro |
GCP_SERVICE_ACCOUNT | Email dell’account di servizio con accesso a 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 |
Troubleshooting
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 secret del repository e conferma che il commento contenga@claude (non /claude).
CI non in esecuzione sui commit di Claude
Assicurati di utilizzare l’app GitHub o un’app personalizzata (non l’utente Actions), controlla che i trigger del flusso di lavoro includano gli eventi necessari e verifica che le autorizzazioni dell’app includano i trigger CI.Errori di autenticazione
Conferma che la chiave API sia valida e abbia autorizzazioni sufficienti. Per Bedrock/Vertex, controlla la configurazione delle credenziali e assicurati che i secret siano denominati correttamente nei flussi di lavoro.Configurazione avanzata
Parametri dell’action
Claude Code Action v1 utilizza una configurazione semplificata:| Parameter | Description | Required |
|---|---|---|
prompt | Istruzioni per Claude (testo o skill come /review) | No* |
claude_args | Argomenti CLI passati a Claude Code | No |
anthropic_api_key | Chiave API Claude | Yes** |
github_token | Token GitHub per l’accesso API | No |
trigger_phrase | Frase trigger personalizzata (predefinito: “@claude”) | No |
use_bedrock | Utilizza AWS Bedrock invece dell’API Claude | No |
use_vertex | Utilizza Google Vertex AI invece dell’API Claude | No |
**Richiesto per l’API Claude diretta, non per Bedrock/Vertex
Passa argomenti CLI
Il parametroclaude_args accetta qualsiasi argomento CLI di Claude Code:
--max-turns: Numero massimo di turni di conversazione (predefinito: 10)--model: Modello da utilizzare (ad esempio,claude-sonnet-4-5-20250929)--mcp-config: Percorso della configurazione MCP--allowed-tools: Elenco separato da virgole degli strumenti consentiti--debug: Abilita l’output di debug
Metodi di integrazione alternativi
Sebbene il comando/install-github-app sia l’approccio consigliato, puoi anche:
- Custom GitHub App: Per le organizzazioni che necessitano di nomi utente personalizzati o flussi di autenticazione personalizzati. Crea la tua app GitHub con le autorizzazioni richieste (contents, issues, pull requests) e utilizza l’action actions/create-github-app-token per generare token nei tuoi flussi di lavoro.
- Manual GitHub Actions: Configurazione diretta del flusso di lavoro per la massima flessibilità
- MCP Configuration: Caricamento dinamico dei server Model Context Protocol
Personalizzazione del comportamento di Claude
Puoi configurare il comportamento di Claude in due modi:- CLAUDE.md: Definisci gli standard di codifica, i criteri di revisione e le regole specifiche del progetto in un file
CLAUDE.mdnella radice del tuo repository. Claude seguirà queste linee guida quando crea PR e risponde alle richieste. Consulta la nostra documentazione Memory per ulteriori dettagli. - Custom prompts: Utilizza il parametro
promptnel file del flusso di lavoro per fornire istruzioni specifiche del flusso di lavoro. Questo ti consente di personalizzare il comportamento di Claude per diversi flussi di lavoro o attività.