MessagesAlat

Alat eksekusi kode

Copy page



Jalankan kode Python dan bash dalam container sandbox untuk menganalisis data, menghasilkan file, dan melakukan iterasi pada solusi.

Claude dapat menganalisis data, membuat visualisasi, melakukan perhitungan kompleks, menjalankan perintah sistem, membuat dan mengedit file, serta memproses file yang diunggah langsung di dalam percakapan API. Alat eksekusi kode memungkinkan Claude menjalankan perintah Bash dan memanipulasi file, termasuk menulis kode, dalam lingkungan "sandbox" (lingkungan terisolasi) yang aman.

Eksekusi kode gratis jika digunakan bersama pencarian web atau web fetch (web_search_20260209, web_fetch_20260209, atau yang lebih baru). Jika salah satu alat tersebut ada dalam permintaan Anda, tidak ada biaya tambahan untuk eksekusi kode dalam permintaan itu selain biaya token standar. Ini mencakup eksekusi kode di balik pemfilteran dinamis maupun kode apa pun yang dijalankan Claude secara langsung. Harga eksekusi kode standar berlaku jika alat-alat tersebut tidak disertakan.

Eksekusi kode juga menjalankan "dynamic filtering" (pemfilteran dinamis) pada alat pencarian web dan web fetch: Claude memfilter hasil di dalam lingkungan eksekusi kode sebelum hasil tersebut mencapai "context window" (jendela konteks). Saat pemfilteran dinamis berjalan, API secara otomatis menyediakan eksekusi kode yang dibutuhkan untuk permintaan tersebut, sehingga Anda tidak perlu menambahkan alat eksekusi kode ke permintaan Anda untuk keperluan itu.

Versi alat

Alat eksekusi kode memiliki tiga versi saat ini, dan setiap model yang didukung menerima ketiganya. Setiap versi dibangun di atas versi sebelumnya:

• code_execution_20250825 mendukung perintah Bash dan operasi file.
• code_execution_20260120 menambahkan "REPL state persistence" (persistensi status REPL) dan pemanggilan alat terprogram dari dalam sandbox. Claude Haiku 4.5 menerima tipe alat code_execution_20260120 dan code_execution_20260521, tetapi pemanggilan alat terprogram dan persistensi status REPL yang bergantung padanya tidak tersedia di model tersebut, sehingga versi yang lebih baru berperilaku seperti code_execution_20250825 di sana.
• code_execution_20260521 menggunakan runtime yang sama dengan code_execution_20260120. Perbedaannya adalah deskripsi alat memberi tahu Claude tentang batas waktu nyata 90 detik pada setiap sel Python dalam pemanggilan alat terprogram, sehingga Claude dapat mengatur anggaran untuk sel yang berjalan lama. Sel yang melebihi batas tersebut mengembalikan hasil eksekusi kode normal dengan return_code bukan nol dan pesan status detection_timeout dalam output-nya. Ini terpisah dari kode error execution_time_exceeded, yang dikembalikan API ketika seluruh pemanggilan alat melebihi waktu eksekusi maksimum.

Tidak satu pun dari ketiga versi alat memerlukan header anthropic-beta. Header beta eksekusi kode lama tetap valid sebagai opsi keikutsertaan.

Contoh-contoh di halaman ini menggunakan code_execution_20250825, yang mencakup operasi Bash dan file yang didemonstrasikan dan berperilaku sama di setiap model yang didukung; gunakan code_execution_20260120 atau yang lebih baru jika Anda memerlukan pemanggilan alat terprogram atau persistensi status REPL. Alat pencarian web dan web fetch saat ini (web_search_20260209,