Claude Code in VS Code: Skills und MCP-Server global oder lokal einrichten
Zuletzt aktualisiert:
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.
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.