Context7 est une plateforme qui injecte la documentation de bibliothèque à jour directement dans le contexte de votre assistant de codage IA, afin qu'il cesse de générer du code basé sur des données d'entraînement obsolètes. L'interface en ligne de commande (CLI) (ctx7) s'exécute avec npx ctx7 (aucune installation requise) et se connecte à Claude Code, Cursor ou OpenCode avec une seule commande ctx7 setup.
Qu'est-ce que Context7 et pourquoi est-ce important ?
Voici un problème auquel chaque développeur utilisant des outils de codage IA a été confronté : vous demandez à votre assistant d'écrire du code en utilisant une bibliothèque que vous connaissez bien, et il vous donne quelque chose qui semble correct mais utilise des API qui n'existent plus. Les signatures de fonctions sont erronées. Les chemins d'importation ont changé il y a deux versions majeures. L'exemple fonctionne dans la documentation pour la version 12, mais vous êtes sur la version 15.
Cela se produit parce que les LLM sont entraînés sur des données avec une date de coupure. Ils ne savent pas ce qui a changé le mois dernier. Ils ne savent pas que Next.js 15 a remanié la façon dont les mises en page fonctionnent, ou qu'une bibliothèque sur laquelle vous comptez a déprécié la moitié de sa surface API depuis la capture d'entraînement.
Context7 résout ce problème. C'est une plateforme construite par Upstash qui indexe la documentation de plus de 9 000 bibliothèques et la fournit à votre assistant IA en temps réel. Lorsque vous posez une question à votre agent de codage, Context7 récupère la documentation actuelle et spécifique à la version et la place dans la fenêtre de contexte avant que le modèle ne génère sa réponse.
Le résultat : votre outil de codage IA cesse d'halluciner des API et commence à produire du code qui correspond à ce que la bibliothèque fait réellement aujourd'hui.
L'interface de ligne de commande (CLI) ctx7 est l'interface en ligne de commande pour Context7. Elle fait trois choses :
- Récupérer la documentation de bibliothèque directement dans votre terminal
- Gérer les compétences de codage IA (fichiers d'invite réutilisables qui améliorent votre agent)
- Configurer le serveur MCP Context7 pour Claude Code, Cursor ou OpenCode
Installation de ctx7
La seule exigence est Node.js 18 ou une version ultérieure. Vérifiez votre version avec node --version.
Exécuter sans installer
Le moyen le plus rapide d'essayer ctx7 est avec npx :
npx ctx7 --help
npx ctx7 library react
Cela télécharge la dernière version chaque fois que vous l'exécutez. Convient pour une utilisation occasionnelle.
Installer globalement
Pour une utilisation régulière, installez globalement :
npm install -g ctx7
ctx7 --version
Après cela, chaque commande ctx7 s'exécute localement sans la surcharge de npx.
Configuration de Context7 pour votre agent de codage IA
La commande ctx7 setup connecte Context7 à votre environnement de codage IA. Elle s'authentifie via OAuth, génère une clé API et écrit la configuration au bon endroit.
Configuration interactive
ctx7 setup
Cela vous invite à choisir votre agent et votre mode préféré (CLI + Compétences vs. MCP). Si vous souhaitez ignorer les invites :
ctx7 setup --yes
Cibler un agent spécifique
ctx7 setup --claude # Claude Code (~/.claude/skills ou config MCP)
ctx7 setup --cursor # Cursor (~/.cursor/skills ou config MCP)
ctx7 setup --opencode # OpenCode
Utiliser une clé API existante
Si vous avez déjà une clé API Context7 depuis context7.com/dashboard :
ctx7 setup --api-key VOTRE_CLE_API
Configuration au niveau du projet vs. globale
Par défaut, ctx7 setup s'installe globalement. Pour configurer uniquement pour le projet actuel :
ctx7 setup --project
Deux modes : CLI + Compétences vs. MCP
Le mode CLI + Compétences installe un fichier SKILL.md qui indique à votre agent IA de récupérer la documentation en exécutant des commandes CLI ctx7. Votre agent lit les instructions de compétence et exécute de manière autonome ctx7 library et ctx7 docs lorsqu'il a besoin de la documentation de bibliothèque. Aucun serveur MCP n'est requis.
ctx7 setup --cli --claude # Installe la compétence dans ~/.claude/skills
ctx7 setup --cli --cursor # Installe la compétence dans ~/.cursor/skills
ctx7 setup --cli --universal # Installe dans ~/.config/agents/skills
Le mode Serveur MCP enregistre Context7 comme serveur de Protocole de Contexte de Modèle. Votre agent appelle les outils resolve-library-id et query-docs nativement sans exécuter de commandes CLI. La récupération de la documentation est invisible.
Pour le mode MCP, la configuration ressemble à ceci (à ajouter aux paramètres MCP de votre éditeur) :
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "VOTRE_CLE_API"
}
}
Ou ajoutez-le à Claude Code via la CLI :
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key VOTRE_CLE_API
Authentification
ctx7 login # Connexion OAuth via le navigateur
ctx7 whoami # Confirmer votre identité
ctx7 logout # Supprimer les identifiants stockés
Vous pouvez également définir la clé API comme variable d'environnement :
export CONTEXT7_API_KEY=votre_clé_ici
La connexion n'est requise que pour la génération de compétences et certains flux de configuration. Les recherches de documentation de base fonctionnent sans.
Télémétrie
Context7 collecte des données d'utilisation anonymes par défaut. Pour le désactiver :
export CTX7_TELEMETRY_DISABLED=1
Récupérer la documentation de bibliothèque depuis le terminal
Même sans agent IA, ctx7 est utile comme outil autonome de recherche de documentation. Deux commandes effectuent le gros du travail.
Résoudre un nom de bibliothèque
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json # Sortie JSON
Ceci recherche l'index Context7 et renvoie l'ID canonique de la bibliothèque, ainsi que des métadonnées : nombre d'extraits, réputation de la source, scores de référence et identifiants de version.
Exemple de sortie pour ctx7 library nextjs :
Bibliothèque: /vercel/next.js
Extraits: 4,820
Réputation: élevée
Version: 15.2.0
Récupérer la documentation
Une fois que vous avez un ID de bibliothèque, passez-le à ctx7 docs avec une requête de sujet :
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 sortie est constituée d'extraits de documentation pertinents pour votre requête, extraits de la version actuelle de la bibliothèque. Vous pouvez rediriger cette sortie vers un fichier ou un autre outil.
Si vous connaissez déjà l'ID de la bibliothèque, vous pouvez ignorer ctx7 library et passer directement à ctx7 docs.
Gérer les compétences de codage IA
Les compétences sont des fichiers SKILL.md qui donnent à votre agent IA des connaissances ou un comportement spécialisés. Considérez-les comme de petits manuels d'instructions que votre agent lit avant d'aborder un type de tâche spécifique.
Context7 héberge un registre de compétences contribuées par la communauté. Vous pouvez les rechercher, installer des compétences dans votre environnement d'agent, en générer des personnalisées et supprimer celles dont vous n'avez pas besoin.
Rechercher des compétences
ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Installer une compétence
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor # Installer spécifiquement pour Cursor
ctx7 skills install /anthropics/skills pdf --claude # Installer pour Claude Code
Lorsque vous installez globalement (--global), la compétence est disponible dans tous vos projets :
ctx7 skills install /anthropics/skills pdf --global
Obtenir des suggestions basées sur votre projet
ctx7 skills suggest scanne votre répertoire de projet, détecte les bibliothèques et frameworks que vous utilisez, et recommande des compétences pertinentes :
ctx7 skills suggest
Cela fonctionne bien lorsque vous démarrez un nouveau projet et que vous souhaitez pré-charger votre agent avec des connaissances pertinentes.
Lister les compétences installées
ctx7 skills list # Toutes les compétences installées
ctx7 skills list --claude # Uniquement les compétences installées pour Claude Code
ctx7 skills list --cursor # Uniquement les compétences Cursor
Supprimer une compétence
ctx7 skills remove pdf
Générer une compétence personnalisée avec l'IA
C'est la fonctionnalité la plus puissante. Avec un compte payant, vous pouvez générer une compétence personnalisée à partir de n'importe quelle bibliothèque de l'index Context7 :
ctx7 login
ctx7 skills generate
L'interface en ligne de commande vous guide à travers une invite interactive : choisissez une bibliothèque, décrivez ce que vous voulez que la compétence enseigne à votre agent, et Context7 génère un fichier SKILL.md adapté à la documentation actuelle de cette bibliothèque.
Les compétences générées sont portables. Le format SKILL.md suit la norme Agent Skills, ce qui signifie qu'une compétence que vous générez pour Claude Code fonctionne sans modification dans Cursor, VS Code Copilot, OpenCode et tout autre outil compatible Agent Skills.
Les comptes gratuits bénéficient de 6 générations de compétences par semaine. Les comptes Pro en obtiennent 10.
Alias raccourcis pour une saisie plus rapide :
| Commande complète | Alias |
|---|---|
ctx7 skills install | ctx7 si |
ctx7 skills search | ctx7 ss |
ctx7 skills generate | ctx7 skills gen ou ctx7 skills g |
Utiliser Context7 dans vos invites IA
Une fois Context7 configuré, vous disposez de plusieurs façons de l'utiliser dans votre flux de travail de codage quotidien.
Le modèle "use context7"
En mode MCP, ajoutez "use context7" à toute invite où vous souhaitez une documentation actuelle :
Create a Next.js middleware that checks for a valid JWT in cookies and redirects
unauthenticated users to /login. use context7
Set up a Prisma schema with user and post models and a one-to-many relation. use context7
How do I configure the App Router layout in Next.js 15? use context7
L'agent appelle automatiquement les outils resolve-library-id et query-docs de Context7, récupère la documentation actuelle et l'utilise pour fonder sa réponse.
Référencer une bibliothèque spécifique
Si votre invite implique plusieurs bibliothèques et que vous souhaitez que Context7 se concentre sur l'une d'elles :
Implement Supabase authentication in a Next.js app.
use library /supabase/supabase for Supabase and /vercel/next.js for Next.js routing.
Cela ignore l'étape de correspondance de la bibliothèque et va directement à la documentation.
Invocation automatique sans taper "use context7"
Ajoutez une règle à votre agent IA afin qu'il récupère automatiquement la documentation chaque fois qu'il touche au code de la bibliothèque. Dans Claude Code, ajoutez à votre CLAUDE.md :
Utilisez toujours les outils MCP de Context7 lors de la génération de code qui utilise des bibliothèques tierces.
Résolvez l'ID de la bibliothèque et récupérez la documentation actuelle avant d'écrire toute implémentation.
Faites cela sans attendre que je le demande.
Dans Cursor, ajoutez à Paramètres > Règles pour l'IA :
Lorsque vous écrivez du code qui utilise des bibliothèques ou des frameworks externes, invoquez toujours
Context7 pour récupérer la documentation actuelle avant de générer l'implémentation.
Associez-le à Apidog pour une confiance API totale
Context7 maintient à jour les connaissances de la bibliothèque de votre assistant IA. Mais une documentation précise n'est que la moitié du tableau. Lorsque vous créez une intégration API, vous devez également vérifier que vos appels HTTP réels fonctionnent comme vous l'attendez.
Apidog couvre cela. C'est un client API gratuit où vous pouvez envoyer des requêtes, inspecter les réponses, configurer des environnements et automatiser des suites de tests. Il gère tout, de l'exploration de points de terminaison ad hoc aux tests d'intégration répétables.
Voici comment ils se complètent dans un flux de travail réel :
Vous construisez une application Next.js qui appelle une API tierce. Context7 fournit à votre agent IA la documentation Next.js actuelle afin que ses suggestions de code soient correctes. Apidog vous permet de tester l'API tierce directement, de vérifier la structure de la réponse et de confirmer que les charges utiles envoyées par votre code correspondent à ce que l'API attend.
Vous intégrez une nouvelle bibliothèque qui possède sa propre API HTTP. Context7 fournit à votre agent la documentation SDK actuelle de la bibliothèque. Apidog vous permet de tester les points de terminaison API bruts pour comprendre le comportement au niveau HTTP avant d'écrire tout code d'application.
Vous déboguez une intégration. Vous pouvez envoyer la requête exacte que votre code construit dans Apidog, inspecter la réponse brute et isoler si le problème se situe dans la logique de votre requête ou dans le comportement de l'API.
Configurez un environnement dans Apidog avec vos clés API stockées comme variables, basculez entre le développement et la production en un clic, et exécutez des assertions de test sur chaque réponse. Context7 + Apidog vous offre à la fois une documentation actuelle et un comportement API vérifié.
Tarification et limites de débit
La CLI ctx7 est gratuite. Les limites de débit et l'accès aux fonctionnalités dépendent de votre plan Context7 :
| Plan | Prix | Appels API/mois | Limite de débit | Dépôts privés |
|---|---|---|---|---|
| Gratuit | 0 $ | 1 000 | 60 requêtes/heure | Non |
| Pro | 7 $/siège/mois | 5 000/siège | 60/heure/siège | Oui (15 $/1M jetons à analyser) |
| Entreprise | Personnalisé | 5 000/siège | Personnalisé | Oui (25 $/1M jetons) |
Notes sur le plan gratuit :
- Lorsque vous atteignez la limite mensuelle, vous obtenez 20 appels API bonus par jour jusqu'à la réinitialisation du mois
- L'accès aux dépôts privés nécessite un plan Pro ou supérieur
- Génération de compétences : 6/semaine en Gratuit, 10/semaine en Pro
- Le plan Pro prend en charge un maximum de 20 membres
Limitation importante : Context7 achemine toutes les requêtes via les serveurs d'Upstash. Il n'y a pas de mode hors ligne. Si vous êtes dans un environnement sans accès à Internet, l'outil ne fonctionnera pas. Les réponses de documentation peuvent également être volumineuses, ce qui réduit la fenêtre de contexte de votre LLM. Sur les projets complexes avec de nombreuses requêtes de bibliothèque, cela s'accumule.
Obtenez une clé API gratuite sur context7.com/dashboard. La clé API vous donne des limites de débit plus élevées que les requêtes non authentifiées.
FAQ
Context7 envoie-t-il mon code à ses serveurs ?
Non. Seuls le nom de la bibliothèque et le texte de la requête sont envoyés aux serveurs de Context7, pas votre code, l'historique de conversation ou toute donnée sensible. Votre base de code reste chez votre fournisseur de LLM.
Quelles bibliothèques Context7 prend-il en charge ?
L'index couvre plus de 9 000 bibliothèques et frameworks publics. Vous pouvez rechercher dans l'index sur context7.com pour vérifier si une bibliothèque spécifique est disponible. De nouvelles bibliothèques peuvent être soumises via /add-library dans l'interface Context7.
À quel point la documentation est-elle à jour ?
Les bibliothèques sont réindexées périodiquement. Les versions très récentes (des derniers jours) peuvent ne pas encore être disponibles. Pour les bibliothèques stables, la documentation est généralement à jour avec la dernière version.
Fonctionne-t-il sans clé API ?
L'utilisation de base fonctionne sans clé API mais avec des limites de débit inférieures. Pour une utilisation régulière, inscrivez-vous sur context7.com et définissez CONTEXT7_API_KEY pour obtenir un meilleur débit.
Quels éditeurs et agents prend-il en charge ?
Context7 fonctionne avec Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop et tout autre client prenant en charge le protocole MCP ou la norme Agent Skills.
Quelle est la différence entre le mode CLI + Compétences et le mode MCP ?
En mode CLI + Compétences, un fichier de compétence indique à votre agent d'exécuter explicitement les commandes ctx7 lorsqu'il a besoin de documentation. En mode MCP, votre agent appelle les outils de Context7 nativement via le protocole MCP. Le mode MCP est plus transparent pour l'utilisateur et ne nécessite aucune invite explicite "use context7" une fois configuré.
Puis-je utiliser ctx7 sans agent de codage IA ?
Oui. ctx7 library et ctx7 docs fonctionnent comme des commandes terminales autonomes. Vous pouvez rechercher la documentation de bibliothèque directement sans l'intervention d'aucun agent IA.