Context7
Context7 es una plataforma que inyecta documentación actualizada de librerías directamente en el contexto de tu asistente de codificación con IA, para que deje de generar código basado en datos de entrenamiento obsoletos. La CLI (ctx7) se ejecuta con npx ctx7 (no requiere instalación) y se conecta a Claude Code, Cursor u OpenCode con un solo comando ctx7 setup.
¿Qué es Context7 y por qué es importante?
Aquí tienes un problema con el que se ha encontrado todo desarrollador que utiliza herramientas de codificación con IA: le pides a tu asistente que escriba código utilizando una librería que conoces bien, y te da algo que parece correcto, pero que utiliza APIs que ya no existen. Las firmas de las funciones son incorrectas. Las rutas de importación cambiaron hace dos versiones principales. El ejemplo funciona en la documentación de la versión 12, pero tú estás en la versión 15.
Esto ocurre porque los LLM son entrenados con datos con una fecha de corte. No saben lo que cambió el mes pasado. No saben que Next.js 15 rediseñó cómo funcionan los diseños (layouts), o que una librería en la que confías ha deprecado la mitad de su superficie API desde la instantánea de entrenamiento.
Context7 resuelve esto. Es una plataforma creada por Upstash que indexa la documentación de más de 9.000 librerías y la sirve a tu asistente de IA en tiempo real. Cuando le haces una pregunta a tu agente de codificación, Context7 obtiene la documentación actual y específica de la versión, y la coloca en la ventana de contexto antes de que el modelo genere su respuesta.
El resultado: tu herramienta de codificación con IA deja de "alucinar" APIs y comienza a producir código que coincide con lo que la librería realmente hace hoy.
La CLI de ctx7 es la interfaz de línea de comandos para Context7. Hace tres cosas:
- Obtener la documentación de la librería directamente en tu terminal
- Gestionar habilidades de codificación con IA (archivos de prompts reutilizables que mejoran tu agente)
- Configurar el servidor MCP de Context7 para Claude Code, Cursor u OpenCode
Instalando ctx7
El único requisito es Node.js 18 o posterior. Comprueba tu versión con node --version.
Ejecutar sin instalar
La forma más rápida de probar ctx7 es con npx:
npx ctx7 --help
npx ctx7 library react
Esto descarga la última versión cada vez que lo ejecutas. Suficiente para un uso ocasional.
Instalar globalmente
Para un uso regular, instala globalmente:
npm install -g ctx7
ctx7 --version
Después de eso, cada comando ctx7 se ejecuta localmente sin la sobrecarga de npx.
Configurando Context7 para tu agente de codificación con IA
El comando ctx7 setup conecta Context7 a tu entorno de codificación con IA. Se autentica a través de OAuth, genera una clave API y escribe la configuración en el lugar correcto.
Configuración interactiva
ctx7 setup
Esto te pedirá que elijas tu agente y tu modo preferido (CLI + Habilidades vs. MCP). Si quieres omitir las indicaciones:
ctx7 setup --yes
Dirigirse a un agente específico
ctx7 setup --claude # Claude Code (~/.claude/skills o configuración MCP)
ctx7 setup --cursor # Cursor (~/.cursor/skills o configuración MCP)
ctx7 setup --opencode # OpenCode
Usar una clave API existente
Si ya tienes una clave API de Context7 de context7.com/dashboard:
ctx7 setup --api-key TU_CLAVE_API
Configuración a nivel de proyecto vs. global
Por defecto, ctx7 setup se instala globalmente. Para configurarlo solo para el proyecto actual:
ctx7 setup --project
Dos modos: CLI + Habilidades vs. MCP
El modo CLI + Habilidades instala un archivo SKILL.md que le dice a tu agente de IA que obtenga la documentación ejecutando comandos de la CLI de ctx7. Tu agente lee las instrucciones de la habilidad y ejecuta autónomamente ctx7 library y ctx7 docs cuando necesita documentación de librerías. No se requiere servidor MCP.
ctx7 setup --cli --claude # Instala la habilidad en ~/.claude/skills
ctx7 setup --cli --cursor # Instala la habilidad en ~/.cursor/skills
ctx7 setup --cli --universal # Instala en ~/.config/agents/skills
El modo Servidor MCP registra Context7 como un servidor de Protocolo de Contexto de Modelo. Tu agente llama a las herramientas resolve-library-id y query-docs de forma nativa sin ejecutar ningún comando CLI. La obtención de documentación es invisible.
Para el modo MCP, la configuración se ve así (añade esto a la configuración MCP de tu editor):
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "TU_CLAVE_API"
}
}
O añádelo a Claude Code a través de la CLI:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key TU_CLAVE_API
Autenticación
ctx7 login # Inicio de sesión OAuth en el navegador
ctx7 whoami # Confirma con qué usuario has iniciado sesión
ctx7 logout # Elimina las credenciales almacenadas
También puedes establecer la clave API como una variable de entorno:
export CONTEXT7_API_KEY=tu_clave_aqui
El inicio de sesión solo es necesario para la generación de habilidades y ciertos flujos de configuración. Las búsquedas básicas de documentación funcionan sin él.
Telemetría
Context7 recopila datos de uso anónimos por defecto. Desactívalo:
export CTX7_TELEMETRY_DISABLED=1
Obtener documentación de librerías desde la terminal
Incluso sin un agente de IA involucrado, ctx7 es útil como herramienta independiente de búsqueda de documentación. Dos comandos hacen el trabajo pesado.
Resolver un nombre de librería
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json # Salida JSON
Esto busca en el índice de Context7 y devuelve el ID canónico de la librería, junto con metadatos: recuento de fragmentos, reputación de la fuente, puntuaciones de referencia e identificadores de versión.
Ejemplo de salida para ctx7 library nextjs:
Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0
Obtener documentación
Una vez que tengas un ID de librería, pásalo a ctx7 docs junto con una consulta de tema:
ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
ctx7 docs /facebook/react "hooks" --json
La salida son fragmentos de documentación relevantes para tu consulta, obtenidos de la versión actual de la librería. Puedes canalizar esta salida a un archivo o a otra herramienta.
Si ya conoces el ID de la librería, puedes omitir ctx7 library e ir directamente a ctx7 docs.
Gestionar habilidades de codificación con IA
Las habilidades son archivos SKILL.md que le dan a tu agente de IA conocimiento o comportamiento especializado. Piensa en ellos como pequeños manuales de instrucciones que tu agente lee antes de abordar un tipo de tarea específica.
Context7 alberga un registro de habilidades aportadas por la comunidad. Puedes buscar en él, instalar habilidades en tu entorno de agente, generar habilidades personalizadas y eliminar las que no necesites.
Buscar habilidades
ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Instalar una habilidad
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor # Instalar específicamente para Cursor
ctx7 skills install /anthropics/skills pdf --claude # Instalar para Claude Code
Cuando instalas globalmente (--global), la habilidad está disponible en todos tus proyectos:
ctx7 skills install /anthropics/skills pdf --global
Obtener sugerencias basadas en tu proyecto
ctx7 skills suggest escanea el directorio de tu proyecto, detecta las librerías y frameworks que estás utilizando y recomienda habilidades relevantes:
ctx7 skills suggest
Esto funciona bien cuando inicias un nuevo proyecto y quieres "sembrar" tu agente con conocimiento relevante de antemano.
Listar habilidades instaladas
ctx7 skills list # Todas las habilidades instaladas
ctx7 skills list --claude # Solo habilidades instaladas para Claude Code
ctx7 skills list --cursor # Solo habilidades de Cursor
Eliminar una habilidad
ctx7 skills remove pdf
Generar una habilidad personalizada con IA
Esta es la característica más potente. Con una cuenta de pago, puedes generar una habilidad personalizada a partir de cualquier librería en el índice de Context7:
ctx7 login
ctx7 skills generate
La CLI te guía a través de un prompt interactivo: elige una librería, describe lo que quieres que la habilidad le enseñe a tu agente, y Context7 genera un archivo SKILL.md adaptado a la documentación actual de esa librería.
Las habilidades generadas son portátiles. El formato SKILL.md sigue el estándar Agent Skills, lo que significa que una habilidad que generas para Claude Code funciona sin cambios en Cursor, VS Code Copilot, OpenCode y cualquier otra herramienta compatible con Agent Skills.
Las cuentas gratuitas obtienen 6 generaciones de habilidades por semana. Las cuentas Pro obtienen 10.
Alias abreviados para una escritura más rápida:
| Comando completo | Alias |
|---|---|
ctx7 skills install | ctx7 si |
ctx7 skills search | ctx7 ss |
ctx7 skills generate | ctx7 skills gen o ctx7 skills g |
Usando Context7 en tus prompts de IA
Una vez que Context7 está configurado, tienes varias formas de usarlo en tu flujo de trabajo diario de codificación.
El patrón "use context7"
En el modo MCP, añade "use context7" a cualquier prompt donde quieras documentación actual:
Crea un middleware de Next.js que compruebe un JWT válido en las cookies y redirija
a los usuarios no autenticados a /login. use context7
Configura un esquema Prisma con modelos de usuario y publicación y una relación uno a muchos. use context7
¿Cómo configuro el diseño del App Router en Next.js 15? use context7
El agente llama automáticamente a las herramientas resolve-library-id y query-docs de Context7, obtiene la documentación actual y la utiliza para fundamentar su respuesta.
Referenciar una librería específica
Si tu prompt involucra varias librerías y quieres que Context7 se enfoque en una:
Implementa la autenticación de Supabase en una aplicación Next.js.
use library /supabase/supabase para Supabase y /vercel/next.js para el enrutamiento de Next.js.
Esto omite el paso de coincidencia de librerías y va directamente a la documentación.
Auto-invocación sin escribir "use context7"
Añade una regla a tu agente de IA para que obtenga la documentación automáticamente cada vez que toque código de librería. En Claude Code, añade a tu CLAUDE.md:
Utiliza siempre las herramientas MCP de Context7 al generar código que usa librerías de terceros.
Resuelve el ID de la librería y obtén la documentación actual antes de escribir cualquier implementación.
Haz esto sin esperar a que te lo pida.
En Cursor, añade a Configuración > Reglas para IA:
Al escribir código que utiliza librerías o frameworks externos, invoca siempre
Context7 para obtener la documentación actual antes de generar la implementación.
Combínalo con Apidog para una confianza total en las API
Context7 mantiene actualizado el conocimiento de las librerías de tu asistente de IA. Pero la documentación precisa es solo la mitad de la historia. Cuando estás construyendo una integración de API, también necesitas verificar que tus llamadas HTTP reales funcionen como esperas.
Apidog cubre eso. Es un cliente de API gratuito donde puedes enviar solicitudes, inspeccionar respuestas, configurar entornos y automatizar suites de prueba. Maneja todo, desde la exploración de endpoints ad-hoc hasta pruebas de integración repetibles.
Así es como se complementan en un flujo de trabajo real:
Estás construyendo una aplicación Next.js que llama a una API de terceros. Context7 le da a tu agente de IA la documentación actual de Next.js para que sus sugerencias de código sean correctas. Apidog te permite probar la API de terceros directamente, verificar la estructura de la respuesta y confirmar que las cargas útiles que envía tu código coinciden con lo que espera la API.
Estás integrando una nueva librería que tiene su propia API HTTP. Context7 le da a tu agente la documentación actual del SDK de la librería. Apidog te permite probar los endpoints de la API en bruto para entender el comportamiento a nivel HTTP antes de escribir cualquier código de aplicación.
Estás depurando una integración. Puedes enviar la solicitud exacta que tu código construye en Apidog, inspeccionar la respuesta en bruto y aislar si el problema está en la lógica de tu solicitud o en el comportamiento de la API.
Configura un entorno en Apidog con tus claves API almacenadas como variables, cambia entre desarrollo y producción con un solo clic y ejecuta aserciones de prueba en cada respuesta. Context7 + Apidog te brindan documentación actual y comportamiento verificado de la API.
Precios y límites de tasa
La CLI de ctx7 es de uso gratuito. Los límites de tasa y el acceso a las funciones dependen de tu plan de Context7:
| Plan | Precio | Llamadas API/mes | Límite de tasa | Repos privados |
|---|---|---|---|---|
| Gratuito | 0 $ | 1.000 | 60 solicitudes/hora | No |
| Pro | 7 $/asiento/mes | 5.000/asiento | 60/hora/asiento | Sí (15 $/1M tokens para analizar) |
| Empresarial | Personalizado | 5.000/asiento | Personalizado | Sí (25 $/1M tokens) |
Notas del nivel gratuito:
- Cuando alcanzas el límite mensual, obtienes 20 llamadas API adicionales por día hasta que se restablece el mes.
- El acceso a repositorios privados requiere un plan Pro o superior.
- Generación de habilidades: 6/semana en Gratuito, 10/semana en Pro.
- Pro soporta un máximo de 20 miembros.
Limitación importante: Context7 enruta todas las consultas a través de los servidores de Upstash. No hay modo offline. Si te encuentras en un entorno sin acceso a internet, la herramienta no funcionará. Las respuestas de la documentación también pueden ser grandes, lo que reduce la ventana de contexto de tu LLM. En proyectos complejos con muchas consultas de librerías, esto se acumula.
Obtén una clave API gratuita en context7.com/dashboard. La clave API te proporciona límites de tasa más altos que las solicitudes no autenticadas.
Preguntas frecuentes
¿Context7 envía mi código a sus servidores?
No. Solo el nombre de la librería y el texto de la consulta se envían a los servidores de Context7, no tu código, el historial de conversación ni ningún dato sensible. Tu base de código permanece con tu proveedor de LLM.
¿Qué librerías soporta Context7?
El índice cubre más de 9.000 librerías y frameworks públicos. Puedes buscar en el índice en context7.com para comprobar si una librería específica está disponible. Se pueden enviar nuevas librerías a través de /add-library en la interfaz de Context7.
¿Qué tan actualizada está la documentación?
Las librerías se reindexan periódicamente. Las versiones muy recientes (en los últimos días) pueden no estar disponibles todavía. Para librerías estables, la documentación suele estar actualizada con la última versión.
¿Funciona sin una clave API?
El uso básico funciona sin una clave API, pero con límites de tasa más bajos. Para un uso regular, regístrate en context7.com y configura CONTEXT7_API_KEY para obtener un mejor rendimiento.
¿Qué editores y agentes soporta?
Context7 funciona con Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop y cualquier otro cliente que admita MCP o el estándar Agent Skills.
¿Cuál es la diferencia entre el modo CLI + Habilidades y el modo MCP?
En el modo CLI + Habilidades, un archivo de habilidad le dice a tu agente que ejecute comandos ctx7 explícitamente cuando necesite documentación. En el modo MCP, tu agente llama a las herramientas de Context7 de forma nativa a través del protocolo MCP. El modo MCP es más transparente para el usuario y no requiere ningún prompt explícito "use context7" una vez configurado.
¿Puedo usar ctx7 sin un agente de codificación con IA?
Sí. ctx7 library y ctx7 docs funcionan como comandos de terminal independientes. Puedes buscar la documentación de la librería directamente sin la intervención de ningún agente de IA.