Usare Claude Code con GAC

May 17, 2026 · View on GitHub

GAC supporta l'autenticazione tramite abbonamenti Claude Code, permettendoti di usare il tuo abbonamento Claude Code invece di pagare per l'API Anthropic costosa. Questo è perfetto per utenti che hanno già accesso a Claude Code tramite il loro abbonamento.

⚠️ Attenzione — utilizzo non ufficiale: Anthropic sta attivamente reprimendo gli strumenti di terze parti che utilizzano token OAuth di Claude Code al di fuori della CLI Claude Code, revocando a volte l'accesso. gac è abbastanza piccolo da essere rimasto sotto il radar finora, ma usare Claude Code (OAuth) qui non è ufficialmente autorizzato e potrebbe smettere di funzionare in qualsiasi momento. Se hai bisogno di una generazione affidabile di messaggi di commit, utilizza invece un fornitore di API diretto (anthropic, openai, ecc.). Consulta la documentazione dell'abbonamento Claude Code di Anthropic per la politica attuale.

Cos'è Claude Code?

Claude Code è il servizio di abbonamento di Anthropic che fornisce accesso ai modelli Claude basato su OAuth. Invece di usare chiavi API (che vengono fatturate per token), Claude Code usa token OAuth dal tuo abbonamento.

Vantaggi

Conveniente: Usa il tuo abbonamento Claude Code esistente invece di pagare separatamente per l'accesso API
Stessi modelli: Accedi agli stessi modelli Claude (es. claude-sonnet-4-5)
Fatturazione separata: L'uso di Claude Code è separato dalla fatturazione API Anthropic

Configurazione

GAC include autenticazione OAuth integrata per Claude Code. Il processo di configurazione è completamente automatizzato e aprirà il tuo browser per l'autenticazione.

Opzione 1: Durante la configurazione iniziale (Raccomandato)

Quando esegui uvx gac init, seleziona semplicemente "Claude Code" come tuo provider:

uvx gac init

La procedura guidata:

Ti chiederà di selezionare "Claude Code" dall'elenco dei provider
Aprirà automaticamente il tuo browser per l'autenticazione OAuth
Salverà il tuo token di accesso in ~/.gac.env
Imposterà il modello predefinito

Opzione 2: Passare a Claude Code in seguito

Se hai già configurato GAC con un altro provider e vuoi passare a Claude Code:

uvx gac model

Quindi:

Seleziona "Claude Code" dall'elenco dei provider
Il tuo browser si aprirà automaticamente per l'autenticazione OAuth
Token salvato in ~/.gac.env
Modello configurato automaticamente

Usare GAC normalmente

Una volta autenticato, usa GAC come al solito:

# Metti in stage le tue modifiche
git add .

# Genera e fai il commit con Claude Code
uvx gac

# O sovrascrivi il modello per un singolo commit
uvx gac -m claude-code:claude-sonnet-4-5

Modelli disponibili

Claude Code fornisce accesso agli stessi modelli dell'API Anthropic. I modelli attuali della famiglia Claude 4.5 includono:

claude-sonnet-4-5 - Modello Sonnet più recente e intelligente, migliore per la codifica
claude-haiku-4-5 - Veloce ed efficiente
claude-opus-4-5 - Modello più capace per ragionamento complesso

Consulta la documentazione di Claude per l'elenco completo dei modelli disponibili.

Risoluzione dei problemi

Token scaduto

Se vedi errori di autenticazione, il tuo token potrebbe essere scaduto. Ri-autenticati eseguendo:

uvx gac auth claude-code login

Il tuo browser si aprirà automaticamente per una nuova autenticazione OAuth. In alternativa, puoi eseguire uvx gac model, selezionare "Claude Code (OAuth)" e scegliere "Ri-autenticati (ottieni nuovo token)".

Verificare lo stato di autenticazione

Per verificare se sei attualmente autenticato:

uvx gac auth claude-code status

Oppure controlla tutti i provider contemporaneamente:

uvx gac auth

Disconnessione

Per rimuovere il tuo token memorizzato:

uvx gac auth claude-code logout

"CLAUDE_CODE_ACCESS_TOKEN non trovato"

Questo significa che GAC non può trovare il tuo token di accesso. Autenticati eseguendo:

uvx gac model

Quindi seleziona "Claude Code" dall'elenco dei provider. Il flusso OAuth inizierà automaticamente.

"Autenticazione fallita"

Se l'autenticazione OAuth fallisce:

Assicurati di avere un abbonamento Claude Code attivo
Verifica che il tuo browser si apra correttamente
Prova un browser diverso se i problemi persistono
Verifica la connettività di rete a claude.ai
Verifica che le porte 8765-8795 siano disponibili per il server di callback locale

Differenze dal provider Anthropic

Funzionalità	Anthropic (`anthropic:`)	Claude Code (`claude-code:`)
Autenticazione	Chiave API (`ANTHROPIC_API_KEY`)	OAuth (flusso browser automatico)
Fatturazione	Fatturazione API per token	Basata su abbonamento
Configurazione	Inserimento manuale chiave API	OAuth automatico tramite `uvx gac init` o `uvx gac model`
Gestione token	Chiavi API a lungo termine	Token OAuth (possono scadere, facile ri-autenticazione tramite `model`)
Modelli	Stessi modelli	Stessi modelli

Note sulla sicurezza

Non fare mai commit del tuo token di accesso nel controllo versione
GAC memorizza automaticamente i token in ~/.gac.env (fuori dalla tua directory di progetto)
I token possono scadere e richiederanno ri-autenticazione tramite uvx gac model
Il flusso OAuth usa PKCE (Proof Key for Code Exchange) per sicurezza migliorata
Il server di callback locale viene eseguito solo su localhost (porte 8765-8795)