Bash 工具

模型	工具版本
Claude 4 模型和 Sonnet 3.7 (已棄用)	`bash_20250124`

模型	工具版本
Claude 4 模型和 Sonnet 3.7 (已棄用)	`bash_20250124`

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

參數	必需	描述
`command`	是*	要運行的 bash 命令
`restart`	否	設置為 `true` 以重新啟動 bash 會話

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

# Claude 的工具使用：
# 1. 安裝軟件包
{"command": "pip install requests"}

# 2. 創建腳本
{"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. 運行腳本
{"command": "python fetch_joke.py"}

設置 bash 環境

創建一個 Claude 可以交互的持久 bash 會話：

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):
    # 將命令發送到 bash
    self.process.stdin.write(command + '\n')
    self.process.stdin.flush()
    
    # 使用超時捕獲輸出
    output = self._read_output(timeout=10)
    return output

處理 Claude 的工具調用

從 Claude 的響應中提取並執行命令：

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)
        
        # 將結果返回給 Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

實現安全措施

添加驗證和限制：

def validate_command(command):
    # 阻止危險命令
    dangerous_patterns = ['rm -rf /', 'format', ':(){:|:&};:']
    for pattern in dangerous_patterns:
        if pattern in command:
            return False, f"Command contains dangerous pattern: {pattern}"
    
    # 根據需要添加更多驗證
    return True, None

Bash 工具

概述

模型兼容性

使用案例

Bash 工具

概述

模型兼容性

使用案例

快速開始

工作原理

參數

示例：多步驟自動化

實現 bash 工具

處理錯誤

遵循實現最佳實踐

安全性

關鍵建議

定價

常見模式

開發工作流程

文件操作

系統任務

限制

與其他工具結合

後續步驟

概述

模型兼容性

使用案例

概述

模型兼容性

使用案例

快速開始

工作原理

參數

使用示例

示例：多步驟自動化

實現 bash 工具

處理錯誤

命令執行超時

命令未找到

權限被拒絕

遵循實現最佳實踐

使用命令超時

維持會話狀態

處理大型輸出

記錄所有命令

清理輸出

安全性

關鍵建議

定價

常見模式

開發工作流程

文件操作

系統任務

限制

與其他工具結合

後續步驟