Tool editor teks
Claude dapat menggunakan tool editor teks yang didefinisikan oleh Anthropic untuk melihat dan memodifikasi file teks, membantu Anda debug, memperbaiki, dan meningkatkan kode atau dokumen teks lainnya.
Claude dapat menggunakan tool editor teks yang didefinisikan oleh Anthropic untuk melihat dan memodifikasi file teks, membantu Anda debug, memperbaiki, dan meningkatkan kode atau dokumen teks lainnya. Ini memungkinkan Claude untuk berinteraksi langsung dengan file Anda, memberikan bantuan langsung daripada hanya menyarankan perubahan.
Sebelum menggunakan tool editor teks
Gunakan model yang kompatibel
Tool editor teks Anthropic tersedia untuk beberapa model Claude:
- Claude 4 Opus & Sonnet:
text_editor_20250429
- Claude Sonnet 3.7:
text_editor_20250124
- Claude Sonnet 3.5:
text_editor_20241022
Claude Sonnet 3.5 memerlukan header beta computer-use-2024-10-22
saat menggunakan tool editor teks.
Tool editor teks tersedia secara umum di Claude 4 dan Sonnet 3.7.
text_editor_20250429
yang lebih baru untuk model Claude 4 tidak menyertakan perintah undo_edit
. Jika Anda memerlukan fungsionalitas ini, Anda perlu menggunakan Claude 3.7 atau Sonnet 3.5 dengan versi tool masing-masing.
Evaluasi kesesuaian kasus penggunaan Anda
Beberapa contoh kapan menggunakan tool editor teks adalah:
- Debugging kode: Minta Claude mengidentifikasi dan memperbaiki bug dalam kode Anda, dari kesalahan sintaks hingga masalah logika.
- Refactoring kode: Biarkan Claude meningkatkan struktur kode, keterbacaan, dan performa melalui pengeditan yang terarah.
- Pembuatan dokumentasi: Minta Claude menambahkan docstring, komentar, atau file README ke codebase Anda.
- Pembuatan tes: Minta Claude membuat unit test untuk kode Anda berdasarkan pemahamannya terhadap implementasi.
Gunakan tool editor teks
Berikan tool editor teks (bernama str_replace_based_edit_tool
) kepada Claude menggunakan Messages API:
Berikan tool editor teks (bernama str_replace_based_edit_tool
) kepada Claude menggunakan Messages API:
Berikan tool editor teks (bernama str_replace_editor
) kepada Claude menggunakan Messages API:
Berikan tool editor teks (bernama str_replace_editor
) kepada Claude menggunakan Messages API:
Tool editor teks dapat digunakan dengan cara berikut:
Berikan Claude tool editor teks dan prompt pengguna
- Sertakan tool editor teks dalam permintaan API Anda
- Berikan prompt pengguna yang mungkin memerlukan pemeriksaan atau modifikasi file, seperti “Bisakah Anda memperbaiki kesalahan sintaks dalam kode saya?”
Claude menggunakan tool untuk memeriksa file atau direktori
- Claude menilai apa yang perlu dilihat dan menggunakan perintah
view
untuk memeriksa konten file atau mendaftar konten direktori - Respons API akan berisi blok konten
tool_use
dengan perintahview
Jalankan perintah view dan kembalikan hasil
- Ekstrak path file atau direktori dari permintaan penggunaan tool Claude
- Baca konten file atau daftar konten direktori dan kembalikan ke Claude
- Kembalikan hasil ke Claude dengan melanjutkan percakapan dengan pesan
user
baru yang berisi blok kontentool_result
Claude menggunakan tool untuk memodifikasi file
- Setelah memeriksa file atau direktori, Claude mungkin menggunakan perintah seperti
str_replace
untuk membuat perubahan atauinsert
untuk menambahkan teks pada nomor baris tertentu. - Jika Claude menggunakan perintah
str_replace
, Claude membuat permintaan penggunaan tool yang diformat dengan benar dengan teks lama dan teks baru untuk menggantinya
Jalankan pengeditan dan kembalikan hasil
- Ekstrak path file, teks lama, dan teks baru dari permintaan penggunaan tool Claude
- Lakukan penggantian teks dalam file
- Kembalikan hasil ke Claude
Claude memberikan analisis dan penjelasan
- Setelah memeriksa dan mungkin mengedit file, Claude memberikan penjelasan lengkap tentang apa yang ditemukan dan perubahan apa yang dibuat
Perintah tool editor teks
Tool editor teks mendukung beberapa perintah untuk melihat dan memodifikasi file:
view
Perintah view
memungkinkan Claude untuk memeriksa konten file atau mendaftar konten direktori. Ini dapat membaca seluruh file atau rentang baris tertentu.
Parameter:
command
: Harus “view”path
: Path ke file atau direktori yang akan dilihatview_range
(opsional): Array dari dua integer yang menentukan nomor baris awal dan akhir untuk dilihat. Nomor baris dimulai dari 1, dan -1 untuk baris akhir berarti baca sampai akhir file. Parameter ini hanya berlaku saat melihat file, bukan direktori.
str_replace
Perintah str_replace
memungkinkan Claude untuk mengganti string tertentu dalam file dengan string baru. Ini digunakan untuk membuat pengeditan yang tepat.
Parameter:
command
: Harus “str_replace”path
: Path ke file yang akan dimodifikasiold_str
: Teks yang akan diganti (harus cocok persis, termasuk whitespace dan indentasi)new_str
: Teks baru untuk dimasukkan menggantikan teks lama
create
Perintah create
memungkinkan Claude untuk membuat file baru dengan konten yang ditentukan.
Parameter:
command
: Harus “create”path
: Path di mana file baru harus dibuatfile_text
: Konten yang akan ditulis ke file baru
insert
Perintah insert
memungkinkan Claude untuk menyisipkan teks pada lokasi tertentu dalam file.
Parameter:
command
: Harus “insert”path
: Path ke file yang akan dimodifikasiinsert_line
: Nomor baris setelah mana teks akan disisipkan (0 untuk awal file)new_str
: Teks yang akan disisipkan
undo_edit
Perintah undo_edit
memungkinkan Claude untuk mengembalikan pengeditan terakhir yang dibuat pada file.
Perintah ini hanya tersedia di Claude Sonnet 3.7 dan Claude Sonnet 3.5. Tidak didukung di model Claude 4 yang menggunakan text_editor_20250429
.
Parameter:
command
: Harus “undo_edit”path
: Path ke file yang pengeditan terakhirnya harus dibatalkan
Contoh: Memperbaiki kesalahan sintaks dengan tool editor teks
Contoh ini mendemonstrasikan bagaimana Claude 4 menggunakan tool editor teks untuk memperbaiki kesalahan sintaks dalam file Python.
Pertama, aplikasi Anda memberikan Claude tool editor teks dan prompt untuk memperbaiki kesalahan sintaks:
Claude akan menggunakan tool editor teks terlebih dahulu untuk melihat file:
Aplikasi Anda kemudian harus membaca file dan mengembalikan kontennya ke Claude:
Nomor baris
Dalam contoh di atas, hasil tool view
menyertakan konten file dengan nomor baris yang ditambahkan di depan setiap baris (misalnya, “1: def is_prime(n):”). Nomor baris tidak diperlukan, tetapi sangat penting untuk berhasil menggunakan parameter view_range
untuk memeriksa bagian tertentu dari file dan parameter insert_line
untuk menambahkan konten pada lokasi yang tepat.
Claude akan mengidentifikasi kesalahan sintaks dan menggunakan perintah str_replace
untuk memperbaikinya:
Aplikasi Anda kemudian harus membuat pengeditan dan mengembalikan hasilnya:
Akhirnya, Claude akan memberikan penjelasan lengkap tentang perbaikan:
Contoh ini mendemonstrasikan bagaimana Claude 4 menggunakan tool editor teks untuk memperbaiki kesalahan sintaks dalam file Python.
Pertama, aplikasi Anda memberikan Claude tool editor teks dan prompt untuk memperbaiki kesalahan sintaks:
Claude akan menggunakan tool editor teks terlebih dahulu untuk melihat file:
Aplikasi Anda kemudian harus membaca file dan mengembalikan kontennya ke Claude:
Nomor baris
Dalam contoh di atas, hasil tool view
menyertakan konten file dengan nomor baris yang ditambahkan di depan setiap baris (misalnya, “1: def is_prime(n):”). Nomor baris tidak diperlukan, tetapi sangat penting untuk berhasil menggunakan parameter view_range
untuk memeriksa bagian tertentu dari file dan parameter insert_line
untuk menambahkan konten pada lokasi yang tepat.
Claude akan mengidentifikasi kesalahan sintaks dan menggunakan perintah str_replace
untuk memperbaikinya:
Aplikasi Anda kemudian harus membuat pengeditan dan mengembalikan hasilnya:
Akhirnya, Claude akan memberikan penjelasan lengkap tentang perbaikan:
Contoh ini mendemonstrasikan bagaimana Claude Sonnet 3.7 menggunakan tool editor teks untuk memperbaiki kesalahan sintaks dalam file Python.
Pertama, aplikasi Anda memberikan Claude tool editor teks dan prompt untuk memperbaiki kesalahan sintaks:
Contoh Claude Sonnet 3.7 mengikuti format yang sama dengan contoh Claude 4 di atas, menggunakan panggilan tool dan respons yang sama tetapi dengan tipe tool text_editor_20250124
dan nama str_replace_editor
.
Implementasikan tool editor teks
Tool editor teks diimplementasikan sebagai tool tanpa skema. Saat menggunakan tool ini, Anda tidak perlu menyediakan skema input seperti tool lainnya; skema sudah terpasang dalam model Claude dan tidak dapat dimodifikasi.
Tipe tool tergantung pada versi model:
- Claude 4:
type: "text_editor_20250429"
- Claude Sonnet 3.7:
type: "text_editor_20250124"
- Claude Sonnet 3.5:
type: "text_editor_20241022"
Inisialisasi implementasi editor Anda
Buat fungsi helper untuk menangani operasi file seperti membaca, menulis, dan memodifikasi file. Pertimbangkan untuk mengimplementasikan fungsionalitas backup untuk pulih dari kesalahan.
Tangani panggilan tool editor
Buat fungsi yang memproses panggilan tool dari Claude berdasarkan tipe perintah:
Implementasikan langkah-langkah keamanan
Tambahkan validasi dan pemeriksaan keamanan:
- Validasi path file untuk mencegah directory traversal
- Buat backup sebelum membuat perubahan
- Tangani kesalahan dengan baik
- Implementasikan pemeriksaan izin
Proses respons Claude
Ekstrak dan tangani panggilan tool dari respons Claude:
Saat mengimplementasikan tool editor teks, ingatlah:
- Keamanan: Tool memiliki akses ke sistem file lokal Anda, jadi implementasikan langkah-langkah keamanan yang tepat.
- Backup: Selalu buat backup sebelum mengizinkan pengeditan file penting.
- Validasi: Validasi semua input untuk mencegah perubahan yang tidak diinginkan.
- Pencocokan unik: Pastikan penggantian cocok dengan tepat satu lokasi untuk menghindari pengeditan yang tidak diinginkan.
Tangani kesalahan
Saat menggunakan tool editor teks, berbagai kesalahan mungkin terjadi. Berikut panduan cara menanganinya:
Ikuti praktik terbaik implementasi
Harga dan penggunaan token
The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you’re using.
In addition to the base tokens, the following additional input tokens are needed for the text editor tool:
Tool | Additional input tokens |
---|---|
text_editor_20250429 (Claude 4) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5) | 700 tokens |
Untuk informasi lebih detail tentang harga tool, lihat Harga penggunaan tool.
Integrasikan tool editor teks dengan tool lain
Tool editor teks dapat digunakan bersama tool Claude lainnya. Saat menggabungkan tool, pastikan Anda:
- Mencocokkan versi tool dengan model yang Anda gunakan
- Memperhitungkan penggunaan token tambahan untuk semua tool yang disertakan dalam permintaan Anda
Log perubahan
Tanggal | Versi | Perubahan |
---|---|---|
29 April 2025 | text_editor_20250429 | Rilis Tool editor teks untuk Claude 4. Versi ini menghapus perintah undo_edit tetapi mempertahankan semua kemampuan lainnya. Nama tool telah diperbarui untuk mencerminkan arsitektur berbasis str_replace. |
13 Maret 2025 | text_editor_20250124 | Pengenalan dokumentasi Tool editor teks mandiri. Versi ini dioptimalkan untuk Claude Sonnet 3.7 tetapi memiliki kemampuan yang identik dengan versi sebelumnya. |
22 Oktober 2024 | text_editor_20241022 | Rilis awal Tool editor teks dengan Claude Sonnet 3.5. Menyediakan kemampuan untuk melihat, membuat, dan mengedit file melalui perintah view , create , str_replace , insert , dan undo_edit . |
Langkah selanjutnya
Berikut beberapa ide tentang cara menggunakan tool editor teks dengan cara yang lebih nyaman dan kuat:
- Integrasikan dengan alur kerja pengembangan Anda: Bangun tool editor teks ke dalam alat pengembangan atau IDE Anda
- Buat sistem review kode: Minta Claude meninjau kode Anda dan membuat perbaikan
- Bangun asisten debugging: Buat sistem di mana Claude dapat membantu Anda mendiagnosis dan memperbaiki masalah dalam kode Anda
- Implementasikan konversi format file: Biarkan Claude membantu Anda mengonversi file dari satu format ke format lain
- Otomatisasi dokumentasi: Siapkan alur kerja untuk Claude secara otomatis mendokumentasikan kode Anda
Saat Anda membangun aplikasi dengan tool editor teks, kami sangat senang melihat bagaimana Anda memanfaatkan kemampuan Claude untuk meningkatkan alur kerja pengembangan dan produktivitas Anda.