Claude Code con HopBase: configuración en 10 minutos

Respuesta corta: puede conectar Claude Code a HopBase sin cambios de código configurando dos variables de entorno. Regístrese, cree una API key en la página "API Keys" de la consola, exporte ANTHROPIC_BASE_URL=https://api.hop-base.com y ANTHROPIC_AUTH_TOKEN con su clave, y ejecute claude; añada ambas líneas a ~/.zshrc o ~/.bashrc para que sean permanentes. El gateway mantiene los límites de tasa y los errores transitorios del proveedor fuera de su flujo de trabajo mediante enrutamiento redundante, conmutación automática por error y facturación transparente por solicitud. Una clave solo puede llamar a los modelos de los grupos que incluye, así que elija un grupo con enrutamiento redundante para el desarrollo diario y producción, uno que priorice la latencia para el trabajo interactivo o uno de menor precio para trabajos por lotes. Si algo falla, abra una terminal nueva para que se carguen las variables, confirme que los grupos de la clave incluyen su modelo y pruebe fuera de cualquier proxy HTTPS corporativo. Cada solicitud aparece en la página de uso de la consola con tokens, aciertos de caché y costo.

Claude Code es la herramienta de programación con IA de Anthropic. Esta guía explica cómo conectarlo a HopBase sin cambios de código, solo con dos variables de entorno, y cómo comprobar en la consola el uso y el costo de cada solicitud.

Configuración en tres pasos

Primero, regístrese e inicie sesión en la consola, y cree una nueva API Key en la página "API Keys". Segundo, configure dos variables de entorno en su terminal:

# Two environment variables — Claude Code connects to the gateway
export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=your-key-here

claude   # Use normally — usage shows up in the console in real time

Tercero, ejecute claude e inicie una conversación. Si el autocompletado funciona con normalidad, ha terminado. Para que sea permanente, añada estas dos líneas a ~/.zshrc o ~/.bashrc.

Tres problemas frecuentes

• Las variables de entorno no surten efecto: tras editar la configuración de su shell, abra una terminal nueva o ejecute source; las terminales abiertas desde el IDE podrían no leer la configuración de su shell.
• Los permisos de la clave no coinciden: una clave solo puede llamar a los modelos de los grupos que incluye (una clave puede incluir varios grupos). Si recibe un error de "modelo no disponible", compruebe en la consola que alguno de los grupos de la clave incluye el modelo que necesita, o añada ese grupo a la clave.
• Interferencia del proxy corporativo: los proxies HTTPS empresariales a veces reescriben los encabezados de las solicitudes. Si ve errores 401/403 extraños, pruebe primero en un entorno sin proxy.

Elija su grupo según el caso de uso

Una clave puede usar todos los modelos de los grupos que incluye. Cada grupo tiene sus propias estrategias de precios y enrutamiento (la tabla muestra tipos de grupo habituales; los nombres reales de los grupos en la consola varían):

Verificación y facturación transparente

Tras una solicitud, la página de uso de su consola muestra un registro de inmediato: modelo, número de tokens, aciertos de caché y costo, todo correlacionado. Los tokens que aciertan en la prompt cache se facturan con un descuento considerable; las herramientas conversacionales como Claude Code suelen registrar una proporción considerable de aciertos de caché, por lo que su costo real a menudo resulta inferior al que estimaría a partir de los precios de lista.