Alat editor teks

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. 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_20250728
Claude Sonnet 3.7: text_editor_20250124
Claude Sonnet 3.5: text_editor_20241022

Claude Sonnet 3.5 memerlukan header beta computer-use-2024-10-22 saat menggunakan alat editor teks.

Alat editor teks tersedia secara umum di Claude 4 dan Sonnet 3.7.

Alat text_editor_20250728 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.

Evaluasi kesesuaian kasus penggunaan Anda

Beberapa contoh kapan menggunakan alat editor teks adalah:

Debugging kode: Minta Claude mengidentifikasi dan memperbaiki bug dalam kode Anda, dari kesalahan sintaks hingga masalah logika.
Refactoring kode: Biarkan Claude meningkatkan struktur kode, keterbacaan, dan performa melalui pengeditan yang ditargetkan.
Pembuatan dokumentasi: Minta Claude untuk menambahkan docstring, komentar, atau file README ke basis kode Anda.
Pembuatan tes: Minta Claude 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.

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.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool",
        "max_characters": 10000
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      }
    ]
  }'

Berikan alat editor teks (bernama 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.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool",
        "max_characters": 10000
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      }
    ]
  }'

Berikan alat editor teks (bernama str_replace_editor) kepada Claude menggunakan Messages API:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-7-sonnet-20250219",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      }
    ]
  }'

Berikan alat editor teks (bernama str_replace_editor) kepada Claude menggunakan Messages API:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: computer-use-2024-10-22" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20241022",
        "name": "str_replace_editor"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      }
    ]
  }'

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 konten file atau mendaftar konten direktori
Respons API akan berisi blok konten tool_use dengan perintah view

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_characters ditentukan dalam konfigurasi alat, potong konten file hingga panjang tersebut
Kembalikan hasil ke Claude dengan melanjutkan percakapan dengan pesan user baru yang berisi blok konten tool_result

Claude menggunakan alat untuk memodifikasi file

Setelah memeriksa file atau direktori, Claude mungkin menggunakan perintah seperti str_replace untuk membuat perubahan atau insert 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 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 mungkin mengedit file, Claude memberikan penjelasan lengkap tentang apa yang ditemukan dan perubahan apa yang dibuat

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): Array dari dua integer 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.

Contoh perintah view

// Contoh untuk melihat file
{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "primes.py"
  }
}

// Contoh untuk melihat direktori
{
  "type": "tool_use",
  "id": "toolu_02B19r91rw91mr917835mr9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "src/"
  }
}

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 untuk disisipkan menggantikan teks lama

Contoh perintah str_replace

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "str_replace",
    "path": "primes.py",
    "old_str": "for num in range(2, limit + 1)",
    "new_str": "for num in range(2, limit + 1):"
  }
}

create

Perintah create memungkinkan Claude untuk membuat file baru dengan konten yang ditentukan.

Parameter:

command: Harus “create”
path: Jalur di mana file baru harus dibuat
file_text: Konten untuk ditulis ke file baru

Contoh perintah create

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "create",
    "path": "test_primes.py",
    "file_text": "import unittest\nimport primes\n\nclass TestPrimes(unittest.TestCase):\n    def test_is_prime(self):\n        self.assertTrue(primes.is_prime(2))\n        self.assertTrue(primes.is_prime(3))\n        self.assertFalse(primes.is_prime(4))\n\nif __name__ == '__main__':\n    unittest.main()"
  }
}

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 mana teks akan disisipkan (0 untuk awal file)
new_str: Teks yang akan disisipkan

Contoh perintah insert

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "insert",
    "path": "primes.py",
    "insert_line": 0,
    "new_str": "\"\"\"Module for working with prime numbers.\n\nThis module provides functions to check if a number is prime\nand to generate a list of prime numbers up to a given limit.\n\"\"\"\n"
  }
}

undo_edit

Perintah undo_edit memungkinkan Claude untuk mengembalikan pengeditan terakhir yang dibuat pada file.

Perintah ini hanya tersedia di Claude Sonnet 3.7 dan Claude Sonnet 3.5. Ini tidak didukung di model Claude 4 yang menggunakan text_editor_20250728.

Parameter:

command: Harus “undo_edit”
path: Jalur ke file yang pengeditan terakhirnya harus dibatalkan

Contoh perintah undo_edit

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:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      }
    ]
  }'

Claude akan menggunakan alat editor teks terlebih dahulu untuk melihat file:

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Saya akan membantu Anda memperbaiki kesalahan sintaks di file primes.py Anda. Pertama, biarkan saya melihat file untuk mengidentifikasi masalahnya."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

Aplikasi Anda kemudian harus membaca file dan mengembalikan kontennya ke Claude:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      },
      {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "Saya akan membantu Anda memperbaiki kesalahan sintaks di file primes.py Anda. Pertama, biarkan saya melihat file untuk mengidentifikasi masalahnya."
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "name": "str_replace_based_edit_tool",
                    "input": {
                        "command": "view",
                        "path": "primes.py"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "content": "1: def is_prime(n):\n2:     \"\"\"Check if a number is prime.\"\"\"\n3:     if n <= 1:\n4:         return False\n5:     if n <= 3:\n6:         return True\n7:     if n % 2 == 0 or n % 3 == 0:\n8:         return False\n9:     i = 5\n10:     while i * i <= n:\n11:         if n % i == 0 or n % (i + 2) == 0:\n12:             return False\n13:         i += 6\n14:     return True\n15: \n16: def get_primes(limit):\n17:     \"\"\"Generate a list of prime numbers up to the given limit.\"\"\"\n18:     primes = []\n19:     for num in range(2, limit + 1)\n20:         if is_prime(num):\n21:             primes.append(num)\n22:     return primes\n23: \n24: def main():\n25:     \"\"\"Main function to demonstrate prime number generation.\"\"\"\n26:     limit = 100\n27:     prime_list = get_primes(limit)\n28:     print(f\"Prime numbers up to {limit}:\")\n29:     print(prime_list)\n30:     print(f\"Found {len(prime_list)} prime numbers.\")\n31: \n32: if __name__ == \"__main__\":\n33:     main()"
                }
            ]
        }
    ]
  }'

Nomor baris

Dalam contoh di atas, hasil alat 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.

Claude akan mengidentifikasi kesalahan sintaks dan menggunakan perintah str_replace untuk memperbaikinya:

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Saya menemukan kesalahan sintaks di file primes.py Anda. Dalam fungsi `get_primes`, ada titik dua (:) yang hilang di akhir baris for loop. Biarkan saya memperbaikinya untuk Anda."
    },
    {
      "type": "tool_use",
      "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "str_replace",
        "path": "primes.py",
        "old_str": "    for num in range(2, limit + 1)",
        "new_str": "    for num in range(2, limit + 1):"
      }
    }
  ]
}

Aplikasi Anda kemudian harus membuat pengeditan dan mengembalikan hasilnya:

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        # Pesan sebelumnya...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "Saya menemukan kesalahan sintaks di file primes.py Anda. Dalam fungsi `get_primes`, ada titik dua (:) yang hilang di akhir baris for loop. Biarkan saya memperbaikinya untuk Anda."
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "name": "str_replace_based_edit_tool",
                    "input": {
                        "command": "str_replace",
                        "path": "primes.py",
                        "old_str": "    for num in range(2, limit + 1)",
                        "new_str": "    for num in range(2, limit + 1):"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "content": "Berhasil mengganti teks di tepat satu lokasi."
                }
            ]
        }
    ]
)

Akhirnya, Claude akan memberikan penjelasan lengkap tentang perbaikan:

{
  "id": "msg_01Ij KlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-20250514",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Saya telah memperbaiki kesalahan sintaks di file primes.py Anda. Masalahnya ada di fungsi `get_primes` pada baris 19. Ada titik dua (:) yang hilang di akhir baris for loop.\n\nBerikut yang saya ubah:\n\nDari:\n```python\nfor num in range(2, limit + 1)\n```\n\nMenjadi:\n```python\nfor num in range(2, limit + 1):\n```\n\nDalam Python, titik dua diperlukan di akhir pernyataan yang memulai blok kode baru, seperti for loop, if statement, definisi fungsi, dll. Tanpa titik dua, Python menimbulkan kesalahan sintaks karena tidak tahu di mana blok kode dimulai.\n\nKode Anda sekarang harus berjalan dengan benar. Fungsi akan menghasilkan daftar bilangan prima hingga batas yang ditentukan dengan benar."
    }
  ]
}

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:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      }
    ]
  }'

Claude akan menggunakan alat editor teks terlebih dahulu untuk melihat file:

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Saya akan membantu Anda memperbaiki kesalahan sintaks di file primes.py Anda. Pertama, biarkan saya melihat file untuk mengidentifikasi masalahnya."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

Aplikasi Anda kemudian harus membaca file dan mengembalikan kontennya ke Claude:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
      },
      {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "Saya akan membantu Anda memperbaiki kesalahan sintaks di file primes.py Anda. Pertama, biarkan saya melihat file untuk mengidentifikasi masalahnya."
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "name": "str_replace_based_edit_tool",
                    "input": {
                        "command": "view",
                        "path": "primes.py"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "content": "1: def is_prime(n):\n2:     \"\"\"Check if a number is prime.\"\"\"\n3:     if n <= 1:\n4:         return False\n5:     if n <= 3:\n6:         return True\n7:     if n % 2 == 0 or n % 3 == 0:\n8:         return False\n9:     i = 5\n10:     while i * i <= n:\n11:         if n % i == 0 or n % (i + 2) == 0:\n12:             return False\n13:         i += 6\n14:     return True\n15: \n16: def get_primes(limit):\n17:     \"\"\"Generate a list of prime numbers up to the given limit.\"\"\"\n18:     primes = []\n19:     for num in range(2, limit + 1)\n20:         if is_prime(num):\n21:             primes.append(num)\n22:     return primes\n23: \n24: def main():\n25:     \"\"\"Main function to demonstrate prime number generation.\"\"\"\n26:     limit = 100\n27:     prime_list = get_primes(limit)\n28:     print(f\"Prime numbers up to {limit}:\")\n29:     print(prime_list)\n30:     print(f\"Found {len(prime_list)} prime numbers.\")\n31: \n32: if __name__ == \"__main__\":\n33:     main()"
                }
            ]
        }
    ]
  }'

Nomor baris

Claude akan mengidentifikasi kesalahan sintaks dan menggunakan perintah str_replace untuk memperbaikinya:

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Saya menemukan kesalahan sintaks di file primes.py Anda. Dalam fungsi `get_primes`, ada titik dua (:) yang hilang di akhir baris for loop. Biarkan saya memperbaikinya untuk Anda."
    },
    {
      "type": "tool_use",
      "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "str_replace",
        "path": "primes.py",
        "old_str": "    for num in range(2, limit + 1)",
        "new_str": "    for num in range(2, limit + 1):"
      }
    }
  ]
}

Aplikasi Anda kemudian harus membuat pengeditan dan mengembalikan hasilnya:

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        # Pesan sebelumnya...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "Saya menemukan kesalahan sintaks di file primes.py Anda. Dalam fungsi `get_primes`, ada titik dua (:) yang hilang di akhir baris for loop. Biarkan saya memperbaikinya untuk Anda."
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "name": "str_replace_based_edit_tool",
                    "input": {
                        "command": "str_replace",
                        "path": "primes.py",
                        "old_str": "    for num in range(2, limit + 1)",
                        "new_str": "    for num in range(2, limit + 1):"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "content": "Berhasil mengganti teks di tepat satu lokasi."
                }
            ]
        }
    ]
)

Akhirnya, Claude akan memberikan penjelasan lengkap tentang perbaikan:

{
  "id": "msg_01Ij KlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-20250514",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Saya telah memperbaiki kesalahan sintaks di file primes.py Anda. Masalahnya ada di fungsi `get_primes` pada baris 19. Ada titik dua (:) yang hilang di akhir baris for loop.\n\nBerikut yang saya ubah:\n\nDari:\n```python\nfor num in range(2, limit + 1)\n```\n\nMenjadi:\n```python\nfor num in range(2, limit + 1):\n```\n\nDalam Python, titik dua diperlukan di akhir pernyataan yang memulai blok kode baru, seperti for loop, if statement, definisi fungsi, dll. Tanpa titik dua, Python menimbulkan kesalahan sintaks karena tidak tahu di mana blok kode dimulai.\n\nKode Anda sekarang harus berjalan dengan benar. Fungsi akan menghasilkan daftar bilangan prima hingga batas yang ditentukan dengan benar."
    }
  ]
}

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:

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250124",
            "name": "str_replace_editor"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "Ada kesalahan sintaks di file primes.py saya. Bisakah Anda membantu memperbaikinya?"
        }
    ]
)

print(response)

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 memberikan skema input seperti alat lainnya; skema sudah terpasang 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"
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 pulih dari kesalahan.

Tangani panggilan alat editor

Buat fungsi yang memproses panggilan alat dari Claude berdasarkan tipe 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 pada lokasi
        pass
    elif command == 'undo_edit':
        # Periksa apakah ini model Claude 4
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "perintah undo_edit tidak didukung di Claude 4"}
        # Pulihkan dari backup untuk Claude 3.7/3.5
        pass

Implementasikan langkah-langkah keamanan

Tambahkan validasi dan pemeriksaan keamanan:

Validasi jalur file untuk mencegah directory traversal
Buat backup 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, ingatlah:

Keamanan: Alat memiliki akses ke sistem file lokal Anda, jadi implementasikan langkah-langkah keamanan yang tepat.
Backup: Selalu buat backup sebelum mengizinkan 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 mungkin terjadi. Berikut panduan cara menanganinya:

File tidak ditemukan

Jika Claude mencoba melihat atau memodifikasi file yang tidak ada, kembalikan pesan kesalahan yang sesuai dalam tool_result:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: File tidak ditemukan",
      "is_error": true
    }
  ]
}

Beberapa kecocokan untuk penggantian

Jika perintah str_replace Claude cocok dengan beberapa lokasi dalam file, kembalikan pesan kesalahan yang sesuai:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Ditemukan 3 kecocokan untuk teks penggantian. Harap berikan lebih banyak konteks untuk membuat kecocokan yang unik.",
      "is_error": true
    }
  ]
}

Tidak ada kecocokan untuk penggantian

Jika perintah str_replace Claude tidak cocok dengan teks apa pun dalam file, kembalikan pesan kesalahan yang sesuai:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Tidak ditemukan kecocokan untuk penggantian. Harap periksa teks Anda dan coba lagi.",
      "is_error": true
    }
  ]
}

Kesalahan izin

Jika ada masalah izin dengan membuat, membaca, atau memodifikasi file, kembalikan pesan kesalahan yang sesuai:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Izin ditolak. Tidak dapat menulis ke file.",
      "is_error": true
    }
  ]
}

Ikuti praktik terbaik implementasi

Berikan konteks yang jelas

Eksplisit tentang jalur file

Buat backup sebelum mengedit

Implementasikan sistem backup dalam aplikasi Anda yang membuat salinan file sebelum mengizinkan Claude mengeditnya, terutama untuk kode penting atau produksi.

def backup_file(file_path):
    """Buat backup file sebelum mengedit."""
    backup_path = f"{file_path}.backup"
    if os.path.exists(file_path):
        with open(file_path, 'r') as src, open(backup_path, 'w') as dst:
            dst.write(src.read())

Tangani penggantian teks unik dengan hati-hati

Perintah 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.

def safe_replace(file_path, old_text, new_text):
    """Ganti teks hanya jika ada tepat satu kecocokan."""
    with open(file_path, 'r') as f:
        content = f.read()
    
    count = content.count(old_text)
    if count == 0:
        return "Error: Tidak ditemukan kecocokan"
    elif count > 1:
        return f"Error: Ditemukan {count} kecocokan"
    else:
        new_content = content.replace(old_text, new_text)
        with open(file_path, 'w') as f:
            f.write(new_content)
        return "Berhasil mengganti teks"

Verifikasi perubahan

Setelah Claude membuat perubahan pada file, verifikasi perubahan dengan menjalankan tes atau memeriksa bahwa kode masih berfungsi seperti yang diharapkan.

def verify_changes(file_path):
    """Jalankan tes atau pemeriksaan setelah membuat perubahan."""
    try:
        # Untuk file Python, periksa kesalahan sintaks
        if file_path.endswith('.py'):
            import ast
            with open(file_path, 'r') as f:
                ast.parse(f.read())
            return "Pemeriksaan sintaks berhasil"
    except Exception as e:
        return f"Verifikasi gagal: {str(e)}"

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)	700 tokens
`text_editor_20250124` (Claude Sonnet 3.7)	700 tokens
`text_editor_20241022` (Claude Sonnet 3.5 (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:

Mencocokkan versi alat dengan model yang Anda gunakan
Memperhitungkan penggunaan token tambahan untuk semua alat yang disertakan dalam permintaan Anda

Log 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. 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. Menyediakan kemampuan untuk melihat, membuat, dan mengedit file melalui perintah `view`, `create`, `str_replace`, `insert`, dan `undo_edit`.

Langkah selanjutnya

Berikut 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 review 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 untuk 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 pengembangan dan produktivitas Anda.

Ikhtisar penggunaan alat

Pelajari cara mengimplementasikan alur kerja alat untuk digunakan dengan Claude.

Penggunaan alat yang efisien token

Kurangi latensi dan biaya saat menggunakan alat dengan Claude Sonnet 3.7.

Alat Bash

Jalankan perintah shell dengan Claude.

Tool penggunaan komputer Alat pencarian web

On this page

Sebelum menggunakan alat editor teks
Gunakan model yang kompatibel
Evaluasi kesesuaian kasus penggunaan Anda
Gunakan alat editor teks
Perintah alat editor teks
view
str_replace
create
insert
undo_edit
Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks
Implementasikan alat editor teks
Tangani kesalahan
Ikuti praktik terbaik implementasi
Harga dan penggunaan token
Integrasikan alat editor teks dengan alat lain
Log perubahan
Langkah selanjutnya

Langkah pertama

Model & harga

Pelajari tentang Claude

Kemampuan

Alat

Model Context Protocol (MCP)

Kasus penggunaan

Rekayasa prompt

Uji & evaluasi

Perkuat pagar pengaman

Pusat Hukum

Sebelum menggunakan alat editor teks

Gunakan model yang kompatibel

Evaluasi kesesuaian kasus penggunaan Anda

Gunakan alat editor teks

Perintah alat editor teks

view

str_replace

create

insert

undo_edit

Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks

Implementasikan alat editor teks

Tangani kesalahan

Ikuti praktik terbaik implementasi

Harga dan penggunaan token

Integrasikan alat editor teks dengan alat lain

Log perubahan

Langkah selanjutnya

Ikhtisar penggunaan alat

Penggunaan alat yang efisien token

Alat Bash

Langkah pertama

Model & harga

Pelajari tentang Claude

Kemampuan

Alat

Model Context Protocol (MCP)

Kasus penggunaan

Rekayasa prompt

Uji & evaluasi

Perkuat pagar pengaman

Pusat Hukum

​Sebelum menggunakan alat editor teks

​Gunakan model yang kompatibel

​Evaluasi kesesuaian kasus penggunaan Anda

​Gunakan alat editor teks

​Perintah alat editor teks

​view

​str_replace

​create

​insert

​undo_edit

​Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks

​Implementasikan alat editor teks

​Tangani kesalahan

​Ikuti praktik terbaik implementasi

​Harga dan penggunaan token

​Integrasikan alat editor teks dengan alat lain

​Log perubahan

​Langkah selanjutnya

Ikhtisar penggunaan alat

Penggunaan alat yang efisien token

Alat Bash

Sebelum menggunakan alat editor teks

Gunakan model yang kompatibel

Evaluasi kesesuaian kasus penggunaan Anda

Gunakan alat editor teks

Perintah alat editor teks

view

str_replace

create

insert

undo_edit

Contoh: Memperbaiki kesalahan sintaks dengan alat editor teks

Implementasikan alat editor teks

Tangani kesalahan

Ikuti praktik terbaik implementasi

Harga dan penggunaan token

Integrasikan alat editor teks dengan alat lain

Log perubahan

Langkah selanjutnya