도구

Bash 도구

Claude가 지속적인 bash 세션에서 셸 명령을 실행할 수 있게 해주는 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`	아니오	bash 세션을 재시작하려면 `true`로 설정

*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 도구

Claude가 지속적인 bash 세션에서 셸 명령을 실행할 수 있게 해주는 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`	아니오	bash 세션을 재시작하려면 `true`로 설정

*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 도구 구현

오류 처리

명령 실행 타임아웃

명령을 찾을 수 없음

권한 거부

구현 모범 사례 따르기

명령 타임아웃 사용

세션 상태 유지

대용량 출력 처리

모든 명령 로깅

출력 정제

보안

주요 권장 사항

가격

일반적인 패턴

개발 워크플로우

파일 작업

시스템 작업

제한 사항

다른 도구와 결합

다음 단계