La API de Claude Code, explicada

Claude Code es un agente de terminal, pero internamente cada acción es una llamada a la misma API Messages de Anthropic que puedes utilizar directamente. Esto tiene una consecuencia útil: controlas a qué endpoint se conecta, a qué clave se factura y, por tanto, cuánto cuesta una sesión. Esta página explica los componentes y enlaza a las guías de configuración detalladas.

Qué significa realmente «API de Claude Code»

No existe un producto independiente llamado API de Claude Code. Claude Code se autentica mediante una suscripción de Claude (Pro/Max) o una clave API y, en modo API, envía solicitudes estándar de la API Messages —prompt del sistema, conversación, definiciones de herramientas y resultados de herramientas— al endpoint al que apunte su entorno.

Ese endpoint es configurable. Dos variables de entorno lo controlan todo: ANTHROPIC_BASE_URL (adónde se envían las solicitudes) y ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY (qué cuenta paga). Apúntalas directamente a Anthropic o a una pasarela compatible con Anthropic y Claude Code se comportará de la misma manera.

Usar tu propia clave API con Claude Code

Configura las dos variables en el perfil de tu shell o en ~/.claude/settings.json e inicia claude como de costumbre. Encontrarás el procedimiento completo con ejemplos de settings.json en nuestra <a href="/es/learn/claude-code-api-key-setup/">guía de configuración de claves API para Claude Code</a>.

Un detalle que conviene conocer: si ANTHROPIC_API_KEY está definida en tu shell, Claude Code factura según las tarifas de la API aunque también tengas una suscripción; la variable de entorno tiene prioridad. Elimínala si quieres utilizar tu plan Pro/Max.

Cuánto cuesta una sesión de Claude Code

Las sesiones con agentes consumen muchos tokens: cada lectura de archivo, resultado de herramienta y diff se incorpora al contexto. Una hora de trabajo concentrado puede consumir millones de tokens de entrada, por lo que el almacenamiento en caché de prompts resulta tan importante: en los endpoints compatibles, el contexto repetido se vuelve a leer desde la caché por una fracción del precio.

Desglosamos cifras reales por sesión, el comportamiento de la caché y cómo mantener asequibles las sesiones largas en la <a href="/es/learn/claude-code-api-costs/">guía de costes de la API de Claude Code</a>.

Anthropic directo frente a una pasarela

El acceso directo a la API de Anthropic ofrece facturación por uso y soporte del propio proveedor: la opción predeterminada adecuada para equipos con presupuestos estables. Las pasarelas independientes como AI Prime Tech (sin afiliación ni respaldo de Anthropic) revenden el acceso con tarifas fijas o con descuento y ofrecen el mismo formato de comunicación, por lo que Claude Code funciona cambiando únicamente la URL base y la clave.

Elijas la opción que elijas, verifica que el streaming funcione de extremo a extremo y que los modelos que necesitas estén disponibles con los identificadores exactos que solicita Claude Code. Consulta <a href="/es/learn/use-claude-api-with-claude-code/">cómo usar la API de Claude con Claude Code</a> para ver la lista de comprobación completa.

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Preguntas frecuentes

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.