DEV Community

Cover image for Cómo instalar y usar la CLI de Context7
Roobia
Roobia

Posted on • Originally published at apidog.com

Cómo instalar y usar la CLI de Context7

#ai #productivity #cli #tutorial

Context7

Context7 es una plataforma que inyecta documentación siempre actualizada de librerías directamente en el contexto de tu asistente de codificación con IA. Así, tu código generado no depende de datos de entrenamiento obsoletos. La CLI (ctx7) se ejecuta con npx ctx7 (no requiere instalación) y conecta a Claude Code, Cursor u OpenCode con un solo comando: ctx7 setup.

Prueba Apidog hoy

¿Qué es Context7 y por qué te conviene usarlo?

Si alguna vez tu asistente de IA te ha generado código con APIs inexistentes o firmas de funciones equivocadas, sabes lo frustrante que es depender de documentación desactualizada. Los LLMs no conocen los cambios recientes; por ejemplo, no saben que Next.js 15 rediseñó los layouts o que una librería deprecó su API tras su entrenamiento.

Context7 soluciona este problema. Es una plataforma de Upstash que indexa documentación de más de 9.000 librerías y la entrega a tu agente IA en tiempo real. Al hacer una consulta, Context7 obtiene la documentación específica de la versión y la inserta en la ventana de contexto antes de que el modelo responda.

Resultado: tu herramienta IA deja de "alucinar" APIs y produce código alineado con la librería real.

La CLI ctx7 es la interfaz principal. Permite:

  1. Obtener documentación de librerías en tu terminal.
  2. Gestionar habilidades de codificación IA (prompts especialistas que mejoran tu agente).
  3. Configurar el servidor MCP de Context7 para Claude Code, Cursor u OpenCode.

💡 Si trabajas con integraciones de API, Apidog se encarga de las pruebas de API: cliente gratuito para enviar, organizar y automatizar requests. Context7 mantiene tu IA actualizada y Apidog verifica tus llamadas de API.

Instalando ctx7

Solo necesitas Node.js 18+. Verifica tu versión:

node --version
Enter fullscreen mode Exit fullscreen mode

Ejecutar sin instalar

Para probar ctx7 rápidamente:

npx ctx7 --help
npx ctx7 library react
Enter fullscreen mode Exit fullscreen mode

Esto descarga la última versión cada vez. Ideal para uso ocasional.

Instalar globalmente

Para uso frecuente, instala globalmente:

npm install -g ctx7
ctx7 --version
Enter fullscreen mode Exit fullscreen mode

Así, cada comando ctx7 se ejecuta localmente y más rápido.

Configura Context7 para tu agente de IA

El comando ctx7 setup conecta Context7 a tu entorno IA. Usa OAuth, genera tu API key y escribe la configuración donde corresponde.

Configuración interactiva 

ctx7 setup
Enter fullscreen mode Exit fullscreen mode

Elegirás agente y modo (CLI + Skills o MCP). Para instalar sin prompts:

ctx7 setup --yes
Enter fullscreen mode Exit fullscreen mode

Elegir agente específico 

ctx7 setup --claude   # Claude Code (~/.claude/skills o MCP)
ctx7 setup --cursor   # Cursor (~/.cursor/skills o MCP)
ctx7 setup --opencode # OpenCode
Enter fullscreen mode Exit fullscreen mode

Usar una API key existente

Si ya tienes tu clave en context7.com/dashboard:

ctx7 setup --api-key TU_CLAVE_API
Enter fullscreen mode Exit fullscreen mode

Configuración por proyecto vs global

Por defecto, es global. Para solo el proyecto:

ctx7 setup --project
Enter fullscreen mode Exit fullscreen mode

Modos: CLI + Skills vs MCP

CLI + Skills instala un archivo SKILL.md que instruye a tu agente IA a usar comandos de la CLI de ctx7. El agente ejecuta ctx7 library y ctx7 docs cuando necesita documentación. No necesita servidor MCP.

ctx7 setup --cli --claude
ctx7 setup --cli --cursor
ctx7 setup --cli --universal
Enter fullscreen mode Exit fullscreen mode

Modo Servidor MCP: Context7 actúa como servidor del Protocolo de Contexto de Modelo. El agente llama a resolve-library-id y query-docs sin comandos CLI; todo es transparente.

Configura MCP así (ejemplo):

{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "CONTEXT7_API_KEY": "TU_CLAVE_API"
  }
}
Enter fullscreen mode Exit fullscreen mode

O agrega a Claude Code vía CLI:

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key TU_CLAVE_API
Enter fullscreen mode Exit fullscreen mode

Autenticación 

ctx7 login   # Login OAuth en navegador
ctx7 whoami  # Ver usuario actual
ctx7 logout  # Elimina credenciales
Enter fullscreen mode Exit fullscreen mode

También puedes usar variable de entorno:

export CONTEXT7_API_KEY=tu_clave_aqui
Enter fullscreen mode Exit fullscreen mode

El login solo es necesario para generación de skills y flujos avanzados. Consultas básicas de documentación funcionan sin él.

Telemetría

Desactiva la telemetría anónima así:

export CTX7_TELEMETRY_DISABLED=1
Enter fullscreen mode Exit fullscreen mode

Obtener documentación de librerías desde la terminal

Incluso sin un agente IA, ctx7 es útil como buscador de documentación.

Resolver el nombre de una librería 

ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json
Enter fullscreen mode Exit fullscreen mode

Devuelve el ID canónico, metadatos, recuento de fragmentos, reputación y versión.

Ejemplo de salida:

Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0
Enter fullscreen mode Exit fullscreen mode

Obtener documentación

Con el ID de librería, ejecuta:

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
Enter fullscreen mode Exit fullscreen mode

Recibirás fragmentos relevantes de la documentación actual. Puedes canalizar la salida a archivos o herramientas.

Si ya sabes el ID, puedes saltarte ctx7 library e ir directo a ctx7 docs.

Gestiona habilidades de codificación con IA

Las skills son archivos SKILL.md que otorgan a tu agente IA conocimiento o instrucciones especializadas. Context7 tiene un registro de skills de la comunidad, puedes buscarlas, instalarlas, generarlas o eliminarlas.

Buscar skills 

ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Enter fullscreen mode Exit fullscreen mode

Instalar una skill 

ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude
Enter fullscreen mode Exit fullscreen mode

Instalación global:

ctx7 skills install /anthropics/skills pdf --global
Enter fullscreen mode Exit fullscreen mode

Sugerencias basadas en tu proyecto

ctx7 skills suggest analiza tu proyecto y recomienda skills relevantes:

ctx7 skills suggest
Enter fullscreen mode Exit fullscreen mode

Listar skills instaladas 

ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
Enter fullscreen mode Exit fullscreen mode

Eliminar una skill 

ctx7 skills remove pdf
Enter fullscreen mode Exit fullscreen mode

Generar una skill personalizada con IA

Con cuenta pagada puedes generar skills personalizadas de cualquier librería:

ctx7 login
ctx7 skills generate
Enter fullscreen mode Exit fullscreen mode

La CLI te guía: eliges la librería, describes lo que quieres y Context7 genera el archivo SKILL.md actualizado.

Las skills generadas son portátiles: formato estándar Agent Skills, por lo que funcionan en Claude Code, Cursor, VS Code Copilot, OpenCode y más.

Cuentas gratuitas: 6 skills/semana.

Pro: 10/semana.

Alias abreviados:

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

Con Context7 listo, hay varias formas de integrarlo en tu flujo de codificación.

Patrón "use context7"

En modo MCP, añade "use context7" a cualquier prompt:

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
Enter fullscreen mode Exit fullscreen mode 
Configura un esquema Prisma con modelos de usuario y publicación y una relación uno a muchos. use context7
Enter fullscreen mode Exit fullscreen mode 
¿Como configuro el diseño del App Router en Next.js 15? use context7
Enter fullscreen mode Exit fullscreen mode

El agente invoca automáticamente las herramientas de Context7 y usa la documentación actual para responder.

Referenciar una librería específica

Si tu prompt involucra varias librerías:

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.
Enter fullscreen mode Exit fullscreen mode

Así, Context7 va directo a la documentación relevante.

Auto-invocación sin escribir "use context7"

Agrega una regla a tu agente IA para obtener documentación siempre que toque librerías.

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.
Enter fullscreen mode Exit fullscreen mode

En Cursor, en Configuración > Reglas 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.
Enter fullscreen mode Exit fullscreen mode

Combínalo con Apidog para validación total de APIs

Context7 mantiene actualizado el conocimiento de tu asistente IA sobre librerías. Pero para integraciones de API, necesitas comprobar que tus llamadas HTTP funcionan.

Apidog lo cubre: cliente de API gratuito para enviar requests, inspeccionar respuestas, configurar entornos y automatizar pruebas.

Ejemplo de flujo real:

  • Construyes una app Next.js que llama a una API de terceros.

    Context7 da la documentación actual de Next.js a tu IA. Apidog te permite probar la API de terceros, verificar respuestas y asegurar que las payloads sean correctas.

  • Integras una nueva librería con API HTTP propia.

    Context7 entrega la documentación actual del SDK. Apidog te permite probar los endpoints en bruto antes de codificar.

  • Depuras una integración.

    Envía la request exacta que genera tu código en Apidog, revisa la respuesta cruda y aísla el problema.

Configura ambientes y variables en Apidog, alterna entre dev/prod y ejecuta aserciones en cada respuesta. Context7 + Apidog = documentación al día y APIs verificadas.

Precios y límites de tasa

La CLI de ctx7 es gratuita. Los límites y funciones dependen de tu plan 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 analizar)
Empresarial Personalizado 5.000/asiento Personalizado Sí (25 $/1M tokens)

Notas del nivel gratuito:

  • Al llegar al tope mensual, recibes 20 llamadas API extra por día hasta el siguiente mes.
  • Repos privados requieren plan Pro o superior.
  • Generación de skills: 6/semana (Gratuito), 10/semana (Pro).
  • Pro: máximo 20 miembros.

Limitación importante: Context7 funciona solo online (consulta vía servidores de Upstash). Sin internet, no operará. La documentación puede ocupar mucho espacio en la ventana de contexto del LLM en proyectos complejos.

Consigue tu clave API gratuita en context7.com/dashboard. La clave eleva tus límites de tasa.

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. Tu código y datos sensibles no salen de tu entorno.

¿Qué librerías soporta Context7?

Más de 9.000 librerías y frameworks. Busca en context7.com para ver si tu librería está disponible. Puedes sugerir nuevas vía /add-library en la plataforma.

¿Qué tan actualizada está la documentación?

Las librerías se reindexan periódicamente. Las versiones muy recientes pueden tardar días en aparecer. Para librerías estables, suele estar al día.

¿Funciona sin API key?

Sí, pero con límites de tasa bajos. Para uso regular, regístrate y configura CONTEXT7_API_KEY.

¿Qué editores y agentes soporta?

Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop y cualquier cliente compatible con MCP o Agent Skills.

¿Diferencia entre modo CLI + Skills y MCP?

En CLI + Skills, el agente ejecuta comandos ctx7 explícitos cuando necesita docs. En MCP, el agente llama a Context7 nativamente, sin prompts explícitos.

¿Puedo usar ctx7 sin agente IA?

Sí. ctx7 library y ctx7 docs funcionan como comandos independientes de terminal.

Recursos adicionales

Top comments (0)