Alat editor teks
Claude dapat menggunakan alat editor teks yang didefinisikan oleh 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.
Sebelum menggunakan alat editor teks
Gunakan model yang kompatibel
Alat 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
Versi terbaru text_editor_20250429
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 alat masing-masing.
Nilai kesesuaian kasus penggunaan Anda
Beberapa contoh kapan menggunakan alat editor teks adalah:
- Debugging kode: Minta Claude untuk mengidentifikasi dan memperbaiki bug dalam kode Anda, mulai dari kesalahan sintaks hingga masalah logika.
- Refactoring kode: Biarkan Claude meningkatkan struktur kode, keterbacaan, dan kinerja melalui pengeditan yang ditargetkan.
- Pembuatan dokumentasi: Minta Claude untuk menambahkan docstring, komentar, atau file README ke basis kode Anda.
- Pembuatan tes: Minta Claude untuk membuat unit test untuk kode Anda berdasarkan pemahamannya tentang implementasi.
Gunakan alat editor teks
Berikan alat editor teks (bernama str_replace_based_edit_tool
) kepada Claude menggunakan Messages API:
Berikan alat editor teks (bernama str_replace_based_edit_tool
) kepada Claude menggunakan Messages API:
Berikan alat editor teks (bernama str_replace_editor
) kepada Claude menggunakan Messages API:
Berikan alat editor teks (bernama str_replace_editor
) kepada Claude menggunakan Messages API:
Alat editor teks dapat digunakan dengan cara berikut:
Berikan Claude alat editor teks dan prompt pengguna
- Sertakan alat 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 alat untuk memeriksa file atau direktori
- Claude menilai apa yang perlu dilihat dan menggunakan perintah
view
untuk memeriksa isi file atau mencantumkan isi direktori - Respons API akan berisi blok konten
tool_use
dengan perintahview
Jalankan perintah view dan kembalikan hasilnya
- Ekstrak jalur file atau direktori dari permintaan penggunaan alat Claude
- Baca isi file atau daftar isi direktori dan kembalikan ke Claude
- Kembalikan hasilnya ke Claude dengan melanjutkan percakapan dengan pesan
user
baru yang berisi blok kontentool_result
Claude menggunakan alat 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 alat yang diformat dengan benar dengan teks lama dan teks baru untuk menggantinya
Jalankan pengeditan dan kembalikan hasilnya
- Ekstrak jalur file, teks lama, dan teks baru dari permintaan penggunaan alat Claude
- Lakukan penggantian teks dalam file
- Kembalikan hasilnya ke Claude
Claude memberikan analisis dan penjelasannya
- Setelah memeriksa dan mungkin mengedit file, Claude memberikan penjelasan lengkap tentang apa yang ditemukan dan perubahan apa yang dilakukan
Perintah alat editor teks
Alat editor teks mendukung beberapa perintah untuk melihat dan memodifikasi file:
view
Perintah view
memungkinkan Claude memeriksa isi file atau mencantumkan isi direktori. Perintah 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 dimulai dari 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 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 yang akan disisipkan sebagai pengganti teks lama
create
Perintah create
memungkinkan Claude 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 menyisipkan teks di 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 membatalkan pengeditan terakhir yang dilakukan pada file.
Perintah ini hanya tersedia di Claude Sonnet 3.7 dan Claude Sonnet 3.5. Perintah ini tidak didukung di model Claude 4 yang menggunakan text_editor_20250429
.
Parameter:
command
: Harus “undo_edit”path
: Jalur ke file yang pengeditan terakhirnya harus dibatalkan
Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks
Contoh ini menunjukkan bagaimana Claude 4 menggunakan alat editor teks untuk memperbaiki kesalahan sintaks dalam file Python.
Pertama, aplikasi Anda memberikan Claude alat editor teks dan prompt untuk memperbaiki kesalahan sintaks:
Nomor baris
Dalam contoh di atas, hasil alat view
menyertakan isi file dengan nomor baris yang ditambahkan ke 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 di lokasi yang tepat.
Claude akan menggunakan alat editor teks terlebih dahulu untuk melihat file:
Aplikasi Anda kemudian harus membaca file dan mengembalikan isinya ke Claude:
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 menunjukkan bagaimana Claude 4 menggunakan alat editor teks untuk memperbaiki kesalahan sintaks dalam file Python.
Pertama, aplikasi Anda memberikan Claude alat editor teks dan prompt untuk memperbaiki kesalahan sintaks:
Nomor baris
Dalam contoh di atas, hasil alat view
menyertakan isi file dengan nomor baris yang ditambahkan ke 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 di lokasi yang tepat.
Claude akan menggunakan alat editor teks terlebih dahulu untuk melihat file:
Aplikasi Anda kemudian harus membaca file dan mengembalikan isinya ke Claude:
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 menunjukkan bagaimana Claude Sonnet 3.7 menggunakan alat editor teks untuk memperbaiki kesalahan sintaks dalam file Python.
Pertama, aplikasi Anda memberikan Claude alat 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 alat dan respons yang sama tetapi dengan tipe alat text_editor_20250124
dan nama str_replace_editor
.
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 lain; skema sudah tertanam dalam model Claude dan tidak dapat dimodifikasi.
Tipe alat 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 pembantu untuk menangani operasi file seperti membaca, menulis, dan memodifikasi file. Pertimbangkan untuk mengimplementasikan fungsionalitas backup untuk memulihkan dari kesalahan.
Tangani panggilan alat editor
Buat fungsi yang memproses panggilan alat dari Claude berdasarkan jenis perintah:
Implementasikan langkah-langkah keamanan
Tambahkan validasi dan pemeriksaan keamanan:
- Validasi jalur file untuk mencegah traversal direktori
- Buat backup sebelum membuat perubahan
- Tangani kesalahan dengan anggun
- Implementasikan pemeriksaan izin
Proses respons Claude
Ekstrak dan tangani panggilan alat dari respons Claude:
Saat mengimplementasikan alat editor teks, perhatikan:
- Keamanan: Alat ini memiliki akses ke sistem file lokal Anda, jadi terapkan langkah-langkah keamanan yang tepat.
- Backup: Selalu buat backup sebelum mengizinkan pengeditan pada file penting.
- Validasi: Validasi semua input untuk mencegah perubahan yang tidak diinginkan.
- Pencocokan unik: Pastikan penggantian cocok persis di satu lokasi untuk menghindari pengeditan yang tidak diinginkan.
Tangani kesalahan
Saat menggunakan alat editor teks, berbagai kesalahan mungkin terjadi. Berikut adalah panduan tentang cara menanganinya:
Ikuti praktik terbaik implementasi
Harga dan penggunaan token
Alat editor teks menggunakan struktur harga yang sama dengan alat lain yang digunakan dengan Claude. Ini mengikuti harga token input dan output standar berdasarkan model Claude yang Anda gunakan.
Selain token dasar, token input tambahan berikut diperlukan untuk alat editor teks:
Alat | Token input tambahan |
---|---|
text_editor_20250429 (Claude 4) | 700 token |
text_editor_20250124 (Claude Sonnet 3.7) | 700 token |
text_editor_20241022 (Claude Sonnet 3.5) | 700 token |
Untuk informasi lebih rinci tentang harga alat, lihat Harga penggunaan alat.
Integrasikan alat editor teks dengan penggunaan komputer
Alat editor teks dapat digunakan bersama dengan alat penggunaan komputer dan alat lain yang didefinisikan oleh Anthropic. Saat menggabungkan alat-alat ini, Anda perlu:
- Sertakan header beta yang sesuai (jika digunakan dengan penggunaan komputer)
- Cocokkan versi al at dengan model yang Anda gunakan
- Perhitungkan penggunaan token tambahan untuk semua alat yang disertakan dalam permintaan Anda
Untuk informasi lebih lanjut tentang penggunaan alat editor teks dalam konteks penggunaan komputer, lihat Penggunaan komputer.
Log perubahan
Tanggal | Versi | Perubahan |
---|---|---|
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. Menyediakan kemampuan untuk melihat, membuat, dan mengedit file melalui perintah view , create , str_replace , insert , dan undo_edit . |
Langkah selanjutnya
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 peninjauan 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 agar Claude secara otomatis mendokumentasikan kode Anda
Saat Anda membangun aplikasi dengan alat editor teks, kami sangat senang melihat bagaimana Anda memanfaatkan kemampuan Claude untuk meningkatkan alur kerja dan produktivitas pengembangan Anda.
Ikhtisar penggunaan alat
Pelajari cara mengimplementasikan alur kerja alat untuk digunakan dengan Claude.
Penggunaan alat hemat token
Kurangi latensi dan biaya saat menggunakan alat dengan Claude Sonnet 3.7.
Alat yang didefinisikan Anthropic
Pelajari cara menggunakan alat lain yang didefinisikan Anthropic seperti alat komputer dan bash.