Werkzeugreferenz
Vollständige Referenz für die Werkzeuge, die Claude Code verwenden kann, einschließlich Berechtigungsanforderungen.
Claude Code hat Zugriff auf eine Reihe von integrierten Werkzeugen, die ihm helfen, Ihre Codebasis zu verstehen und zu ändern. Die Werkzeugnamen sind die genauen Zeichenketten, die Sie in Berechtigungsregeln, Subagent-Werkzeuglisten und Hook-Matchern verwenden. Um ein Werkzeug vollständig zu deaktivieren, fügen Sie seinen Namen zum deny-Array in Ihren Berechtigungseinstellungen hinzu.
Um benutzerdefinierte Werkzeuge hinzuzufügen, verbinden Sie einen MCP-Server. Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen Skill, der über das vorhandene Skill-Werkzeug ausgeführt wird, anstatt einen neuen Werkzeugeintrag hinzuzufügen.
| Werkzeug | Beschreibung | Berechtigung erforderlich |
|---|---|---|
Agent |
Erzeugt einen Subagenten mit eigenem Kontextfenster zur Bewältigung einer Aufgabe | Nein |
AskUserQuestion |
Stellt Multiple-Choice-Fragen, um Anforderungen zu sammeln oder Mehrdeutigkeiten zu klären | Nein |
Bash |
Führt Shell-Befehle in Ihrer Umgebung aus. Siehe Bash-Werkzeugverhalten | Ja |
CronCreate |
Plant eine wiederkehrende oder einmalige Eingabeaufforderung innerhalb der aktuellen Sitzung. Aufgaben sind sitzungsbezogen und werden bei --resume oder --continue wiederhergestellt, wenn sie nicht abgelaufen sind. Siehe geplante Aufgaben |
Nein |
CronDelete |
Bricht eine geplante Aufgabe nach ID ab | Nein |
CronList |
Listet alle geplanten Aufgaben in der Sitzung auf | Nein |
Edit |
Nimmt gezielte Änderungen an bestimmten Dateien vor | Ja |
EnterPlanMode |
Wechselt in Plan Mode, um einen Ansatz vor dem Codieren zu entwerfen | Nein |
EnterWorktree |
Erstellt einen isolierten Git Worktree und wechselt hinein. Übergeben Sie einen path, um stattdessen in einen vorhandenen Worktree des aktuellen Repositorys zu wechseln, anstatt einen neuen zu erstellen. Nicht für Subagenten verfügbar |
Nein |
ExitPlanMode |
Präsentiert einen Plan zur Genehmigung und beendet Plan Mode | Ja |
ExitWorktree |
Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht für Subagenten verfügbar | Nein |
Glob |
Findet Dateien basierend auf Musterabgleich | Nein |
Grep |
Sucht nach Mustern in Dateiinhalten | Nein |
ListMcpResourcesTool |
Listet Ressourcen auf, die von verbundenen MCP-Servern bereitgestellt werden | Nein |
LSP |
Code-Intelligenz über Sprachserver: Sprung zu Definitionen, Suche nach Referenzen, Meldung von Typfehlern und Warnungen. Siehe LSP-Werkzeugverhalten | Nein |
Monitor |
Führt einen Befehl im Hintergrund aus und gibt jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status während des Gesprächs reagieren kann. Siehe Monitor-Werkzeug | Ja |
NotebookEdit |
Ändert Jupyter-Notebook-Zellen | Ja |
PowerShell |
Führt PowerShell-Befehle nativ aus. Siehe PowerShell-Werkzeug für Verfügbarkeit | Ja |
Read |
Liest den Inhalt von Dateien | Nein |
ReadMcpResourceTool |
Liest eine bestimmte MCP-Ressource nach URI | Nein |
SendMessage |
Sendet eine Nachricht an einen Agent-Team-Mitarbeiter oder setzt einen Subagenten nach seiner Agent-ID fort. Gestoppte Subagenten werden automatisch im Hintergrund fortgesetzt. Nur verfügbar, wenn CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 gesetzt ist |
Nein |
Skill |
Führt einen Skill innerhalb des Hauptgesprächs aus | Ja |
TaskCreate |
Erstellt eine neue Aufgabe in der Aufgabenliste | Nein |
TaskGet |
Ruft vollständige Details für eine bestimmte Aufgabe ab | Nein |
TaskList |
Listet alle Aufgaben mit ihrem aktuellen Status auf | Nein |
TaskOutput |
(Veraltet) Ruft Ausgabe von einer Hintergrundaufgabe ab. Bevorzugen Sie Read auf dem Ausgabedateipfad der Aufgabe |
Nein |
TaskStop |
Beendet eine laufende Hintergrundaufgabe nach ID | Nein |
TaskUpdate |
Aktualisiert Aufgabenstatus, Abhängigkeiten, Details oder löscht Aufgaben | Nein |
TeamCreate |
Erstellt ein Agent-Team mit mehreren Mitarbeitern. Nur verfügbar, wenn CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 gesetzt ist |
Nein |
TeamDelete |
Löst ein Agent-Team auf und bereinigt Mitarbeiterprozesse. Nur verfügbar, wenn CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 gesetzt ist |
Nein |
TodoWrite |
Verwaltet die Sitzungs-Aufgabenliste. Verfügbar im nicht-interaktiven Modus und im Agent SDK; interaktive Sitzungen verwenden stattdessen TaskCreate, TaskGet, TaskList und TaskUpdate | Nein |
ToolSearch |
Sucht nach verschobenen Werkzeugen und lädt sie, wenn Tool-Suche aktiviert ist | Nein |
WebFetch |
Ruft Inhalte von einer angegebenen URL ab | Ja |
WebSearch |
Führt Web-Suchen durch | Ja |
Write |
Erstellt oder überschreibt Dateien | Ja |
Berechtigungsregeln können mit /permissions oder in Berechtigungseinstellungen konfiguriert werden. Siehe auch Werkzeugspezifische Berechtigungsregeln.
Bash-Werkzeugverhalten
Das Bash-Werkzeug führt jeden Befehl in einem separaten Prozess mit folgendem Persistenzverhalten aus:
- Wenn Claude
cdin der Hauptsitzung ausführt, wird das neue Arbeitsverzeichnis zu späteren Bash-Befehlen übertragen, solange es sich im Projektverzeichnis oder einem zusätzlichen Arbeitsverzeichnis befindet, das Sie mit--add-dir,/add-diroderadditionalDirectoriesin den Einstellungen hinzugefügt haben. Subagent-Sitzungen übertragen niemals Arbeitsverzeichnisänderungen.- Wenn
cdaußerhalb dieser Verzeichnisse landet, setzt Claude Code auf das Projektverzeichnis zurück und fügtShell cwd was reset to <dir>zum Werkzeugergebnis hinzu. - Um diese Übertragung zu deaktivieren, damit jeder Bash-Befehl im Projektverzeichnis startet, setzen Sie
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
- Wenn
- Umgebungsvariablen bleiben nicht erhalten. Ein
exportin einem Befehl ist im nächsten nicht verfügbar.
Aktivieren Sie Ihre virtualenv- oder Conda-Umgebung, bevor Sie Claude Code starten. Um Umgebungsvariablen über Bash-Befehle hinweg persistent zu machen, setzen Sie CLAUDE_ENV_FILE auf ein Shell-Skript, bevor Sie Claude Code starten, oder verwenden Sie einen SessionStart-Hook, um ihn dynamisch zu füllen.
LSP-Werkzeugverhalten
Das LSP-Werkzeug gibt Claude Code-Intelligenz von einem laufenden Sprachserver. Nach jeder Dateiänderung meldet es automatisch Typfehler und Warnungen, damit Claude Probleme ohne einen separaten Build-Schritt beheben kann. Claude kann es auch direkt aufrufen, um Code zu navigieren:
- Sprung zu einer Symbol-Definition
- Suche nach allen Referenzen zu einem Symbol
- Typinformationen an einer Position abrufen
- Symbole in einer Datei oder im Workspace auflisten
- Implementierungen einer Schnittstelle finden
- Aufrufen-Hierarchien verfolgen
Das Werkzeug ist inaktiv, bis Sie ein Code-Intelligence-Plugin für Ihre Sprache installieren. Das Plugin bündelt die Sprachserver-Konfiguration, und Sie installieren die Server-Binärdatei separat.
Monitor-Werkzeug
Das Monitor-Werkzeug ermöglicht es Claude, etwas im Hintergrund zu beobachten und zu reagieren, wenn es sich ändert, ohne das Gespräch zu unterbrechen. Bitten Sie Claude:
- Eine Protokolldatei zu verfolgen und Fehler zu kennzeichnen, wenn sie erscheinen
- Eine PR oder CI-Job abzufragen und zu melden, wenn sich ihr Status ändert
- Ein Verzeichnis auf Dateiänderungen zu überwachen
- Ausgabe von einem beliebigen langfristigen Skript zu verfolgen, auf das Sie es hinweisen
Claude schreibt ein kleines Skript für die Überwachung, führt es im Hintergrund aus und empfängt jede Ausgabezeile, wenn sie ankommt. Sie arbeiten weiter in der gleichen Sitzung und Claude interveniert, wenn ein Ereignis eintritt. Beenden Sie eine Überwachung, indem Sie Claude auffordern, sie zu stornieren, oder indem Sie die Sitzung beenden.
Monitor verwendet die gleichen Berechtigungsregeln wie Bash, daher gelten allow- und deny-Muster, die Sie für Bash festgelegt haben, auch hier. Es ist nicht auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verfügbar. Es ist auch nicht verfügbar, wenn DISABLE_TELEMETRY oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC gesetzt ist.
Plugins können Monitore deklarieren, die automatisch starten, wenn das Plugin aktiv ist, anstatt Claude zu bitten, sie zu starten. Siehe Plugin-Monitore.
PowerShell-Werkzeug
Das PowerShell-Werkzeug ermöglicht es Claude, PowerShell-Befehle nativ auszuführen. Unter Windows bedeutet dies, dass Befehle in PowerShell ausgeführt werden, anstatt sie über Git Bash zu leiten. Unter Windows ohne Git Bash ist das Werkzeug automatisch aktiviert. Unter Windows mit installiertem Git Bash wird das Werkzeug schrittweise eingeführt. Unter Linux, macOS und WSL ist das Werkzeug optional.
Aktivieren Sie das PowerShell-Werkzeug
Setzen Sie CLAUDE_CODE_USE_POWERSHELL_TOOL=1 in Ihrer Umgebung oder in settings.json:
{
"env": {
"CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
}
}
Unter Windows setzen Sie die Variable auf 0, um sich von der Einführung abzumelden. Unter Linux, macOS und WSL erfordert das Werkzeug PowerShell 7 oder später: Installieren Sie pwsh und stellen Sie sicher, dass es sich auf Ihrem PATH befindet.
Unter Windows erkennt Claude Code pwsh.exe für PowerShell 7+ automatisch mit einem Fallback auf powershell.exe für PowerShell 5.1. Wenn das Werkzeug aktiviert ist, behandelt Claude PowerShell als die primäre Shell. Das Bash-Werkzeug bleibt für POSIX-Skripte verfügbar, wenn Git Bash installiert ist.
Shell-Auswahl in Einstellungen, Hooks und Skills
Drei zusätzliche Einstellungen steuern, wo PowerShell verwendet wird:
"defaultShell": "powershell"insettings.json: leitet interaktive!-Befehle durch PowerShell. Erfordert, dass das PowerShell-Werkzeug aktiviert ist."shell": "powershell"auf einzelnen Command-Hooks: führt diesen Hook in PowerShell aus. Hooks starten PowerShell direkt, daher funktioniert dies unabhängig vonCLAUDE_CODE_USE_POWERSHELL_TOOL.shell: powershellin Skill-Frontmatter: führt!`command`-Blöcke in PowerShell aus. Erfordert, dass das PowerShell-Werkzeug aktiviert ist.
Das gleiche Verhalten zum Zurücksetzen des Arbeitsverzeichnisses in der Hauptsitzung, das im Abschnitt zum Bash-Werkzeug beschrieben ist, gilt für PowerShell-Befehle, einschließlich der Umgebungsvariable CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR.
Vorschau-Einschränkungen
Das PowerShell-Werkzeug hat während der Vorschau die folgenden bekannten Einschränkungen:
- PowerShell-Profile werden nicht geladen
- Unter Windows wird Sandboxing nicht unterstützt
Überprüfen Sie, welche Werkzeuge verfügbar sind
Ihr genaues Werkzeugsatz hängt von Ihrem Anbieter, Ihrer Plattform und Ihren Einstellungen ab. Um zu überprüfen, was in einer laufenden Sitzung geladen ist, fragen Sie Claude direkt:
What tools do you have access to?
Claude gibt eine Zusammenfassung im Gesprächsstil. Für genaue MCP-Werkzeugnamen führen Sie /mcp aus.
Siehe auch
- MCP-Server: Fügen Sie benutzerdefinierte Werkzeuge durch Verbindung externer Server hinzu
- Berechtigungen: Berechtigungssystem, Regelsyntax und werkzeugspezifische Muster
- Subagents: Konfigurieren Sie Werkzeugzugriff für Subagents
- Hooks: Führen Sie benutzerdefinierte Befehle vor oder nach der Werkzeugausführung aus