¿Se puede usar Claude Code gratis? Instalación, suscripción y API

Qué es gratis y qué es de pago en Claude Code

Descargar e instalar el cliente no tiene un coste separado. Sin embargo, la instalación por sí sola no da acceso a los modelos: Claude Code debe autenticarse mediante un plan de Claude de pago, Claude Console o una plataforma empresarial compatible.

La guía oficial de configuración de Claude Code indica expresamente que el plan Claude.ai Free no incluye acceso a Claude Code. Las solicitudes requieren un plan de Claude de pago, facturación de Claude Console/API o un proveedor externo compatible. Utiliza la página de precios de Claude solo para consultar las funciones y los límites actuales de los planes de pago, que pueden cambiar.

La frase «Claude Code es gratis» suele referirse únicamente al cliente. Las solicitudes consumen el cupo de un plan de pago o tokens de API facturables.

La suscripción de Claude y la API tienen facturación distinta

Al iniciar sesión mediante Claude.ai, el uso de Claude Code está incluido en el plan de pago y comparte sus límites generales con otras superficies de Claude. Al autenticarse mediante Claude Console, se aplica la facturación de API por tokens. El coste real depende del modelo, el tamaño del contexto y el trabajo realizado.

• Plan de Claude de pago: suscripción con uso incluido y contabilizado en el cupo compartido; consulta /usage y Settings → Usage. Adecuado para trabajo interactivo si ya tienes un plan.
• Claude Console / API: facturación por tokens registrada en la organización de API y el Workspace; consulta /usage para la sesión y Claude Console para la factura. Adecuado para facturación, presupuestos y acceso organizativo independientes.

Evita confundir la autenticación de suscripción y API

Claude Code elige las credenciales según un orden de prioridad. La variable de entorno ANTHROPIC_API_KEY tiene prioridad sobre la autenticación OAuth mediante /login. En modo interactivo, Claude Code pide una vez permiso para utilizar una clave detectada; en modo no interactivo -p, la clave se usa automáticamente si está definida.

Puedes comprobar si la variable está definida sin mostrar su valor:

if [ "${ANTHROPIC_API_KEY+x}" = x ]; then
  printf '%s\n' 'Variable is set'
else
  printf '%s\n' 'Variable is not set'
fi

Después, ejecuta /status dentro de Claude Code. La línea Login method muestra el método activo y aparece una línea API key adicional cuando se utiliza una clave de API.

Si querías usar la suscripción, pero hay una clave de entorno activa, elimínala de la sesión actual:

unset ANTHROPIC_API_KEY

Vuelve a ejecutar /status. No borres manualmente los archivos de credenciales: utiliza los comandos oficiales /logout y /login para cambiar la cuenta guardada.

Cómo leer el uso y los límites en /usage

La sección Session al principio de /usage muestra estadísticas de la sesión actual: tokens de entrada, salida, lectura de caché y escritura de caché. Su importe en dólares se calcula localmente a partir de los tokens y puede diferir de la factura real.

Para usuarios de API, ayuda a estimar el uso de la sesión, pero la referencia de facturación es la página Usage de Claude Console. Después de /clear, los contadores de la nueva sesión vuelven a empezar.

Para suscriptores Pro, Max, Team y Enterprise, el uso de Claude Code está incluido en el plan. La estimación en dólares de Session no es el importe cobrado a la suscripción. En la misma pantalla aparecen barras de uso del plan, estadísticas de actividad y desgloses de skills, subagents, plugins y servidores MCP.

Las teclas d y w alternan el desglose entre las últimas 24 horas y siete días. La información procede del historial local del ordenador actual y no incluye actividad de otros dispositivos ni de claude.ai.

Dónde consultar las condiciones actuales

Cuatro páginas oficiales cubren el tema:

• Claude Plans & Pricing — planes que incluyen actualmente Claude Code y límites publicados.
• Manage costs effectively — cómo leer /usage, consultar la factura de API y entender los límites.
• Authentication — métodos de acceso, prioridad de credenciales, /status, /login y /logout.
• Claude Console Usage — uso y costes reales de una organización de API.

No trates precios, tamaños de límites o funciones como valores permanentes en tus notas. Abre la página de precios actual antes de pagar o cambiar el método de autenticación.

Cómo elegir un método de acceso a Claude Code

La opción adecuada depende de dónde deba contabilizarse el uso:

1. Ya tienes un plan de Claude de pago y trabajas de forma interactiva. Inicia sesión con /login, comprueba Login method en /status y vigila las barras del plan en /usage.
2. Tu organización necesita facturación de API y límites de gasto separados. Utiliza Claude Console y consulta allí la factura real, no la estimación local de Session.
3. Claude Code se ejecuta en CI o en un script sin navegador. El acceso por API es una opción, pero no la única: la documentación oficial también admite un token OAuth de suscripción de larga duración mediante claude setup-token. El método activo determina cómo se paga el uso.
4. Has agotado el límite del plan de pago. Puedes esperar a que se restablezca, cambiar de plan o activar créditos de uso si están disponibles para tu cuenta. El uso adicional se factura con las tarifas estándar de la API.

Después de cambiar el método, repite dos comprobaciones: /status responde «¿qué cuenta está activa?» y /usage responde «¿qué límite o registro de uso es visible ahora?».

La comparación detallada de las vías de pago de Claude Code cubre suscripción y API. Esta página mantiene un objetivo más concreto: separar la instalación gratuita del cliente del acceso de pago al modelo.

Preguntas frecuentes

¿Puedo usar Claude Code con el plan Free?

En la página de precios actual, Claude Code aparece en los planes de pago, pero no en Free. Puedes instalar el cliente sin una compra independiente, aunque las solicitudes requieren un método de acceso de pago compatible.

¿Por qué /usage muestra dólares si tengo una suscripción?

Es una estimación local del coste API de los tokens utilizados en la sesión actual, no una factura de la suscripción. Consulta las barras de uso del plan en la misma pantalla.

¿Puede una API Key cambiar Claude Code de suscripción a facturación de API?

Sí. Si ANTHROPIC_API_KEY está definida y se ha autorizado su uso, tiene prioridad sobre el OAuth de suscripción. Comprueba el método activo en /status.

¿Dónde puedo ver los cargos exactos de la API?

En Claude Console. La sección Session de /usage es una estimación local y puede no coincidir con la factura real.

Siguiente paso: acceso API para Claude Code

Si elegiste un presupuesto de API independiente y tu propia clave para Claude Code, consulta la página de API para Claude Code. Es una integración de la API de BetterToken, no una suscripción de Claude; revisa los campos y límites actuales antes de configurarla.