Source: https://aiprimetech.io/es/learn/use-claude-api-with-claude-code/ [Inicio](/es/) / [Aprende](/es/learn/) / Acceso ilimitado a Claude Code # Acceso ilimitado a Claude Code Claude Code es el agente oficial de línea de comandos de Anthropic para el desarrollo de software. Funciona con una ventana de contexto de 200k, crea subagentes con sus propios contextos independientes, lee archivos completos y los incorpora al historial de conversación, y vuelve a enviar todo el contexto en cada turno, lo que genera un crecimiento cuadrático del consumo de tokens en sesiones largas. Esto lo convierte en una de las herramientas para desarrolladores que más tokens consumen. Conectar Claude Code a una pasarela de acceso ilimitado con tarifa plana lo transforma de una herramienta cuyo uso debe racionarse cuidadosamente en un verdadero colaborador de desarrollo siempre disponible. ## Por qué el consumo de tokens de Claude Code crece de forma cuadrática Desde la perspectiva de la API, Claude Code no conserva el estado entre turnos. Cada mensaje que envías incluye todo el historial de conversación: todos los mensajes anteriores, todo el contenido de los archivos leídos, todos los resultados de las herramientas y todas las respuestas del asistente. El primer mensaje puede tener 5,000 tokens. En el décimo intercambio, ya envías 50,000 tokens de historial más cualquier contenido nuevo que se haya añadido. En el vigésimo intercambio, el contexto puede superar los 150,000 tokens por solicitud. Los subagentes agravan esta situación. Cuando Claude Code delega trabajo a un subagente, este recibe su propia ventana de contexto y empieza a acumular su propio historial de forma independiente. El contexto del agente principal crece al incorporar el resumen del subagente, mientras que el propio subagente genera su propio gasto en tokens. Los equipos de agentes, en los que colaboran varios subagentes, multiplican aún más este consumo. Una tarea compleja puede tener un agente principal y tres subagentes, cada uno con más de 100k tokens de contexto, todos usando la misma clave de API. El comando /compact ayuda al resumir el historial y recortar el contexto antiguo, pero es una intervención manual que sacrifica detalle para ahorrar espacio. Con la facturación por token, los usuarios compactan compulsivamente para controlar los costes. Con el acceso ilimitado, puedes dejar que las conversaciones crezcan de forma natural, compactar solo cuando se deteriore la calidad del contexto y usar subagentes libremente sin hacer cálculos mentales sobre su coste. ## Configuración de variables de entorno Claude Code lee su configuración de API de las variables de entorno. Las dos variables esenciales son ANTHROPIC_BASE_URL y una de estas dos: ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN. Establece ANTHROPIC_BASE_URL en https://unlimited.aiprimetech.io, el host raíz sin /v1, porque el SDK de Anthropic añade la ruta de la API automáticamente. Para la clave, usa ANTHROPIC_API_KEY si tu pasarela requiere autenticación mediante la cabecera x-api-key, el formato estándar de Anthropic. Define estas variables en el perfil de tu shell (.bashrc, .zshrc o $PROFILE de PowerShell) para que la configuración sea persistente. En Windows, también puedes definirlas como variables de entorno del sistema mediante el cuadro de diálogo Configuración avanzada del sistema. Claude Code las lee al iniciarse: si las cambias, reinicia la sesión de Claude Code para que los nuevos valores surtan efecto. Para sobrescribir la configuración por proyecto, crea un archivo .env en la raíz de tu proyecto. Claude Code carga los archivos .env del directorio de trabajo. Esto te permite usar distintas configuraciones de API para cada proyecto, algo útil si tienes algunos proyectos con acceso ilimitado y otros con facturación directa de Anthropic. El archivo .env tiene prioridad sobre las variables de entorno del sistema. ## Asignación de modelos para Sonnet, Opus, Haiku y Fable Claude Code usa alias internos de modelos que puedes sobrescribir mediante variables de entorno. ANTHROPIC_DEFAULT_SONNET_MODEL controla qué modelo se usa para la selección predeterminada 'sonnet'. ANTHROPIC_DEFAULT_OPUS_MODEL sobrescribe la opción 'opus'. ANTHROPIC_DEFAULT_HAIKU_MODEL y ANTHROPIC_DEFAULT_FABLE_MODEL controlan los niveles restantes. Establece estas variables con los identificadores exactos de los modelos que admite tu pasarela. Por ejemplo, establece ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 y ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.. Cuando seleccionas un nivel de modelo en Claude Code mediante /model o la opción de inicio, se utiliza el modelo que hayas asignado. Esto resulta especialmente útil si la pasarela ofrece identificadores de modelos personalizados o si quieres fijar versiones específicas de los modelos. Con el acceso ilimitado, la elección del modelo depende exclusivamente del equilibrio entre calidad y velocidad. No hay diferencia de coste entre niveles. Usa Opus como modelo predeterminado para obtener la máxima calidad y cambia a Sonnet o Haiku solo cuando necesites respuestas más rápidas durante iteraciones rápidas. El comando /effort permite ajustar aún más el grado de exhaustividad con el que Claude Code aborda cada tarea: combina un nivel de esfuerzo alto con Opus para obtener la configuración más capaz. ## Subagentes, equipos de agentes y agentes en segundo plano Claude Code puede crear subagentes: instancias independientes de Claude con sus propias ventanas de contexto que se encargan de subtareas delegadas. Cuando el agente principal se encuentra con una tarea compleja, puede delegar la investigación, la implementación o la verificación a subagentes que trabajan de forma aislada y le comunican los resultados. Cada subagente empieza con un contexto nuevo y acumula su propio historial de conversación. Los equipos de agentes amplían este concepto al permitir que varios subagentes colaboren simultáneamente en trabajos relacionados. El agente principal actúa como coordinador, distribuye el trabajo y sintetiza los resultados. Esto resulta extremadamente potente para cambios a gran escala: un subagente puede refactorizar el módulo A mientras otro se encarga del módulo B, pero el consumo de la API crece de forma lineal con el número de agentes activos. Los agentes en segundo plano se ejecutan de forma asíncrona mientras continúas trabajando en la sesión principal. Se ocupan de tareas independientes y comunican los resultados al terminar. Con la facturación por token, ejecutar varios agentes en segundo plano simultáneamente se vuelve caro rápidamente. Con el acceso ilimitado, puedes iniciar varios agentes en segundo plano, dejar que trabajen en distintos aspectos de tu proyecto y revisar sus resultados cuando estén listos, todo cubierto por la tarifa plana. Establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 para impedir que Claude Code envíe telemetría y solicitudes no esenciales. Esta es una buena práctica con cualquier pasarela personalizada para reducir el ruido. Además, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 indica a Claude Code que consulte a la pasarela los modelos disponibles en lugar de usar listas codificadas de forma fija. ## Modo sin interfaz interactiva e integración con CI/CD El modo sin interfaz interactiva de Claude Code (opción --headless) se ejecuta sin solicitudes de entrada interactivas, lo que lo hace adecuado para flujos de CI/CD, revisión automatizada de código y procesamiento por lotes. En este modo, Claude Code lee la entrada de stdin o de los argumentos de la línea de comandos y escribe los resultados en stdout. Finaliza cuando se completa la tarea en lugar de esperar más entradas. Para la integración con CI, define las variables de entorno en la configuración de tu flujo (secretos de GitHub Actions, variables de GitLab CI o credenciales de Jenkins) e invoca Claude Code con la descripción de la tarea como argumento. Entre los casos de uso habituales en CI se encuentran la revisión automatizada de PR, la generación de documentación, la creación de pruebas y los scripts de migración. Con el acceso ilimitado, el modo sin interfaz interactiva permite flujos de trabajo de alto rendimiento. Puedes ejecutar Claude Code en cada PR de un repositorio, generar por lotes conjuntos de pruebas para módulos sin pruebas o automatizar las actualizaciones de documentación en cada versión, sin preocuparte por el coste de cada invocación. La tarifa plana cubre todo el volumen siempre que se mantenga dentro de los límites de frecuencia de uso razonable. ## Memoria del proyecto en CLAUDE.md y hooks Los archivos CLAUDE.md proporcionan un contexto persistente del proyecto que Claude Code carga automáticamente. Coloca un archivo CLAUDE.md en la raíz de tu proyecto con estándares de código, decisiones de arquitectura, patrones comunes e instrucciones específicas del proyecto. Este contenido se incluye en el mensaje de sistema de cada solicitud, lo que añade tokens a cada llamada, pero mejora considerablemente la calidad y la coherencia de las respuestas. Con la facturación por token, los usuarios mantienen CLAUDE.md al mínimo para controlar los costes: cada palabra añade tokens a todas y cada una de las solicitudes durante toda la sesión. Con el acceso ilimitado, escribe todo el contexto que realmente resulte útil: documentación detallada de la arquitectura, guías de estilo completas, explicaciones de las dependencias y convenciones del equipo. Los tokens adicionales por solicitud no cuestan nada más y la mejora de calidad se acumula con cada interacción. Los hooks te permiten ejecutar scripts personalizados en puntos específicos de la ejecución de Claude Code: antes y después de las llamadas a herramientas, al iniciar la sesión y al compactar. Usa hooks para incorporar contexto dinámico, validar cambios mediante CI, dar formato al código automáticamente o activar notificaciones. Los hooks se integran sin problemas con la pasarela de acceso ilimitado, ya que funcionan a nivel de CLI en lugar de a nivel de API. ## Solución de problemas de Claude Code con la pasarela Si Claude Code no puede conectarse, comprueba que ANTHROPIC_BASE_URL esté establecido en el host raíz sin /v1. Ejecuta echo $ANTHROPIC_BASE_URL (o $env:ANTHROPIC_BASE_URL en PowerShell) para confirmar el valor. El SDK añade /v1/messages automáticamente: si incluyes /v1 en la URL base, las solicitudes se envían a /v1/v1/messages, que devuelve un 404. Los errores de modelo no encontrado significan que el identificador del modelo en tu variable de asignación no coincide con los que ofrece la pasarela. Consulta los identificadores exactos admitidos en tu panel de AI Prime Tech y actualiza ANTHROPIC_DEFAULT_SONNET_MODEL en consecuencia. Recuerda que los identificadores de modelos distinguen entre mayúsculas y minúsculas e incluyen sufijos de versión. Si las sesiones funcionan, pero los subagentes fallan, el problema puede deberse a que los subagentes heredan las variables de entorno de forma distinta según cómo se inicien. Asegúrate de que las variables de entorno estén definidas a nivel del sistema y no solo en la sesión actual del intérprete de comandos, especialmente en Windows, donde los procesos secundarios pueden no heredar las variables locales del intérprete. Copiar ``` # Shell environment (add to .bashrc / .zshrc / $PROFILE) export ANTHROPIC_BASE_URL="https://aiprimetech.io" export ANTHROPIC_API_KEY="" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6" export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 # Or per-project .env file: # ANTHROPIC_BASE_URL=https://aiprimetech.io # ANTHROPIC_API_KEY=sk-... # ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 # Run Claude Code: # claude (interactive) # claude --headless (CI/CD mode) ``` ## Preguntas frecuentes ¿Por qué Claude Code usa muchos más tokens que el chat? Claude Code reenvía todo el historial de la conversación en cada turno: la API no conserva el estado. A medida que crece la sesión, cada solicitud incluye todos los mensajes anteriores, el contenido de los archivos y los resultados de las herramientas. Esto genera un crecimiento cuadrático de los tokens, por lo que el vigésimo mensaje de una sesión puede ser 10-20x más grande que el primero. ¿Los subagentes se contabilizan por separado en mi consumo? Cada subagente mantiene su propia conversación independiente con su propia ventana de contexto. En el plan ilimitado, todas las conversaciones de los agentes —el principal, los subagentes y los agentes en segundo plano— están cubiertas por la tarifa fija. No hay recargos por agente ni por conversación. ¿Debo incluir /v1 en ANTHROPIC_BASE_URL? No. Usa el host raíz: https://unlimited.aiprimetech.io. El SDK de Anthropic añade /v1/messages automáticamente. Incluir /v1 en la variable duplica la ruta y provoca errores 404. ¿Puedo usar el modo sin interfaz de Claude Code en CI/CD con el plan ilimitado? Sí. Define ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY en los secretos de tu pipeline y ejecuta claude --headless con los argumentos de la tarea. El plan ilimitado cubre el uso en CI con la misma tarifa fija, sujeto a límites de frecuencia de uso razonable. ¿Cómo cambio de modelo en Claude Code? Usa el comando /model durante una sesión o define las variables de entorno ANTHROPIC_DEFAULT_SONNET_MODEL y ANTHROPIC_DEFAULT_OPUS_MODEL para controlar qué modelos se usan en cada nivel. En el plan ilimitado no hay diferencias de coste entre modelos. Empieza a usar Claude en minutos Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.[Obtén tu clave de API](/register) AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios. ## Más guías de la API de Claude [Cómo obtener una clave de API de Claude](/es/learn/how-to-get-a-claude-api-key/)[Precios de la API de Claude, explicados](/es/learn/claude-api-pricing-explained/)[La forma más económica de usar la API de Claude](/es/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado con la API de Claude](/es/learn/unlimited-cursor-claude-api/)[Gateway de la API de Claude frente al acceso directo a Anthropic](/es/learn/claude-api-vs-anthropic-direct/)[Usar Claude a través de una API compatible con OpenAI](/es/learn/openai-compatible-claude-api/)[Comparativa de modelos de Claude](/es/learn/claude-api-models-compared/)[Pagar la API de Claude con criptomonedas](/es/learn/claude-api-with-crypto-payment/)[Acceso a la API de Claude sin lista de espera](/es/learn/claude-api-without-waitlist/)[Cómo reducir el uso de tokens de Claude](/es/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado con la API de Claude](/es/learn/use-claude-api-with-cline/)[Roo Code ilimitado con la API de Claude](/es/learn/use-claude-api-with-roo-code/)[Claude ilimitado en los IDE de JetBrains](/es/learn/use-claude-api-with-jetbrains/)[Aider sin límites con la API de Claude](/es/learn/use-claude-api-with-aider/)[Claude ilimitado en VS Code](/es/learn/use-claude-api-with-vscode/)[OpenCode sin límites con la API de Claude](/es/learn/use-claude-api-with-opencode/)[Ejecutar un agente Hermes sin límites con Claude](/es/learn/run-hermes-agent-with-claude-api/)[Ejecutar OpenClaw sin límites con Claude](/es/learn/run-openclaw-with-claude-api/)[Qué significa una API compatible con Anthropic](/es/learn/anthropic-compatible-api/)[Clave de API de Claude Code: cómo obtenerla y configurarla](/es/learn/claude-code-api-key-setup/)[Costes de la API de Claude Code: precios y cómo reducirlos](/es/learn/claude-code-api-costs/)[Errores de la API de Claude: límites de solicitudes y soluciones para 400, 500 y 529](/es/learn/claude-api-errors-troubleshooting/)[Cómo comprar créditos para la API de Claude](/es/learn/buy-claude-api-credits/)[Prueba gratuita de la API de Claude: qué es realmente gratis y qué no](/es/learn/claude-api-free-trial/)[API de Claude frente a la suscripción Claude Pro/Max: cuál elegir](/es/learn/claude-api-vs-subscription/)[Ejecutar la CLI de Codex con Claude](/es/learn/use-claude-api-with-codex/)[Conectar Claude a n8n](/es/learn/use-claude-api-with-n8n/)[Enrutar LiteLLM a Claude](/es/learn/use-claude-api-with-litellm/)[Usar Claude en Kilo Code](/es/learn/use-claude-api-with-kilo-code/)[Integra Claude en GitHub Copilot](/es/learn/use-claude-api-with-github-copilot/)[Conecta Zed a Claude a través de la pasarela](/es/learn/use-claude-api-with-zed/)[Conecta Cherry Studio a Claude](/es/learn/use-claude-api-with-cherry-studio/)[Configura LangChain para usar Claude en la pasarela](/es/learn/use-claude-api-with-langchain/)[Ejecuta Factory Droid con Claude](/es/learn/use-claude-api-with-factory-droid/)[La API de Claude Code, explicada](/es/learn/claude-code-api/)[Integración de la API de Claude en tu aplicación](/es/learn/claude-api-integration/)