Claude Code con una URL base personalizada
Define estas cuatro variables en tu shell, o en el bloque env de ~/.claude/settings.json, y Claude Code funcionará con modelos Claude a través de tu clave de AIGROW.
¿Ya tienes un código? Canjéalo en acceso a la API y después crea una clave.
Shell, antes de iniciar claude
export ANTHROPIC_BASE_URL="https://aigrow.gg"
export ANTHROPIC_AUTH_TOKEN="ag_your_key_here"
export ANTHROPIC_MODEL="claude-opus-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5.5"Cambia ag_your_key_here por una clave de acceso a la API.
Dónde está el ajuste
- macOS y Linux
~/.claude/settings.json- Windows
%USERPROFILE%\.claude\settings.json- Solo un proyecto
.claude/settings.local.json- Extensión de VS Code
claudeCode.environmentVariables
O guárdalo en settings.json
Claude Code lee el bloque env de su archivo de ajustes en cada inicio, así que la configuración se mantiene en una terminal nueva. Un valor definido aquí prevalece sobre un export de la shell. No pongas la clave en el .claude/settings.json de un proyecto, ya que está pensado para subirse al repositorio.
{
"env": {
"ANTHROPIC_BASE_URL": "https://aigrow.gg",
"ANTHROPIC_AUTH_TOKEN": "ag_your_key_here",
"ANTHROPIC_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5.5"
}
}Qué modelo usar
Escribe el id exactamente como aparece aquí.
- Claude Opus 5.5
claude-opus-5.5 - ANTHROPIC_MODEL, el modelo con el que trabajas. Es el predeterminado en todos los bloques de esta página. Contexto: 1.000.000 tokens.
- Claude Sonnet 5.5
claude-sonnet-5.5 - ANTHROPIC_DEFAULT_HAIKU_MODEL, para títulos, resúmenes y otras llamadas en segundo plano. Claude Code las envía por defecto a un modelo Haiku, que el endpoint no ofrece. Como modelo principal es el que menos cuesta en una sesión larga, porque sus lecturas de caché son las más baratas de aquí. Contexto: 1.000.000 tokens.
- Claude Fable 5.1
claude-fable-5.1 - Cuesta más por token que Opus. Compara ambos en la clasificación de programación antes de cambiar. Contexto: 1.000.000 tokens.
La lista de precios incluye cada id y su tarifa en crédito, los precios de la API de Claude muestran las tarifas oficiales y la clasificación de programación compara los modelos con consultas de código.
Comprueba que funciona
Primero la clave por sí sola y después Claude Code con ella.
La clave
Pide la lista de modelos. Requiere una clave válida y no cuesta nada.
curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"{
"object": "list",
"data": [
{ "id": "claude-opus-5.5", "object": "model", ... },
{ "id": "claude-fable-5.1", "object": "model", ... },
{ "id": "gpt-6-astra", "object": "model", ... },
{ "id": "claude-sonnet-5.5", "object": "model", ... },
{ "id": "gpt-6.1-sol", "object": "model", ... },
{ "id": "grok-4.7", "object": "model", ... },
...
],
"has_more": false
}Claude Code
Ejecuta un prompt desde la shell. Dentro de una sesión, /status muestra la URL base y de dónde procede la clave.
claude -p "Reply with the word ready"readyCuando falla
Primero los errores de Claude Code y luego las respuestas que el endpoint da a cualquier herramienta.
- 404 en todas las solicitudes
- La URL base termina en /v1. Claude Code añade /v1/messages por sí mismo, así que ANTHROPIC_BASE_URL es https://aigrow.gg sin nada después.
- 400 por un campo desconocido
- Define CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 y vuelve a iniciar. Claude Code dejará de enviar sus campos de solicitud experimentales.
- Te pide aprobar una clave de API
- Definiste ANTHROPIC_API_KEY, que se envía como cabecera x-api-key y requiere tu aprobación una vez. Apruébala, o usa ANTHROPIC_AUTH_TOKEN como en el bloque, que se envía como cabecera Bearer sin pedir confirmación.
- Sigue usando tu sesión de Claude
- Ejecuta /status. Si no muestra ninguna URL base personalizada, las variables no llegaron a Claude Code: expórtalas en la shell desde la que inicias claude, o ponlas en el bloque env de settings.json.
- Mi herramienta muestra un error 401 o de autenticación
- Falta la clave o está mal escrita. Cópiala de nuevo desde Acceso a la API en el panel y asegúrate de enviarla como clave, no como nombre de modelo. Una clave revocada falla igual: crea una nueva y sustitúyela.
- Recibo un 402 o un mensaje sobre el crédito
- Tu saldo está agotado. Abre Acceso a la API en el panel, canjea un código o compra otro paquete y la siguiente solicitud se procesará. No hace falta cambiar nada más.
- Aparece 404 o Unknown model
- El modelo tiene que ser uno de los que sirve el endpoint, por ejemplo claude-opus-5.5. Las grafías propias del proveedor también funcionan (claude-opus-5-5, anthropic/claude-opus-5.5), pero un id con fecha o cualquier modelo fuera del catálogo se rechaza antes de reenviar la solicitud y no se factura nada. Solicita GET /v1/models con tu clave para ver la lista actualizada, o consulta los ids en la lista de precios.
- Las solicitudes se rechazan con un 429
- La capacidad del endpoint la comparten todos los clientes: unas 20 solicitudes por minuto y 4 simultáneas. Cada 429 incluye una cabecera retry-after, y los SDK de OpenAI y Anthropic esperan ese tiempo y reintentan por su cuenta. En un bucle propio, espera los segundos que indica o reduce la concurrencia.
- El modelo no está disponible en este momento
- Un 404 que indica que el modelo no está disponible en este momento significa que el proveedor original ha dejado de responder durante un breve periodo; no es un problema de tu clave ni de tu saldo. Reintenta en unos instantes o envía la solicitud a otro modelo.
- Recibo un 502 o un 503
- Es un fallo transitorio del proveedor o de la configuración, y no se cobra de tu saldo. Reintenta la solicitud; si sigue fallando, escríbenos a través de la tienda y lo revisaremos.
Lo que no funciona a través de AIGROW
GPT y Grok. Claude Code está hecho para modelos Claude, así que define aquí solo ids de Claude y usa alguna de las otras herramientas de esta página para el resto.
Remote Control y dictado por voz. Requieren una sesión de Claude y están desactivados con una clave de pasarela.
Tamaño de contexto para un id que Claude Code no reconoce. Lo trata como de 200.000 tokens, así que una sesión puede compactarse antes de lo que el modelo necesita.
Recuento exacto de tokens antes de una solicitud. El endpoint no tiene ruta de recuento de tokens, así que Claude Code estima por su cuenta el tamaño de un prompt.
Búsqueda web en vivo dentro del modelo. Una herramienta de búsqueda web enviada con una solicitud se responde con lo que el modelo ya sabe, sin resultados en vivo. Una herramienta que obtiene páginas en tu propio equipo sigue funcionando.
Cualquier endpoint además de estos tres: /v1/messages, /v1/chat/completions y /v1/models. La Responses API, los embeddings y el recuento de tokens responden 404.
Campos de enrutador como models, route, provider y plugins. Se descartan, de modo que una solicitud siempre va al único modelo que indica.
Cuánto cuesta un mes con Claude Code
Un desarrollador trabajando todo el día, con la mayor parte de cada solicitud leída de la caché del prompt, al precio de tarifa y con crédito. Cambia el modelo para comparar.
Claude Opus 5.5, Agente de programación: $214.20 al mes al precio de lista, $100.80 con crédito de AIGROW, $113.40 menos (53%).
Preguntas sobre Claude Code y una API personalizada
- ¿Claude Code funciona con una URL base personalizada?
- Sí. Define ANTHROPIC_BASE_URL como https://aigrow.gg y ANTHROPIC_AUTH_TOKEN con tu clave, y Claude Code enviará todas las solicitudes allí en lugar de a Anthropic. La extensión de VS Code lee los mismos ajustes.
- ¿ANTHROPIC_BASE_URL debe terminar en /v1?
- No. Claude Code añade /v1/messages por sí mismo, así que el valor es https://aigrow.gg. Si pones /v1 al final, todas las solicitudes van a /v1/v1/messages y fallan con un error 404.
- ¿ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY?
- Ambas funcionan con una clave de AIGROW. ANTHROPIC_AUTH_TOKEN se envía como cabecera Bearer sin pedir confirmación. ANTHROPIC_API_KEY se envía como x-api-key, y en una sesión interactiva Claude Code te pide aprobarla una vez.
- ¿Puedo usarlo solo en un proyecto?
- Sí. Pon el bloque env en .claude/settings.local.json, en la raíz del proyecto. Claude Code lo lee solo en ese proyecto, y el archivo no está pensado para subirse al repositorio.
- ¿El Claude Agent SDK funciona igual?
- Sí, con las mismas variables pasadas en su opción env. En TypeScript esa opción reemplaza el entorno, así que incluye process.env con el operador spread; en Python, ClaudeAgentOptions(env=...) se suma al entorno.
- ¿Cómo vuelvo a mi suscripción de Claude?
- Elimina las variables de tu shell y del bloque env de settings.json, y luego inicia claude de nuevo. Si no hay ninguna URL base definida, usa tu sesión de Claude.
Fuentes: Claude Code LLM gateway · Claude Code Connect a gateway · Claude Code Settings. Consultado el 21 de octubre de 2026.
Configurar otra herramienta
- ClineProtocolo de OpenAI
El proveedor OpenAI Compatible, cuatro campos en la pantalla de ajustes.
- Roo CodeProtocolo de OpenAI
El proveedor OpenAI Compatible, los mismos campos que en Cline.
- Kilo CodeProtocolo de OpenAI
Un proveedor personalizado en la pestaña Providers; la lista de modelos se rellena sola.
- ContinueProtocolo de OpenAI
Una entrada de models en config.yaml, con provider openai y un apiBase.
- AiderProtocolo de OpenAI
OPENAI_API_BASE y OPENAI_API_KEY, y después openai/ antes del id del modelo.
- OpenCodeProtocolo de OpenAI
Un bloque provider en opencode.json y la clave mediante /connect.
- ZedProtocolos de Anthropic y OpenAI
Un proveedor compatible con Anthropic para Claude y uno compatible con OpenAI para GPT y Grok.
- GooseProtocolo de OpenAI
El proveedor de OpenAI con OPENAI_HOST, o un archivo de proveedor personalizado.
- Vercel AI SDKProtocolos de Anthropic y OpenAI
El proveedor compatible con OpenAI para todos los modelos, o el proveedor de Anthropic para Claude.
- OpenAI Agents SDKProtocolo de OpenAI
Tu propio cliente AsyncOpenAI, cambiado a chat completions y con el rastreo desactivado.
- LangChainProtocolos de Anthropic y OpenAI
ChatOpenAI con base_url para todos los modelos, o ChatAnthropic para Claude.
La guía de la API incluye los SDK, curl, los endpoints y los límites de uso.
Pega el bloque y Claude Code funcionará con tu crédito.
Compra un paquete de crédito, canjea el código de tu correo en acceso a la API, crea una clave y ponla en lugar de ag_your_key_here.