Claude Code in VS Code: Skills und MCP-Server global oder lokal einrichten

Zuletzt aktualisiert:

Zwei Kästen: links eine Person, deren Skill und MCP-Server global in jedem Projekt gilt, rechts ein Ordner-Symbol, dessen Skill und MCP-Server nur lokal in einem Projekt gilt und auf Wunsch mit dem Team geteilt wird

Warum das für dich als Projektleiter wichtig ist

Claude Code ist ein KI-Assistent, mit dem Entwickler:innen direkt in VS Code oder im Terminal programmieren. Man kann ihm zwei Arten von Erweiterungen mitgeben: Skills (kleine Anleitungen, die der Assistent befolgt, etwa „so machen wir bei uns ein Release“) und MCP-Server (zusätzliche Werkzeuge, mit denen der Assistent etwas kann, was er sonst nicht könnte, zum Beispiel in eine Datenbank schauen oder Informationen bei GitHub nachsehen).

Die entscheidende Frage ist nicht, wie diese Erweiterungen technisch funktionieren. Die entscheidende Frage ist: In wie vielen Workspaces gilt eine Erweiterung? In allen, die eine Person auf ihrem Rechner öffnet, oder nur in diesem einen? Wird das verwechselt, passiert eines von zwei Dingen: Entweder taucht eine Erweiterung ungewollt überall auf, auch bei einem anderen Kunden, wo sie nicht hingehört. Oder sie bleibt an ein einzelnes Projekt gefesselt, obwohl man sie überall bräuchte.

Die zwei Ebenen in einfachen Worten

Global (workspaceübergreifend) heißt: Die Erweiterung liegt auf dem eigenen Rechner einer Person und gilt in jedem Projekt, das diese Person dort öffnet, unabhängig vom Kunden oder Thema. Wechselt die Person den Rechner, muss die Erweiterung dort neu eingerichtet werden.

Lokal (auf den Workspace begrenzt) heißt: Die Erweiterung gilt nur in einem einzigen Projekt, in keinem anderen derselben Person. Liegt sie im Projektordner und wird mit dem Projekt geteilt, bekommen sie auch alle anderen, die daran arbeiten. Das ist praktisch, aber nicht der Kernpunkt. Der Kernpunkt ist die Reichweite: alle eigenen Projekte oder nur dieses eine.

Achtung, Begriffsfalle bei MCP-Servern: Claude Code benutzt die Wörter anders als dieser Beitrag. „user“ ist das, was hier global heißt. „project“ gilt nur in diesem Projekt und wird mit dem Team geteilt. „local“ gilt ebenfalls nur in diesem Projekt, bleibt aber privat. Sagt jemand im Team „local“, ist also nicht das geteilte Werkzeug gemeint. Praktisch ist diese private Variante, um etwas erst einmal allein auszuprobieren.
Tipp: Die Änderung kommt nicht an? Du hast einen globalen Skill oder MCP-Server geändert, und die KI weiß noch nichts davon? Drücke Strg+Umschalt+P (Mac: Cmd+Shift+P), tippe Reload Window und bestätige mit Enter. Das Fenster lädt neu, dein Projekt bleibt offen. Warte vorher, bis die KI fertig ist, denn das Neuladen unterbricht laufende Arbeit. Oft ist der Schritt gar nicht nötig: Skill-Änderungen erkennt Claude Code laut Doku meist noch in der laufenden Sitzung, MCP-Änderungen gelten ab der nächsten neuen Unterhaltung.

Praxisbeispiel

Eine Entwicklerin hat sich eine persönliche Checkliste für Code-Reviews zusammengestellt. Die legt sie global an. Dadurch steht sie ihr in jedem Projekt zur Verfügung, egal ob für Kunde A oder Kunde B. Das ist gewollt, weil es ihre persönliche Arbeitsweise ist.

Für ein bestimmtes Projekt, eine Kundenwebsite, legt das Team zusätzlich fest, wie ein Release abläuft: Tests laufen lassen, Versionsnummer erhöhen, Änderungsprotokoll ergänzen. Dieser Skill wird bewusst lokal angelegt, also nur in diesem einen Projekt. Bei einem anderen Kunden, für den ein ganz anderer Ablauf gilt, taucht er nicht auf.

Ähnlich bei MCP-Servern: Ein persönlicher GitHub-Zugang, mit dem der Assistent Tickets nachschlägt, gehört global angelegt, denn er soll überall funktionieren, wo diese Person arbeitet. Der Zugang zur Testdatenbank eines bestimmten Projekts gehört lokal an genau dieses Projekt. In einem anderen Projekt wäre diese Verbindung schlicht falsch.

Entscheidungshilfe

Situation Global oder lokal? Warum
Eigene Arbeitsweise, die überall gelten soll (Review-Stil, persönliche Vorlieben) Global Soll in jedem Projekt verfügbar sein
Ablauf, der nur zu einem bestimmten Projekt gehört (Release-Prozess, Projekt-Standard) Lokal Würde in einem anderen Projekt nicht passen
Zugang zu einem persönlichen Konto (GitHub, Jira) mit eigenem Login Global Das Konto gehört zur Person, nicht zu einem Projekt
Zugang zu einer projektspezifischen Datenbank oder einem Testsystem Lokal Die Verbindung passt nur zu genau diesem Projekt
Ein MCP-Server, den jemand an einem Projekt allein ausprobieren will Lokal und privat („local“) Landet noch nicht beim ganzen Team

Die Teamnutzung ergibt sich davon: Was im Projektordner liegt und geteilt wird, haben alle, die daran mitarbeiten. Man legt also nicht zuerst fest „das ist für das Team“, sondern „das gilt nur in diesem Projekt“.

Worauf du als Projektleiter achten solltest

  • Zugangsdaten gehören nie ins Projekt. Steht ein Passwort in einer geteilten Datei im Projektordner, wandert es mit dem Projekt mit und ist für alle sichtbar, die darauf Zugriff haben.
  • Globale Erweiterungen wirken auch bei anderen Kunden. Eine globale Erweiterung steht einer Person in jedem Projekt zur Verfügung, auch dort, wofür sie nie gedacht war. Bei vertraulichen Projekten lohnt sich ein kurzer Blick, was global eingerichtet ist.
  • Die Rückfrage bei fremden Projekten ernst nehmen. Bringt ein Projekt eigene MCP-Server mit, fragt Claude Code bei der normalen Arbeit nach, bevor es sie nutzt. Stammt das Projekt nicht aus dem eigenen Haus, sollte niemand das einfach wegklicken, denn dahinter stecken Programme.

Fazit

Was überall gelten soll, gehört global auf den eigenen Rechner. Was nur zu einem bestimmten Projekt passt, gehört lokal in genau dieses Projekt. Wer bei jeder neuen Erweiterung diese eine Frage stellt, muss die technischen Details der Konfiguration nicht kennen. Weitere nützliche Tasten findest du unter Tastenkürzel in VS Code mit Claude Code.

Direkt ausprobieren: Der Projektmanagement-Coach ist ein fertig eingerichteter Arbeitsbereich für Kiro und Claude Code, mit dem du im Dialog Projektdokumente, Risikoregister und Statusberichte erstellst (kostenpflichtig).

Quellen