Konfiguration & Installation
Claude Code legt seine Konfiguration in .claude-Ordnern ab – einen in deinem Home-Verzeichnis (~/.claude/), einen optional im Projektordner (.claude/). Plugins, Skills und Slash Commands folgen alle demselben Prinzip, unterscheiden sich aber darin, wo die Dateien liegen und wer sie sieht.
Übersicht
| Pfad | Inhalt | Sichtbar für |
|---|---|---|
~/.claude/settings.json |
Plugin-Einträge (User-Scope), Permissions | Nur du |
~/.claude/plugins/cache/ |
Plugin-Dateien (Skills, Hooks, Commands) | Nur du |
~/.claude/skills/ |
Persönliche Standalone-Skills | Nur du, alle Projekte |
~/.claude/commands/ |
Persönliche Slash Commands | Nur du, alle Projekte |
.claude/settings.json |
Plugin-Einträge (Project-Scope) | Alle im Repo (eingecheckt) |
.claude/settings.local.json |
Plugin-Einträge (Local-Scope) | Nur du, dieses Repo (gitignored) |
.claude/skills/ |
Projekt-Standalone-Skills | Alle im Repo |
.claude/commands/ |
Projekt-Slash-Commands | Alle im Repo |
Die drei Scopes
Wenn du ein Plugin über den Marketplace installierst, wählst du einen von drei Scopes. Der Unterschied liegt ausschließlich darin, welche settings.json einen Eintrag bekommt – die Plugin-Dateien selbst landen nie im Projektordner.
Install for you → ~/.claude/settings.json
Das Plugin ist in allen deinen Projekten verfügbar. Sinnvoll für Tools, die du überall nutzt.
Install for this project → .claude/settings.json
Die Datei wird eingecheckt und gilt für alle im Repo. Sinnvoll für Team-Standards.
Install locally → .claude/settings.local.json
Die Datei ist gitignored – nur du, nur dieses Repo. Sinnvoll zum Ausprobieren oder für rein persönliche Setups.
| Ich will… | Scope |
|---|---|
| Tool überall für mich | User |
| Team-Standard im Repo | Project |
| Ausprobieren ohne Repo-Impact | Local |
Plugins vs. Standalone-Skills
Hier löst sich der häufigste Denkfehler auf: Warum sieht man bei manchen Skills MD-Dateien im Repo, bei Marketplace-Plugins aber nur einen Eintrag in settings.json?
Das sind zwei verschiedene Mechanismen.
Marketplace-Plugins
Die eigentlichen Dateien (SKILL.md, Hooks, Commands) landen nie im Projektordner. Claude Code kopiert sie beim Installieren in den Cache unter ~/.claude/plugins/cache/. Der Scope-Dialog entscheidet nur, welche settings.json den Verweis (enabledPlugins) bekommt.
Standalone-Skills
Ein einfacherer Mechanismus: eine einzelne SKILL.md-Datei, die du manuell oder per curl an einen bestimmten Ort legst.
| Ort | Sichtbar für |
|---|---|
~/.claude/skills/<name>/SKILL.md |
Nur du, alle Projekte |
.claude/skills/<name>/SKILL.md |
Alle im Repo |
Manche Anbieter verteilen ihre Skills direkt so – daher sieht man bei ihnen die kompletten MD-Dateien, beim Plugin nur den Eintrag in settings.json.
Slash Commands und lokale Skills
Slash Commands
Jede .md-Datei in einem commands/-Ordner wird automatisch zum Slash Command – der Dateiname wird zum Befehl, der Inhalt ist der Prompt, den Claude ausführt.
| Datei | Befehl | Sichtbar für |
|---|---|---|
~/.claude/commands/bananas.md |
/bananas |
Nur du, alle Projekte |
.claude/commands/deploy.md |
/deploy |
Alle im Repo |
Keine weitere Konfiguration nötig.
Lokale Skills
Skills in ~/.claude/skills/ oder .claude/skills/ funktionieren wie Marketplace-Plugin-Skills – Claude ruft sie per Skill-Tool auf. Der einzige Unterschied: du hast sie manuell abgelegt statt über den Marketplace installiert.
Ein typischer Installations-Einzeiler: