Werkzeuge

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 Zustand beibehält
Möglichkeit, jeden Shell-Befehl auszuführen
Zugriff auf Umgebungsvariablen und Arbeitsverzeichnis
Befehlsverkettung und Skriptfunktionen

Modellkompatibilität

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

Ältere Tool-Versionen sind nicht garantiert rückwä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
Umgebungssetup: Installieren Sie Pakete, konfigurieren Sie Umgebungen

Schnellstart

Python

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."}
    ]
)

Shell

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "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."
      }
    ]
  }'

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 Sitzungszustand 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 Zustand 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 schemafreies 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.

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 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}"
    
    # Fügen Sie weitere Validierungen nach Bedarf hinzu
    return True, None

Behandeln Sie Fehler

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

Befolgen Sie Best Practices bei der 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
Umgebungssetup: export PATH=$PATH:/new/path && echo $PATH

Einschränkungen

Keine interaktiven Befehle: Kann vim, less oder Passwort-Eingabeaufforderungen nicht verarbeiten
Keine GUI-Anwendungen: Nur Befehlszeile
Sitzungsumfang: Bleibt innerhalb des Gesprächs erhalten, geht zwischen API-Aufrufen verloren
Ausgabelimits: Große Ausgaben können gekürzt werden
Kein Streaming: Ergebnisse werden nach Abschluss zurückgegeben

Kombinieren mit anderen Tools

Das Bash-Tool ist am leistungsstärksten, 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

Text-Editor-Tool

Anzeigen und Bearbeiten von Textdateien mit Claude

Werkzeuge

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 Zustand beibehält
Möglichkeit, jeden Shell-Befehl auszuführen
Zugriff auf Umgebungsvariablen und Arbeitsverzeichnis
Befehlsverkettung und Skriptfunktionen

Modellkompatibilität

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

Ältere Tool-Versionen sind nicht garantiert rückwä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
Umgebungssetup: Installieren Sie Pakete, konfigurieren Sie Umgebungen

Schnellstart

Python

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."}
    ]
)

Shell

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "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."
      }
    ]
  }'

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 Sitzungszustand 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 Zustand zwischen Befehlen bei, sodass in Schritt 2 erstellte Dateien in Schritt 3 verfügbar sind.

Implementieren Sie das Bash-Tool

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 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}"
    
    # Fügen Sie weitere Validierungen nach Bedarf hinzu
    return True, None

Behandeln Sie Fehler

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

Befolgen Sie Best Practices bei der 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
Umgebungssetup: export PATH=$PATH:/new/path && echo $PATH

Einschränkungen

Keine interaktiven Befehle: Kann vim, less oder Passwort-Eingabeaufforderungen nicht verarbeiten
Keine GUI-Anwendungen: Nur Befehlszeile
Sitzungsumfang: Bleibt innerhalb des Gesprächs erhalten, geht zwischen API-Aufrufen verloren
Ausgabelimits: Große Ausgaben können gekürzt werden
Kein Streaming: Ergebnisse werden nach Abschluss zurückgegeben

Kombinieren mit anderen Tools

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

Ü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

Zugriff verweigert

Befolgen Sie Best Practices bei der Implementierung

Verwenden Sie Befehls-Timeouts

Behalten Sie den Sitzungszustand bei

Behandeln Sie große Ausgaben

Protokollieren Sie alle Befehle

Bereinigen Sie Ausgaben

Sicherheit

Wichtige Empfehlungen

Preisgestaltung

Häufige Muster

Entwicklungs-Workflows

Dateivorgänge

Systemaufgaben

Einschränkungen

Kombinieren mit anderen Tools

Nächste Schritte

Tool-Use-Übersicht

Text-Editor-Tool

Ü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

Zugriff verweigert

Befolgen Sie Best Practices bei der Implementierung

Verwenden Sie Befehls-Timeouts

Behalten Sie den Sitzungszustand bei

Behandeln Sie große Ausgaben

Protokollieren Sie alle Befehle

Bereinigen Sie Ausgaben

Sicherheit

Wichtige Empfehlungen

Preisgestaltung

Häufige Muster

Entwicklungs-Workflows

Dateivorgänge

Systemaufgaben

Einschränkungen

Kombinieren mit anderen Tools

Nächste Schritte

Tool-Use-Übersicht

Text-Editor-Tool