Aller au contenu
Floskool

Chapitre 3 · Chapitre 3 · Les marketplaces et les portées

3.3 Les trois portées d'installation

Leçon gratuite 9 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Au moment d'installer, Claude Code te demande pour qui tu installes le plugin. C'est ce qu'on appelle la portée.

Les 3 portées

Pour toi (portée utilisateur). Le plugin est activé pour toi dans tous tes projets sur cet ordinateur. Le réglage est enregistré dans ~/.claude/settings.json. C'est le bon choix pour un outil personnel que tu veux partout.

Pour tous les collaborateurs du dépôt (portée projet). Le plugin est activé pour tous ceux qui travaillent dans ce dépôt, via le fichier .claude/settings.json que vous partagez. Attention, la documentation précise que cela active le plugin chez tes collègues mais ne le télécharge pas sur leur machine : chacun doit encore l'installer une fois chez lui.

Pour toi, dans ce dépôt seulement (portée locale). Le plugin n'est activé que pour toi et que dans ce projet. Le réglage va dans .claude/settings.local.json. Pratique pour tester sans toucher au reste.

Quand un plugin est réglé à plusieurs endroits

La règle de priorité est simple : le réglage local l'emporte sur le réglage projet, qui l'emporte sur le réglage utilisateur.

Exercice

Pour chacun de ces cas, choisis la portée : 1) un plugin de relecture que tu veux dans tous tes projets ; 2) un plugin que toute l'équipe du site client doit avoir ; 3) un plugin que tu veux essayer sur un seul projet.

Corrigé. 1) Pour toi (utilisateur). 2) Projet. 3) Local.

À retenir

  • Utilisateur : partout pour toi. Projet : pour toute l'équipe du dépôt. Local : toi, ici.
  • La portée projet active le plugin mais chacun l'installe chez lui.
  • Local > projet > utilisateur.