テキストエディタツール

Claudeは、Anthropicが定義したテキストエディタツールを使用して、テキストファイルの表示や修正を行い、コードやその他のテキスト文書のデバッグ、修正、改善を支援できます。これにより、Claudeはファイルと直接やり取りし、変更を提案するだけでなく実際に手を動かして支援することができます。

テキストエディタツールを使用する前に

互換性のあるモデルを使用する

Anthropicのテキストエディタツールは複数のClaudeモデルで利用可能です：

Claude 4 Opus & Sonnet: text_editor_20250429
Claude Sonnet 3.7: text_editor_20250124
Claude Sonnet 3.5: text_editor_20241022

Claude 4モデル向けの新しいtext_editor_20250429にはundo_editコマンドが含まれていません。この機能が必要な場合は、Claude 3.7またはSonnet 3.5をそれぞれのツールバージョンで使用する必要があります。

ユースケースの適合性を評価する

テキストエディタツールを使用する例としては以下のようなものがあります：

コードデバッグ: Claudeに構文エラーからロジックの問題まで、コードのバグを特定して修正してもらいます。
コードリファクタリング: Claudeに的確な編集を通じてコード構造、可読性、パフォーマンスを改善してもらいます。
ドキュメント生成: Claudeにコードベースにdocstring、コメント、READMEファイルを追加してもらいます。
テスト作成: Claudeに実装の理解に基づいてコードの単体テストを作成してもらいます。

テキストエディタツールを使用する

Messages APIを使用してテキストエディタツール（str_replace_based_edit_toolという名前）をClaudeに提供します：

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

Messages APIを使用してテキストエディタツール（str_replace_based_edit_toolという名前）をClaudeに提供します：

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

Messages APIを使用してテキストエディタツール（str_replace_editorという名前）をClaudeに提供します：

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": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

Messages APIを使用してテキストエディタツール（str_replace_editorという名前）をClaudeに提供します：

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20241022",
            "name": "str_replace_editor"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

テキストエディタツールは以下のように使用できます：

テキストエディタツールとユーザープロンプトをClaudeに提供する

APIリクエストにテキストエディタツールを含める
「コードの構文エラーを修正できますか？」などのファイルの検査や修正が必要なユーザープロンプトを提供する

Claudeがツールを使用してファイルやディレクトリを検査する

Claudeは何を見る必要があるかを評価し、viewコマンドを使用してファイルの内容を調べたりディレクトリの内容を一覧表示したりする
APIレスポンスにはviewコマンドを含むtool_useコンテンツブロックが含まれる

viewコマンドを実行して結果を返す

Claudeのツール使用リクエストからファイルまたはディレクトリのパスを抽出する
ファイルの内容を読み取るかディレクトリの内容を一覧表示し、それをClaudeに返す
tool_resultコンテンツブロックを含む新しいuserメッセージで会話を続けることで、結果をClaudeに返す

Claudeがツールを使用してファイルを修正する

ファイルやディレクトリを検査した後、Claudeは変更を加えるためにstr_replaceコマンドや特定の行番号にテキストを追加するためのinsertコマンドなどを使用することがある
Claudeがstr_replaceコマンドを使用する場合、古いテキストと置き換える新しいテキストを含む適切にフォーマットされたツール使用リクエストを構築する

編集を実行して結果を返す

Claudeのツール使用リクエストからファイルパス、古いテキスト、新しいテキストを抽出する
ファイル内のテキスト置換を実行する
結果をClaudeに返す

Claudeが分析と説明を提供する

ファイルを検査し、場合によっては編集した後、Claudeは発見したことと行った変更について完全な説明を提供する

テキストエディタツールのコマンド

テキストエディタツールはファイルの表示と修正のためにいくつかのコマンドをサポートしています：

view

viewコマンドを使用すると、Claudeはファイルの内容を調べたり、ディレクトリの内容を一覧表示したりできます。ファイル全体または特定の行範囲を読み取ることができます。

パラメータ：

command: “view”でなければならない
path: 表示するファイルまたはディレクトリへのパス
view_range (オプション): 表示する開始行と終了行の番号を指定する2つの整数の配列。行番号は1から始まり、終了行が-1の場合はファイルの最後まで読み取ることを意味します。このパラメータはディレクトリではなくファイルを表示する場合にのみ適用されます。

viewコマンドの例

// ファイルを表示する例
{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "primes.py"
  }
}

// ディレクトリを表示する例
{
  "type": "tool_use",
  "id": "toolu_02B19r91rw91mr917835mr9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "src/"
  }
}

str_replace

str_replaceコマンドを使用すると、Claudeはファイル内の特定の文字列を新しい文字列に置き換えることができます。これは正確な編集を行うために使用されます。

パラメータ：

command: “str_replace”でなければならない
path: 修正するファイルへのパス
old_str: 置き換えるテキスト（空白やインデントを含め、正確に一致する必要がある）
new_str: 古いテキストの代わりに挿入する新しいテキスト

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

createコマンドを使用すると、Claudeは指定された内容で新しいファイルを作成できます。

パラメータ：

command: “create”でなければならない
path: 新しいファイルを作成する場所へのパス
file_text: 新しいファイルに書き込む内容

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

insertコマンドを使用すると、Claudeはファイル内の特定の位置にテキストを挿入できます。

パラメータ：

command: “insert”でなければならない
path: 修正するファイルへのパス
insert_line: テキストを挿入する行番号（ファイルの先頭の場合は0）
new_str: 挿入するテキスト

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

undo_editコマンドを使用すると、Claudeはファイルに対して行われた最後の編集を元に戻すことができます。

このコマンドはClaude Sonnet 3.7とClaude Sonnet 3.5でのみ利用可能です。Claude 4モデルのtext_editor_20250429ではサポートされていません。

パラメータ：

command: “undo_edit”でなければならない
path: 最後の編集を元に戻すファイルへのパス

undo_editコマンドの例

例：テキストエディタツールを使用した構文エラーの修正

この例では、Claude 4がテキストエディタツールを使用してPythonファイルの構文エラーを修正する方法を示しています。

まず、アプリケーションはテキストエディタツールと構文エラーを修正するためのプロンプトをClaudeに提供します：

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

print(response)

Claudeはまずテキストエディタツールを使用してファイルを表示します：

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

アプリケーションはファイルを読み取り、その内容をClaudeに返します：

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue."
                },
                {
                    "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()"
                }
            ]
        }
    ]
)

行番号

上記の例では、viewツールの結果には各行の先頭に行番号が付加されたファイルの内容が含まれています（例：「1: def is_prime(n):」）。行番号は必須ではありませんが、view_rangeパラメータを使用してファイルの特定のセクションを調べたり、insert_lineパラメータを使用して正確な位置にコンテンツを追加したりするために不可欠です。

Claudeは構文エラーを特定し、str_replaceコマンドを使用して修正します：

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you."
    },
    {
      "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):"
      }
    }
  ]
}

アプリケーションは編集を行い、結果を返します：

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        # 前のメッセージ...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you."
                },
                {
                    "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": "Successfully replaced text at exactly one location."
                }
            ]
        }
    ]
)

最後に、Claudeは修正の完全な説明を提供します：

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-20250514",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I've fixed the syntax error in your primes.py file. The issue was in the `get_primes` function at line 19. There was a missing colon (:) at the end of the for loop line.\n\nHere's what I changed:\n\nFrom:\n```python\nfor num in range(2, limit + 1)\n```\n\nTo:\n```python\nfor num in range(2, limit + 1):\n```\n\nIn Python, a colon is required at the end of statements that start a new code block, such as for loops, if statements, function definitions, etc. Without the colon, Python raises a syntax error because it doesn't know where the code block begins.\n\nYour code should now run correctly. The function will properly generate a list of prime numbers up to the specified limit."
    }
  ]
}

この例では、Claude 4がテキストエディタツールを使用してPythonファイルの構文エラーを修正する方法を示しています。

まず、アプリケーションはテキストエディタツールと構文エラーを修正するためのプロンプトをClaudeに提供します：

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

print(response)

Claudeはまずテキストエディタツールを使用してファイルを表示します：

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

アプリケーションはファイルを読み取り、その内容をClaudeに返します：

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue."
                },
                {
                    "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()"
                }
            ]
        }
    ]
)

行番号

Claudeは構文エラーを特定し、str_replaceコマンドを使用して修正します：

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you."
    },
    {
      "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):"
      }
    }
  ]
}

アプリケーションは編集を行い、結果を返します：

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250429",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        # 前のメッセージ...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you."
                },
                {
                    "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": "Successfully replaced text at exactly one location."
                }
            ]
        }
    ]
)

最後に、Claudeは修正の完全な説明を提供します：

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-20250514",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I've fixed the syntax error in your primes.py file. The issue was in the `get_primes` function at line 19. There was a missing colon (:) at the end of the for loop line.\n\nHere's what I changed:\n\nFrom:\n```python\nfor num in range(2, limit + 1)\n```\n\nTo:\n```python\nfor num in range(2, limit + 1):\n```\n\nIn Python, a colon is required at the end of statements that start a new code block, such as for loops, if statements, function definitions, etc. Without the colon, Python raises a syntax error because it doesn't know where the code block begins.\n\nYour code should now run correctly. The function will properly generate a list of prime numbers up to the specified limit."
    }
  ]
}

この例では、Claude Sonnet 3.7がテキストエディタツールを使用してPythonファイルの構文エラーを修正する方法を示しています。

まず、アプリケーションはテキストエディタツールと構文エラーを修正するためのプロンプトをClaudeに提供します：

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": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

print(response)

Claude Sonnet 3.7の例は、上記のClaude 4の例と同じ形式に従い、同じツール呼び出しとレスポンスを使用していますが、ツールタイプはtext_editor_20250124、名前はstr_replace_editorを使用しています。

テキストエディタツールを実装する

テキストエディタツールはスキーマレスツールとして実装されています。このツールを使用する際、他のツールのように入力スキーマを提供する必要はありません。スキーマはClaudeのモデルに組み込まれており、変更することはできません。

ツールタイプはモデルバージョンによって異なります：

Claude 4: type: "text_editor_20250429"
Claude Sonnet 3.7: type: "text_editor_20250124"
Claude Sonnet 3.5: type: "text_editor_20241022"

エディタ実装を初期化する

ファイルの読み取り、書き込み、修正などのファイル操作を処理するヘルパー関数を作成します。ミスから回復するためのバックアップ機能の実装を検討してください。

エディタツール呼び出しを処理する

コマンドタイプに基づいてClaudeからのツール呼び出しを処理する関数を作成します：

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':
        # ファイルの内容を読み取って返す
        pass
    elif command == 'str_replace':
        # ファイル内のテキストを置き換える
        pass
    elif command == 'create':
        # 新しいファイルを作成する
        pass
    elif command == 'insert':
        # 指定位置にテキストを挿入する
        pass
    elif command == 'undo_edit':
        # Claude 4モデルかどうかを確認する
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "undo_edit command is not supported in Claude 4"}
        # Claude 3.7/3.5のバックアップから復元する
        pass

セキュリティ対策を実装する

検証とセキュリティチェックを追加します：

ディレクトリトラバーサルを防ぐためのファイルパスの検証
変更を加える前のバックアップの作成
エラーの適切な処理
権限チェックの実装

Claudeのレスポンスを処理する

Claudeのレスポンスからツール呼び出しを抽出して処理します：

# Claudeのレスポンス内のツール使用を処理する
for content in response.content:
    if content.type == "tool_use":
        # コマンドに基づいてツールを実行する
        result = handle_editor_tool(content)
        
        # 結果をClaudeに返す
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

テキストエディタツールを実装する際は、以下の点に注意してください：

セキュリティ: このツールはローカルファイルシステムにアクセスできるため、適切なセキュリティ対策を実装してください。
バックアップ: 重要なファイルの編集を許可する前に、常にバックアップを作成してください。
検証: 意図しない変更を防ぐために、すべての入力を検証してください。
一意のマッチング: 意図しない編集を避けるために、置換が正確に1か所にマッチすることを確認してください。

エラーを処理する

テキストエディタツールを使用する際、さまざまなエラーが発生する可能性があります。以下はそれらを処理するためのガイダンスです：

ファイルが見つからない

Claudeが存在しないファイルを表示または修正しようとした場合、tool_resultに適切なエラーメッセージを返します：

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

置換の複数一致

Claudeのstr_replaceコマンドがファイル内の複数の場所に一致する場合、適切なエラーメッセージを返します：

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Found 3 matches for replacement text. Please provide more context to make a unique match.",
      "is_error": true
    }
  ]
}

置換の一致なし

Claudeのstr_replaceコマンドがファイル内のテキストに一致しない場合、適切なエラーメッセージを返します：

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: No match found for replacement. Please check your text and try again.",
      "is_error": true
    }
  ]
}

権限エラー

ファイルの作成、読み取り、または修正に関する権限の問題がある場合、適切なエラーメッセージを返します：

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Permission denied. Cannot write to file.",
      "is_error": true
    }
  ]
}

実装のベストプラクティスに従う

明確なコンテキストを提供する

ファイルパスを明示的に指定する

編集前にバックアップを作成する

特に重要なコードや本番コードの場合、Claudeが編集する前にファイルのコピーを作成するバックアップシステムをアプリケーションに実装してください。

def backup_file(file_path):
    """編集前にファイルのバックアップを作成する。"""
    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())

一意のテキスト置換を慎重に処理する

str_replaceコマンドは、置き換えるテキストの正確な一致を必要とします。アプリケーションは、古いテキストに対して正確に1つの一致があることを確認するか、適切なエラーメッセージを提供する必要があります。

def safe_replace(file_path, old_text, new_text):
    """正確に1つの一致がある場合にのみテキストを置き換える。"""
    with open(file_path, 'r') as f:
        content = f.read()
    
    count = content.count(old_text)
    if count == 0:
        return "Error: No match found"
    elif count > 1:
        return f"Error: Found {count} matches"
    else:
        new_content = content.replace(old_text, new_text)
        with open(file_path, 'w') as f:
            f.write(new_content)
        return "Successfully replaced text"

変更を検証する

Claudeがファイルに変更を加えた後、テストを実行するか、コードが期待通りに動作することを確認して変更を検証します。

def verify_changes(file_path):
    """変更後にテストまたはチェックを実行する。"""
    try:
        # Pythonファイルの場合、構文エラーをチェックする
        if file_path.endswith('.py'):
            import ast
            with open(file_path, 'r') as f:
                ast.parse(f.read())
            return "Syntax check passed"
    except Exception as e:
        return f"Verification failed: {str(e)}"

価格とトークン使用量

テキストエディタツールは、Claudeで使用される他のツールと同じ価格構造を使用します。使用しているClaudeモデルに基づく標準的な入力および出力トークンの価格に従います。

基本トークンに加えて、テキストエディタツールには以下の追加入力トークンが必要です：

ツール	追加入力トークン
`text_editor_20250429` (Claude 4)	700トークン
`text_editor_20250124` (Claude Sonnet 3.7)	700トークン
`text_editor_20241022` (Claude Sonnet 3.5)	700トークン

ツールの価格に関する詳細情報については、ツール使用の価格を参照してください。

テキストエディタツールをコンピュータ使用と統合する

テキストエディタツールはコンピュータ使用ツールや他のAnthropicが定義したツールと一緒に使用できます。これらのツールを組み合わせる場合は、以下の点に注意する必要があります：

適切なベータヘッダーを含める（コンピュータ使用と一緒に使用する場合）
ツールバージョンを使用しているモデルと一致させる
リクエストに含まれるすべてのツールの追加トークン使用量を考慮する

コンピュータ使用のコンテキストでテキストエディタツールを使用する方法の詳細については、コンピュータ使用を参照してください。

変更履歴

日付	バージョン	変更内容
2025年4月29日	`text_editor_20250429`	Claude 4用テキストエディタツールのリリース。このバージョンでは`undo_edit`コマンドが削除されましたが、他のすべての機能は維持されています。ツール名はstr_replaceベースのアーキテクチャを反映するように更新されました。
2025年3月13日	`text_editor_20250124`	スタンドアロンのテキストエディタツールドキュメントの導入。このバージョンはClaude Sonnet 3.7向けに最適化されていますが、前のバージョンと同じ機能を持っています。
2024年10月22日	`text_editor_20241022`	Claude Sonnet 3.5でのテキストエディタツールの初回リリース。`view`、`create`、`str_replace`、`insert`、`undo_edit`コマンドを通じてファイルの表示、作成、編集機能を提供します。

次のステップ

テキストエディタツールをより便利で強力な方法で使用するためのいくつかのアイデアを紹介します：

開発ワークフローとの統合: テキストエディタツールを開発ツールやIDEに組み込む
コードレビューシステムの作成: Claudeにコードをレビューして改善してもらう
デバッグアシスタントの構築: Claudeがコードの問題を診断して修正するのを手伝うシステムを作成する
ファイル形式変換の実装: Claudeにファイルをある形式から別の形式に変換するのを手伝ってもらう
ドキュメント自動化: Claudeがコードを自動的にドキュメント化するワークフローを設定する

テキストエディタツールを使用してアプリケーションを構築する際、Claudeの機能を活用して開発ワークフローと生産性を向上させる方法を見るのを楽しみにしています。

ツール使用の概要

Claudeで使用するツールワークフローの実装方法を学びます。

トークン効率の良いツール使用

Claude Sonnet 3.7でツールを使用する際のレイテンシとコストを削減します。

Anthropic定義ツール

コンピュータやbashツールなど、他のAnthropic定義ツールの使用方法を学びます。

トークン効率の良いツール使用（ベータ版）ウェブ検索ツール

On this page

テキストエディタツールを使用する前に
互換性のあるモデルを使用する
ユースケースの適合性を評価する
テキストエディタツールを使用する
テキストエディタツールのコマンド
view
str_replace
create
insert
undo_edit
例：テキストエディタツールを使用した構文エラーの修正
テキストエディタツールを実装する
エラーを処理する
実装のベストプラクティスに従う
価格とトークン使用量
テキストエディタツールをコンピュータ使用と統合する
変更履歴
次のステップ

はじめの一歩

モデルと料金

機能を探索

Claudeについて学ぶ

法務センター

テストと評価

エージェントコンポーネント

テキストエディタツール

テキストエディタツールを使用する前に

互換性のあるモデルを使用する

ユースケースの適合性を評価する

テキストエディタツールを使用する

テキストエディタツールのコマンド

view

str_replace

create

insert

undo_edit

例：テキストエディタツールを使用した構文エラーの修正

テキストエディタツールを実装する

エラーを処理する

実装のベストプラクティスに従う

価格とトークン使用量

テキストエディタツールをコンピュータ使用と統合する

変更履歴

次のステップ

ツール使用の概要

トークン効率の良いツール使用

Anthropic定義ツール

はじめの一歩

モデルと料金

機能を探索

Claudeについて学ぶ

法務センター

テストと評価

エージェントコンポーネント

​テキストエディタツールを使用する前に

​互換性のあるモデルを使用する

​ユースケースの適合性を評価する

​テキストエディタツールを使用する

​テキストエディタツールのコマンド

​view

​str_replace

​create

​insert

​undo_edit

​例：テキストエディタツールを使用した構文エラーの修正

​テキストエディタツールを実装する

​エラーを処理する

​実装のベストプラクティスに従う

​価格とトークン使用量

​テキストエディタツールをコンピュータ使用と統合する

​変更履歴

​次のステップ

ツール使用の概要

トークン効率の良いツール使用

Anthropic定義ツール

テキストエディタツールを使用する前に

互換性のあるモデルを使用する

ユースケースの適合性を評価する

テキストエディタツールを使用する

テキストエディタツールのコマンド

view

str_replace

create

insert

undo_edit

例：テキストエディタツールを使用した構文エラーの修正

テキストエディタツールを実装する

エラーを処理する

実装のベストプラクティスに従う

価格とトークン使用量

テキストエディタツールをコンピュータ使用と統合する

変更履歴

次のステップ