La CLI de Claude Code se puede instalar gratis. Ejecutarla no. Cada acción que realiza Claude Code —leer un archivo, proponer una edición, ejecutar un comando o comprobar el resultado— es una llamada a un modelo que alguien paga. Anthropic proporciona a las cuentas nuevas de API una pequeña cantidad de crédito gratuito para hacer pruebas, pero no hay un nivel gratuito más allá de esa concesión; una vez gastada, cada llamada se factura.
Lo que pagues depende por completo de cuál de las dos vías de pago elijas: una suscripción de claude.ai o una clave de API facturada por token; ambas se adaptan a patrones de uso muy distintos. La forma más barata de ejecutarlo sin suscripción es una clave de pago por uso: en Kunavo, todos los modelos de Claude cuestan 30% menos que la tarifa publicada de Anthropic, desde una recarga de $10 sin cuota mensual, y la configuración requiere unas pocas variables de entorno (abajo). Estos son los cálculos reales.
Qué es gratis y qué no
| Componente | Costo |
|---|---|
| Instalar la CLI | Gratis |
| Las extensiones de VS Code y JetBrains | Gratis |
| Configuración, hooks, habilidades, subagentes y servidores MCP | Gratis |
| Llamadas al modelo; es decir, usarlo realmente | De pago |
La única forma gratuita de empezar es con un pase de invitado. Los suscriptores elegibles de Pro y Max pueden compartir pases que ofrecen una prueba de Pro de siete días, con Claude Code incluido, a quienes nunca hayan tenido un plan de pago de Claude; para encontrarlos, usa el comando /passes. Los pases son limitados y pueden caducar, así que permiten probar Claude Code, pero no usarlo gratis de forma continua (artículo de Anthropic sobre los pases de invitado, consultado el 2026-10-10). El plan Free no incluye Claude Code.
En cambio, el plan Free de ChatGPT incluye Codex en la aplicación de escritorio, con límites. La comparación directa está en ¿Codex es gratis?.
Las dos formas de pagar
| Suscripción | Clave de API | |
|---|---|---|
| Facturación | Mensual fija (Claude Pro o Max) | Por token, sin cuota mensual |
| Límites | Topes de uso por ventana | Ninguno: pagas por lo que usas |
| Mes tranquilo | Se sigue cobrando | No se cobra nada |
| Mes intenso | Limitado, pero alcanzas los límites | Aumenta con el trabajo |
| Ideal para | Uso diario y predecible | Uso irregular o por rachas |
No se acumulan, y cuál esté activa importa: mientras esté configurada una variable de credenciales como ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY, Claude Code la usa en lugar de de un inicio de sesión guardado de claude.ai. Tu suscripción queda en pausa y sin uso, sus límites dejan de aplicarse y el uso se factura a la clave. Elimina la variable y Claude Code vuelve a la suscripción. Ejecuta /status para ver cuál está activa ahora mismo.
Cuánto cuesta un mes real
El coste depende de los pasos agénticos, no de los días del calendario. Claude Code vuelve a enviar el prompt del sistema, la conversación y el contexto de archivos actualizado en cada paso, por lo que un paso es mayor que un mensaje de chat; lo habitual son unos 25,000 tokens de entrada y 1,200 de salida. A las tarifas de Kunavo en claude-sonnet-5:
| Carga de trabajo | Kunavo | Con las tarifas de Anthropic |
|---|---|---|
| Un paso agentivo | $0.043 | $0.062 |
| Una tarea de 20 pasos | ~$0.87 | ~$1.24 |
| Un día intenso (5 tareas) | ~$4.34 | ~$6.20 |
| 20 días así | ~$87 | ~$124 |
Son cifras sin optimizar: sin almacenamiento en caché de prompts y con todo en el modelo principal. El uso ligero o exploratorio se sitúa en cifras de un solo dígito al mes; la fila costosa es el trabajo agéntico diario sostenido, precisamente donde la tarifa por token se acumula. Calcula tus propias cifras en la calculadora de costes o consulta precios de Claude Code para conocer los niveles de suscripción, la tabla completa de tarifas por modelo y el punto de equilibrio entre ambas vías. La columna “A tarifa de Anthropic” anterior procede de los precios oficiales de la API de Anthropic, que muestra el precio actual publicado por token de cada modelo de Claude junto al coste del mismo modelo aquí.
La forma más barata de ejecutarlo
Claude Code lee ANTHROPIC_BASE_URL de forma nativa, por lo que funciona con cualquier endpoint que sirva la API de Anthropic Messages: sin plugin, sin binario modificado y sin un proxy al que prestar atención. Esa es la vía compatible para obtener una tarifa por token menor:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Los mismos modelos, la misma CLI y aproximadamente un 30 % por debajo del precio de lista en el modelo principal. Conserva las líneas de modelo: el valor predeterminado integrado de Claude Code y sus alias opus y sonnet siguen los modelos más recientes de Anthropic, y si Kunavo todavía no ofrece uno, la solicitud devuelve 404. El alias sonnet solicita Sonnet 5.5, que Kunavo no ofrece, por lo que /model sonnet, la fase de ejecución de opusplan y los subagentes configurados en sonnet devuelven 404, a menos que ANTHROPIC_DEFAULT_SONNET_MODEL lo fije. La referencia opus es Opus 5.5, que requiere Claude Code v2.1.280 o posterior; ejecuta claude update en una instalación anterior. Pago por uso desde una recarga de $10, sin cuota mensual y sin caducidad del saldo: un mes sin actividad realmente no cuesta nada. Consulta el recorrido completo en la guía de configuración de Claude Code. Si ya tienes un plan y sigues alcanzando su límite de ventana, qué ocurre cuando alcanzas un límite de Claude calcula el punto de equilibrio entre mantener el plan y añadir una clave para las horas en que ha dejado de prestar servicio.
Cuatro palancas que realmente cambian la cifra
- Dirige el trabajo en segundo plano a Haiku. Claude Code realiza sus propias llamadas para resúmenes y títulos.
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5($0.70 / $3.50 por 1M) las traslada al modelo más barato. Una línea, ahorro permanente: la lista de precios de la API de Claude de Anthropic contiene las tarifas por modelo entre las que se hace este intercambio, oficiales y con descuento lado a lado. - Inicia tareas nuevas. El contexto se reenvía en cada paso, por lo que una sesión larga resulta costosa de forma cuadrática. Una tarea nueva vuelve a tener un contexto pequeño.
- Deja que funcione el almacenamiento en caché de prompts. La entrada almacenada en caché se factura al 10% de la tarifa de entrada. En un bucle que reenvía un prefijo estable en cada paso, es el mayor ahorro individual disponible (cómo funciona).
- Limita la clave. Asigna al editor su propia clave con un límite de gasto en el panel. Un bucle descontrolado se convierte en uno limitado en lugar de generar una sorpresa.
Errores habituales sobre esto
“Claude Code es de código abierto, así que es gratis”
Que el cliente se pueda instalar gratis no dice nada sobre las llamadas al modelo. La CLI es la parte barata; la inferencia es el coste.
“Mi suscripción Claude Pro cubre la API”
No es así. Las suscripciones y las claves de API son productos distintos con facturación independiente: claude.ai gestiona uno y console.anthropic.com el otro. Pro financia Claude Code únicamente mediante la vía de suscripción, no mediante una clave.
“Debe de haber un nivel gratuito si uso un modelo pequeño”
Más barato, no gratis. claude-haiku-4-5 a $0.70 / $3.50 por 1M es una fracción de Sonnet, pero sigue facturándose.
“Una pasarela significa que puedo usarlo sin pagar a Anthropic”
Sigues pagando la inferencia, solo que a una tarifa distinta y a otra entidad. Lo que cambia es el precio y el modelo de facturación, no el hecho de que cueste dinero.
Preguntas frecuentes
¿Claude Code es gratuito?
La CLI de Claude Code se puede instalar gratis, pero ejecutarla no: cada acción que realiza es una llamada a un modelo que debe pagarse. Hay dos formas de pagar: una suscripción de claude.ai (Pro o Max), que incluye el uso de Claude Code dentro de los límites de ese plan, o una clave de API facturada por token y sin cuota mensual. No existe un nivel gratuito que permita a Claude Code llamar a un modelo sin coste.
¿Puedo usar Claude Code sin una suscripción?
Sí, con una clave de API. Claude Code acepta una clave facturada por token, lo que resulta adecuado para un uso irregular porque no pagas nada en los meses en que no programas. Configurar una clave también deja en pausa cualquier suscripción de claude.ai: mientras la variable de credenciales esté configurada, dejan de aplicarse los límites del plan y el uso se factura a la clave.
¿Cuánto cuesta realmente Claude Code al mes?
Depende de cuántos pasos agénticos ejecutes, no de cuántos días lo uses. Un paso típico tiene unos 25.000 tokens de entrada y 1.200 de salida; una tarea de 20 pasos cuesta aproximadamente $0.87 con Claude Sonnet 5 a las tarifas de Kunavo, frente a unos $1.24 al precio de lista de Anthropic. Un uso ligero cuesta unos pocos dólares al mes; un uso diario intensivo —cinco tareas de este tipo al día durante 20 días— cuesta aproximadamente $87.
¿Hay una prueba gratuita de Claude Code?
Solo por invitación. Los suscriptores elegibles de Pro y Max pueden enviar pases de invitado. Estos dan siete días de Pro a quienes nunca hayan tenido un plan de pago de Claude e incluyen Claude Code. Sin invitación, no hay forma gratuita de usarlo: instalar el CLI es gratis, pero para enviar la primera solicitud real se necesita un plan de pago o una clave de API con saldo. Una pequeña recarga prepaga de pago por uso, sin cuota mensual, es la forma de probarlo con el menor compromiso.
¿Cuál es la forma más barata de ejecutar Claude Code?
Apúntalo a un endpoint más barato y dirige el trabajo en segundo plano a un modelo pequeño. Claude Code lee ANTHROPIC_BASE_URL de forma nativa, así que una puerta de enlace no necesita software adicional; en Kunavo, los mismos modelos Claude cuestan aproximadamente un 30% menos que el precio de lista de Anthropic. Establecer ANTHROPIC_DEFAULT_HAIKU_MODEL en claude-haiku-4-5 traslada las llamadas automáticas en segundo plano de Claude Code al modelo más barato, lo que requiere una sola línea para lograr una reducción permanente.
¿Puedo probar Claude Code sin comprometerme con una suscripción?
Sí: una clave de pago por uso es la opción con menor compromiso, ya que una pequeña recarga no tiene cuota mensual ni caducidad. También puedes instalar la CLI y explorar su configuración, habilidades y comandos antes de añadir fondos; solo la primera solicitud real necesita credenciales.
¿Qué es más barato para mí: una suscripción o la API?
Regla general: si alcanzarías los límites de la suscripción la mayoría de los días, gana la tarifa fija. Si programas por rachas —algunas semanas mucho y otras nada—, gana el pago por token, porque las semanas tranquilas no cuestan nada. Calcula tu punto de equilibrio con la calculadora de costes.
¿Usar una pasarela rompe algo?
La programación, las herramientas, los subagentes, MCP y el almacenamiento en caché de prompts funcionan con normalidad. Remote Control y el dictado por voz no: ambos necesitan una identidad de claude.ai y no están disponibles mientras haya configuradas credenciales de una pasarela. La lista completa está en la guía de configuración.
¿Cómo configuro la clave?
Consulta cómo obtener una clave de API para Claude Code: allí se explica dónde crearla, qué variable debes usar y por qué la incorrecta falla en silencio. Si todavía no has instalado la CLI, instalar Claude Code incluye el comando para cada sistema operativo.