Alat editor teks

Claude dapat menggunakan alat editor teks yang ditentukan 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.

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 mundur 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:

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 mendaftar konten direktori. Ini dapat membaca seluruh file atau rentang baris tertentu.

Parameter:

command: Harus "view"
path: Jalur ke file atau direktori yang akan dilihat
view_range (opsional): Larik dua bilangan bulat yang menentukan nomor baris awal dan akhir untuk dilihat. Nomor baris diindeks 1, dan -1 untuk baris akhir berarti baca 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 pengeditan yang tepat.

Parameter:

command: Harus "str_replace"
path: Jalur ke file yang akan dimodifikasi
old_str: Teks yang akan diganti (harus cocok persis, termasuk spasi dan indentasi)
new_str: Teks baru yang akan dimasukkan sebagai pengganti 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 dibuat
file_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 dimodifikasi
insert_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 pengeditan 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 pengeditan 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 memberikan skema input seperti dengan alat lainnya; skema dibangun ke dalam model Claude dan tidak dapat dimodifikasi.

Jenis alat tergantung pada versi model:

Claude 4: type: "text_editor_20250728"
Claude Sonnet 3.7: type: "text_editor_20250124"

Saat mengimplementasikan alat editor teks, perhatikan hal berikut:

Keamanan: Alat ini memiliki akses ke sistem file lokal Anda, jadi implementasikan langkah-langkah keamanan yang tepat.
Cadangan: Selalu buat cadangan sebelum memungkinkan 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 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 lainnya

Alat editor teks dapat digunakan bersama dengan alat Claude lainnya. Saat menggabungkan alat, pastikan Anda:

Cocokkan versi alat dengan model yang Anda gunakan
Pertimbangkan 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. Sebaliknya 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-nya.
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 (). Menyediakan kemampuan untuk melihat, membuat, dan mengedit file melalui perintah , , , , dan .

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: Siapkan 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.

Gambaran umum penggunaan alat

Pelajari cara mengimplementasikan alur kerja alat untuk digunakan dengan Claude.

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':
        # Read and return file contents
        pass
    elif command == 'str_replace':
        # Replace text in file
        pass
    elif command == 'create':
        # Create new file
        pass
    elif command == 'insert':
        # Insert text at location
        pass
    elif command == 'undo_edit':
        # Check if it's a Claude 4 model
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "undo_edit command is not supported in Claude 4"}
        # Restore from backup for Claude 3.7
        pass

Implementasikan 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:

# Process tool use in Claude's response
for content in response.content:
    if content.type == "tool_use":
        # Execute the tool based on command
        result = handle_editor_tool(content)
        
        # Return result to Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

view

create

str_replace

insert

undo_edit

Kompatibilitas model

Kapan menggunakan alat editor teks

Gunakan alat editor teks

Perintah alat editor teks

view

Contoh perintah view

str_replace

Contoh perintah str_replace

create

Contoh perintah create

insert

Contoh perintah insert

undo_edit

Contoh perintah undo_edit

Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks

Implementasikan alat editor teks

Tangani kesalahan

File tidak ditemukan

Beberapa kecocokan untuk penggantian

Ikuti praktik terbaik implementasi

Berikan konteks yang jelas

Jadilah eksplisit tentang jalur file

Buat cadangan sebelum mengedit

Harga dan penggunaan token

Integrasikan alat editor teks dengan alat lainnya

Catatan perubahan

Langkah berikutnya

Tidak ada kecocokan untuk penggantian

Kesalahan izin

Tangani penggantian teks unik dengan hati-hati

Verifikasi perubahan