Claude Code dans un dépôt Python

Claude Code dans un dépôt Python, ce n’est pas un client Python, et ce n’est pas un tutoriel Flask. How Claude Code works et Common workflows, relus le 2026-10-19, décrivent un assistant lancé dans un dossier : il voit les fichiers, le terminal, l’état git, et peut lancer la commande de test déjà écrite dans le dépôt. Code intelligence plugins, relu le même jour, nomme le plugin Python et son binaire. Aucune de ces commandes n’a été relancée.

Lancer Claude Code depuis un script est un autre sujet, traité dans un lot ultérieur. Une route Flask a sa page. La carte du produit est sur Claude Code : la carte.

Ce que la session voit

Lancé dans le dossier du projet, Claude Code voit les fichiers, le terminal, la branche, les changements non commités, et CLAUDE.md s’il existe. La page le distingue d’un assistant qui ne voit que le fichier ouvert. Ce n’est pas une mesure de qualité. C’est le périmètre écrit.

Sans outils, le modèle ne répond qu’en texte. Avec les outils d’exécution, il peut lancer ce que le terminal peut lancer : le gestionnaire de paquets, git, la commande de test. Les conventions durables, le formateur, l’outil de test, les fichiers à ne pas toucher, vont dans CLAUDE.md. Comment écrire un bon CLAUDE.md tient ce fichier. /init est décrit comme un générateur de brouillon. Je ne l’ai pas lancé.

Le contexte se remplit. Une consigne du début de conversation peut disparaître au compactage. La page dit de mettre les règles durables dans CLAUDE.md, et d’utiliser /context pour voir ce qui occupe la place. Je n’ai pas ouvert cette vue.

Pyright, pas un diagnostic inventé

Le tableau des plugins officiels associe Python à pyright-lsp, et le binaire à pyright-langserver. Le plugin ne contient pas le serveur de langage. La page dit d’installer le binaire d’abord, puis le plugin, puis de vérifier que le serveur démarre. La commande d’installation du binaire n’est pas sur cette page : elle renvoie au README du plugin. Je ne l’ai pas ouvert, et je ne la recopie pas.

Le motif d’installation du plugin, sur la page, est /plugin install, avec le nom du plugin et la marketplace officielle. Pour la ligne Python du tableau, cela donne :

/plugin install pyright-lsp@claude-plugins-official

Cette commande n’a pas été lancée. Si la marketplace n’est pas enregistrée, la page nomme l’erreur Marketplace "claude-plugins-official" not found et renvoie vers son dépannage.

Le serveur démarre la première fois que Claude édite un fichier dont l’extension est celle du plugin. La page propose, comme vérification, de faire introduire une erreur de type puis de la faire corriger, et de chercher une ligne de diagnostics du type Found N new diagnostic issues. Je n’ai pas fait cet essai. L’absence de cette ligne, sur la page, mène à l’onglet Errors de /plugin, où Executable not found in $PATH nomme le binaire manquant.

Deux limites sont écrites, et elles comptent plus qu’un plugin installé sur ma machine. Les sessions cloud ne démarrent pas les serveurs de langage des plugins : pas de diagnostics, pas de navigation par symbole. L’outil LSP est en lecture seule. Il ne remplace pas la commande de test du dépôt.

Si le binaire est déjà sur le PATH et que le plugin ne l’est pas, une boîte LSP plugin recommendation peut apparaître après une édition, au plus une fois par session, et jamais quand le terminal est attaché à une session cloud. Je ne l’ai pas vue.

Tests et docstrings, sans commande maison

La page des workflows dit de donner à Claude la commande qui reproduit l’erreur, et d’obtenir une trace. Elle ne nomme pas pytest, unittest, ni tox. La commande est celle du README ou de la CI du dépôt, pas une commande choisie ici. Générer des tests tient le cas général. Cette page ne le rejoue pas.

Pour la documentation, la même page dit de préciser le style voulu, docstrings ou autre, et de demander des exemples sur les API publiques. Ce n’est pas un format imposé par Claude Code. C’est une consigne que vous écrivez, ou que CLAUDE.md tient déjà.

Avant une modification que vous voulez relire, la page des workflows documente le mode plan : claude --permission-mode plan, ou Maj+Tab jusqu’à ce que la barre indique le mode plan. Claude lit et propose. Il n’édite pas tant que vous n’approuvez pas. Je n’ai pas ouvert de session pour le voir.

Ce qui reste sur d’autres pages

Sujet	Page déjà écrite	Ce que celle-ci ne refait pas
Installer la commande `claude`	Installer Claude Code	Le script d’installation
Lancer Claude depuis Python	Guide prévu dans un lot ultérieur	Le paquet `claude-agent-sdk`
Une route Flask	Claude Code pour Flask	Le client de test Flask
Carte du produit	Guide Claude Code	Les surfaces et les prix

Le face-à-face avec un éditeur n’est pas ici. Claude Code ou Cursor existe. Cette page ne choisit pas.

Ce qui n’a pas tourné

Aucun claude, aucun plugin, aucun test. Le nom pyright-lsp et le binaire pyright-langserver viennent du tableau relu le 2026-10-19. La commande du README du plugin n’a pas été lue. Les prix ne sont pas sur ces pages, ou n’ont pas été recopiés.

Sources

Documentation officielle Anthropic consultée le 2026-10-19 :