Cómo configurar Claude Code con apmix en dos minutos

Claude Code es el agente de programación de Anthropic para la terminal: lee tu repositorio, edita archivos, ejecuta comandos y escribe pruebas. Habla con la API de Anthropic, y apmix ofrece esa misma API. Así que puedes usar Claude Code con tu clave de apmix, con los modelos de Claude de tu plan y una sola cuota mensual en lugar de una factura aparte de Anthropic.

Esta guía lleva unos dos minutos. Necesitas una cuenta de apmix con una clave de API (créala en el panel) y Node.js 18 o superior.

1. Instala Claude Code#

Sáltate este paso si claude ya funciona en tu equipo.

npm install -g @anthropic-ai/claude-code

2. Apúntalo a apmix#

Claude Code lee tres variables de entorno. Como habla el protocolo de Anthropic, la Base URL es https://api.apmix.ai sin /v1; Claude Code añade la ruta por su cuenta.

En macOS o Linux:

export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

En Windows, con PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.apmix.ai"
$env:ANTHROPIC_AUTH_TOKEN = "apx_live_YOUR_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

Estas variables solo duran en la terminal actual. Es perfecto para una primera prueba; el siguiente paso las hace permanentes.

3. Hazlo permanente#

Claude Code también lee su configuración de ~/.claude/settings.json. Pon los mismos valores en su bloque env y cada terminal nueva estará lista:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

La documentación tiene comandos de una línea para PowerShell y bash que escriben este archivo por ti y guardan una copia del anterior.

4. Ejecútalo#

Abre tu proyecto e inicia Claude Code:

cd your-project
claude

Listo: ahora cada solicitud pasa por apmix y se descuenta de la cuota de tu plan.

Cambia de modelo con /model#

Dentro de Claude Code, escribe /model para cambiar el modelo de la sesión, con cualquier id de Claude del catálogo:

Cada modelo tiene su propio multiplicador de tokens ponderados, que aparece en la página de precios. Con un modelo más ligero para el trabajo rutinario, la misma cuota dura mucho más; lee los tokens ponderados, explicados.

Comprueba que la clave funciona#

Si algo no va bien, lista los modelos a los que llega tu clave. Si recibes una lista en JSON, la clave y la URL son correctas:

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Las respuestas más habituales y qué hacer:

• 401 invalid_api_key: la clave es incorrecta o se eliminó. Cópiala de nuevo desde Panel → Claves de API.
• 403 model_not_in_plan: el modelo está por encima de tu plan. GET /v1/models lista solo lo que tu plan puede usar; elige uno de esos o mejora tu plan.
• 429 rate_limit_exceeded: más de 60 solicitudes por minuto en una clave (120 en Max). Espera los segundos que indica retry-after.

Todos los errores se explican en la referencia de errores, y cada respuesta incluye una cabecera x-apmix-request-id para indicar si escribes a soporte.

Controla tu uso#

Los agentes consumen mucho: una sesión larga de Claude Code puede enviar millones de tokens. Tres cosas ayudan:

1. Mira Panel → Registros, que muestra cada solicitud en vivo con su modelo, sus tokens y su coste.
2. Configura límites diarios o semanales opcionales en Ajustes, para que una sesión descontrolada no vacíe el mes.
3. Activa los avisos por correo al 50, 70, 80 o 90 % de tu cuota.

Con eso, Claude Code en apmix se siente exactamente igual que Claude Code, con una sola clave y una sola factura para todo lo demás que uses.