Guide · IA & agents
Claude Code dans un dépôt JavaScript
Plugin TypeScript, JSDoc et tests npm. Docs lues le 2026-10-18. Aucune commande relancée.
Claude Code dans un dépôt JavaScript ou TypeScript, ce n’est pas un guide Next.js, et ce n’est pas un serveur MCP. How Claude Code works, Common workflows et Code intelligence plugins, relus le 2026-10-19, décrivent la même boucle que pour un autre langage : fichiers, terminal, git, et un serveur de langage si vous l’installez. Aucune commande n’a été relancée. Aucun npm test n’a été lancé ici.
Next.js a déjà sa page. Un serveur MCP en TypeScript a la sienne. La carte du produit est sur Claude Code : la carte.
Une boucle, le dépôt comme périmètre
Lancé dans le dossier, Claude Code voit le projet, le terminal, l’état git et CLAUDE.md. La page le distingue des assistants qui ne voient que le fichier ouvert. Sans outils, le modèle ne fait que du texte. Avec les outils d’exécution, il peut lancer npm, git, ou la commande de test que le dépôt utilise déjà.
La page des workflows donne des exemples de consignes, pas des résultats. L’un d’eux est « I'm seeing an error when I run npm test ». Un autre demande des commentaires JSDoc sur des fonctions non documentées de auth.js. Un troisième parle de refactorer utils.js. Ce sont des phrases modèles. Elles n’ont pas été envoyées, et elles ne prouvent pas qu’un test est passé.
Les conventions du dépôt, le gestionnaire de paquets, le linter, les dossiers générés à ignorer, vont dans CLAUDE.md. Comment écrire un bon CLAUDE.md tient ce fichier. Une consigne dite une seule fois en début de session peut disparaître quand le contexte est compacté.
Pour inclure un fichier sans attendre que Claude le lise, la page documente @. @src/utils/auth.js ajoute le contenu si le fichier tient dans la limite de l’outil Read : 25 000 jetons par défaut, et un fichier texte au-dessus de 256 KB n’est pas inclus. Une référence de dossier montre la liste des fichiers, pas leur contenu. Je n’ai pas mesuré ces plafonds. Ils sont ceux de la page.
Le plugin couvre JavaScript et TypeScript
Le tableau officiel met TypeScript et JavaScript sur la même ligne : plugin typescript-lsp, binaire typescript-language-server. Le plugin ne livre pas le binaire. Pour TypeScript, la page écrit la commande d’installation du binaire, non rejouée ici :
npm install -g typescript-language-server typescript
Elle demande ensuite de vérifier que le binaire est sur le PATH du shell qui lance claude, par exemple avec which typescript-language-server. Je ne l’ai pas fait.
L’installation du plugin, dans une session Claude Code, suit le motif de la page :
/plugin install typescript-lsp@claude-plugins-official
Non lancé. Le serveur démarre à la première édition d’un fichier dont l’extension est celle du plugin. La vérification écrite est une erreur de type introduite puis corrigée, et une ligne Found N new diagnostic issues. Sans cette ligne, l’onglet Errors de /plugin peut afficher Executable not found in $PATH. Je n’ai pas ouvert cet onglet.
Les sessions cloud ne démarrent pas ces serveurs. Pas de diagnostics, pas d’aller à la définition. L’outil LSP, quand il tourne, est en lecture seule. Il ne remplace pas le build, ni la suite de tests. Générer des tests reste la page de ce sujet.
Si le binaire est déjà sur le PATH, une boîte peut proposer le plugin après une édition. Elle n’apparaît pas quand le terminal est attaché à une session cloud. Je ne l’ai pas vue.
Avant d’écrire
Pour une modification à relire avant qu’elle touche le disque, la page des workflows documente claude --permission-mode plan. Claude propose un plan. Il n’édite pas tant que vous n’approuvez pas. Maj+Tab mène au même mode en cours de session. Aucune session n’a été ouverte pour le constater.
Créer une pull request depuis le terminal, avec gh pr create, est un autre flux, décrit sur la même page. Le branchement GitHub Actions de Claude Code est sur Claude Code dans un workflow GitHub. Ce n’est pas la CI Node.js déjà écrite dans GitHub Actions pour un SaaS.
Où ne pas rester
| Besoin | Page | Ce qui n’est pas rejoué ici |
|---|---|---|
Installer claude | Installer Claude Code | Le script d’installation |
| Une app Next.js | Claude Code pour Next.js | Le cadre du framework |
| Un serveur MCP | Serveur MCP TypeScript | Le serveur |
| Carte du produit | Guide Claude Code | Les surfaces |
Claude Code ou Cursor existe pour le choix d’outil. Cette page ne tranche pas.
Ce qui n’a pas tourné
Aucun paquet installé globalement, aucun plugin, aucun test npm. La commande du binaire et le nom typescript-lsp viennent de la page des plugins, relue le 2026-10-19. Les plafonds de @ viennent de la page des workflows, pas d’une mesure locale. Les prix ne sont pas recopiés.
Sources
Documentation officielle Anthropic consultée le 2026-10-19 :