Claude Code Mods: installieren, nutzen und sicher deaktivieren
Mods sind Plugins mit In-Process-Function-Hooks, die das Interface neu zeichnen, Befehle ergänzen und Tool-Aufrufe abfangen können. Dieser Guide führt durch deinen ersten Mod, die eingebaute Liste und die Aus-Schalter — jede Angabe geprüft gegen die offizielle Doku.
Kurzfassung
- Mods sind Claude-Code-Plugins mit einem Hooks-Modul — JavaScript, das direkt in Claude Code läuft und Events beobachten, umschreiben oder beantworten kann.
- Ab v2.1.287 funktionieren Mods out of the box: Mit /plugin install name@marketplace installieren, nach einem Neustart der Sitzung ist der Mod aktiv.
- Der eingebaute You-Should-Know-Mod ist Opt-in: einmal aktivieren mit /plugin enable cc-plugin-you-should-know@builtin.
- Zum Abwählen: einen einzelnen Mod in /plugin deaktivieren, mit --safe-mode eine Sitzung ohne Mods starten oder "disableAllHooks": true setzen, damit alle installierten Mods aus bleiben.
Claude Mods Make Claude Code 10x More Powerful
Kanal: Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
Kanal: Claude Code Changelog2:13
Mods overview — official docs (function hooks)
Doku: code.claude.com/docs
Die Screenshots stammen aus den beiden Videos oben; verwendet wurden nur saubere Bildschirmsegmente und typografische Changelog-Slides — Presenter-Segmente flogen raus. Die Fakten wurden gegen die offizielle Mods-Dokumentation geprüft, nicht gegen die Videos.
Frame-Zeitstempel führen per Deep-Link zu den Quellvideos zurück, damit die Creator den Besuch bekommen. Claude Code ist eine Marke von Anthropic; dieser Guide ist unabhängig und nicht affiliiert.
Deinen ersten Claude-Code-Mod installieren und nutzen
Verstehen, was ein Mod ist
- 1
Wissen, was ein Mod ändert
Claude Code 2.1.287 führt Mods ein: Plugins, die tieferes Verhalten des Agenten selbst ändern. Ein Mod kann auf Sitzungs-Events reagieren, einen eigenen Zustand halten und direkt im Interface zeichnen — ein kleines Programm, das dein Terminal erweitert, nicht eine weitere Anweisung fürs Modell.
Die v2.1.287-Release-Notes stellen Mods als Plugins vor, die tieferliegendes Verhalten innerhalb von Claude Code ändern.Bei 0:30 ansehen - 2
Mods in den anderen Erweiterungsebenen verorten
Skills steuern das Modellverhalten, MCP-Server exponieren externe Tools, Shell-Hooks führen Befehle an Lifecycle-Events aus. Mods sind die vierte Schicht: Code, der im Prozess läuft, das Interface verändern und Events davor oder danach abfangen kann. Der Spickzettel unter dem Walkthrough vergleicht alle fünf Ebenen.
- 3
Deine Claude-Code-Version prüfen
Mods brauchen Claude Code v2.1.287 oder neuer, wo sie standardmäßig aktiviert sind. Prüfe mit claude --version; wenn du hinten dran bist, folge unserem Claude-Code-Update-Guide und komm zurück. Einzelne Mods verlangen womöglich noch neuere Builds.
Die v2.1.287-Release-Notes umfassen: Claude Mods, das You-Should-Know-Plugin, Agent-View-Filterung und Hintergrund-Task-Management.Bei 0:09 ansehen
Einen installieren und laufen sehen
- 4
Das veraltete Enable-Flag überspringen
Ältere Anleitungen raten zu CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 — das war die Early-Access-Preview. Seit 2.1.287 sind Mods standardmäßig an und die Umgebungsvariable wird ignoriert, du kannst sie also aus deinen Settings entfernen. Mehr ist nicht nötig, um Mods anzuschalten.
- 5
Einen Mod aus einem Marketplace installieren
In einer Sitzung: /plugin install mod-name@marketplace. Aus der Shell: claude plugin install mod-name@marketplace, danach /reload-plugins, falls schon eine Sitzung offen ist. Vor der Installation von Drittanbieter-Code kannst du mit claude plugin validate ./some-mod prüfen.
- 6
Lesen, was ein Mod wirklich ist
Ein Mod ist ein Hooks-Modul: ein register(on)-Einstieg, der Handler-Funktionen an Engine-Events abonniert. Jeder Handler erhält die Mods-API, das Event und eine next()-Fortsetzung — ein Express-Middleware-Muster, bei dem du das Event beobachten, umschreiben oder beantworten und dann weiterreichen kannst.
Das register.tsx eines echten Mods: ein on('ui.render')-Handler, der die AbovePrompt-Komponente mit einer Extra-Textzeile neu zeichnet.Bei 2:35 ansehen - 7
Sitzung starten und verifizieren
Starte Claude Code und prüfe die Belege: Die eigenen Slash-Befehle des Mods tauchen in der Hilfsliste auf, und /plugin zeigt unter den Tabs eine Zeile wie "1 mod active". Wenn nichts erscheint, lies die Anleitung des Mods noch einmal — zeichnende Mods funktionieren nur im Terminal und im Code-Tab der Desktop-App.
Der /hello-Befehl in der Hilfsliste stammt aus einem installierten Mod — Mods können sofort ausgeführte eigene Befehle registrieren, ohne dass ein Claude-Durchlauf nötig ist.Bei 2:32 ansehen
Die eingebauten Mods
- 8
Die eingebauten Mods kennenlernen
Öffne /plugin und schau in den Built-in-Bereich: cc-plugin-agents-md lädt AGENTS.md, cc-plugin-diff treibt das /diff-Pane an, cc-plugin-plugin-authoring ist die Plugin-Authoring-Skill, cc-plugin-sec-default bewacht die Org-Richtlinien, und cc-plugin-telemetry kümmert sich um Analytics. Deren Quellcode liegt im Mods-Verzeichnis des Claude-Code-Repositorys.
- 9
Den You-Should-Know-Mod aktivieren
You Should Know ist Claude Codes eingebauter Side-Agent: Einmal aktiviert, beobachtet er deine Sitzung und markiert Dinge, die dir vielleicht entgangen sind. Ausgeliefert wird er deaktiviert — einmal einschalten mit /plugin enable cc-plugin-you-should-know@builtin, und er bleibt für künftige Sitzungen an.
Die offizielle You-Should-Know-Karte: ein Side-Agent, der deine Sitzung überwacht, aktiviert mit /plugin enable cc-plugin-you-should-know@builtin.Bei 0:48 ansehen - 10
Die drei Aus-Schalter kennen
Einen einzelnen Mod deaktivierst du im Installed-Tab von /plugin. Mit claude --safe-mode startest du eine einzelne Sitzung ohne Mods. Oder setze "disableAllHooks": true in ~/.claude/settings.json, dann bleiben alle installierten Mods aus, bis du das zurückdrehst. Eingebaute Mods laufen in allen drei Fällen weiter — das ist Absicht.
Die Kontrolle behalten
- 11
Das Sicherheitsmodell ernst nehmen
Mods laufen mit deinen Rechten und ohne Sandbox: Sie können Umgebungsvariablen und Secrets lesen, Prompts umschreiben, Tool-Aufrufe vorab genehmigen und dein Kontingent ausgeben. Installiere nur Mods, die du auch als nackten Code auf deiner Maschine laufen lassen würdest, und prüfe mit /plugin, was eine Sitzung tatsächlich geladen hat.
- 12
Wissen, wo Mods zeichnen dürfen
Mod-UI — Panes neben dem Transkript, Bänder über dem Prompt, eigene Tabs — rendert im Terminal und im Code-Tab der Desktop-App. In WSL-Sitzungen, im VS-Code-Chat-Panel, in claude -p-Läufen, im Agent SDK und in Cloud-Sitzungen wird nicht gezeichnet, und Mods dürfen Claude Codes UI umstylen — aber nie den Berechtigungsdialog.
Mods vs. Plugins vs. Skills vs. MCP vs. Hooks
Claude Code hat jetzt fünf Erweiterungsebenen, und die Namen verschwimmen schnell. Die Kurzfassung — wo der Code läuft und was er anfassen darf:
- 1Skills sind Markdown-Anweisungspakete, die das Modellverhalten bei Aufruf steuern — eigene Code-Ausführung gibt es nicht.
- 2MCP-Server binden externe Tools und Datenquellen über das Model Context Protocol an — außerhalb des Prozesses, als Tools exponiert.
- 3Shell-Hooks sind Befehle aus deinen Settings-Dateien, die an Lifecycle-Events laufen, etwa vor oder nach einem Tool-Aufruf.
- 4Plugins bündeln all das — Befehle, Agenten, MCP-Server, Hooks — in ein installierbares Paket.
- 5Mods sind Plugins, deren Hooks-Modul im Prozess läuft: TypeScript-Funktionen, die die UI neu zeichnen, Events unterwegs abfangen und zwischen Events Zustand halten können.
Faustregel: Anweisungen gehören in Skills, Integrationen in MCP, Automatisierung in Shell-Hooks, Verpackung in Plugins — und wenn du ändern willst, wie Claude Code selbst aussieht oder wie ein Event ausgeht, ist es ein Mod.