Claude Code sin suscripción: paga por tokens en vez de Pro

Sí. La documentación de autenticación de Claude Code enumera varias formas de autenticarse: una suscripción Claude Pro o Max, Claude for Teams o Enterprise, una cuenta de Claude Console facturada por la API, proveedores en la nube y credenciales en variables de entorno. La suscripción es una de esas opciones, no un requisito. (El plan Free no incluye Claude Code; claude.com/pricing indica que «Claude Code is included in all paid plans».)

Cuando Claude Code se autentica con una clave de API, cada solicitud se cobra por tokens de entrada y salida en lugar de contar contra los límites de un plan. Claude Code no cambia: los mismos comandos, herramientas, permisos y el selector /model. Puedes usar una clave de Console a los precios oficiales de Anthropic o un proxy de la API de Claude como APIVAI, que acepta las mismas solicitudes en formato Anthropic con un precio por token más bajo en la mayoría de los modelos.

Según la documentación de autenticación (consultada en octubre de 2026), cuando hay varias credenciales Claude Code usa la primera que encuentra en este orden:

1. Credenciales de un proveedor en la nube, si está definida CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX o CLAUDE_CODE_USE_FOUNDRY
2. ANTHROPIC_AUTH_TOKEN, enviada en la cabecera Authorization: Bearer y pensada para gateways y proxies
3. ANTHROPIC_API_KEY, enviada en la cabecera X-Api-Key; en modo interactivo Claude Code te pide aprobarla una vez
4. La salida de un script apiKeyHelper
5. CLAUDE_CODE_OAUTH_TOKEN, un token de larga duración de claude setup-token que usa tu suscripción
6. Perfiles de Anthropic y credenciales federadas
7. El inicio de sesión de la suscripción creado con /login

En la práctica:

• Con ANTHROPIC_AUTH_TOKEN definida, Claude Code usa esa clave aunque también hayas iniciado sesión en Pro o Max. Las solicitudes no consumen los límites del plan.
• Si tienes suscripción y además defines ANTHROPIC_API_KEY, Claude Code usa la clave cuando la apruebas. Puedes cambiar esa elección después con el interruptor «Use custom API key» de /config.
• Escribe /status para ver qué credencial está activa. Si hay un inicio de sesión y una clave configurados, /status marca la que no se está usando.

## ¿Cómo configuro Claude Code con una clave de pago por uso?

Aquí va la versión corta; la guía completa de configuración de Claude Code cubre Windows cmd, la alternativa con settings.json y una prueba con curl.

1. Crea una cuenta, recarga saldo (desde $10, sin suscripción) y crea una clave en el Dashboard. Ponle un límite de presupuesto para que una sola sesión no pueda gastar todo tu saldo.
2. Define dos variables de entorno. En macOS o Linux, añádelas a ~/.zshrc o ~/.bashrc:

En PowerShell, añádelas a tu perfil (notepad $PROFILE):

1. Abre una terminal nueva, ejecuta claude y luego /status para confirmar que la credencial activa es el token de tu entorno.
2. Elige un modelo con /model.

¿Quieres conservar también la suscripción? Deja claude con tu inicio de sesión de claude.ai y añade un alias que defina las variables solo para un comando, por ejemplo en bash o zsh:

Así claude usa el plan y claude-api cobra por tokens, algo práctico cuando llegas a un límite a mitad de una tarea.

Según claude.com/pricing en octubre de 2026 (precios sin impuestos):

La página explica los límites así: «Every plan has usage limits that reset on a rolling five-hour session window, and paid plans add weekly limits on top». Al llegar a un límite puedes esperar al reinicio, pasar a un plan superior o, en los planes de pago, activar usage credits para «keep working at standard API rates». La página no traduce estos límites a tokens, así que cualquier comparación con el pago por tokens es una estimación.

Claude Code envía mucho contexto en cada paso: su prompt de sistema, las definiciones de herramientas, los archivos que ha leído y la conversación hasta el momento. Para los ejemplos suponemos que una hora de trabajo activo son unas 40 solicitudes, cada una con unos 40.000 tokens de entrada y 1.000 de salida. Son supuestos, no mediciones: los repositorios grandes y las sesiones largas envían más, las tareas pequeñas menos. Contamos 22 días laborables al mes.

El mismo mes intensivo con Claude Opus 5.5 costaría $244 en APIVAI ($634 a precio oficial).

Estas cifras no tienen en cuenta el caché de prompts, así que tómalas como un máximo. Claude Code mantiene estable su contexto para que las partes repetidas se guarden en caché automáticamente. Para Claude Sonnet 4.6 en APIVAI, la lectura de caché cuesta $0.12 por 1M de tokens y la escritura $1.44, frente a $1.15 de la entrada normal. Como estimación aproximada, si cerca del 80% de la entrada de una sesión se lee de caché, la parte de entrada de la factura baja a más o menos un tercio de la cifra sin caché.

El pago por tokens suele ganar cuando:

• Tu uso es ligero o irregular. Una semana sin programar no cuesta nada; la suscripción se cobra cada mes.
• Un equipo comparte presupuesto. Un saldo, una clave por persona o proyecto, cada una con su propio límite.
• También usas modelos GPT. La misma clave y el mismo saldo funcionan en herramientas con formato OpenAI como Codex CLI; consulta cómo reducir los costes de Claude Code y la API de GPT.
• No quieres ventanas de cinco horas ni topes semanales. Tus límites son el saldo, el presupuesto de la clave y 60 solicitudes por minuto por clave (soporte puede ampliarlo).

La suscripción puede ser más barata cuando:

• Usas Claude Code durante horas todos los días, sobre todo con modelos Opus o tareas autónomas largas. Si tu estimación por tokens supera claramente los $100 al mes y te mantienes dentro de los límites del plan, una tarifa plana es difícil de superar.
• También usas las apps de Claude en la web, el escritorio o el móvil, que el plan cubre y una clave de API no.
• Dependes de funciones ligadas a un inicio de sesión de claude.ai, como las sesiones en la nube.

Una prueba práctica: paga por tokens durante una semana, mira el total en el Dashboard, multiplícalo por unos 4,3 y compáralo con $20 o $100. Para una comparación más amplia con Cursor y Codex CLI, lee Claude Code vs Cursor: coste real.

Precios por 1M de tokens en APIVAI a fecha de 2026-10-10; la lista completa está en la página de precios:

Empieza con Sonnet y cambia a Opus con /model cuando una tarea se atasque. Los ID de los modelos cambian con el tiempo, así que tómalos de la página de precios.

No. Claude Code también funciona con una clave de API que se cobra por tokens. Define ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN y funciona sin ningún plan.

Sí. Usa un alias como claude-api que defina las variables para un solo comando y comprueba con /status qué credencial usa cada sesión.

Depende del volumen. Con unas pocas horas a la semana suele ser más barato; con varias horas diarias de Opus, Max puede costar menos si te mantienes dentro de sus límites. Compara una semana de datos reales del Dashboard con el precio del plan.

No hay ventanas de cinco horas ni topes semanales. El uso lo limitan tu saldo, el presupuesto que pongas a la clave y, por defecto, 60 solicitudes por minuto por clave.

Sí, en herramientas con formato OpenAI como Codex CLI, con la base URL https://api.apivai.com/v1. Claude Code en sí trabaja con modelos Claude. Crea una cuenta, recarga desde $10 y pega tu clave en Claude Code.