Kompatibilitas model
| Model | Versi Alat |
|---|---|
| Model Claude 4.x | text_editor_20250728 |
| Claude Sonnet 3.7 (deprecated) | text_editor_20250124 |
text_editor_20250728 untuk model Claude 4 tidak menyertakan perintah undo_edit. Jika Anda memerlukan fungsi ini, Anda perlu menggunakan Claude Sonnet 3.7 (deprecated).Kapan menggunakan alat editor teks
Beberapa contoh kapan menggunakan alat editor teks adalah:- Debugging kode: Biarkan Claude mengidentifikasi dan memperbaiki bug dalam kode Anda, dari kesalahan sintaks hingga masalah logika.
- Refactoring kode: Biarkan Claude meningkatkan struktur kode, keterbacaan, dan kinerja Anda melalui pengeditan yang ditargetkan.
- Pembuatan dokumentasi: Minta Claude untuk menambahkan docstring, komentar, atau file README ke basis kode Anda.
- Pembuatan tes: Biarkan Claude membuat tes unit untuk kode Anda berdasarkan pemahamannya tentang implementasi.
Gunakan alat editor teks
str_replace_based_edit_tool) ke Claude menggunakan Messages API.Anda dapat secara opsional menentukan parameter max_characters untuk mengontrol pemotongan saat melihat file besar.max_characters hanya kompatibel dengan text_editor_20250728 dan versi alat editor teks yang lebih baru.Sediakan Claude dengan alat editor teks dan prompt pengguna
- Sertakan alat editor teks dalam permintaan API Anda
- Sediakan prompt pengguna yang mungkin memerlukan pemeriksaan atau modifikasi file, seperti “Bisakah Anda memperbaiki kesalahan sintaks dalam kode saya?”
Claude menggunakan alat untuk memeriksa file atau direktori
- Claude menilai apa yang perlu dilihat dan menggunakan perintah
viewuntuk memeriksa konten file atau daftar konten direktori - Respons API akan berisi blok konten
tool_usedengan perintahview
Jalankan perintah view dan kembalikan hasil
- Ekstrak jalur file atau direktori dari permintaan penggunaan alat Claude
- Baca konten file atau daftar konten direktori
- Jika parameter
max_charactersditentukan dalam konfigurasi alat, potong konten file ke panjang tersebut - Kembalikan hasil ke Claude dengan melanjutkan percakapan dengan pesan
userbaru yang berisi blok kontentool_result
Claude menggunakan alat untuk memodifikasi file
- Setelah memeriksa file atau direktori, Claude dapat menggunakan perintah seperti
str_replaceuntuk membuat perubahan atauinsertuntuk menambahkan teks pada nomor baris tertentu. - Jika Claude menggunakan perintah
str_replace, Claude membuat permintaan penggunaan alat yang diformat dengan benar dengan teks lama dan teks baru untuk menggantinya
Jalankan edit dan kembalikan hasil
- Ekstrak jalur file, teks lama, dan teks baru dari permintaan penggunaan alat Claude
- Lakukan penggantian teks dalam file
- Kembalikan hasil ke Claude
Claude memberikan analisis dan penjelasannya
- Setelah memeriksa dan kemungkinan mengedit file, Claude memberikan penjelasan lengkap tentang apa yang ditemukannya dan perubahan apa yang dilakukannya
Perintah alat editor teks
Alat editor teks mendukung beberapa perintah untuk melihat dan memodifikasi file:view
Perintahview memungkinkan Claude untuk memeriksa konten file atau daftar konten direktori. Ini dapat membaca seluruh file atau rentang baris tertentu.
Parameter:
command: Harus “view”path: Jalur ke file atau direktori yang akan dilihatview_range(opsional): Array dua bilangan bulat yang menentukan nomor baris awal dan akhir yang akan dilihat. Nomor baris diindeks 1, dan -1 untuk baris akhir berarti membaca hingga akhir file. Parameter ini hanya berlaku saat melihat file, bukan direktori.
Contoh perintah view
Contoh perintah view
str_replace
Perintahstr_replace memungkinkan Claude untuk mengganti string tertentu dalam file dengan string baru. Ini digunakan untuk membuat edit yang presisi.
Parameter:
command: Harus “str_replace”path: Jalur ke file yang akan dimodifikasiold_str: Teks yang akan diganti (harus cocok persis, termasuk spasi dan indentasi)new_str: Teks baru yang akan dimasukkan menggantikan teks lama
Contoh perintah str_replace
Contoh perintah str_replace
create
Perintahcreate memungkinkan Claude untuk membuat file baru dengan konten yang ditentukan.
Parameter:
command: Harus “create”path: Jalur tempat file baru harus dibuatfile_text: Konten yang akan ditulis ke file baru
Contoh perintah create
Contoh perintah create
insert
Perintahinsert memungkinkan Claude untuk menyisipkan teks pada lokasi tertentu dalam file.
Parameter:
command: Harus “insert”path: Jalur ke file yang akan dimodifikasiinsert_line: Nomor baris setelah teks akan disisipkan (0 untuk awal file)new_str: Teks yang akan disisipkan
Contoh perintah insert
Contoh perintah insert
undo_edit
Perintahundo_edit memungkinkan Claude untuk membatalkan edit terakhir yang dilakukan pada file.
text_editor_20250728.command: Harus “undo_edit”path: Jalur ke file yang edit terakhirnya harus dibatalkan
Contoh perintah undo_edit
Contoh perintah undo_edit
Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks
view mencakup konten file dengan nomor baris yang ditambahkan di depan setiap baris (misalnya, “1: def is_prime(n):”). Nomor baris tidak diperlukan, tetapi penting untuk berhasil menggunakan parameter view_range untuk memeriksa bagian file tertentu dan parameter insert_line untuk menambahkan konten pada lokasi yang tepat.str_replace untuk memperbaikinya:Implementasikan alat editor teks
Alat editor teks diimplementasikan sebagai alat tanpa skema. Saat menggunakan alat ini, Anda tidak perlu menyediakan skema input seperti dengan alat lainnya; skema dibangun ke dalam model Claude dan tidak dapat dimodifikasi. Tipe alat tergantung pada versi model:- Claude 4:
type: "text_editor_20250728" - Claude Sonnet 3.7:
type: "text_editor_20250124"
Inisialisasi implementasi editor Anda
Tangani panggilan alat editor
Implementasikan langkah-langkah keamanan
- Validasi jalur file untuk mencegah traversal direktori
- Buat cadangan sebelum membuat perubahan
- Tangani kesalahan dengan baik
- Implementasikan pemeriksaan izin
Proses respons Claude
- Keamanan: Alat memiliki akses ke sistem file lokal Anda, jadi implementasikan langkah-langkah keamanan yang tepat.
- Cadangan: Selalu buat cadangan sebelum memungkinkan edit ke file penting.
- Validasi: Validasi semua input untuk mencegah perubahan yang tidak diinginkan.
- Pencocokan unik: Pastikan penggantian cocok dengan tepat satu lokasi untuk menghindari edit yang tidak diinginkan.
Tangani kesalahan
Saat menggunakan alat editor teks, berbagai kesalahan dapat terjadi. Berikut adalah panduan tentang cara menanganinya:File tidak ditemukan
File tidak ditemukan
tool_result:Beberapa kecocokan untuk penggantian
Beberapa kecocokan untuk penggantian
str_replace Claude cocok dengan beberapa lokasi dalam file, kembalikan pesan kesalahan yang sesuai:Tidak ada kecocokan untuk penggantian
Tidak ada kecocokan untuk penggantian
str_replace Claude tidak cocok dengan teks apa pun dalam file, kembalikan pesan kesalahan yang sesuai:Kesalahan izin
Kesalahan izin
Ikuti praktik terbaik implementasi
Sediakan konteks yang jelas
Sediakan konteks yang jelas
Jadilah eksplisit tentang jalur file
Jadilah eksplisit tentang jalur file
Buat cadangan sebelum mengedit
Buat cadangan sebelum mengedit
Tangani penggantian teks unik dengan hati-hati
Tangani penggantian teks unik dengan hati-hati
str_replace memerlukan kecocokan yang tepat untuk teks yang akan diganti. Aplikasi Anda harus memastikan bahwa ada tepat satu kecocokan untuk teks lama atau memberikan pesan kesalahan yang sesuai.Verifikasi perubahan
Verifikasi perubahan
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.x) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7 (deprecated)) | 700 tokens |
Integrasikan alat editor teks dengan alat lain
Alat editor teks dapat digunakan bersama alat Claude lainnya. Saat menggabungkan alat, pastikan Anda:- Cocokkan versi alat dengan model yang Anda gunakan
- Hitung penggunaan token tambahan untuk semua alat yang disertakan dalam permintaan Anda
Catatan perubahan
| Tanggal | Versi | Perubahan |
|---|---|---|
| 28 Juli 2025 | text_editor_20250728 | Rilis alat editor teks yang diperbarui yang memperbaiki beberapa masalah dan menambahkan parameter max_characters opsional. Ini identik dengan text_editor_20250429. |
| 29 April 2025 | text_editor_20250429 | Rilis alat editor teks untuk Claude 4. Versi ini menghapus perintah undo_edit tetapi mempertahankan semua kemampuan lainnya. Nama alat telah diperbarui untuk mencerminkan arsitekturnya berbasis str_replace. |
| 13 Maret 2025 | text_editor_20250124 | Pengenalan dokumentasi alat editor teks mandiri. Versi ini dioptimalkan untuk Claude Sonnet 3.7 tetapi memiliki kemampuan identik dengan versi sebelumnya. |
| 22 Oktober 2024 | text_editor_20241022 | Rilis awal alat editor teks dengan Claude Sonnet 3.5 (retired). Menyediakan kemampuan untuk melihat, membuat, dan mengedit file melalui perintah view, create, str_replace, insert, dan undo_edit. |
Langkah berikutnya
Berikut adalah beberapa ide tentang cara menggunakan alat editor teks dengan cara yang lebih nyaman dan kuat:- Integrasikan dengan alur kerja pengembangan Anda: Bangun alat editor teks ke dalam alat pengembangan atau IDE Anda
- Buat sistem tinjauan kode: Biarkan 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: Atur alur kerja untuk Claude secara otomatis mendokumentasikan kode Anda