---
title: Referensi alat
url: https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-reference
description: Direktori alat server, alat klien, dan toolset klien yang disediakan Anthropic, beserta referensi untuk properti definisi alat opsional.
---

Halaman ini adalah referensi untuk alat-alat yang disediakan Anthropic dan properti opsional yang dapat Anda atur pada definisi alat apa pun. Untuk pengantar konseptual tentang “tool use” (penggunaan alat), lihat [Penggunaan alat dengan Claude](https://platform.claude.com/docs/id/agents-and-tools/tool-use/overview). Untuk panduan mengimplementasikan penggunaan alat dalam aplikasi Anda, lihat [Mendefinisikan alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/define-tools).

## Alat yang disediakan Anthropic

Anthropic menyediakan dua jenis alat: **server tool** (alat server) yang berjalan di infrastruktur Anthropic, dan **client tool** (alat klien) di mana Anthropic mendefinisikan skemanya tetapi aplikasi Anda yang menangani eksekusinya. Kedua jenis alat muncul dalam array `tools` permintaan Anda bersama dengan alat yang didefinisikan pengguna.

| Alat | `type` | Eksekusi | [Header beta](https://platform.claude.com/docs/id/api/beta-headers) |
| ----- | ----- | ----- | ----- |
| [Alat pencarian web](https://platform.claude.com/docs/id/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`<br />`web_search_20260209`<br />`web_search_20250305` | Server | Tidak ada |
| [Alat pengambilan web](https://platform.claude.com/docs/id/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`<br />`web_fetch_20260309`<br />`web_fetch_20260209`<br />`web_fetch_20250910` | Server | Tidak ada |
| [Alat eksekusi kode](https://platform.claude.com/docs/id/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`<br />`code_execution_20260120`<br />`code_execution_20250825` | Server | Tidak ada |
| [Alat advisor](https://platform.claude.com/docs/id/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | Server | `advisor-tool-2026-03-01` |
| [Alat pencarian alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`<br />`tool_search_tool_bm25_20251119` | Server | Tidak ada |
| [Konektor MCP](https://platform.claude.com/docs/id/agents-and-tools/mcp-connector) | `mcp_toolset` | Server | `mcp-client-2025-11-20` |
| [Alat memori](https://platform.claude.com/docs/id/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | Klien | Tidak ada |
| [Alat Bash](https://platform.claude.com/docs/id/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | Klien | Tidak ada |
| [Alat editor teks](https://platform.claude.com/docs/id/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`<br />`text_editor_20250124` | Klien | Tidak ada |
| [Alat penggunaan komputer](https://platform.claude.com/docs/id/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`<br />`computer_20251124`<br />`computer_20250124` | Klien | Tidak ada<br />`computer-use-2025-11-24`<br />`computer-use-2025-01-24` |
| [Alat penggunaan browser](https://platform.claude.com/docs/id/agents-and-tools/tool-use/browser-use-tool) | `browser_toolset_20260801` | Klien | Tidak ada |

Untuk kompatibilitas model, lihat halaman masing-masing alat. Model yang didukung bervariasi menurut alat dan versi alat. Untuk memeriksa dari kode Anda apakah suatu model menerima pencarian web atau eksekusi kode, lihat [Menggunakan Models API](https://platform.claude.com/docs/id/models/overview#using-the-models-api).

<Note>
  Nilai `type` pencarian alat juga menerima alias tanpa tanggal: `tool_search_tool_regex` dan `tool_search_tool_bm25`. Alias ini mengarah ke versi bertanggal terbaru.
</Note>

### Pemversian alat

Sebagian besar alat yang disediakan Anthropic memiliki akhiran `_YYYYMMDD` dalam string `type`. Versi baru dirilis ketika perilaku, skema, atau dukungan model alat tersebut berubah. Versi lama tetap tersedia agar integrasi yang sudah ada terus berfungsi.

Ketika sebuah alat memiliki beberapa versi aktif, hubungan di antaranya bervariasi:

* **Berdasarkan kemampuan:** `web_search_20260209` dan `web_fetch_20260209` menambahkan pemfilteran konten dinamis dibandingkan pendahulunya; `web_fetch_20260309` menambahkan opsi untuk melewati cache; `web_search_20260318` dan `web_fetch_20260318` menambahkan kontrol penyertaan respons. `code_execution_20260120` menambahkan [pemanggilan alat terprogram](https://platform.claude.com/docs/id/agents-and-tools/tool-use/programmatic-tool-calling) dari dalam sandbox; `code_execution_20260521` mengungkapkan batas waktu per sel dalam deskripsi alat. Dalam setiap kasus, versi baru maupun lama sama-sama berlaku; versi mana yang Anda gunakan bergantung pada apakah Anda membutuhkan kemampuan baru tersebut.
* **Berdasarkan model:** `text_editor_20250728` ditujukan untuk model Claude 4 dan yang lebih baru, sedangkan `text_editor_20250124` ditujukan untuk model yang lebih lama. Versi yang Anda gunakan bergantung pada model yang Anda targetkan.
* **Varian, bukan versi:** `tool_search_tool_regex_20251119` dan `tool_search_tool_bm25_20251119` adalah dua algoritma pencarian yang dirilis bersamaan. Tidak ada yang menggantikan yang lain.
* **Lama (legacy):** `code_execution_20250522` hanya mendukung Python. `code_execution_20250825` menambahkan Bash dan operasi file.
* **Penerus:** `computer_toolset_20260801` adalah penerus stabil dari versi beta `computer_20251124` dan `computer_20250124`, yang tersedia pada model yang tercantum untuk versi tersebut di bagian [Versi alat sebelumnya](https://platform.claude.com/docs/id/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions). `browser_toolset_20260801` adalah versi pertama dari alat penggunaan browser. Keduanya merupakan [toolset klien](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-reference#client-toolsets).

Tipe `mcp_toolset` tidak diberi versi berdasarkan tanggal; pemversiannya dibawa dalam header `anthropic-beta`.

### Toolset klien

[Alat penggunaan komputer](https://platform.claude.com/docs/id/agents-and-tools/tool-use/computer-use-tool) dan [alat penggunaan browser](https://platform.claude.com/docs/id/agents-and-tools/tool-use/browser-use-tool) adalah “client toolset” (kumpulan alat klien) yang didefinisikan Anthropic: satu entri dalam `tools` mendeklarasikan kumpulan tetap alat anggota yang nama, deskripsi, dan skema inputnya didefinisikan oleh Anthropic, dan aplikasi Anda menjalankan setiap panggilan. Entri tersebut tidak menerima `name`, karena `type` bertanggal sudah menetapkan nama-nama anggotanya. `configs`, `cache_control`, dan `allowed_callers` (yang hanya menerima `["direct"]`) bersifat opsional.

Toolset klien adalah alat Messages API. Saat ini toolset ini tidak tersedia sebagai alat agen di [Claude Managed Agents](https://platform.claude.com/docs/id/managed-agents/tools), yang menyediakan toolset agen bawaan, toolset MCP, dan alat kustomnya sendiri.

```json
{
  "type": "browser_toolset_20260801",
  "configs": {
    "javascript_exec": { "enabled": true }
  },
  "cache_control": { "type": "ephemeral" }
}
```

`configs` menyesuaikan anggota secara individual:

* Kuncinya adalah nama anggota, dan setiap nilai hanya menerima `enabled` dan `defer_loading`.
* Anggota yang Anda hilangkan mempertahankan nilai defaultnya. Nilai yang tidak ada, `{}`, dan default yang dinyatakan ulang adalah setara.
* Nama anggota yang tidak dikenal atau field lain apa pun dalam nilai anggota akan ditolak, demikian pula `configs` yang menonaktifkan setiap anggota (hilangkan entrinya saja).
* Anggota yang dinonaktifkan dihapus dari alat yang diterima Claude. Jika Claude tetap menyebutkannya, kembalikan `tool_result` berupa error.

Atur `defer_loading` untuk setiap anggota, jangan pernah pada entri, dan berikan nilai yang sama untuk setiap anggota yang diaktifkan: di bawah [pencarian alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading), toolset dimuat dan diperluas sebagai satu definisi. Ketika setiap anggota yang diaktifkan ditunda, hanya [alat pencarian alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-search-tool) yang tidak ditunda itu sendiri yang dapat memunculkan toolset tersebut, jadi deklarasikan satu dalam permintaan yang sama. Jangan letakkan `cache_control` pada entri toolset yang anggotanya ditunda; atur breakpoint pada alat yang tidak ditunda sebagai gantinya, karena definisi yang ditunda bukan bagian dari prefiks yang di-cache.

`cache_control` hanya diletakkan pada entri; untuk mengetahui di mana breakpoint berada, termasuk penanda di dalam aksi batch, lihat [Penggunaan alat dengan caching prompt](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions).

**Menangani panggilan alat anggota.** Claude memanggil anggota dengan blok `tool_use` yang `name`-nya adalah nama anggota dan `toolset_name`-nya adalah `computer` atau `browser`; `input` berisi parameter anggota tersebut dan tidak ada field `action`. Lakukan dispatch berdasarkan pasangan `toolset_name` dan `name`, karena alat kustom mungkin memiliki nama yang sama dengan anggota dan kedua toolset memiliki nama yang sama seperti `screenshot`. Hanya hasil anggota yang menggemakan `toolset_name`. Beberapa panggilan anggota dalam satu giliran membentuk tindakan batch yang Anda jalankan secara berurutan ([penggunaan komputer](https://platform.claude.com/docs/id/agents-and-tools/tool-use/computer-use-tool#batch-actions), [penggunaan browser](https://platform.claude.com/docs/id/agents-and-tools/tool-use/browser-use-tool#batch-actions)). Anggota baru hanya hadir dengan `type` bertanggal yang baru.

**Tidak didukung pada entri toolset.** API menolak masing-masing hal berikut dengan `invalid_request_error`:

* `strict: true` atau `input_examples`.
* `defer_loading` pada entri, atau anggota yang diaktifkan dengan nilai `defer_loading` yang berbeda (atur untuk setiap anggota dalam `configs`, semuanya dengan nilai yang sama).
* Pemanggil eksekusi kode dalam `allowed_callers` (tidak ada [pemanggilan alat terprogram](https://platform.claude.com/docs/id/agents-and-tools/tool-use/programmatic-tool-calling)).
* Header beta `fine-grained-tool-streaming-2025-05-14`. Saat Anda melakukan streaming, `input` setiap anggota tiba sebagai satu `input_json_delta` yang lengkap.
* `tool_choice` bertipe `tool` yang menyebut toolset atau anggota (gunakan `auto`, `any`, atau `none`).
* Dua entri dari toolset yang sama, atau alat lain yang membawa nama toolset tersebut: alat bernama `computer` bersama `computer_toolset_20260801`, atau alat bernama `browser` bersama `browser_toolset_20260801`. Kedua toolset dapat dideklarasikan bersama.

## Properti definisi alat

Setiap alat dalam array `tools`, termasuk alat yang didefinisikan pengguna, menerima properti opsional yang mengontrol bagaimana alat dimuat, siapa yang dapat memanggilnya, dan bagaimana inputnya divalidasi. Anda dapat mengombinasikan properti-properti ini, dengan dua pengecualian: alat dengan `defer_loading: true` tidak dapat sekaligus membawa `cache_control`, dan alat yang didefinisikan pengguna dengan `strict: true` tidak dapat mencantumkan pemanggil eksekusi kode dalam `allowed_callers`.

| Properti | Tujuan | Tersedia pada | Panduan terperinci |
| ----- | ----- | ----- | ----- |
| `cache_control` | Menetapkan breakpoint prompt-cache pada definisi alat ini | Semua alat (pada `computer_toolset_20260801` dan `browser_toolset_20260801`, atur pada entri toolset itu sendiri, bukan di dalam `configs` anggota) | [Caching prompt](https://platform.claude.com/docs/id/build-with-claude/prompt-caching) |
| `strict` | Menjamin validasi skema pada nama dan input alat | Semua alat kecuali `mcp_toolset`, `computer_toolset_20260801`, dan `browser_toolset_20260801` | [Penggunaan alat strict](https://platform.claude.com/docs/id/agents-and-tools/tool-use/strict-tool-use) |
| `defer_loading` | Mengecualikan alat dari prompt sistem awal; memuatnya sesuai permintaan ketika pencarian alat mengembalikan `tool_reference` untuknya | Semua alat (untuk `mcp_toolset`, lihat [konfigurasi toolset MCP](https://platform.claude.com/docs/id/agents-and-tools/mcp-connector#mcp-toolset-configuration)). Pada toolset penggunaan komputer dan penggunaan browser, atur per anggota di dalam `configs`; lihat [Toolset klien](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-reference#client-toolsets). | [Alat pencarian alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-search-tool) |
| `allowed_callers` | Membatasi pemanggil mana yang dapat memanggil alat | Semua alat kecuali `mcp_toolset` (pada `computer_toolset_20260801` dan `browser_toolset_20260801`, hanya `["direct"]` yang diterima; lihat [Toolset klien](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-reference#client-toolsets)) | [Pemanggilan alat terprogram](https://platform.claude.com/docs/id/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) |
| `input_examples` | Memberikan contoh objek input untuk menunjukkan kepada Claude cara memanggil alat | Alat yang didefinisikan pengguna dan alat klien dengan skema Anthropic, kecuali `computer_toolset_20260801` dan `browser_toolset_20260801`. Tidak tersedia pada alat server. | [Mendefinisikan alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) |
| `eager_input_streaming` | Mengaktifkan streaming input fine-grained (`true`) atau mempertahankan streaming buffer standar (`false`) untuk alat ini | Hanya alat yang didefinisikan pengguna | [Streaming alat fine-grained](https://platform.claude.com/docs/id/agents-and-tools/tool-use/fine-grained-tool-streaming) |

### Nilai `allowed_callers`

`allowed_callers` adalah array yang menerima kombinasi apa pun dari:

| Nilai | Arti |
| ----- | ----- |
| `"direct"` | Model dapat memanggil alat ini secara langsung dalam blok `tool_use`. Ini adalah default jika `allowed_callers` dihilangkan. |
| `"code_execution_20260120"` | Kode yang berjalan di dalam sandbox `code_execution_20260120` atau yang lebih baru dapat memanggil alat ini. |

Baik `"code_execution_20260120"` maupun `"code_execution_20260521"` diterima dalam `allowed_callers` dan dapat saling menggantikan: permintaan yang menggunakan salah satu versi alat eksekusi kode memenuhi alat yang mencantumkan salah satu pemanggil tersebut. Blok respons selalu menandai pemanggil sebagai `code_execution_20260120` terlepas dari versi mana yang dideklarasikan permintaan.

Menghilangkan `"direct"` dari array (misalnya, `"allowed_callers": ["code_execution_20260120"]`) mengarahkan Claude untuk memanggil alat hanya dari dalam eksekusi kode. Blok `tool_use` pada respons menyertakan field `caller` yang mengidentifikasi pemanggil mana yang memanggil alat tersebut. Lihat [Pemanggilan alat terprogram](https://platform.claude.com/docs/id/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) untuk pembahasan lengkap, termasuk bentuk respons `caller` dan perilaku error.

### `defer_loading` dan caching prompt

`defer_loading: true` mempertahankan cache prompt Anda: pencarian alat dapat memuat alat yang ditangguhkan selama percakapan tanpa membatalkan entri cache yang sudah ada. Letakkan breakpoint `cache_control` pada alat yang tidak ditangguhkan. Untuk mempelajari bagaimana alat yang ditangguhkan menjaga cache tetap valid, lihat [`defer_loading` dan pelestarian cache](https://platform.claude.com/docs/id/agents-and-tools/tool-use/tool-use-with-prompt-caching#defer-loading-and-cache-preservation).
