Alat editor teks
Claude dapat menggunakan alat editor teks yang didefinisikan Anthropic untuk melihat dan memodifikasi file teks, membantu Anda men-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.
Kompatibilitas model
| Model | Versi Alat |
|---|---|
| Model Claude 4.x | text_editor_20250728 |
| Claude Sonnet 3.7 (deprecated) | text_editor_20250124 |
Alat 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).
Versi alat yang lebih lama tidak dijamin kompatibel ke belakang dengan model yang lebih baru. Selalu gunakan versi alat yang sesuai dengan versi model Anda.
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
Alat editor teks dapat digunakan dengan cara berikut:
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
- Claude menilai apa yang perlu dilihat dan menggunakan perintah
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
- Setelah memeriksa file atau direktori, Claude dapat menggunakan perintah seperti
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
Perintah view 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.
str_replace
Perintah str_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
create
Perintah create 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
insert
Perintah insert 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
undo_edit
Perintah undo_edit memungkinkan Claude untuk membatalkan edit terakhir yang dilakukan pada file.
Perintah ini hanya tersedia di Claude Sonnet 3.7 (deprecated). Ini tidak didukung dalam model Claude 4 menggunakan text_editor_20250728.
Parameter:
command: Harus "undo_edit"path: Jalur ke file yang edit terakhirnya harus dibatalkan
Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks
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
Buat fungsi pembantu untuk menangani operasi file seperti membaca, menulis, dan memodifikasi file. Pertimbangkan untuk mengimplementasikan fungsionalitas cadangan untuk memulihkan dari kesalahan.
Tangani panggilan alat editor
Buat fungsi yang memproses panggilan alat dari Claude berdasarkan jenis perintah:
def handle_editor_tool(tool_call, model_version): input_params = tool_call.input command = input_params.get('command', '') file_path = input_params.get('path', '') if command == 'view': # Baca dan kembalikan konten file pass elif command == 'str_replace': # Ganti teks dalam file pass elif command == 'create': # Buat file baru pass elif command == 'insert': # Sisipkan teks di lokasi pass elif command == 'undo_edit': # Periksa apakah itu model Claude 4 if 'str_replace_based_edit_tool' in model_version: return {"error": "undo_edit command is not supported in Claude 4"} # Pulihkan dari cadangan untuk Claude 3.7 passImplementasikan langkah-langkah keamanan
Tambahkan validasi dan pemeriksaan keamanan:
- Validasi jalur file untuk mencegah traversal direktori
- Buat cadangan sebelum membuat perubahan
- Tangani kesalahan dengan baik
- Implementasikan pemeriksaan izin
Proses respons Claude
Ekstrak dan tangani panggilan alat dari respons Claude:
# Proses penggunaan alat dalam respons Claude for content in response.content: if content.type == "tool_use": # Jalankan alat berdasarkan perintah result = handle_editor_tool(content) # Kembalikan hasil ke Claude tool_result = { "type": "tool_result", "tool_use_id": content.id, "content": result }
Saat mengimplementasikan alat editor teks, ingat:
- 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:
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.x) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7 (deprecated)) | 700 tokens |
Untuk informasi lebih detail tentang harga alat, lihat Harga penggunaan alat.
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
Saat Anda membangun aplikasi dengan alat editor teks, kami bersemangat melihat bagaimana Anda memanfaatkan kemampuan Claude untuk meningkatkan alur kerja pengembangan dan produktivitas Anda.