> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Guida all'uso di Claude Code GitHub Actions

> Claude Code 集成指南 - Ace Data Cloud

Claude Code è uno strumento di **Agentic Coding** lanciato da Anthropic, ed è considerato uno dei più potenti agenti di programmazione al mondo. Claude Code GitHub Actions può integrare le capacità di programmazione AI nel tuo flusso di lavoro GitHub; basta menzionare `@claude` in una PR o in un Issue, e Claude analizzerà automaticamente il codice, creerà PR, implementerà funzionalità e risolverà Bug.

Questo documento descrive principalmente come configurare e utilizzare Claude Code GitHub Actions tramite il servizio proxy di AceData Cloud.

## Processo di richiesta

Per utilizzare Claude Code, puoi prima andare alla [pagina del servizio Claude Messages](https://platform.acedata.cloud/documents/claude-messages) e cliccare sul pulsante "Acquire" per ottenere le credenziali necessarie per la richiesta:

![](https://cdn.acedata.cloud/nyq0xz.png)

Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login per registrarti e accedere; dopo aver effettuato il login, verrai riportato automaticamente alla pagina corrente.

Alla prima richiesta, verrà offerto un credito gratuito per provare il servizio Claude Code.

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

Vai su [https://github.com/apps/claude](https://github.com/apps/claude) e installa l'App GitHub di Claude nel tuo repository.

![Pagina di installazione dell'App GitHub Claude](https://cdn.acedata.cloud/ba4b8df66d.png)

Questa App richiede le seguenti autorizzazioni del repository:

| Autorizzazione    | Livello      | Descrizione                    |
| ----------------- | ------------ | ------------------------------ |
| **Contents**      | Read & Write | Modifica i file del repository |
| **Issues**        | Read & Write | Risponde agli Issue            |
| **Pull requests** | Read & Write | Crea PR e invia modifiche      |

### Passo 2: Aggiungere la chiave API

Aggiungi la chiave API di AceData Cloud come Secret del repository:

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](https://platform.acedata.cloud/console).

### Passo 3: Creare il file Workflow

Crea un file `.github/workflows/claude.yml` nel repository:

```yaml theme={null}
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 }}
```

Se hai bisogno di utilizzare l'endpoint API proxy di AceData Cloud, devi anche impostare le variabili d'ambiente nel Workflow:

```yaml theme={null}
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

Dopo aver completato la configurazione, in qualsiasi commento di Issue o PR puoi menzionare `@claude`, e Claude risponderà automaticamente:

```
@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

Crea un Workflow che esegue automaticamente la revisione del codice quando viene aperta una PR:

```yaml theme={null}
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

Crea un'attività automatizzata eseguita a intervalli regolari:

```yaml theme={null}
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

| Parametro           | Descrizione                                             | Obbligatorio |
| ------------------- | ------------------------------------------------------- | ------------ |
| `anthropic_api_key` | Chiave API                                              | Sì           |
| `prompt`            | Istruzione per Claude (testo o Skill come `/review`)    | No           |
| `claude_args`       | Parametri da passare al CLI di Claude Code              | No           |
| `github_token`      | Token GitHub                                            | No           |
| `trigger_phrase`    | Frase di attivazione personalizzata (default `@claude`) | No           |

### Parametri comuni di claude\_args

```yaml theme={null}
claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
```

| Parametro         | Descrizione                                     |
| ----------------- | ----------------------------------------------- |
| `--max-turns`     | Numero massimo di turni di dialogo (default 10) |
| `--model`         | Modello da utilizzare                           |
| `--mcp-config`    | Percorso del file di configurazione MCP         |
| `--allowed-tools` | Strumenti consentiti (separati da virgola)      |
| `--debug`         | Abilita l'output di debug                       |

## Migliori pratiche

### Configurare CLAUDE.md

Crea un file `CLAUDE.md` nella directory principale del repository, definendo le linee guida sullo stile di codice, gli standard di revisione e le norme di progetto; Claude seguirà automaticamente queste regole.

### 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?

Accedi al [Pannello di controllo di AceData Cloud](https://platform.acedata.cloud/console) per visualizzare il saldo rimanente e l'utilizzo attuale del tuo account.

## Scopri di più

* 📖 [Documentazione ufficiale di Claude Code GitHub Actions](https://code.claude.com/docs/en/github-actions)
* 📂 [Repository claude-code-action](https://github.com/anthropics/claude-code-action)
* 📋 [Esempi di Workflow](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [Servizio Claude Code di AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Se hai domande, non esitare a contattarci tramite il servizio clienti della piattaforma