Bash-Tool

​

Übersicht

• 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

​

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

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

​

Funktionsweise

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

​

Parameter

// Befehl ausführen
{
  "command": "ls -la *.py"
}

// Sitzung neu starten
{
  "restart": true
}

​

Beispiel: Mehrstufige Automatisierung

# 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"}

​

Implementieren Sie das Bash-Tool

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()

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

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
        }

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

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Command timed out after 30 seconds",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "bash: nonexistentcommand: command not found",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "bash: /root/sensitive-file: Permission denied",
      "is_error": true
    }
  ]
}

​

Befolgen Sie Best Practices bei der Implementierung

def execute_with_timeout(command, timeout=30):
    try:
        result = subprocess.run(
            command, 
            shell=True, 
            capture_output=True, 
            text=True, 
            timeout=timeout
        )
        return result.stdout + result.stderr
    except subprocess.TimeoutExpired:
        return f"Command timed out after {timeout} seconds"

# Befehle, die in derselben Sitzung ausgeführt werden, behalten den Zustand bei
commands = [
    "cd /tmp",
    "echo 'Hello' > test.txt",
    "cat test.txt"  # Dies funktioniert, weil wir noch in /tmp sind
]

def truncate_output(output, max_lines=100):
    lines = output.split('\n')
    if len(lines) > max_lines:
        truncated = '\n'.join(lines[:max_lines])
        return f"{truncated}\n\n... Output truncated ({len(lines)} total lines) ..."
    return output

import logging

def log_command(command, output, user_id):
    logging.info(f"User {user_id} executed: {command}")
    logging.info(f"Output: {output[:200]}...")  # Protokollieren Sie die ersten 200 Zeichen

def sanitize_output(output):
    # Entfernen Sie potenzielle Geheimnisse oder Anmeldedaten
    import re
    # Beispiel: AWS-Anmeldedaten entfernen
    output = re.sub(r'aws_access_key_id\s*=\s*\S+', 'aws_access_key_id=***', output)
    output = re.sub(r'aws_secret_access_key\s*=\s*\S+', 'aws_secret_access_key=***', output)
    return output

​

Sicherheit

​

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

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

​

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

​

Nächste Schritte