Claude dapat menggunakan alat editor teks yang didefinisikan Anthropic untuk melihat dan memodifikasi file teks, membantu Anda debug, memperbaiki, dan meningkatkan kode atau dokumen teks lainnya.
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
saat menggunakan alat editor teks.Alat editor teks tersedia secara umum di model Claude 4 dan Claude Sonnet 3.7.text_editor_20250728
untuk model Claude 4 tidak menyertakan perintah undo_edit
. Jika Anda memerlukan fungsionalitas ini, Anda perlu menggunakan Claude Sonnet 3.7 atau Sonnet 3.5 dengan versi alat masing-masing.str_replace_based_edit_tool
) kepada 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.Berikan Claude alat editor teks dan prompt pengguna
Claude menggunakan alat untuk memeriksa file atau direktori
view
untuk memeriksa konten file atau mendaftar konten direktoritool_use
dengan perintah view
Jalankan perintah view dan kembalikan hasil
max_characters
ditentukan dalam konfigurasi alat, potong konten file hingga panjang tersebutuser
baru yang berisi blok konten tool_result
Claude menggunakan alat untuk memodifikasi file
str_replace
untuk membuat perubahan atau insert
untuk menambahkan teks pada nomor baris tertentu.str_replace
, Claude membuat permintaan penggunaan alat yang diformat dengan benar dengan teks lama dan teks baru untuk menggantinyaJalankan pengeditan dan kembalikan hasil
Claude memberikan analisis dan penjelasan
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
: Jalur 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 hingga akhir file. Parameter ini hanya berlaku saat melihat file, bukan direktori.Contoh perintah view
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
: Jalur ke file yang akan dimodifikasiold_str
: Teks yang akan diganti (harus cocok persis, termasuk spasi dan indentasi)new_str
: Teks baru untuk dimasukkan menggantikan teks lamaContoh perintah str_replace
create
memungkinkan Claude untuk membuat file baru dengan konten yang ditentukan.
Parameter:
command
: Harus “create”path
: Jalur di mana file baru harus dibuatfile_text
: Konten untuk ditulis ke file baruContoh perintah create
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 mana teks akan disisipkan (0 untuk awal file)new_str
: Teks yang akan disisipkanContoh perintah insert
undo_edit
memungkinkan Claude untuk mengembalikan pengeditan terakhir yang dibuat pada file.
text_editor_20250728
.command
: Harus “undo_edit”path
: Jalur ke file yang pengeditan terakhirnya harus dibatalkanContoh perintah undo_edit
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.str_replace
untuk memperbaikinya:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
Inisialisasi implementasi editor Anda
Tangani panggilan alat editor
Implementasikan langkah-langkah keamanan
Proses respons Claude
File tidak ditemukan
tool_result
:Beberapa kecocokan untuk penggantian
str_replace
Claude cocok dengan beberapa lokasi dalam file, kembalikan pesan kesalahan yang sesuai:Tidak ada kecocokan untuk penggantian
str_replace
Claude tidak cocok dengan teks apa pun dalam file, kembalikan pesan kesalahan yang sesuai:Kesalahan izin
Berikan konteks yang jelas
Eksplisit tentang jalur file
Buat backup sebelum mengedit
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
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 (deprecated)) | 700 tokens |
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. Selain itu 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 arsitektur 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 yang identik dengan versi sebelumnya. |
22 Oktober 2024 | text_editor_20241022 | Rilis awal alat editor teks dengan Claude Sonnet 3.5 (deprecated). Menyediakan kemampuan untuk melihat, membuat, dan mengedit file melalui perintah view , create , str_replace , insert , dan undo_edit . |