ツール

Bashツール

Bashツールを使用すると、Claudeが永続的なbashセッションでシェルコマンドを実行でき、システム操作、スクリプト実行、コマンドライン自動化が可能になります。

概要

Bashツールは、Claudeに以下の機能を提供します：

状態を維持する永続的なbashセッション
任意のシェルコマンドを実行する機能
環境変数と作業ディレクトリへのアクセス
コマンドチェーンとスクリプト機能

モデル互換性

モデル	ツールバージョン
Claude 4モデルおよびSonnet 3.7（非推奨）	`bash_20250124`

古いツールバージョンは、新しいモデルとの後方互換性が保証されていません。常にモデルバージョンに対応するツールバージョンを使用してください。

ユースケース

開発ワークフロー：ビルドコマンド、テスト、開発ツールの実行
システム自動化：スクリプトの実行、ファイル管理、タスクの自動化
データ処理：ファイルの処理、分析スクリプトの実行、データセットの管理
環境セットアップ：パッケージのインストール、環境の設定

クイックスタート

import anthropic

client = anthropic.Anthropic()

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

仕組み

Bashツールは永続的なセッションを維持します：

Claudeが実行するコマンドを決定します
あなたがbashシェルでコマンドを実行します
出力（stdoutとstderr）をClaudeに返します
セッション状態はコマンド間で保持されます（環境変数、作業ディレクトリ）

パラメータ

パラメータ	必須	説明
`command`	はい*	実行するbashコマンド
`restart`	いいえ	`true`に設定するとbashセッションを再起動します

*restartを使用する場合を除き必須

例：マルチステップ自動化

Claudeはコマンドをチェーンして複雑なタスクを完了できます：

# ユーザーリクエスト
"requestsライブラリをインストールし、APIからジョークを取得するシンプルなPythonスクリプトを作成して、実行してください。"

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

セッションはコマンド間で状態を維持するため、ステップ2で作成されたファイルはステップ3で利用可能です。

Bashツールの実装

Bashツールはスキーマレスツールとして実装されています。このツールを使用する際、他のツールのように入力スキーマを提供する必要はありません。スキーマはClaudeのモデルに組み込まれており、変更できません。

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ツールはシステムへの直接アクセスを提供します。以下の重要な安全対策を実装してください：

隔離された環境（Docker/VM）での実行
コマンドフィルタリングと許可リストの実装
リソース制限（CPU、メモリ、ディスク）の設定
実行されたすべてのコマンドのログ記録

主な推奨事項

ulimitを使用してリソース制約を設定する
危険なコマンド（sudo、rm -rfなど）をフィルタリングする
最小限のユーザー権限で実行する
すべてのコマンド実行を監視およびログに記録する

料金

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

完全な料金の詳細については、ツール使用の料金を参照してください。

一般的なパターン

開発ワークフロー

テストの実行：pytest && coverage report
プロジェクトのビルド：npm install && npm run build
Git操作：git status && git add . && git commit -m "message"

ファイル操作

データの処理：wc -l *.csv && ls -lh *.csv
ファイルの検索：find . -name "*.py" | xargs grep "pattern"
バックアップの作成：tar -czf backup.tar.gz ./data

システムタスク

リソースの確認：df -h && free -m
プロセス管理：ps aux | grep python
環境セットアップ：export PATH=$PATH:/new/path && echo $PATH

制限事項

対話型コマンド非対応：vim、less、パスワードプロンプトは処理できません
GUIアプリケーション非対応：コマンドラインのみ
セッションスコープ：会話内で保持されますが、API呼び出し間では失われます
出力制限：大きな出力は切り詰められる場合があります
ストリーミング非対応：結果は完了後に返されます

他のツールとの組み合わせ

Bashツールは、テキストエディタやその他のツールと組み合わせることで最も強力になります。

次のステップ

ツール使用の概要

Claudeでのツール使用について学ぶ

テキストエディタツール

Claudeでテキストファイルを表示・編集する

Was this page helpful?

ツール

Bashツール

概要

Bashツールは、Claudeに以下の機能を提供します：

状態を維持する永続的なbashセッション
任意のシェルコマンドを実行する機能
環境変数と作業ディレクトリへのアクセス
コマンドチェーンとスクリプト機能

モデル互換性

モデル	ツールバージョン
Claude 4モデルおよびSonnet 3.7（非推奨）	`bash_20250124`

ユースケース

開発ワークフロー：ビルドコマンド、テスト、開発ツールの実行
システム自動化：スクリプトの実行、ファイル管理、タスクの自動化
データ処理：ファイルの処理、分析スクリプトの実行、データセットの管理
環境セットアップ：パッケージのインストール、環境の設定

クイックスタート

import anthropic

client = anthropic.Anthropic()

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

仕組み

Bashツールは永続的なセッションを維持します：

Claudeが実行するコマンドを決定します
あなたがbashシェルでコマンドを実行します
出力（stdoutとstderr）をClaudeに返します
セッション状態はコマンド間で保持されます（環境変数、作業ディレクトリ）

パラメータ

パラメータ	必須	説明
`command`	はい*	実行するbashコマンド
`restart`	いいえ	`true`に設定するとbashセッションを再起動します

*restartを使用する場合を除き必須

例：マルチステップ自動化

Claudeはコマンドをチェーンして複雑なタスクを完了できます：

# ユーザーリクエスト
"requestsライブラリをインストールし、APIからジョークを取得するシンプルなPythonスクリプトを作成して、実行してください。"

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

セッションはコマンド間で状態を維持するため、ステップ2で作成されたファイルはステップ3で利用可能です。

Bashツールの実装

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ツールはシステムへの直接アクセスを提供します。以下の重要な安全対策を実装してください：

隔離された環境（Docker/VM）での実行
コマンドフィルタリングと許可リストの実装
リソース制限（CPU、メモリ、ディスク）の設定
実行されたすべてのコマンドのログ記録

主な推奨事項

ulimitを使用してリソース制約を設定する
危険なコマンド（sudo、rm -rfなど）をフィルタリングする
最小限のユーザー権限で実行する
すべてのコマンド実行を監視およびログに記録する

料金

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

完全な料金の詳細については、ツール使用の料金を参照してください。

一般的なパターン

開発ワークフロー

テストの実行：pytest && coverage report
プロジェクトのビルド：npm install && npm run build
Git操作：git status && git add . && git commit -m "message"

ファイル操作

データの処理：wc -l *.csv && ls -lh *.csv
ファイルの検索：find . -name "*.py" | xargs grep "pattern"
バックアップの作成：tar -czf backup.tar.gz ./data

システムタスク

リソースの確認：df -h && free -m
プロセス管理：ps aux | grep python
環境セットアップ：export PATH=$PATH:/new/path && echo $PATH

制限事項

対話型コマンド非対応：vim、less、パスワードプロンプトは処理できません
GUIアプリケーション非対応：コマンドラインのみ
セッションスコープ：会話内で保持されますが、API呼び出し間では失われます
出力制限：大きな出力は切り詰められる場合があります
ストリーミング非対応：結果は完了後に返されます

他のツールとの組み合わせ

Bashツールは、テキストエディタやその他のツールと組み合わせることで最も強力になります。

次のステップ

ツール使用の概要

Claudeでのツール使用について学ぶ

テキストエディタツール

Claudeでテキストファイルを表示・編集する

Was this page helpful?

概要

モデル互換性

ユースケース

クイックスタート

仕組み

パラメータ

使用例

例：マルチステップ自動化

Bashツールの実装

エラーの処理

コマンド実行タイムアウト

コマンドが見つからない

権限拒否

実装のベストプラクティスに従う

コマンドタイムアウトを使用する

セッション状態を維持する

大きな出力を処理する

すべてのコマンドをログに記録する

出力をサニタイズする

セキュリティ

主な推奨事項

料金

一般的なパターン

開発ワークフロー

ファイル操作

システムタスク

制限事項

他のツールとの組み合わせ

次のステップ

概要

モデル互換性

ユースケース

クイックスタート

仕組み

パラメータ

使用例

例：マルチステップ自動化

Bashツールの実装

エラーの処理

コマンド実行タイムアウト

コマンドが見つからない

権限拒否

実装のベストプラクティスに従う

コマンドタイムアウトを使用する

セッション状態を維持する

大きな出力を処理する

すべてのコマンドをログに記録する

出力をサニタイズする

セキュリティ

主な推奨事項

料金

一般的なパターン

開発ワークフロー

ファイル操作

システムタスク

制限事項

他のツールとの組み合わせ

次のステップ