Claude Code
Crea una Key dedicada y usa las variables de entorno o ~/.claude/settings.json generados por la consola. Los clientes compatibles con Claude usan la raíz del sitio porque el cliente añade /v1/messages; usa ANTHROPIC_AUTH_TOKEN y no guardes secretos en archivos del proyecto.
Antes de empezar
Instala la versión actual del cliente sólo desde su editor oficial. Antes de cambiar una configuración local, crea una API Key dedicada en la consola; no reutilices una Key personal, compartida o de despliegue de producción.
Windows, macOS y Linux
- Windows: usa el instalador actual de Windows o el flujo de PowerShell y cierra todos los procesos del cliente después de cambiar un archivo de configuración.
- macOS: usa la aplicación firmada o el instalador oficial de terminal para tu CPU; los ajustes del directorio personal pertenecen a ese usuario de macOS.
- Linux / WSL: sigue las instrucciones actuales de la distribución o del CLI oficial; WSL lee su directorio personal de Linux, no el perfil de Windows.
Elegir un modelo
Llama a GET /v1/models con la Key dedicada y selecciona un data[].id devuelto. La lista limitada por Key es la fuente de verdad; una configuración anterior, un artículo o un selector del cliente no garantiza acceso.
Configuración
export ANTHROPIC_BASE_URL='https://ai.tavonilo.com'
export ANTHROPIC_AUTH_TOKEN='sk-...'
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1Verificación
Comprueba la Key con /v1/models, realiza una solicitud pequeña sin datos sensibles y conserva sólo hora, ruta, modelo, estado HTTP e ID de solicitud para soporte. Un timeout no demuestra que una generación facturable no se procesó, por lo que no repitas ciegamente solicitudes largas o de imagen.
Recuperación segura
- 401: sustituye una Key incompleta, revocada o equivocada; no la pegues en una solicitud a soporte.
- 403: comprueba el grupo de la Key, visibilidad del modelo, saldo y permiso de ruta.
- 404: usa la Base URL mostrada aquí, no un endpoint completo, y no añadas /v1 dos veces.
- 429: encola el trabajo y respeta Retry-After si existe; no repitas un lote en paralelo.
- 5xx o timeout: reintenta de forma limitada sólo si la operación es segura. Conserva hora, ruta, modelo, estado HTTP e ID de solicitud en registros anonimizados.
Límite de credenciales
Usa una Key por dispositivo o carga de trabajo. Nunca envíes a soporte una API Key, auth.json, prompt privado completo, contraseña, código de verificación o datos de pago; revoca y reemplaza una Key de inmediato si sospechas exposición.