Usar Claude Code con GAC

May 17, 2026 · View on GitHub

GAC admite la autenticación mediante suscripciones de Claude Code, permitiéndote usar tu suscripción de Claude Code en lugar de pagar por la costosa API de Anthropic. Esto es perfecto para usuarios que ya tienen acceso a Claude Code a través de su suscripción.

⚠️ Aviso — uso no oficial: Anthropic ha estado reprimiendo activamente herramientas de terceros que usan tokens OAuth de Claude Code fuera de la CLI de Claude Code, revocando el acceso en ocasiones. gac es lo suficientemente pequeño como para haber pasado desapercibido hasta ahora, pero usar Claude Code (OAuth) aquí no es oficialmente sancionado y podría dejar de funcionar en cualquier momento. Si necesitas generación confiable de mensajes de commit, usa un proveedor de API directo (anthropic, openai, etc.) en su lugar. Consulta la documentación de suscripción de Claude Code de Anthropic para la política actual.

¿Qué es Claude Code?

Claude Code es el servicio de suscripción de Anthropic que proporciona acceso a los modelos Claude mediante OAuth. En lugar de usar claves API (que se facturan por token), Claude Code usa tokens OAuth de tu suscripción.

Beneficios

Rentable: Usa tu suscripción existente de Claude Code en lugar de pagar por separado por acceso a la API
Mismos modelos: Accede a los mismos modelos Claude (ej., claude-sonnet-4-5)
Facturación separada: El uso de Claude Code está separado de la facturación de la API de Anthropic

Configuración

GAC incluye autenticación OAuth incorporada para Claude Code. El proceso de configuración está completamente automatizado y abrirá tu navegador para autenticación.

Opción 1: Durante la Configuración Inicial (Recomendado)

Al ejecutar uvx gac init, simplemente selecciona "Claude Code" como tu proveedor:

uvx gac init

El asistente:

Te pedirá que selecciones "Claude Code" de la lista de proveedores
Abrirá automáticamente tu navegador para autenticación OAuth
Guardará tu token de acceso en ~/.gac.env
Establecerá el modelo predeterminado

Opción 2: Cambiar a Claude Code Más Tarde

Si ya tienes GAC configurado con otro proveedor y quieres cambiar a Claude Code:

uvx gac model

Luego:

Selecciona "Claude Code" de la lista de proveedores
Tu navegador se abrirá automáticamente para autenticación OAuth
Token guardado en ~/.gac.env
Modelo configurado automáticamente

Usar GAC Normalmente

Una vez autenticado, usa GAC como de costumbre:

# Prepara tus cambios
git add .

# Genera y confirma con Claude Code
uvx gac

# O anula el modelo para un solo commit
uvx gac -m claude-code:claude-sonnet-4-5

Modelos Disponibles

Claude Code proporciona acceso a los mismos modelos que la API de Anthropic. Los modelos actuales de la familia Claude 4.5 incluyen:

claude-sonnet-4-5 - Modelo Sonnet más reciente e inteligente, mejor para codificación
claude-haiku-4-5 - Rápido y eficiente
claude-opus-4-5 - Modelo más capaz para razonamiento complejo

Consulta la documentación de Claude para la lista completa de modelos disponibles.

Solución de Problemas

Token Expirado

Si ve errores de autenticación, su token puede haber expirado. Vuelva a autenticarse ejecutando:

uvx gac auth claude-code login

Su navegador se abrirá automáticamente para una nueva autenticación OAuth. Alternativamente, puede ejecutar uvx gac model, seleccionar "Claude Code (OAuth)" y elegir "Volver a autenticarse (obtener nuevo token)".

Comprobar estado de autenticación

Para comprobar si está actualmente autenticado:

uvx gac auth claude-code status

O compruebe todos los proveedores a la vez:

uvx gac auth

Cerrar sesión

Para eliminar su token almacenado:

uvx gac auth claude-code logout

"CLAUDE_CODE_ACCESS_TOKEN no encontrado"

Esto significa que GAC no puede encontrar tu token de acceso. Autentícate ejecutando:

uvx gac model

Luego selecciona "Claude Code" de la lista de proveedores. El flujo OAuth comenzará automáticamente.

"Autenticación fallida"

Si la autenticación OAuth falla:

Asegúrate de tener una suscripción activa de Claude Code
Verifica que tu navegador abra correctamente
Intenta un navegador diferente si los problemas persisten
Verifica la conectividad de red a claude.ai
Verifica que los puertos 8765-8795 estén disponibles para el servidor de callback local

Diferencias con el Proveedor Anthropic

Característica	Anthropic (`anthropic:`)	Claude Code (`claude-code:`)
Autenticación	Clave API (`ANTHROPIC_API_KEY`)	OAuth (flujo automático del navegador)
Facturación	Facturación API por token	Basada en suscripción
Configuración	Entrada manual de clave API	OAuth automático via `uvx gac init` o `uvx gac model`
Gestión de Tokens	Claves API de larga duración	Tokens OAuth (pueden expirar, fácil reautenticación via `model`)
Modelos	Mismos modelos	Mismos modelos

Notas de Seguridad

Nunca hagas commit de tu token de acceso al control de versiones
GAC almacena automáticamente tokens en ~/.gac.env (fuera de tu directorio de proyecto)
Los tokens pueden expirar y requerirán reautenticación via uvx gac model
El flujo OAuth usa PKCE (Proof Key for Code Exchange) para seguridad mejorada
El servidor de callback local solo se ejecuta en localhost (puertos 8765-8795)