Claude Code Tool-Mods registrieren neue Tools für Claude, in JavaScript direkt in Claude Code geschrieben – eine leichtere Alternative zum MCP-Server.
Claude Code Tool-Mods geben Claude neue Tools, die es während eines Turns aufrufen kann, etwa eine projektspezifische Suche, eine Abfrage in deinem Issue-Tracker oder einen Rechner für etwas, das in deiner Codebasis wichtig ist. Das Tool ist in JavaScript innerhalb der Mod geschrieben und läuft in Claude Code, es muss also kein separater Serverprozess gestartet werden.
Eine Mod ruft $.tool.register(...) mit einem Namen und einer Beschreibung auf, die Claude liest, sowie mit der Eingabe, die das Tool akzeptiert. Entscheidet sich Claude für das Tool, läuft der Aufruf wie bei jedem eingebauten Tool durch das Event tool.call, und die Mod beantwortet ihn, indem sie { result } zurückgibt. $.tool.list() zeigt, was verfügbar ist, und mit $.tool.call() kann eine Mod selbst ein Tool aufrufen.
Zwei weitere Events spielen hier eine Rolle. tool.describe feuert, wenn die Beschreibung eines Tools zum ersten Mal an Claude geschickt wird; eine Mod kann den Text umschreiben oder das Tool als zurückgestellt markieren, damit es erst bei Bedarf Kontext belegt. agent.offer und $.agent.register erledigen dasselbe für Subagent-Typen. Die API-Referenz dokumentiert die Methoden von $.tool und $.agent.
Was solltest du vor der Installation prüfen?#
Eine Tool-Mod zeigt Fügt Befehle/Tools hinzu. Die übrigen Badges verraten dir, worauf das Tool zugreifen kann. Ein Tool, das eine Web-API abfragt, zeigt Netzwerk; eines, das Dateien durchsucht, zeigt Liest Dateien; eines, das einen Linter ausführt, zeigt Führt Befehle aus. Weil Claude entscheidet, wann das Tool aufgerufen wird, können diese Fähigkeiten in jedem Turn genutzt werden, nicht nur, wenn du darum bittest. Prüfe sie also so, als hätte Claude direkten Zugriff.
Sieh dir auch an, wie Fehler gemeldet werden. Ein gutes Tool gibt eine klare Fehlermeldung als Ergebnis zurück, statt eine Exception zu werfen, damit Claude sich davon erholen kann.
MCP-Server sind der Standardweg, Claude Tools zu geben, und sie funktionieren mit vielen Clients. Eine Tool-Mod ist enger gefasst: Sie funktioniert nur in Claude Code, braucht aber keinen Installationsschritt über das Plugin hinaus, startet mit der Session und kann Zustand mit dem Rest der Mod teilen, zum Beispiel mit einer Statuszeile, die anzeigt, wie oft das Tool benutzt wurde.