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

• Teammate: dengan tim agent diaktifkan, panggilan yang membawa name dapat meluncurkan teammate sebagai gantinya, yang melaporkan kembali melalui pesan tim daripada dengan mengembalikan hasil
• Fork: di mana pun fork mode aktif, tool ini dapat meluncurkan forked subagent, yang mewarisi percakapan induk penuh daripada memulai dari awal

• 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 permintaan izin di sesi utama Anda. Permintaan tersebut menamai subagent mana yang meminta, dan menekan Esc menolak panggilan tool itu saja tanpa menghentikan subagent.

​

Perilaku tool AskUserQuestion

​

Timeout auto-continue pertanyaan

​

Perilaku tool Bash

​

Apa yang bertahan di antara perintah

• Ketika Claude menjalankan cd di sesi utama, direktori kerja yang baru terbawa ke perintah Bash berikutnya selama direktori tersebut tetap berada di dalam direktori proyek atau direktori kerja tambahan yang Anda tambahkan dengan --add-dir, /add-dir, atau additionalDirectories di pengaturan. Ini termasuk perintah yang dijalankan Claude sebagai respons terhadap pesan Anda berikutnya.
  • Sesi subagent tidak pernah membawa perubahan direktori kerja.
  • Jika cd berakhir di luar direktori tersebut, Claude Code mengatur ulang ke direktori proyek dan menambahkan Shell cwd was reset to <dir> ke hasil tool.
  • Untuk menonaktifkan perilaku terbawa ini sehingga setiap perintah Bash dimulai di direktori proyek, atur CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
• Environment variable tidak bertahan. Sebuah export dalam satu perintah tidak akan tersedia di perintah berikutnya.
• Alias dan fungsi shell yang didefinisikan dalam file startup shell Anda tersedia. Saat sesi dimulai, Claude Code memuat ~/.zshrc, ~/.bashrc, atau ~/.profile tergantung shell Anda, menangkap alias, fungsi, dan opsi shell yang dihasilkan, lalu menerapkannya ke setiap perintah Bash.

​

Timeout dan batas output

• BASH_DEFAULT_TIMEOUT_MS — default ketika Claude tidak meneruskan timeout; dua menit secara bawaan
• BASH_MAX_TIMEOUT_MS — bersama default, menetapkan batas atas yang membatasi apa pun yang diminta Claude: batas atas efektif adalah yang lebih besar dari keduanya, sepuluh menit secara bawaan

​

Batas output

​

Perintah latar belakang

​

Kapan perintah latar belakang berhenti

​

Batas waktu untuk perintah latar belakang

• Perintah yang dimulai Claude di latar belakang mendapatkan 30 menit, atau timeout yang diteruskan Claude bersama run_in_background, hingga maksimum 2 jam
• Perintah yang dimulai di latar depan lalu berpindah ke latar belakang, misalnya saat mencapai timeout-nya, mendapatkan 30 menit sejak perpindahan tersebut

​

Menaikkan batas waktu untuk perintah latar belakang

• Atur BASH_DEFAULT_TIMEOUT_MS di atas 1800000 untuk mengganti default 30 menit dengan nilai tersebut, baik untuk perintah yang dimulai Claude tanpa timeout maupun untuk perintah yang dipindahkan. Dalam run -p yang prompt-nya Anda berikan sebagai teks, nilai apa pun di atas 600000 menggantikan default 10 menitnya
• Atur BASH_MAX_TIMEOUT_MS di atas 7200000 untuk menaikkan maksimum 2 jam ke nilai tersebut. Mengatur BASH_DEFAULT_TIMEOUT_MS di atas 7200000 menaikkan maksimum dengan cara yang sama

​

Perintah latar depan yang berpindah ke latar belakang

• Ketika timeout memicu perpindahan, hasilnya melaporkannya secara eksplisit: Command did not complete within its 120s timeout and was moved to the background, dengan jumlah detik yang sesuai dengan timeout yang berlaku, diikuti ID tugas dan path file tempat output sedang ditulis.
• cd, pushd, popd, atau chdir di dalam perintah yang dipindahkan ke latar belakang tidak pernah terbawa: hasilnya menyatakan Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands., sehingga Claude tidak bertindak berdasarkan 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 lain yang tidak dapat dibacanya sebagai ukuran, seperti 4e9.
• Claude Code menghitung semua perintah Bash, PowerShell, dan Monitor dalam satu sesi terhadap satu batas tersebut, bukan setiap perintah secara terpisah.
• Claude Code menerapkan batas dengan cgroup memori. Ketika tidak dapat menyiapkan cgroup, perintah berjalan tanpa batas, dan log debug dari claude --debug menjelaskan alasannya.
• Setelah proses pertama yang dimulai Claude Code telah mengaktifkan batas, atau telah mematikannya karena nilai off atau penyiapan cgroup yang gagal, Claude Code mempertahankan hasil tersebut hingga Anda menjalankan ulang. Untuk menerapkan nilai yang diubah atau dihapus, atau penyiapan yang sudah diperbaiki, jalankan claude lagi.
• Ketika perintah tidak dapat tetap berada di bawah batas, kernel menghentikan paksa sebuah perintah, dan tidak ada apa pun dalam hasilnya yang menyebutkan batas tersebut.

• mcp: server MCP lokal
• lsp: language server
• hooks: perintah hook
• plugin: perintah yang dijalankan plugin
• helper: perintah pembantu milik Claude Code sendiri, seperti git
• agent: proses Claude Code turunan, seperti rekan tim agent

• Nama tidak dikenal: Claude Code mengabaikan nama yang tidak dikenalinya
• Variabel tidak diatur: Claude Code mengambil kumpulan jenis lain yang dibatasi dari konfigurasi yang dikirimkan Anthropic dari server, dan kumpulan tersebut dapat berubah seiring waktu, jadi atur variabel ini ketika Anda membutuhkan kumpulan yang tidak berubah
• Hook yang mengontrol izin: bahkan ketika setiap jenis dibatasi, Claude Code mengecualikan dari batas hook yang dapat memblokir atau mengubah hasil suatu tindakan, serta server MCP mana pun yang dipanggil oleh hook tersebut, sehingga penghentian paksa hook pengontrol izin oleh kernel tidak dapat mengakibatkan tindakan yang sedang diblokir oleh hook tersebut menjadi diizinkan

​

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.

​

File non-UTF-8

​

Perilaku tool EndConversation

• Ketika Anda terus mengirim pesan yang kasar setelah Claude memberikan peringatan yang jelas dan gagal mengalihkan percakapan
• Ketika Anda secara eksplisit meminta Claude untuk mengakhiri sesi, lalu mengonfirmasi saat Claude menanyakan apakah Anda masih ingin melanjutkan

• 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. Surface lain tidak menyertakan tool ini, seperti:
  • proses -p non-interaktif
  • sesi melalui paket TypeScript dan Python Agent SDK
  • panel ekstensi VS Code, yang membundel CLI-nya sendiri
  • GitHub Actions
  • sesi cloud
• Mode startup: bukan sesi --bare. Bare mode hanya memuat tool shell dan file, sehingga tool ini tidak pernah didaftarkan di sana.
• Penyedia: tidak tersedia di Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, atau Microsoft Foundry, maupun pada sesi yang masuk melalui gateway cloud.

​

Perilaku tool EnterWorktree

• Worktree mana yang dapat dirujuk oleh path: pada saat masuk pertama kali, target dapat berupa worktree dari repositori saat ini. Dalam repositori yang menampung repositori lain, target juga dapat berupa worktree dari repositori yang bersarang di dalamnya.
• Kapan Anda diminta persetujuan: path di luar .claude/worktrees/ meminta persetujuan Anda sebelum masuk, karena hal ini memindahkan direktori kerja sesi dan akses tulis ke lokasi tersebut. Pembuatan worktree baru dan path di bawah .claude/worktrees/ tidak memunculkan permintaan. Sebelum v2.1.206, Claude masuk ke path di luar .claude/worktrees/ tanpa permintaan persetujuan.
• Dari dalam worktree: dari dalam sesi worktree, hanya bentuk path yang tersedia dan target harus berada di bawah .claude/worktrees/ dari repositori sesi tersebut. Hal yang sama berlaku untuk subagent dengan direktori kerja yang disematkan, seperti isolation: worktree.
• Saat tool tidak tersedia: setelah permissions.blockWritesOutsideWorkingDirectories diaktifkan, Claude Code menghapus EnterWorktree dan ExitWorktree atau menolak panggilan ke keduanya. Untuk tetap bekerja di worktree, lihat Claude tidak memiliki tool EnterWorktree.

​

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.

​

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

• Versi minimum: di Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, atau Microsoft Foundry, atau ketika DISABLE_TELEMETRY atau CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC diatur, Monitor memerlukan Claude Code v2.1.310 atau yang lebih baru. Persyaratan ini berlaku ketika pengambilan feature flag dinonaktifkan
• Windows: tool ini hanya tersedia ketika Git Bash terinstal

​

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.

​

Alamat dan host yang ditolak untuk watch WebSocket

​

Aturan Bash yang menolak atau meminta persetujuan untuk watch WebSocket

• Aturan deny: jika aturan sudah ada saat sesi dimulai, Claude tidak memiliki Monitor tool, sehingga tidak dapat memulai watch. Jika Anda menambahkan aturan selama sesi, panggilan Monitor berikutnya dari Claude akan ditolak. Penolakan tersebut berbunyi Permission to use Monitor has been denied: it runs code as Bash does, and a rule denies Bash.
• Aturan ask: Anda diminta untuk menyetujui watch. Aturan allow, hook PreToolUse, mode bypassPermissions, maupun pengklasifikasi auto mode tidak dapat menyetujuinya untuk Anda. Anda dapat menyetujuinya dari hook PermissionRequest. Ketika tidak ada yang dapat menjawab, seperti dalam mode dontAsk, Claude Code menolak watch tersebut.

​

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

​

Aturan deny Bash juga mematikan tool PowerShell

• Atur CLAUDE_CODE_USE_POWERSHELL_TOOL=1 di lingkungan Anda atau di blok env dari file pengaturan, seperti yang ditunjukkan di Aktifkan tool PowerShell.
• Tambahkan aturan izin PowerShell bercakupan ke file pengaturan, seperti aturan deny PowerShell(git push *).

​

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.

​

Kode keluar 1 dari pencarian dan git diff di PowerShell

​

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
• Jika where.exe tidak menemukan kecocokan, atau fc.exe atau diff.exe mendapati bahwa file berbeda, hasilnya dapat menampilkan Error: Exit code 1 meskipun perintah tidak gagal. Anda tidak perlu melakukan apa pun.
• Jika kode keluar robocopy dari 1 hingga 7 ditampilkan sebagai kesalahan, penyalinan tidak gagal dan Anda tidak perlu melakukan apa pun. robocopy keluar dengan kode 0 hingga 7 untuk melaporkan hasil, seperti file yang disalin, dan dengan 8 atau lebih tinggi ketika gagal.

​

Keterbatasan pratinjau

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

​

Perilaku alat Read

• Gambar: File PNG, JPEG, GIF, dan WebP 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. Jika Claude melewatkan detail tingkat piksel halus dalam gambar besar, minta Claude untuk memotong wilayah yang Anda perlukan, misalnya dengan ImageMagick melalui Bash, lalu membaca hasil potongan tersebut. Read menolak file gambar yang lebih besar dari 128 MB dengan kesalahan yang memberi tahu Claude untuk mengubah ukuran gambar atau mengekspor salinan yang lebih kecil, lalu membaca salinan tersebut. Jika Claude berhenti pada kesalahan tersebut alih-alih melakukannya, lihat File is too large to read as an image.
• 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. Notebook yang sel-selnya berjumlah lebih dari 256 KB, atau lebih dari batas token, mengembalikan kesalahan sebagai gantinya. 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.

​

File besar

• Seluruh file melebihi batas token: halaman pertama file, dengan pemberitahuan PARTIAL view yang menyebutkan berapa banyak file yang diterima dan cara membaca lebih lanjut dengan offset dan limit
• Seluruh file di atas 256 KB, atau pembacaan dengan offset atau limit yang melebihi batas token: kesalahan yang memberi tahu Claude untuk membaca sebagian dengan offset dan limit, atau untuk mencari konten spesifik dengan Grep sebagai gantinya

​

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, 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 yang menjangkau Claude melalui LLM gateway dengan kunci atau token milik gateway itu sendiri
• 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, organisasi dengan retensi data nol, dan organisasi yang menerapkan konfigurasi HIPAA
• Sesi di mana Claude Code telah berhenti menawarkan umpan balik setelah laporan ditolak

​

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

​

Tool pelacakan tugas dalam subagent dan tim agent

• Tidak ada daftar --tools atau aturan penolakan, dan CLAUDE_CODE_ENABLE_TODO_TOOLS tidak ditetapkan untuk anggota tim: anggota tim memiliki tool pelacakan tugas yang dimiliki model miliknya sendiri secara default.
• CLAUDE_CODE_ENABLE_TODO_TOOLS diekspor di shell Anda: Claude Code meneruskan kepada anggota tim serangkaian environment variable tetap yang tidak menyertakan variabel yang Anda ekspor. Untuk menetapkannya juga bagi anggota tim, mulai sesi Anda dengan menjalankan claude --settings '{"env":{"CLAUDE_CODE_ENABLE_TODO_TOOLS":"1"}}' di shell Anda. Anggota tim juga mendapatkan nilai --settings Anda.
• --tools yang menyebutkan tool pelacakan tugas: anggota tim memilikinya pada model apa pun.
• Tool pelacakan tugas yang tidak ada dalam --tools atau disebutkan dalam aturan penolakan: anggota tim tidak memiliki tool tersebut.

​

Perilaku tool WebFetch

• WebFetch menolak localhost dan hostname lain tanpa titik, seperti nama intranet tanpa domain, sebelum membuat permintaan. Error yang dikembalikannya memberi tahu Claude untuk menjangkau server lokal dengan curl melalui Bash sebagai gantinya.
• URL HTTP secara otomatis ditingkatkan ke HTTPS.
• WebFetch membaca hingga 100.000 karakter konten halaman per panggilan. Pada Claude Code v2.1.290 atau yang lebih baru, hasil untuk halaman yang lebih panjang memberi tahu Claude berapa banyak yang belum terbaca, sehingga Claude dapat mengambil bagian berikutnya.
• WebFetch menyimpan setiap respons dalam cache selama 15 menit secara default, sehingga pengambilan berulang atas URL yang sama kembali dengan cepat. Pada Claude Code v2.1.233 atau yang 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 error tenggat waktu. Pada Claude Code v2.1.268 atau yang lebih baru, atur CLAUDE_CODE_WEBFETCH_DEADLINE_MS untuk mengubah batasnya, 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 tersebut dengan panggilan WebFetch kedua.
• Ketika langkah ekstraksi menemui API yang kelebihan beban, Claude Code mencoba ulang dengan backoff; pengambilan yang tetap gagal mengembalikan hasil error.

• Yes: menyetujui pengambilan ini saja. Panggilan WebFetch berikutnya akan meminta persetujuan lagi, bahkan untuk domain yang sama.
• Yes, and don’t ask again for <domain>: menyetujui pengambilan dan menyimpan aturan allow WebFetch(domain:...) untuk domain tersebut ke .claude/settings.local.json untuk repositori tersebut. Lihat bagaimana persetujuan yang disimpan bertahan. Ketika organisasi Anda menetapkan allowManagedPermissionRulesOnly, Claude Code menyembunyikan opsi ini.
• No, and tell Claude what to do differently: menolak pengambilan.

​

Ketersediaan WebFetch

​

Perilaku alat WebSearch

​

Batas pencarian sesi

• Naikkan batas maksimum: atur environment variable CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION ke angka bulat positif, seperti 500. Batas maksimum dapat dinaikkan tetapi tidak dapat dimatikan.
• Tunggu pengisian ulang: pada Claude Code v2.1.290 atau lebih baru, batas sesi terminal interaktif terisi ulang sekitar 100 panggilan per jam. Untuk mengubah lajunya, atur CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR ke jumlah panggilan per jam, seperti 50.
• Mulai percakapan baru: menjalankan /clear pada prompt Claude Code juga mengatur ulang hitungan. Jika pekerjaan yang masih dapat menghasilkan subagent bertahan setelah pembersihan, seperti alur kerja yang sedang berjalan, hitungan akan dibawa ke depan.

​

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