Referensi Tools

​

Konfigurasi tools dengan aturan izin dan hooks

• dalam permissions.allow dan permissions.deny dalam pengaturan, dan antarmuka /permissions
• dalam flag CLI --allowedTools dan --disallowedTools
• dalam opsi allowedTools dan disallowedTools Agent SDK
• dalam frontmatter tools atau disallowedTools subagent
• dalam frontmatter allowed-tools skill
• dalam kondisi if hook

​

Perilaku Agent tool

• Tidak ada field yang diatur: subagent mewarisi setiap tool yang tersedia untuk induk.
• Hanya tools: subagent mendapatkan hanya tools yang tercantum.
• Hanya disallowedTools: subagent mendapatkan setiap tool induk kecuali yang tercantum.
• Keduanya diatur: disallowedTools mengambil alih. Tool yang tercantum di keduanya dihapus.

• Subagent foreground menampilkan prompt izin yang sama yang akan Anda lihat dalam percakapan utama, pada saat setiap panggilan tool terjadi.
• Subagent background menampilkan prompt izin dalam sesi utama Anda sejak v2.1.186. Prompt menunjukkan subagent mana yang meminta, dan menekan Esc menolak panggilan tool itu saja tanpa menghentikan subagent. Sebelum v2.1.186, subagent background secara otomatis menolak panggilan tool apa pun yang sebaliknya akan meminta dan melanjutkan tanpa tool itu.

​

Perilaku Bash tool

• Ketika Claude menjalankan cd dalam sesi utama, direktori kerja baru berlanjut ke perintah Bash yang lebih baru selama tetap berada di dalam direktori proyek atau direktori kerja tambahan yang Anda tambahkan dengan --add-dir, /add-dir, atau additionalDirectories dalam pengaturan. Sesi subagent tidak pernah membawa perubahan direktori kerja.
  • Jika cd mendarat di luar direktori tersebut, Claude Code mengatur ulang ke direktori proyek dan menambahkan Shell cwd was reset to <dir> ke hasil tool.
  • Untuk menonaktifkan carry-over ini sehingga setiap perintah Bash dimulai di direktori proyek, atur CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
• Variabel lingkungan tidak persisten. export dalam satu perintah tidak akan tersedia di perintah berikutnya.
• Alias dan fungsi shell yang ditentukan dalam file startup shell Anda tersedia. Pada awal sesi, Claude Code bersumber dari ~/.zshrc, ~/.bashrc, atau ~/.profile tergantung pada shell Anda, menangkap alias, fungsi, dan opsi shell yang dihasilkan, dan menerapkannya ke setiap perintah Bash.

• Timeout: dua menit secara default. Claude dapat meminta hingga 10 menit per perintah dengan parameter timeout. Ganti default dan ceiling dengan BASH_DEFAULT_TIMEOUT_MS dan BASH_MAX_TIMEOUT_MS.
• Panjang output: 30.000 karakter secara default. Ketika perintah menghasilkan lebih dari itu, Claude Code menyimpan output penuh ke file dalam direktori sesi dan memberikan Claude jalur file ditambah pratinjau singkat dari awal. Claude membaca atau mencari file itu ketika membutuhkan sisanya. Naikkan batas dengan BASH_MAX_OUTPUT_LENGTH, hingga ceiling keras 150.000 karakter.

​

Perilaku Edit tool

• Read-before-edit: Claude harus telah membaca file dalam percakapan saat ini, dan file tidak boleh berubah di disk sejak pembacaan itu. Pemeriksaan ini berjalan pertama, sebelum pencocokan string apa pun.
• Match: old_string harus muncul dalam file persis seperti yang ditulis. Satu karakter perbedaan whitespace atau indentasi sudah cukup untuk melewatkan.
• Uniqueness: old_string harus muncul persis sekali. Ketika muncul lebih dari sekali, Claude baik menyediakan string yang lebih panjang dengan konteks sekitar yang cukup untuk menyematkan satu kemunculan, atau mengatur replace_all: true untuk mengganti semuanya.

​

Perilaku Glob tool

• **/*.js cocok dengan semua file .js pada kedalaman apa pun
• src/**/*.ts cocok dengan semua file .ts di bawah src/
• *.{json,yaml} cocok dengan file .json dan .yaml dalam direktori saat ini

​

Perilaku Grep tool

• files_with_matches: jalur file saja, tidak ada konten baris. Ini adalah default.
• content: baris yang cocok dengan file dan nomor baris.
• count: jumlah kecocokan per file.

​

Perilaku LSP tool

• Lompat ke definisi simbol
• Temukan semua referensi ke simbol
• Dapatkan informasi tipe pada posisi
• Daftar simbol dalam file
• Cari simbol berdasarkan nama di seluruh workspace
• Temukan implementasi antarmuka
• Lacak hierarki panggilan

​

Monitor tool

• Tail file log dan tandai kesalahan saat muncul
• Poll PR atau CI job dan laporkan ketika statusnya berubah
• Pantau direktori untuk perubahan file
• Lacak output dari skrip yang sedang berjalan lama yang Anda tunjukkan
• Terhubung ke feed WebSocket dan laporkan setiap pesan saat tiba

​

WebSocket source

• Pesan teks: masing-masing menjadi satu peristiwa, bahkan ketika pesan mencakup beberapa baris.
• Pesan biner: tidak dilewatkan. Claude menerima baris placeholder seperti [binary frame, 512 bytes] sebagai gantinya.
• Pesan lebih besar dari 1 MiB: watch berakhir, jadi berlangganan feed yang disaring jika ada.
• Penutupan soket: watch berakhir dan Claude menerima kode penutupan.

​

Perilaku NotebookEdit tool

• replace: timpa sumber sel. Ini adalah default.
• insert: tambahkan sel baru setelah target. Tanpa cell_id, sel baru masuk di awal notebook. Memerlukan cell_type diatur ke code atau markdown.
• delete: hapus sel target.

​

PowerShell tool

​

Aktifkan PowerShell tool

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

​

Pemilihan shell dalam pengaturan, hooks, dan skills

• "defaultShell": "powershell" dalam settings.json: merutekan perintah ! interaktif melalui PowerShell. Memerlukan PowerShell tool untuk diaktifkan.
• "shell": "powershell" pada command hooks individual: menjalankan hook tersebut dalam PowerShell. Hooks menjalankan PowerShell secara langsung, jadi ini berfungsi terlepas dari CLAUDE_CODE_USE_POWERSHELL_TOOL.
• shell: powershell dalam skill frontmatter: menjalankan blok !`command` dalam PowerShell. Memerlukan PowerShell tool untuk diaktifkan.

​

Batasan pratinjau

• Profil PowerShell tidak dimuat
• Di Windows, sandboxing tidak didukung

​

Perilaku Read tool

• Gambar: PNG, JPG, dan format gambar lainnya dikembalikan sebagai konten visual yang dapat dilihat Claude, bukan sebagai byte mentah. Claude Code mengubah ukuran dan mengompresi ulang gambar besar agar sesuai dengan batas ukuran gambar model sebelum mengirimnya, jadi Claude mungkin melihat versi downscaled dari screenshot besar. Mulai dari v2.1.196, gambar yang masih lebih besar dari 500KB setelah pengubahan ukuran tersebut dikodekan ulang sebagai JPEG dengan kualitas berkurang dengan dimensi pikselnya tetap tidak berubah. Jika Claude melewatkan detail tingkat piksel halus dalam gambar besar, minta untuk memotong wilayah minat terlebih dahulu, misalnya dengan ImageMagick melalui Bash.
• PDF: Claude membaca file .pdf pendek secara keseluruhan. Untuk PDF lebih panjang dari 10 halaman, membaca dalam rentang dengan parameter pages, seperti "1-5", hingga 20 halaman sekaligus.
• Notebook Jupyter: file .ipynb mengembalikan semua sel dengan output mereka, termasuk kode, markdown, dan visualisasi.

​

Perilaku WebFetch tool

• URL HTTP secara otomatis ditingkatkan ke HTTPS.
• Halaman besar dipotong ke batas karakter tetap sebelum pemrosesan.
• Respons di-cache selama 15 menit, jadi fetch berulang dari URL yang sama kembali dengan cepat.
• Ketika URL mengalihkan ke host yang berbeda, WebFetch mengembalikan hasil teks yang menyebutkan URL asli dan target pengalihan daripada mengikutinya. Claude kemudian mengambil URL baru dengan panggilan WebFetch kedua.

​

Perilaku WebSearch tool

​

Perilaku Write tool

​

Periksa tools mana yang tersedia

What tools do you have access to?

​

Lihat juga

• MCP servers: tambahkan tools kustom dengan menghubungkan server eksternal
• Permissions: sistem izin, sintaks aturan, dan pola khusus tool
• Subagents: konfigurasi akses tool untuk subagent
• Hooks: jalankan perintah kustom sebelum atau sesudah eksekusi tool