Zum Inhalt springen
claudemods

Claude Code Tool-Mods: Gib Claude neue Tools

Claude Code Tool-Mods registrieren neue Tools für Claude, in JavaScript direkt in Claude Code geschrieben – eine leichtere Alternative zum MCP-Server.

In dieser Kategorie gibt es noch keine getesteten Mods. Kennst du eine gute? Reich sie ein.

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.

Wie fügen Claude Code Tool-Mods ein Tool hinzu?

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.

Tool-Mods oder MCP-Server?

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.

FAQ

Sollte ich eine Tool-Mod oder einen MCP-Server bauen?
Nimm einen MCP-Server, wenn das Tool auch mit anderen Clients funktionieren muss oder als separater Dienst läuft. Eine Tool-Mod ist einfacher, wenn das Tool nur Claude Code und ein paar Zeilen JavaScript braucht.
Verbrauchen eigene Tools mehr Tokens?
Jede Tool-Beschreibung wird an Claude geschickt, daher erhöht jedes Tool den Kontext ein wenig. Mods können ein Tool über tool.describe als zurückgestellt markieren, sodass seine Beschreibung erst bei Bedarf geladen wird.
Kann eine Tool-Mod meine anderen Tool-Aufrufe sehen?
Nur wenn sie sich zusätzlich in tool.call einhängt. Ein Tool nur mit $.tool.register zu registrieren, erlaubt einer Mod nicht, andere Tools zu beobachten; die Berechtigungs-Badges zeigen, ob sie Tool-Aufrufe abfängt.