Hoja de trucos de API personalizada para agentes de codificación: copia y pega configuraciones para reducir tu factura de tokens

Todos los agentes de programación populares permiten cambiar el modelo que utilizan, pero cada uno oculta la configuración en un archivo distinto, con un nombre de clave diferente y un formato de URL distinto. Por eso, la gente se rinde y sigue pagando precios de modelos de frontera, a pesar de que los usuarios intensivos de agentes llegan a gastar alrededor de USD13 por desarrollador activo al día en los modelos predeterminados (CloudZero, 2026). Esta página soluciona ese problema. Es una referencia única con la configuración exacta de API personalizada para Claude Code, OpenClaw, Codex, OpenCode y Cursor, además de la distinción clave que explica todas sus diferencias. Guárdala en favoritos, porque el valor aquí reside en los bloques de código para copiar y pegar y en los posibles problemas, no en el relleno. Al terminar, podrás configurar cualquiera de estos agentes con un modelo más económico en un par de minutos y entenderás por qué la URL cambia de una herramienta a otra.

Puntos clave

• Los agentes de programación se dividen en dos familias de protocolos. Claude Code utiliza la API de Anthropic; OpenClaw, Codex, OpenCode y Cursor utilizan la API compatible con OpenAI.
• El detalle práctico es la URL: las herramientas compatibles con OpenAI requieren el sufijo /v1, mientras que Claude Code no.
• Toda configuración necesita los mismos tres elementos: una URL base, una clave de API y un ID de modelo. Solo cambian los nombres de los campos.
• Los modelos de pesos abiertos (open-weight) son la clave: DeepSeek V4 Flash cuesta cerca de USD0.14 por millón de tokens de entrada frente a los varios dólares de los modelos de frontera (Codersera, 2026).

Por qué una hoja de referencia de API personalizada para agentes de programación vale la pena

El motivo para preocuparse es el costo, y la causa es estructural. Los agentes reenvían su contexto acumulado en cada paso de razonamiento, por lo que consumen de 10 a 100 veces más tokens que una ventana de chat para la misma tarea (LeanOps, 2026). Ese multiplicador es la razón por la que las facturas de los agentes se disparan, y también es el motivo por el cual cambiar el precio de los tokens, en lugar de usar menos el agente, es la estrategia que realmente funciona. Una API personalizada apunta tu agente a un backend más barato sin cambiar tu forma de trabajar. Envía la programación rutinaria a un modelo de pesos abiertos y el costo por token se reduce drásticamente, a menudo en un 70% o más, mientras que la diferencia de calidad en tareas cotidianas sigue siendo mínima. Una hoja de referencia de API personalizada para agentes de programación es importante porque el ahorro es real, pero la fricción de la configuración es lo que detiene a la mayoría, y dicha fricción es casi totalmente: "qué archivo, qué campo, qué URL".

Cómo funciona una entrada en la hoja de referencia de API personalizada para agentes de programación

Antes de las configuraciones, esta es la idea que hace que todas encajen. Los agentes de programación pertenecen a dos familias de protocolos, y la familia a la que pertenece cada herramienta determina la forma de su configuración. Claude Code se comunica con la API de mensajes de Anthropic, por lo que lee su backend desde ANTHROPIC_BASE_URL y se autentica con un token al estilo Anthropic. Todo lo demás en esta hoja (OpenClaw, Codex, OpenCode y Cursor) se comunica con la API de Chat Completions compatible con OpenAI, por lo que requieren una baseURL, una clave al estilo OpenAI y esperan la ruta /v1 en el endpoint. Ese detalle del /v1 es la razón más común por la que una configuración falla silenciosamente. Una vez que entiendes esa separación, cada entrada a continuación consta de los mismos tres valores con diferente apariencia: una URL base, una clave y un ID de modelo. Los ejemplos usan Atlas Cloud como proveedor porque sirve a ambas familias de protocolos desde una sola cuenta, por lo que lo único que cambia entre herramientas es la sintaxis, no la clave que pegas. Cualquier proveedor compatible funciona igual; solo sustituye la URL base y la clave.

Hoja de referencia de API personalizada para agentes de programación, herramienta por herramienta

Aquí tienes primero la tabla de referencia rápida y luego el bloque de configuración completo para cada herramienta. Ten lista tu clave de API antes de empezar. En Atlas Cloud, crea una seleccionando Coding Plan como tipo de clave, lo cual la vincula a la cuota de programación basada en créditos.

Claude Code

Claude Code es la excepción de la familia Anthropic, así que observa que la URL base no tiene /v1. Edita ~/.claude/settings.json en macOS o Linux, o %USERPROFILE%.claude\settings.json en Windows:

JSONCopy
1{
2  "env": {
3    "ANTHROPIC_AUTH_TOKEN": "tu-clave-api-atlas",
4    "ANTHROPIC_BASE_URL": "https://api.atlascloud.ai",
5    "ANTHROPIC_MODEL": "zai-org/glm-5.1",
6    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "zai-org/glm-5.1",
7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "zai-org/glm-5.1",
8    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
9  }
10}

Configurar los valores predeterminados de Haiku y Sonnet con el mismo modelo redirige también las pequeñas llamadas en segundo plano de Claude Code a tu modelo, en lugar de fallar con un valor predeterminado no disponible.

OpenClaw

OpenClaw es la más sencilla porque cuenta con un asistente. En una terminal, ejecuta openclaw onboard, luego elige Yes, QuickStart y Custom Provider. Introduce la URL base https:​//api.atlascloud.ai/v1, pega tu clave, pega el ID del modelo y elige el protocolo OpenAI-compatible. Cuando aparezca Verification successful, ponle nombre al endpoint y listo. Algo a tener en cuenta si editas ~/.openclaw/openclaw.json manualmente: la configuración de OpenClaw es de dos pasos. Defines el proveedor en models.providers, y luego debes incluir el modelo en la lista blanca (allowlist) bajo agents.defaults.models usando la clave provider-name/model-name, de lo contrario, el agente lo rechazará (documentación de OpenClaw, 2026). Olvidar incluirlo en la lista blanca es la causa principal del error "model not allowed". El asistente realiza ambos pasos, por lo que es el camino recomendado.

Codex

Codex utiliza dos archivos. Pon el proveedor en ~/.codex/config.toml:

TOMLCopy
1model_provider = "atlas_coding_plan"
2model = "zai-org/glm-5.1"
3
4[model_providers.atlas_coding_plan]
5name = "atlascloud"
6base_url = "https://api.atlascloud.ai/v1"
7wire_api = "chat"
8requires_openai_auth = true

Luego, pon la clave en ~/.codex/auth.json:

JSONCopy
1{ "OPENAI_API_KEY": "tu-clave-api-atlas" }

Ejecuta codex en tu terminal, salta el aviso de actualización y estarás conectado.

OpenCode y Cursor

OpenCode lee ~/.config/opencode/opencode.json (en Windows, \Users\tu-usuario.config\opencode\opencode.json):

JSONCopy
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "atlascloud": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "atlascloud",
7      "options": {
8        "baseURL": "https://api.atlascloud.ai/v1",
9        "apiKey": "tu-clave-api-atlas"
10      },
11      "models": {
12        "zai-org/glm-5.1": { "name": "glm-5.1" }
13      }
14    }
15  }
16}

Cursor no tiene archivo de configuración para esto. Abre Settings, ve a Models, añade tu ID de modelo por nombre, luego establece la URL base personalizada de OpenAI a https:​//api.atlascloud.ai/v1 y pega tu clave. Dado que Cursor sigue el patrón compatible con OpenAI, la misma URL base y clave de las otras herramientas funcionan sin cambios.

---

Elegir un modelo: La otra mitad de la hoja de referencia de API personalizada para agentes

Configurar el endpoint es solo la mitad del trabajo. El modelo que elijas es lo que determina el ahorro. El patrón que funciona es usar por defecto un modelo abierto, potente y barato, para la programación diaria y reservar un modelo de frontera para los razonamientos más complejos. La brecha de capacidad es menor que la brecha de precio: en SWE-Bench Pro, los modelos abiertos líderes obtienen puntuaciones cercanas a los 70 frente a los aproximadamente 91 de los modelos de frontera (Codersera, 2026), algo que apenas se nota en el trabajo rutinario de funciones y refactorizaciones. En un proveedor basado en créditos, cada modelo tiene un multiplicador que asigna el uso de tokens a créditos, por lo que el costo relativo es fácil de leer:

Fuente: Reglas de crédito del Coding Plan de Atlas Cloud. Costo en créditos = tokens entrada × mult. entrada + tokens salida × mult. salida. Un valor predeterminado práctico: GLM-5.1 o Kimi K2.6 para programación interactiva, DeepSeek V4 Flash para trabajos de gran volumen o en segundo plano, y un modelo de frontera solo para la tarea poco común que un modelo abierto no pueda resolver. Cambiar es solo modificar una línea con el ID del modelo en cualquiera de las configuraciones anteriores.

Una sola clave de API para todos los agentes de programación

Observa lo que muestra silenciosamente la tabla de la hoja de referencia: la misma clave y los mismos IDs de modelo aparecen en cada configuración. Ese es el verdadero argumento a favor de un proveedor unificado. Si conectas cada herramienta a un proveedor diferente, terminas con claves separadas, paneles separados y facturas separadas, perdiendo una visión única del gasto. Apuntar todos ellos a un solo proveedor reduce esto a una bolsa de créditos única y un solo lugar para cambiar modelos. También facilita la elaboración de presupuestos, lo cual es realmente difícil con la facturación medida por tokens. Un plan que renueva una asignación diaria de créditos fija a medianoche limita el daño de un bucle de agente fuera de control, mientras que los paquetes de pago por uso absorben los picos ocasionales. Los planes de Atlas Cloud comienzan desde USD10 al mes, sus paquetes de pago por uso tienen un descuento del 41% y las actualizaciones a mitad de ciclo son prorrateadas, por lo que subir de nivel cuesta solo la diferencia en lugar de un plan nuevo completo.

Hoja de referencia de API personalizada para agentes de programación: errores comunes

Casi toda configuración fallida se reduce a uno de estos puntos, y todos tienen una solución rápida. La confusión con el /v1. El error más frecuente en toda esta hoja. Las herramientas compatibles con OpenAI quieren el sufijo /v1; Claude Code no. Un error de conexión suele significar que la ruta es incorrecta para la familia de esa herramienta. Usar el tipo de clave incorrecto. Tu clave de proveedor no es tu clave de Anthropic, y viceversa. Pegar la incorrecta da un error de autenticación que parece más confuso de lo que es. Omitir la lista blanca de OpenClaw. Definir el proveedor es solo la mitad de la configuración de OpenClaw. Si ves "model not allowed", el modelo falta en la lista blanca o la clave provider-name/model-name tiene un error tipográfico. Dejar los modelos en segundo plano sin configurar en Claude Code. Si configuras solo el modelo principal pero dejas los valores predeterminados de Haiku y Sonnet apuntando a modelos no disponibles, las pequeñas llamadas en segundo plano fallarán. Configura los tres.

Preguntas frecuentes: Hoja de referencia de API personalizada para agentes de programación

¿Esta hoja de referencia requiere cambiar de herramientas?

No. El punto principal es que conservas el agente que ya utilizas, ya sea Claude Code, OpenClaw, Codex, OpenCode o Cursor. Una API personalizada es un cambio de configuración, no una migración, por lo que tu flujo de trabajo permanece idéntico mientras que el backend y la factura cambian.

¿Por qué la URL base en la hoja de referencia cambia por herramienta?

Debido a la familia de protocolos. Claude Code usa la API de Anthropic y toma el dominio base, mientras que las herramientas compatibles con OpenAI esperan la ruta /v1. Mismo proveedor, misma clave, ruta diferente. Esa única diferencia explica la mayoría de las configuraciones fallidas.

¿Cuánto puede ahorrarte esta hoja de referencia de API personalizada?

Mucho, dependiendo del modelo. DeepSeek V4 Flash cuesta cerca de USD0.14 por millón de tokens de entrada frente a los varios dólares de los modelos de frontera (Codersera, 2026), por lo que enviar el trabajo rutinario a un modelo abierto suele reducir la factura por token en un 70% o más sin cambiar tu forma de programar.

¿Con qué modelo debería empezar?

Para programación interactiva, GLM-5.1 o Kimi K2.6 son opciones sólidas y asequibles. Para trabajos de gran volumen o en segundo plano, DeepSeek V4 Flash es más barato. Mantén un modelo de frontera en reserva solo para tareas que un modelo abierto realmente no pueda manejar.

¿La configuración de esta hoja de referencia es reversible?

Sí. Cada configuración es reversible. Restaura la URL base original o elimina el bloque de proveedor, y el agente apuntará de nuevo a su valor predeterminado. Muchos desarrolladores mantienen ambas configuraciones y cambian según la tarea.

Conclusión

La razón por la que vale la pena guardar una hoja de referencia de API personalizada para agentes de programación es que la parte difícil nunca fue el concepto, sino recordar qué archivo y qué URL quiere cada herramienta. Una vez que entiendes las dos familias de protocolos, cada configuración es la misma URL base, clave e ID de modelo con una sintaxis diferente. Elige un modelo de pesos abiertos, pega el bloque correcto, ten cuidado con la regla del /v1 y conservarás el agente que te gusta mientras pagas una fracción de los precios de los modelos de frontera. Si quieres una sola clave y un solo presupuesto para todos, puedes configurarlo a través de la consola del Coding Plan de Atlas Cloud y cambiar de modelo siempre que la tarea lo requiera.