Bash-Tool

Das Bash-Tool ermöglicht Claude, Shell-Befehle in einer persistenten Bash-Sitzung auszuführen, was Systemoperationen, Skriptausführung und Befehlszeilenautomatisierung ermöglicht.

Übersicht

Das Bash-Tool bietet Claude:

Persistente Bash-Sitzung, die den Status beibehält
Möglichkeit, jeden Shell-Befehl auszuführen
Zugriff auf Umgebungsvariablen und Arbeitsverzeichnis
Befehlsverkettungs- und Skriptfunktionen

Modellkompatibilität

Modell	Tool-Version
Claude 4-Modelle und Sonnet 3.7 (veraltet)	`bash_20250124`

Ältere Tool-Versionen sind nicht garantiert abwärtskompatibel mit neueren Modellen. Verwenden Sie immer die Tool-Version, die Ihrer Modellversion entspricht.

Anwendungsfälle

Entwicklungs-Workflows: Führen Sie Build-Befehle, Tests und Entwicklungstools aus
Systemautomatisierung: Führen Sie Skripte aus, verwalten Sie Dateien, automatisieren Sie Aufgaben
Datenverarbeitung: Verarbeiten Sie Dateien, führen Sie Analyseskripte aus, verwalten Sie Datensätze
Umgebungseinrichtung: Installieren Sie Pakete, konfigurieren Sie Umgebungen

Schnellstart

Funktionsweise

Das Bash-Tool verwaltet eine persistente Sitzung:

Claude bestimmt, welcher Befehl ausgeführt werden soll
Sie führen den Befehl in einer Bash-Shell aus
Geben Sie die Ausgabe (stdout und stderr) an Claude zurück
Der Sitzungsstatus bleibt zwischen Befehlen erhalten (Umgebungsvariablen, Arbeitsverzeichnis)

Parameter

Parameter	Erforderlich	Beschreibung
`command`	Ja*	Der auszuführende Bash-Befehl
`restart`	Nein	Auf `true` setzen, um die Bash-Sitzung neu zu starten

*Erforderlich, es sei denn, Sie verwenden restart

Beispiel: Mehrstufige Automatisierung

Claude kann Befehle verketten, um komplexe Aufgaben zu erledigen:

# Benutzeranfrage
"Install the requests library and create a simple Python script that fetches a joke from an API, then run it."

# Claudes Tool verwendet:
# 1. Paket installieren
{"command": "pip install requests"}

# 2. Skript erstellen
{"command": "cat > fetch_joke.py << 'EOF'\nimport requests\nresponse = requests.get('https://official-joke-api.appspot.com/random_joke')\njoke = response.json()\nprint(f\"Setup: {joke['setup']}\")\nprint(f\"Punchline: {joke['punchline']}\")\nEOF"}

# 3. Skript ausführen
{"command": "python fetch_joke.py"}

Die Sitzung behält den Status zwischen Befehlen bei, sodass in Schritt 2 erstellte Dateien in Schritt 3 verfügbar sind.

Implementieren Sie das Bash-Tool

Das Bash-Tool wird als schemalooses Tool implementiert. Bei der Verwendung dieses Tools müssen Sie kein Eingabeschema wie bei anderen Tools bereitstellen. Das Schema ist in Claudes Modell integriert und kann nicht geändert werden.

Behandeln Sie Fehler

Bei der Implementierung des Bash-Tools müssen Sie verschiedene Fehlerszenarien behandeln:

Befolgen Sie Best Practices für die Implementierung

Sicherheit

Das Bash-Tool bietet direkten Systemzugriff. Implementieren Sie diese wesentlichen Sicherheitsmaßnahmen:

Ausführung in isolierten Umgebungen (Docker/VM)
Implementierung von Befehlsfilterung und Allowlists
Festlegung von Ressourcenlimits (CPU, Speicher, Festplatte)
Protokollierung aller ausgeführten Befehle

Wichtige Empfehlungen

Verwenden Sie ulimit, um Ressourcenbeschränkungen festzulegen
Filtern Sie gefährliche Befehle (sudo, rm -rf, usw.)
Führen Sie mit minimalen Benutzerberechtigungen aus
Überwachen und protokollieren Sie alle Befehlsausführungen

Preisgestaltung

The bash tool adds 245 input tokens to your API calls.

Additional tokens are consumed by:

Command outputs (stdout/stderr)
Error messages
Large file contents

Siehe Tool-Use-Preisgestaltung für vollständige Preisdetails.

Häufige Muster

Entwicklungs-Workflows

Tests ausführen: pytest && coverage report
Projekte erstellen: npm install && npm run build
Git-Operationen: git status && git add . && git commit -m "message"

Dateivorgänge

Daten verarbeiten: wc -l *.csv && ls -lh *.csv
Dateien durchsuchen: find . -name "*.py" | xargs grep "pattern"
Sicherungen erstellen: tar -czf backup.tar.gz ./data

Systemaufgaben

Ressourcen überprüfen: df -h && free -m
Prozessverwaltung: ps aux | grep python
Umgebungseinrichtung: export PATH=$PATH:/new/path && echo $PATH

Einschränkungen

Keine interaktiven Befehle: Kann vim, less oder Passwortaufforderungen nicht verarbeiten
Keine GUI-Anwendungen: Nur Befehlszeilenschnittstelle
Sitzungsbereich: Bleibt innerhalb der Konversation bestehen, geht zwischen API-Aufrufen verloren
Ausgabelimits: Große Ausgaben können gekürzt werden
Kein Streaming: Ergebnisse werden nach Abschluss zurückgegeben

Kombination mit anderen Tools

Das Bash-Tool ist am leistungsfähigsten, wenn es mit dem Text-Editor und anderen Tools kombiniert wird.

Nächste Schritte

Tool-Use-Übersicht

Erfahren Sie mehr über Tool-Use mit Claude

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    tools=[
        {
            "type": "bash_20250124",
            "name": "bash"
        }
    ],
    messages=[
        {"role": "user", "content": "List all Python files in the current directory."}
    ]
)

Richten Sie eine Bash-Umgebung ein

Erstellen Sie eine persistente Bash-Sitzung, mit der Claude interagieren kann:

import subprocess
import threading
import queue

class BashSession:
    def __init__(self):
        self.process = subprocess.Popen(
            ['/bin/bash'],
            stdin=subprocess.PIPE,
            stdout=subprocess.PIPE,
            stderr=subprocess.PIPE,
            text=True,
            bufsize=0
        )
        self.output_queue = queue.Queue()
        self.error_queue = queue.Queue()
        self._start_readers()

Behandeln Sie die Befehlsausführung

Erstellen Sie eine Funktion zum Ausführen von Befehlen und zum Erfassen der Ausgabe:

def execute_command(self, command):
    # Befehl an Bash senden
    self.process.stdin.write(command + '\n')
    self.process.stdin.flush()
    
    # Ausgabe mit Timeout erfassen
    output = self._read_output(timeout=10)
    return output

Verarbeiten Sie Claudes Tool-Aufrufe

Extrahieren und führen Sie Befehle aus Claudes Antworten aus:

for content in response.content:
    if content.type == "tool_use" and content.name == "bash":
        if content.input.get("restart"):
            bash_session.restart()
            result = "Bash session restarted"
        else:
            command = content.input.get("command")
            result = bash_session.execute_command(command)
        
        # Ergebnis an Claude zurückgeben
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

Implementieren Sie Sicherheitsmaßnahmen

Fügen Sie Validierung und Einschränkungen hinzu:

def validate_command(command):
    # Gefährliche Befehle blockieren
    dangerous_patterns = ['rm -rf /', 'format', ':(){:|:&};:']
    for pattern in dangerous_patterns:
        if pattern in command:
            return False, f"Command contains dangerous pattern: {pattern}"
    
    # Weitere Validierung nach Bedarf hinzufügen
    return True, None

Übersicht

Modellkompatibilität

Anwendungsfälle

Schnellstart

Funktionsweise

Parameter

Beispielverwendung

Beispiel: Mehrstufige Automatisierung

Implementieren Sie das Bash-Tool

Behandeln Sie Fehler

Timeout bei Befehlsausführung

Befehl nicht gefunden

Befolgen Sie Best Practices für die Implementierung

Verwenden Sie Befehlszeitüberschreitungen

Sicherheit

Wichtige Empfehlungen

Preisgestaltung

Häufige Muster

Entwicklungs-Workflows

Dateivorgänge

Systemaufgaben

Einschränkungen

Kombination mit anderen Tools

Nächste Schritte

Berechtigung verweigert

Behalten Sie den Sitzungsstatus bei

Behandeln Sie große Ausgaben

Protokollieren Sie alle Befehle

Bereinigen Sie Ausgaben