Este artículo se aplica a consumidores individuales que utilizan suscripciones a planes Pro, Max o Ultra para acceder a Claude Code. Si eres miembro de una organización con plan Team o Enterprise, consulta Usa Claude Code con tu plan Team o Enterprise.
¿Qué es Claude Code?
Claude Code es una herramienta de codificación que te da acceso a los modelos de Claude directamente en tu terminal o IDE compatible, permitiéndote delegar tareas de codificación complejas mientras mantienes transparencia y control. Con los planes Pro, Max y Ultra, ahora tienes acceso tanto a Claude en la web, aplicaciones de escritorio y móviles, como a Claude Code en tu terminal con una única suscripción unificada.
¿Por qué usar Claude y Claude Code?
Usa dos productos de IA poderosos en una suscripción simple.
Usa Claude para escribir, investigar, analizar y más, en el trabajo y en casa.
Usa Claude Code para tus flujos de trabajo de codificación basados en terminal.
Cómo conectar Claude Code a tu plan Pro, Max o Ultra
Asegúrate de tener una suscripción activa a un plan Pro, Max o Ultra
Si aún no estás suscrito, actualiza en claude.ai/upgrade
Instala Claude Code
Visita la página de Claude Code en nuestra documentación de Claude para descargar e instalar Claude Code.
Sigue las instrucciones de instalación para tu sistema operativo.
Auténticate con tus credenciales de Claude
Cuando se te solicite durante la configuración o el primer uso, inicia sesión con las mismas credenciales que usas para Claude.
Esto conectará tu suscripción a un plan Pro, Max o Ultra a Claude Code.
Si ya has iniciado sesión en Claude Code a través de Claude Console PAYG, ejecuta /login desde Claude Code para cambiar a tu plan de suscripción.
¿Tienes problemas para usar tu plan Pro, Max o Ultra para acceder a Claude Code?
Si no ves la opción para autenticarte con tu cuenta preferida, sigue estos pasos para actualizar Claude Code:
Cierra sesión completamente de tu sesión activa usando el comando /logout.
Ejecuta claude update.
Reinicia tu terminal completamente para que el cambio surta efecto.
Ejecuta claude y selecciona la cuenta correcta para usar Claude Code.
Importante: Si tienes una variable de entorno ANTHROPIC_API_KEY configurada en tu sistema, Claude Code usará esta clave de API para la autenticación en lugar de tu suscripción a Claude (planes Pro, Max, Ultra, Team o Enterprise), lo que resultará en cargos por uso de API en lugar de usar el uso incluido en tu suscripción. Consulta este artículo para más información: Gestión de variables de entorno de clave de API en Claude Code.
Usa Claude Code en tu IDE
Tu plan Pro, Max o Ultra también cubre Claude Code en IDEs compatibles, incluyendo VS Code, Cursor y otros forks de VS Code, e IDEs de JetBrains como IntelliJ y PyCharm. Inicia sesión con las mismas credenciales de Claude que usas en la terminal. El uso en IDE cuenta hacia los mismos límites de uso compartidos entre Claude y Claude Code.
Para instalar y configurar la extensión para tu IDE, consulta Plataformas e integraciones en nuestra documentación de Claude Code.
Qué sucede cuando alcanzas los límites de uso
Los planes Pro y Max tienen un límite de sesión de cinco horas y un límite semanal. Los planes Ultra tienen un límite semanal, y las cuentas Ultra verificadas no tienen un límite de sesión de cinco horas. Más información.
Los planes Max y Ultra también tienen un límite semanal separado para Fable. Estos límites se comparten entre Claude y Claude Code, lo que significa que toda la actividad en ambas herramientas cuenta contra los mismos límites. Para ayudarte a monitorear tu uso, verás mensajes de advertencia a medida que te acercas a cualquier límite.
Si alcanzas tu límite de sesión de cinco horas mientras Claude Code está a mitad de una respuesta, puede seguir funcionando brevemente para poder terminar el paso en progreso en lugar de detenerse a mitad del paso. Mientras esto sucede, verás "Límite de uso alcanzado · finalizando" en Claude Code. Esta asignación de finalización es pequeña y limitada, y el uso cuenta hacia tu límite semanal. Se aplica solo a una respuesta que ya está en progreso, no a un nuevo mensaje que envíes después de alcanzar tu límite.
En el plan Pro, se aplica hasta una vez por período de uso semanal. En el plan Max, puede aplicarse cada vez que alcances un límite de sesión de cinco horas, dentro de tu límite semanal. Las cuentas Ultra verificadas no tienen un límite de cinco horas, por lo que la asignación de finalización no se aplica. Si tu cuenta Ultra tiene un límite temporal, la asignación de finalización funciona de la misma manera que en el plan Max hasta que se elimine el límite.
Se está implementando gradualmente, por lo que es posible que aún no esté disponible en tu cuenta. Más información sobre la asignación de finalización de Claude Code.
Cuando alcanzas tus límites de uso, puedes seleccionar entre varias opciones según tus necesidades:
Usuarios del plan Pro
Considera actualizar al plan Max si constantemente alcanzas límites y necesitas más capacidad para repositorios más grandes.
Habilita créditos de uso para seguir usando Claude con tu plan Pro después de alcanzar tu límite de sesión de cinco horas o tu límite semanal.
Cambia a una cuenta de Claude Console y compra créditos de uso de API para sprints de codificación intensivos.
Espera a que se restablezcan tus límites de uso.
Usuarios del plan Max
Considera actualizar al plan Ultra si constantemente alcanzas límites.
Habilita créditos de uso para seguir usando Claude con tu plan Max después de alcanzar tu límite de sesión de cinco horas, tu límite semanal general o tu límite semanal separado para Fable.
Cambia a una cuenta de Claude Console y compra créditos de uso de API para sprints de codificación intensivos.
Los créditos de API mensuales incluidos con el plan Max no se pueden usar en Claude Code o en las aplicaciones de Claude, incluyendo para créditos de uso. Más información sobre créditos de API mensuales para planes Max, Ultra y Team.
Espera a que se restablezcan tus límites de uso.
Usuarios del plan Ultra
Habilita créditos de uso para seguir usando Claude con tu plan Ultra después de alcanzar tu límite semanal general o tu límite semanal separado para Fable.
Cambia a una cuenta de Claude Console y compra créditos de uso de API para sprints de codificación intensivos.
Los créditos de API mensuales incluidos con el plan Ultra no se pueden usar en Claude Code o en las aplicaciones de Claude, incluyendo para créditos de uso. Más información sobre créditos de API mensuales para planes Max, Ultra y Team.
Espera a que se restablezcan tus límites de uso.
Para más detalles sobre uso eficiente, consulta nuestras Mejores prácticas de límites de uso.
Facturación de Claude Code
Entendiendo dos sistemas distintos
Es importante reconocer que estos son sistemas separados:
Claude Code: Presenta opciones para continuar el uso a través de créditos de API.
Claude Console / Claude API: Contiene configuraciones opcionales de recarga automática para la gestión de créditos de API donde se encuentra tu terminal.
Eligiendo usar créditos de API
Si deseas usar créditos de API a través de Claude Code:
El uso se facturará a tasas estándar de API (distintas de los precios del plan Pro/Max/Ultra).
Si la recarga automática está habilitada en tu cuenta de Console, se agregarán automáticamente créditos adicionales cuando tu saldo sea bajo.
Manteniéndote dentro de tu plan
Para mantener el uso estrictamente dentro de tu asignación del plan Pro, Max o Ultra:
Rechaza la opción de crédito de API cuando se presente.
Permite que tu período de uso se restablezca antes de continuar usando Claude Code.
Monitorea tu asignación restante usando el comando /status.
Optar por no usar créditos de API para Claude Code
Si prefieres evitar que la opción de crédito de API aparezca completamente:
Ejecuta claude logout en tu terminal.
Ejecuta claude login y auténticate usando solo tus credenciales del plan Pro, Max o Ultra.
Evita agregar credenciales de Claude Console durante el proceso de inicio de sesión.
Esto asegura que Claude Code solo usará tu asignación de plan y no se te pedirá que uses créditos de API cuando alcances tus límites.
Gestión de configuraciones de recarga automática
La funcionalidad de recarga automática se gestiona dentro de tu cuenta de Claude Console, no a través de Claude Code:
Revisa tu configuración de facturación de Console para verificar el estado de la recarga automática.
Ajusta estas configuraciones en Console si prefieres evitar compras automáticas de créditos.
Recuerda, la recarga automática solo se aplica cuando has elegido usar créditos de API.
Resumen
Claude Code mantiene un control estricto del usuario sobre las decisiones de facturación.
La recarga automática es una característica independiente de Claude Console.
Para mantener tu presupuesto del plan Pro, Max o Ultra, simplemente rechaza las opciones de crédito de API cuando se ofrezcan.