Guida all'uso di Claude Code GitHub Actions

​

Processo di richiesta

​

Caratteristiche

• Creazione PR istantanea: descrivi le esigenze, Claude crea automaticamente una Pull Request completa
• Implementazione automatica del codice: menzionando @claude in un Issue, trasforma l’Issue in codice eseguibile
• Rispetto delle norme di progetto: legge automaticamente CLAUDE.md, seguendo il tuo stile di codice e le norme di progetto
• Sicuro e affidabile: il codice viene eseguito sui Runner di GitHub, garantendo la sicurezza dei dati

​

Passaggi di configurazione

​

Passo 1: Installare l’App GitHub di Claude

​

Passo 2: Aggiungere la chiave API

1. Vai su Settings del repository → Secrets and variables → Actions
2. Clicca su New repository secret
3. Inserisci ANTHROPIC_API_KEY come nome e il token API ottenuto da AceData Cloud come valore
4. Clicca su Add secret per salvare

Nota: Il token API può essere visualizzato nel pannello di controllo di AceData Cloud.

​

Passo 3: Creare il file Workflow

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

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"

​

Modalità d’uso

​

Utilizzo nei commenti di Issue o PR

@claude implementa la funzionalità in base alla descrizione di questo Issue
@claude rivedi la sicurezza del codice in questa PR
@claude risolvi il TypeError nel componente user dashboard
@claude come dovrebbe essere implementata l'autenticazione utente per questo endpoint?

​

Revisione automatica del codice

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"

​

Automazione dei compiti programmati

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: "Genera un riepilogo dei commit di ieri e un rapporto sugli Issue non chiusi"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Descrizione dei parametri dell’Action

​

Parametri comuni di claude_args

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

​

Migliori pratiche

​

Configurare CLAUDE.md

​

Considerazioni sulla sicurezza

• Non scrivere mai direttamente la chiave API nei file Workflow
• Utilizza sempre i Segreti di GitHub (come ${{ secrets.ANTHROPIC_API_KEY }})
• Limita le autorizzazioni dell’Action al minimo necessario
• Rivedi manualmente i suggerimenti di Claude prima di unire

​

Controllo dei costi

• Utilizza istruzioni @claude chiare per ridurre le chiamate API non necessarie
• Imposta limiti ragionevoli per --max-turns per il numero di turni di dialogo
• Imposta un timeout a livello di Workflow
• Utilizza il controllo della concorrenza di GitHub per limitare il numero di esecuzioni parallele

​

Domande frequenti

​

Claude non risponde al comando @claude?

1. Verifica che l’App GitHub di Claude sia installata correttamente
2. Controlla se il Workflow è abilitato
3. Assicurati che la chiave API sia impostata come Secret del repository
4. Assicurati di utilizzare @claude nei commenti (non /claude)

​

Errore di autenticazione?

1. Verifica che la chiave API sia valida e abbia i permessi sufficienti
2. Controlla che il nome del segreto sia corretto (ANTHROPIC_API_KEY)
3. Se stai utilizzando ANTHROPIC_BASE_URL, verifica che l’URL sia corretto

​

Come controllare il saldo rimanente?

​

Scopri di più

• 📖 Documentazione ufficiale di Claude Code GitHub Actions
• 📂 Repository claude-code-action
• 📋 Esempi di Workflow
• 🔧 Servizio Claude Code di AceData Cloud
• 💬 Se hai domande, non esitare a contattarci tramite il servizio clienti della piattaforma