Tool bash
Tool bash memungkinkan Claude untuk menjalankan perintah shell dalam sesi bash yang persisten, memungkinkan operasi sistem, eksekusi skrip, dan otomatisasi command-line.
Tool bash memungkinkan Claude untuk menjalankan perintah shell dalam sesi bash yang persisten, memungkinkan operasi sistem, eksekusi skrip, dan otomatisasi command-line.
Ikhtisar
Tool bash menyediakan Claude dengan:
- Sesi bash persisten yang mempertahankan state
- Kemampuan untuk menjalankan perintah shell apa pun
- Akses ke variabel lingkungan dan direktori kerja
- Kemampuan chaining perintah dan scripting
Versi tool
Model | Versi Tool |
---|---|
Claude 4 & Sonnet 3.7 | bash_20250124 |
Claude Sonnet 3.5 | bash_20241022 |
Claude Sonnet 3.5 memerlukan header beta computer-use-2024-10-22
saat menggunakan tool bash.
Tool bash tersedia secara umum di Claude 4 dan Sonnet 3.7.
Kasus penggunaan
- Alur kerja pengembangan: Menjalankan perintah build, tes, dan alat pengembangan
- Otomatisasi sistem: Menjalankan skrip, mengelola file, mengotomatisasi tugas
- Pemrosesan data: Memproses file, menjalankan skrip analisis, mengelola dataset
- Pengaturan lingkungan: Menginstal paket, mengkonfigurasi lingkungan
Mulai cepat
Cara kerjanya
Tool bash mempertahankan sesi yang persisten:
- Claude menentukan perintah apa yang akan dijalankan
- Anda menjalankan perintah dalam shell bash
- Mengembalikan output (stdout dan stderr) ke Claude
- State sesi bertahan antar perintah (variabel lingkungan, direktori kerja)
Parameter
Parameter | Wajib | Deskripsi |
---|---|---|
command | Ya* | Perintah bash yang akan dijalankan |
restart | Tidak | Atur ke true untuk memulai ulang sesi bash |
*Wajib kecuali menggunakan restart
Contoh: Otomatisasi multi-langkah
Claude dapat merangkai perintah untuk menyelesaikan tugas kompleks:
Sesi mempertahankan state antar perintah, jadi file yang dibuat di langkah 2 tersedia di langkah 3.
Implementasi tool bash
Tool bash diimplementasikan sebagai tool tanpa skema. Saat menggunakan tool ini, Anda tidak perlu menyediakan skema input seperti tool lainnya; skema sudah terpasang dalam model Claude dan tidak dapat dimodifikasi.
Siapkan lingkungan bash
Buat sesi bash persisten yang dapat berinteraksi dengan Claude:
Tangani eksekusi perintah
Buat fungsi untuk menjalankan perintah dan menangkap output:
Proses panggilan tool Claude
Ekstrak dan jalankan perintah dari respons Claude:
Implementasi langkah keamanan
Tambahkan validasi dan pembatasan:
Tangani error
Saat mengimplementasikan tool bash, tangani berbagai skenario error:
Ikuti praktik terbaik implementasi
Keamanan
Tool bash menyediakan akses sistem langsung. Implementasikan langkah keamanan penting ini:
- Berjalan dalam lingkungan terisolasi (Docker/VM)
- Mengimplementasikan penyaringan perintah dan allowlist
- Menetapkan batas sumber daya (CPU, memori, disk)
- Mencatat semua perintah yang dijalankan
Rekomendasi utama
- Gunakan
ulimit
untuk menetapkan batasan sumber daya - Filter perintah berbahaya (
sudo
,rm -rf
, dll.) - Jalankan dengan izin pengguna minimal
- Monitor dan log semua eksekusi perintah
Harga
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
Lihat harga penggunaan tool untuk detail harga lengkap.
Pola umum
Alur kerja pengembangan
- Menjalankan tes:
pytest && coverage report
- Membangun proyek:
npm install && npm run build
- Operasi Git:
git status && git add . && git commit -m "message"
Operasi file
- Memproses data:
wc -l *.csv && ls -lh *.csv
- Mencari file:
find . -name "*.py" | xargs grep "pattern"
- Membuat backup:
tar -czf backup.tar.gz ./data
Tugas sistem
- Memeriksa sumber daya:
df -h && free -m
- Manajemen proses:
ps aux | grep python
- Pengaturan lingkungan:
export PATH=$PATH:/new/path && echo $PATH
Keterbatasan
- Tidak ada perintah interaktif: Tidak dapat menangani
vim
,less
, atau prompt password - Tidak ada aplikasi GUI: Hanya command-line
- Cakupan sesi: Bertahan dalam percakapan, hilang antar panggilan API
- Batas output: Output besar mungkin dipotong
- Tidak ada streaming: Hasil dikembalikan setelah selesai
Menggabungkan dengan tool lain
Tool bash paling kuat saat digabungkan dengan text editor dan tool lainnya.