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 Agent SDK allowedTools dan disallowedTools
• dalam frontmatter allowed-tools skill
• dalam kondisi if hook

​

Perilaku tool Agent

• Tidak ada bidang yang diatur: subagent mewarisi setiap tool yang tersedia untuk subagents.
• tools saja: subagent hanya mendapatkan tool yang terdaftar.
• disallowedTools saja: subagent mendapatkan setiap tool induk kecuali yang terdaftar.
• Keduanya diatur: disallowedTools memiliki prioritas. Tool yang terdaftar di keduanya dihapus.

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

​

Perilaku tool AskUserQuestion

​

Timeout auto-continue pertanyaan

​

Perilaku alat Bash

​

Apa yang bertahan di antara perintah

• Ketika Claude menjalankan cd dalam sesi utama, direktori kerja baru terbawa 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. Ini termasuk perintah yang Claude jalankan sebagai respons terhadap pesan Anda yang lebih baru.
  • 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 alat.
  • Untuk menonaktifkan carry-over ini sehingga setiap perintah Bash dimulai di direktori proyek, atur CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
• Variabel lingkungan tidak bertahan. 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.

​

Batas waktu dan output

• BASH_DEFAULT_TIMEOUT_MS — default ketika Claude tidak melewatkan batas waktu; dua menit di luar kotak
• BASH_MAX_TIMEOUT_MS — dengan default, menetapkan batas yang membatasi apa pun yang Claude minta: batas efektif adalah yang lebih besar dari keduanya, sepuluh menit di luar kotak

​

Batas output

​

Perintah latar belakang

• Ketika batas waktu memicu perpindahan, hasil melaporkannya secara eksplisit: Command did not complete within its 120s timeout and was moved to the background, dengan detik sesuai dengan batas waktu yang berlaku, diikuti oleh ID tugas dan jalur file tempat output ditulis.
• Sebuah cd, pushd, popd, atau chdir di dalam perintah yang dipindahkan ke latar belakang tidak pernah terbawa: hasil menyatakan Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands., jadi Claude tidak bertindak atas perubahan direktori yang tidak terjadi.

​

Batas memori di Linux dan WSL

• Tulis ukuran sebagai jumlah byte atau dengan akhiran K, M, G, atau T. Atur 0, off, false, no, atau none untuk mematikan batas. Claude Code mengabaikan nilai apa pun yang tidak dapat dibacanya sebagai ukuran, seperti 4e9.
• Claude Code menghitung semua perintah Bash, PowerShell, dan Monitor sesi terhadap satu batas, bukan setiap perintah pada dirinya sendiri.
• Claude Code menerapkan batas dengan cgroup memori. Ketika tidak dapat mengatur cgroup, perintah berjalan tanpa batas, dan log debug dari claude --debug mengatakan mengapa.
• Setelah proses pertama yang Claude Code mulai telah menghidupkan batas, atau telah mematikannya karena nilai off atau setup cgroup yang gagal, Claude Code menahan hasil itu sampai Anda meluncurkan kembali. Untuk menerapkan nilai yang diubah atau dihapus, atau setup yang diperbaiki, luncurkan claude lagi.
• Ketika perintah tidak dapat tetap di bawah batas, kernel membunuh perintah, dan tidak ada dalam hasilnya yang menyebutkan batas.

• mcp: server MCP lokal
• lsp: server bahasa
• hooks: perintah hook
• plugin: perintah yang plugin jalankan
• helper: perintah helper Claude Code sendiri, seperti git
• agent: proses Claude Code anak, seperti rekan tim agen

• Nama tidak dikenal: Claude Code mengabaikan nama yang tidak dikenalinya
• Bash, PowerShell, dan Monitor: Claude Code menjaga perintah alat Bash, PowerShell, dan Monitor di bawah batas apa pun yang Anda daftar
• Variabel tidak diatur: Claude Code mengambil set jenis yang dibatasi lainnya dari konfigurasi yang Anthropic berikan dari server, dan set itu dapat berubah seiring waktu, jadi atur variabel ketika Anda membutuhkan set yang tidak berubah
• Hook gating izin: bahkan dengan setiap jenis dibatasi, Claude Code mengecualikan dari batas hook yang dapat memblokir atau mengubah hasil tindakan, dan server MCP apa pun yang hook tersebut panggil, sehingga kernel membunuh hook gating izin tidak dapat memungkinkan tindakan yang sedang diblokir.

​

Perilaku alat Edit

• Read-before-edit: Claude membaca file dalam percakapan saat ini sebelum mengeditnya, dan pembacaan yang terpotong dengan pemberitahuan PARTIAL view tidak dihitung. Claude Opus 4.6, Claude Haiku 4.5, dan model yang lebih lama selalu memerlukan pembacaan. Model yang lebih baru dapat mengedit file yang belum dibaca ketika membacanya tidak memerlukan prompt izin dan alat Read tersedia.
• Match: old_string harus muncul dalam file persis seperti yang ditulis. Perbedaan spasi atau indentasi satu karakter saja sudah cukup untuk tidak cocok.
• Uniqueness: old_string harus muncul tepat satu kali. Ketika muncul lebih dari sekali, Claude baik menyediakan string yang lebih panjang dengan konteks sekitar yang cukup untuk menentukan satu kemunculan, atau menetapkan replace_all: true untuk mengganti semuanya.

​

Perilaku tool EndConversation

• sebagai upaya terakhir melawan input yang terus-menerus kasar, setelah upaya untuk mengalihkan percakapan telah gagal dan setelah peringatan yang jelas dalam pesan sebelumnya
• ketika Anda secara eksplisit meminta untuk melihat tool yang ditunjukkan dan mengonfirmasi bahwa Anda ingin sesi berakhir

• Version: Claude Code v2.1.213 atau lebih baru.
• Model: model sesi adalah Claude Opus 4.8, Claude Sonnet 5, Claude Fable 5, atau versi yang lebih baru dari salah satu keluarga tersebut.
• Surface: sesi terminal interaktif, termasuk sesi claude di terminal terintegrasi IDE, yang merupakan cara plugin JetBrains menjalankannya. Permukaan lain tidak menyertakan tool, seperti:
  • run -p non-interaktif
  • sesi melalui paket TypeScript dan Python Agent SDK
  • panel VS Code extension, yang menggabungkan CLI-nya sendiri
  • GitHub Actions
  • Claude Code di web
• Startup mode: bukan sesi --bare. Mode bare hanya memuat shell dan file tools, jadi tool tidak pernah terdaftar di sana.
• Provider: tidak tersedia di Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, atau Microsoft Foundry, atau di sesi yang masuk melalui cloud gateway.

​

Perilaku Glob tool

• Anda menyebutkan Glob atau Grep dalam --tools atau --allowedTools ketika Anda memulai sesi, atau dalam opsi Agent SDK yang setara. Dengan --tools Anda mendapatkan yang Anda daftarkan, dan menyebutkan salah satu tool dalam --allowedTools mengembalikan keduanya. Aturan allow dalam file settings tidak memiliki efek ini.
• Aturan deny izin, flag --disallowedTools, atau --restricted menghapus Bash dari sesi.
• Subagent mencantumkan Glob atau Grep dalam field tools dan mengeluarkan Bash. Tool yang tercantum kembali untuk subagent itu saja, atau untuk seluruh sesi ketika berjalan sebagai agent sesi utama melalui --agent atau pengaturan agent.

• **/*.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. Ketika parameter offset tool menunjuk melampaui kecocokan terakhir untuk pola yang memiliki kecocokan, Grep mengembalikan No entries at this offset, sehingga Claude memperluas atau mengatur ulang offset alih-alih menyimpulkan pola tidak cocok.
• count: jumlah kecocokan per file, diikuti dengan total di semua file yang cocok. Total mencakup setiap kecocokan bahkan ketika parameter head_limit atau offset tool memotong entri per-file yang terdaftar. Sebelum v2.1.208, total hanya menjumlahkan entri yang terdaftar.

​

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.

​

Alat PowerShell

• Windows tanpa Git Bash: alat diaktifkan secara otomatis.
• Windows dengan Git Bash terinstal: alat aktif secara default untuk akun claude.ai dan Console; atur CLAUDE_CODE_USE_POWERSHELL_TOOL=1 untuk mengaktifkannya di sesi Amazon Bedrock, Google Cloud’s Agent Platform, dan Microsoft Foundry, atau 0 untuk mematikannya.
• Linux, macOS, dan WSL: alat bersifat opt-in.

​

Aktifkan alat PowerShell

{
  "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 alat PowerShell untuk diaktifkan.
• "shell": "powershell" pada command hooks individual: menjalankan hook tersebut di PowerShell. Hooks menjalankan PowerShell secara langsung, sehingga ini bekerja terlepas dari CLAUDE_CODE_USE_POWERSHELL_TOOL.
• shell: powershell dalam skill frontmatter: menjalankan blok !`command` di PowerShell. Memerlukan alat PowerShell untuk diaktifkan.

​

Pengkodean Windows dan kode keluar

• Pengalihan dengan > dan >> menulis file UTF-8 di PowerShell 5.1
• Claude Code mengkodekan teks yang disalurkan ke input standar perintah native sebagai UTF-8
• Claude Code menangkap output kesalahan tanpa urutan pelarian ANSI
• Perintah yang proses anak-anaknya menunggu input standar menerima end-of-file alih-alih hang
• Kode keluar 1 dari where.exe berarti tidak ada kecocokan, dan dari fc.exe dan diff.exe berarti file berbeda, jadi ketika perintah menghasilkan output, Claude Code memperlakukan kode keluar tersebut sebagai jawaban negatif yang valid daripada kesalahan perintah. Claude Code masih melaporkan bentuk yang disenyapkan, seperti where.exe /Q atau pengalihan ke $null, sebagai kegagalan pada kode keluar 1

​

Keterbatasan pratinjau

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

​

Perilaku alat Read

• 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 mengirimkannya, jadi Claude mungkin melihat versi yang diperkecil dari tangkapan layar 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 tidak berubah. Jika Claude melewatkan detail tingkat piksel halus dalam gambar besar, minta untuk memotong wilayah yang diminati terlebih dahulu, misalnya dengan ImageMagick melalui Bash.
• PDFs: Claude membaca file .pdf pendek secara keseluruhan. Untuk PDF yang lebih panjang dari 10 halaman, file tersebut dibaca dalam rentang dengan parameter pages, seperti "1-5", hingga 20 halaman sekaligus. Pembacaan rentang halaman merender halaman dengan pdftoppm dari poppler-utils, jadi instal dengan brew install poppler di macOS atau apt-get install poppler-utils di Debian dan Ubuntu. Di Windows dan platform lainnya, instal build poppler yang menempatkan pdftoppm di PATH Anda. Tanpa itu, pembacaan rentang halaman gagal dengan pdftoppm is not installed.
• Jupyter notebooks: File .ipynb mengembalikan semua sel dengan keluarannya, termasuk kode, markdown, dan visualisasi. Claude Code menolak untuk membaca file notebook di atas 100 MB; kesalahan memberi tahu Claude cara membaca sebagian dari notebook sebagai gantinya, seperti irisan sel, dengan perintah shell.

​

Perilaku alat SendFeedback

• Alat atau perintah terus gagal
• Tidak dapat membantu dengan sesuatu yang Anda minta
• Anda menunjukkan kesalahan yang dibuat, atau itu menyadarinya
• Anda memintanya untuk mengajukan umpan balik

​

Apa yang Anda lihat ketika Claude menyusun

​

Tinjau dan edit draf

• Edit judul, area, dan detail
• Atur Send transcript ke yes atau no. Ketika transkrip dari sesi tempat Claude mengantrekan draf masih tersedia, itu dimulai pada yes, yang mengirim percakapan itu ke Anthropic; no mengirim laporan saja
• Kirim draf, buang, atau biarkan di antrian untuk nanti

​

Kirim draf

• Judul, area, dan detail Anda
• Info lingkungan, seperti versi Claude Code Anda, sistem operasi, dan model
• ID permintaan API terbaru
• Transkrip percakapan, ketika Anda meninggalkan Send transcript pada yes di layar tinjauan. Mengirim dari kartu tidak pernah menyertakan transkrip

​

Buang atau simpan draf

​

Matikan umpan balik yang disusun Claude

​

Sesi tanpa umpan balik yang disusun Claude

• Berjalan -p non-interaktif dan sesi Agent SDK, yang tidak memiliki layar untuk meninjau antrian
• Sesi cloud seperti Claude Code di web, yang tidak dapat menulis ke antrian di mesin Anda
• Sesi di Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, atau Microsoft Foundry
• Sesi di mana Anda menetapkan CLAUDE_CODE_SEND_FEEDBACK=0 atau DISABLE_FEEDBACK_COMMAND=1, atur CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ke nilai non-kosong apa pun, atau matikan pengambilan bendera fitur
• Organisasi yang telah mematikan umpan balik produk, dan organisasi dengan retensi data nol

​

Ketersediaan alat Task

• Ekspor CLAUDE_CODE_ENABLE_TODO_TOOLS=1 sebelum Anda memulai Claude Code, misalnya CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude. Claude Code kemudian menyediakan alat yang sama pada setiap model dan setiap penyedia
• Sebutkan salah satu alat dalam --allowedTools, misalnya claude --allowedTools TaskCreate
• Daftarkan alat-alat dalam --tools, yang membatasi alat bawaan sesi ke yang disebutkannya. Sertakan alat yang Anda inginkan bersama dengan alat bawaan lain yang Anda gunakan
• Dalam Agent SDK, opsi allowedTools dan tools bekerja dengan cara yang sama seperti dua flag

​

Perilaku alat WebFetch

• WebFetch menolak localhost dan nama host lainnya tanpa titik, seperti nama intranet biasa, sebelum membuat permintaan. Kesalahan yang dikembalikannya memberitahu Claude untuk menjangkau server lokal dengan curl melalui Bash sebagai gantinya.
• URL HTTP secara otomatis ditingkatkan ke HTTPS.
• Halaman besar dipotong ke batas karakter tetap sebelum diproses.
• WebFetch menyimpan cache setiap respons selama 15 menit secara default, jadi pengambilan berulang dari URL yang sama kembali dengan cepat. Pada Claude Code v2.1.233 atau lebih baru, atur CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS untuk mengubah berapa lama WebFetch menyimpan setiap respons.
• Halaman yang belum selesai diunduh dalam lima menit, termasuk pengalihan apa pun yang diikuti WebFetch, gagal dengan kesalahan batas waktu. Pada Claude Code v2.1.268 atau lebih baru, atur CLAUDE_CODE_WEBFETCH_DEADLINE_MS untuk mengubah batas, atau ke 0 untuk menghapusnya.
• Ketika URL dialihkan ke host yang berbeda, WebFetch mengembalikan hasil teks yang menyebutkan URL asli dan target pengalihan alih-alih mengikutinya. Claude kemudian mengambil URL baru dengan panggilan WebFetch kedua.
• Ketika langkah ekstraksi mengalami API yang kelebihan beban, Claude Code mencoba ulang dengan backoff; pengambilan yang masih gagal mengembalikan hasil kesalahan. Sebelum v2.1.212, teks kesalahan API dapat sampai ke Claude seolah-olah itu adalah konten halaman yang diekstrak.

• Ya: menyetujui pengambilan ini saja. Panggilan WebFetch berikutnya meminta lagi, bahkan untuk domain yang sama.
• Ya, dan jangan tanya lagi untuk <domain>: menyetujui pengambilan dan menyimpan aturan izin WebFetch(domain:...) untuk domain itu ke .claude/settings.local.json untuk repositori itu. Lihat bagaimana persetujuan yang disimpan bertahan. Ketika organisasi Anda menetapkan allowManagedPermissionRulesOnly, Claude Code menyembunyikan opsi ini.
• Tidak, dan beri tahu Claude apa yang harus dilakukan berbeda: menolak pengambilan.

​

Perilaku alat WebSearch

​

Batas pencarian sesi

​

Perilaku tool Write

• Claude Opus 4.6, Claude Haiku 4.5, dan model yang lebih lama selalu memerlukan pembacaan, jadi Write ke file yang sudah ada yang belum dibaca gagal dengan kesalahan.
• Model yang lebih baru dapat menimpa file yang tidak pernah mereka baca dalam sesi ini di bawah kondisi yang sama seperti read-before-edit: membacanya tidak akan memerlukan prompt izin dan tool Read tersedia.
• Jupyter notebooks, dan file yang Claude baca hanya sebagian dengan pemberitahuan PARTIAL view, memerlukan pembacaan pada setiap model.

​

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