Penggunaan alat dengan Claude

Penggunaan alat memungkinkan Claude memanggil fungsi yang Anda tentukan atau yang disediakan Anthropic. Claude memutuskan kapan memanggil alat berdasarkan permintaan pengguna dan deskripsi alat, kemudian mengembalikan panggilan terstruktur yang dijalankan aplikasi Anda (alat klien) atau yang dijalankan Anthropic (alat server).

Berikut adalah contoh paling sederhana menggunakan alat server, di mana Anthropic menangani eksekusi:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    tools=[{"type": "web_search_20260209", "name": "web_search"}],
    messages=[{"role": "user", "content": "What's the latest on the Mars rover?"}],
)
print(response.content)

Cara kerja penggunaan alat

Alat berbeda terutama berdasarkan tempat kode dijalankan. Alat klien (termasuk alat yang ditentukan pengguna dan alat skema Anthropic seperti bash dan text_editor) berjalan di aplikasi Anda: Claude merespons dengan stop_reason: "tool_use" dan satu atau lebih blok tool_use, kode Anda menjalankan operasi, dan Anda mengirim kembali tool_result. Alat server (web_search, code_execution, web_fetch, tool_search) berjalan di infrastruktur Anthropic: Anda melihat hasilnya secara langsung tanpa menangani eksekusi.

Untuk model konseptual lengkap termasuk loop agentic dan kapan memilih setiap pendekatan, lihat Cara kerja penggunaan alat.

Untuk menghubungkan ke server MCP, lihat konektor MCP. Untuk membangun klien MCP Anda sendiri, lihat modelcontextprotocol.io.

Akses alat adalah salah satu primitif dengan leverage tertinggi yang dapat Anda berikan kepada agen. Pada benchmark seperti LAB-Bench FigQA (interpretasi gambar ilmiah) dan SWE-bench (rekayasa perangkat lunak dunia nyata), menambahkan bahkan alat dasar menghasilkan keuntungan kemampuan yang luar biasa, sering kali melampaui baseline ahli manusia.

Contoh penggunaan alat

Untuk panduan langsung lengkap, lihat tutorial. Untuk contoh referensi konsep individual, lihat Tentukan alat dan Tangani panggilan alat.

Harga

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

The additional tokens from tool use come from:

• The tools parameter in API requests (tool names, descriptions, and schemas)
• tool_use content blocks in API requests and responses
• tool_result content blocks in API requests

When you use tools, the API also automatically includes a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

Lihat tabel ringkasan model untuk harga per model saat ini.

Ketika Anda mengirim prompt penggunaan alat, seperti permintaan API lainnya, respons akan menampilkan jumlah token input dan output sebagai bagian dari metrik usage yang dilaporkan.

Langkah berikutnya

Pilih jalur Anda