Usando Claude Code com GAC

May 17, 2026 · View on GitHub

GAC suporta autenticação através de assinaturas Claude Code, permitindo que você use sua assinatura Claude Code em vez de pagar pela API Anthropic cara. Isso é perfeito para usuários que já têm acesso a Claude Code através de sua assinatura.

⚠️ Aviso — uso não autorizado: Anthropic tem combatido ativamente ferramentas de terceiros que usam tokens OAuth de Claude Code fora da CLI Claude Code, às vezes revogando o acesso. gac é pequeno o suficiente para ter ficado sob o radar até agora, mas usar Claude Code (OAuth) aqui não é oficialmente autorizado e pode parar de funcionar a qualquer momento. Se você precisar de geração confiável de mensagens de commit, use um provedor de API direto (anthropic, openai, etc.) em seu lugar. Consulte a documentação de assinatura Claude Code do Anthropic para a política atual.

O que é Claude Code?

Claude Code é o serviço de assinatura da Anthropic que fornece acesso aos modelos Claude baseado em OAuth. Em vez de usar chaves API (que são cobradas por token), Claude Code usa tokens OAuth da sua assinatura.

Benefícios

Custo-efetivo: Use sua assinatura Claude Code existente em vez de pagar separadamente por acesso à API
Mesmos modelos: Acesse os mesmos modelos Claude (ex., claude-sonnet-4-5)
Cobrança separada: O uso do Claude Code é separado da cobrança da API Anthropic

Configuração

GAC inclui autenticação OAuth integrada para Claude Code. O processo de configuração é totalmente automatizado e abrirá seu navegador para autenticação.

Opção 1: Durante a Configuração Inicial (Recomendado)

Ao executar uvx gac init, simplesmente selecione "Claude Code" como seu provedor:

uvx gac init

O assistente irá:

Pedir que você selecione "Claude Code" da lista de provedores
Abrir automaticamente seu navegador para autenticação OAuth
Salvar seu token de acesso em ~/.gac.env
Definir o modelo padrão

Opção 2: Mudar para Claude Code Depois

Se você já tem GAC configurado com outro provedor e quer mudar para Claude Code:

uvx gac model

Então:

Selecione "Claude Code" da lista de provedores
Seu navegador abrirá automaticamente para autenticação OAuth
Token salvo em ~/.gac.env
Modelo configurado automaticamente

Usar GAC Normalmente

Uma vez autenticado, use GAC como de costume:

# Prepare suas mudanças
git add .

# Gere e faça commit com Claude Code
uvx gac

# Ou sobrescreva o modelo para um único commit
uvx gac -m claude-code:claude-sonnet-4-5

Modelos Disponíveis

Claude Code fornece acesso aos mesmos modelos que a API Anthropic. Os modelos atuais da família Claude 4.5 incluem:

claude-sonnet-4-5 - Modelo Sonnet mais recente e inteligente, melhor para codificação
claude-haiku-4-5 - Rápido e eficiente
claude-opus-4-5 - Modelo mais capaz para raciocínio complexo

Consulte a documentação do Claude para a lista completa de modelos disponíveis.

Solução de Problemas

Token Expirado

Se você vir erros de autenticação, seu token pode ter expirado. Reautentique-se executando:

uvx gac auth claude-code login

Seu navegador abrirá automaticamente para uma nova autenticação OAuth. Alternativamente, você pode executar uvx gac model, selecionar "Claude Code (OAuth)" e escolher "Reautenticar (obter novo token)".

Verificar status de autenticação

Para verificar se você está autenticado:

uvx gac auth claude-code status

Ou verifique todos os provedores de uma vez:

uvx gac auth

Logout

Para remover seu token armazenado:

uvx gac auth claude-code logout

"CLAUDE_CODE_ACCESS_TOKEN não encontrado"

Isso significa que GAC não consegue encontrar seu token de acesso. Autentique-se executando:

uvx gac model

Então selecione "Claude Code" da lista de provedores. O fluxo OAuth começará automaticamente.

"Autenticação falhou"

Se a autenticação OAuth falhar:

Certifique-se de ter uma assinatura Claude Code ativa
Verifique se seu navegador abre corretamente
Tente um navegador diferente se os problemas persistirem
Verifique a conectividade de rede com claude.ai
Verifique se as portas 8765-8795 estão disponíveis para o servidor de callback local

Diferenças do Provedor Anthropic

Recurso	Anthropic (`anthropic:`)	Claude Code (`claude-code:`)
Autenticação	Chave API (`ANTHROPIC_API_KEY`)	OAuth (fluxo automático do navegador)
Cobrança	Cobrança API por token	Baseada em assinatura
Configuração	Entrada manual de chave API	OAuth automático via `uvx gac init` ou `uvx gac model`
Gerenciamento de Tokens	Chaves API de longa duração	Tokens OAuth (podem expirar, fácil reautenticação via `model`)
Modelos	Mesmos modelos	Mesmos modelos

Notas de Segurança

Nunca faça commit do seu token de acesso no controle de versão
GAC armazena automaticamente tokens em ~/.gac.env (fora do seu diretório de projeto)
Tokens podem expirar e requererão reautenticação via uvx gac model
O fluxo OAuth usa PKCE (Proof Key for Code Exchange) para segurança aprimorada
O servidor de callback local roda apenas em localhost (portas 8765-8795)