テキストエディタツール

ClaudeはAnthropic定義のテキストエディタツールを使用してテキストファイルを表示・変更し、コードやその他のテキストドキュメントのデバッグ、修正、改善を支援できます。これによりClaudeはファイルと直接やり取りし、単に変更を提案するだけでなく実践的な支援を提供できます。

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

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

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

Claude Sonnet 4、Opus 4、Opus 4.1: text_editor_20250728
Claude Sonnet 3.7: text_editor_20250124
Claude Sonnet 3.5 (非推奨): text_editor_20241022

Claude Sonnet 3.5 (非推奨)では、テキストエディタツールを使用する際にcomputer-use-2024-10-22ベータヘッダーが必要です。

テキストエディタツールはClaude 4モデルとClaude Sonnet 3.7で一般利用可能です。

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

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

テキストエディタツールを使用する場合の例：

コードデバッグ: Claudeにコードのバグを特定・修正させる（構文エラーからロジックの問題まで）
コードリファクタリング: Claudeに対象を絞った編集を通じてコード構造、可読性、パフォーマンスを改善させる
ドキュメント生成: Claudeにコードベースにdocstring、コメント、READMEファイルを追加するよう依頼する
テスト作成: 実装の理解に基づいてClaudeにコードのユニットテストを作成させる

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

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

大きなファイルを表示する際の切り捨てを制御するために、オプションでmax_charactersパラメータを指定できます。

max_charactersはtext_editor_20250728以降のバージョンのテキストエディタツールでのみ互換性があります。

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-1-20250805",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool",
        "max_characters": 10000
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      }
    ]
  }'

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

大きなファイルを表示する際の切り捨てを制御するために、オプションでmax_charactersパラメータを指定できます。

max_charactersはtext_editor_20250728以降のバージョンのテキストエディタツールでのみ互換性があります。

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-1-20250805",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool",
        "max_characters": 10000
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      }
    ]
  }'

Messages APIを使用してテキストエディタツール（str_replace_editorという名前）を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-3-7-sonnet-20250219",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      }
    ]
  }'

Messages APIを使用してテキストエディタツール（str_replace_editorという名前）を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" \
  -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": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      }
    ]
  }'

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

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

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

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

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

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

Claudeのツール使用リクエストからファイルまたはディレクトリパスを抽出する
ファイルの内容を読み取るかディレクトリの内容をリストする
ツール設定でmax_charactersパラメータが指定されている場合、ファイル内容をその長さに切り詰める
tool_resultコンテンツブロックを含む新しいuserメッセージで会話を続けることで結果をClaudeに返す

Claudeがツールを使用してファイルを変更する

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

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

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（非推奨）でのみ利用可能です。text_editor_20250728を使用するClaude 4モデルではサポートされていません。

パラメータ：

command: “undo_edit”である必要があります
path: 最後の編集を元に戻すファイルのパス

undo_editコマンドの例

例：テキストエディタツールで構文エラーを修正する

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

まず、アプリケーションは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-1-20250805",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      }
    ]
  }'

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

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-1-20250805",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "primes.pyファイルの構文エラーの修正をお手伝いします。まず、ファイルを確認して問題を特定しましょう。"
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

その後、アプリケーションはファイルを読み取り、その内容を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-1-20250805",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      },
      {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "primes.pyファイルの構文エラーの修正をお手伝いします。まず、ファイルを確認して問題を特定しましょう。"
                },
                {
                    "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-1-20250805",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "primes.pyファイルで構文エラーを見つけました。`get_primes`関数で、forループ行の最後にコロン（:）が不足しています。修正いたします。"
    },
    {
      "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-1-20250805",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        # 以前のメッセージ...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "primes.pyファイルで構文エラーを見つけました。`get_primes`関数で、forループ行の最後にコロン（:）が不足しています。修正いたします。"
                },
                {
                    "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": "正確に1箇所でテキストの置換が成功しました。"
                }
            ]
        }
    ]
)

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

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-1-20250805",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "primes.pyファイルの構文エラーを修正しました。問題は19行目の`get_primes`関数にありました。forループ行の最後にコロン（:）が不足していました。\n\n変更内容：\n\n変更前：\n```python\nfor num in range(2, limit + 1)\n```\n\n変更後：\n```python\nfor num in range(2, limit + 1):\n```\n\nPythonでは、forループ、if文、関数定義など、新しいコードブロックを開始する文の最後にはコロンが必要です。コロンがないと、Pythonはコードブロックがどこから始まるかわからないため構文エラーが発生します。\n\nコードは正常に動作するはずです。この関数は指定された制限まで素数のリストを適切に生成します。"
    }
  ]
}

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

まず、アプリケーションは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-1-20250805",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      }
    ]
  }'

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

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-1-20250805",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "primes.pyファイルの構文エラーの修正をお手伝いします。まず、ファイルを確認して問題を特定しましょう。"
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

その後、アプリケーションはファイルを読み取り、その内容を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-1-20250805",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
      },
      {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "primes.pyファイルの構文エラーの修正をお手伝いします。まず、ファイルを確認して問題を特定しましょう。"
                },
                {
                    "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-1-20250805",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "primes.pyファイルで構文エラーを見つけました。`get_primes`関数で、forループ行の最後にコロン（:）が不足しています。修正いたします。"
    },
    {
      "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-1-20250805",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool"
        }
    ],
    messages=[
        # 以前のメッセージ...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "primes.pyファイルで構文エラーを見つけました。`get_primes`関数で、forループ行の最後にコロン（:）が不足しています。修正いたします。"
                },
                {
                    "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": "正確に1箇所でテキストの置換が成功しました。"
                }
            ]
        }
    ]
)

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

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-1-20250805",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "primes.pyファイルの構文エラーを修正しました。問題は19行目の`get_primes`関数にありました。forループ行の最後にコロン（:）が不足していました。\n\n変更内容：\n\n変更前：\n```python\nfor num in range(2, limit + 1)\n```\n\n変更後：\n```python\nfor num in range(2, limit + 1):\n```\n\nPythonでは、forループ、if文、関数定義など、新しいコードブロックを開始する文の最後にはコロンが必要です。コロンがないと、Pythonはコードブロックがどこから始まるかわからないため構文エラーが発生します。\n\nコードは正常に動作するはずです。この関数は指定された制限まで素数のリストを適切に生成します。"
    }
  ]
}

この例では、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": "primes.pyファイルに構文エラーがあります。修正を手伝ってもらえますか？"
        }
    ]
)

print(response)

Claude Sonnet 3.7の例は上記のClaude 4の例と同じ形式に従いますが、text_editor_20250124ツールタイプとstr_replace_editor名を使用します。

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

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

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

Claude 4: type: "text_editor_20250728"
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コマンドは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": "エラー: ファイルが見つかりません",
      "is_error": true
    }
  ]
}

置換の複数マッチ

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

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "エラー: 置換テキストに3つのマッチが見つかりました。一意のマッチを作るためにより多くのコンテキストを提供してください。",
      "is_error": true
    }
  ]
}

置換のマッチなし

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

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "エラー: 置換のマッチが見つかりません。テキストを確認して再試行してください。",
      "is_error": true
    }
  ]
}

権限エラー

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

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "エラー: 権限が拒否されました。ファイルに書き込めません。",
      "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 "エラー: マッチが見つかりません"
    elif count > 1:
        return f"エラー: {count}個のマッチが見つかりました"
    else:
        new_content = content.replace(old_text, new_text)
        with open(file_path, 'w') as f:
            f.write(new_content)
        return "テキストの置換が成功しました"

変更を検証する

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 "構文チェックが通りました"
    except Exception as e:
        return f"検証に失敗しました: {str(e)}"

価格とトークン使用量

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

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

テキストエディタツールを他のツールと統合する

テキストエディタツールは他のClaudeツールと併用できます。ツールを組み合わせる際は、以下を確認してください：

使用するモデルとツールバージョンを一致させる
リクエストに含まれるすべてのツールの追加トークン使用量を考慮する

変更ログ

日付	バージョン	変更内容
2025年7月28日	`text_editor_20250728`	いくつかの問題を修正し、オプションの`max_characters`パラメータを追加した更新されたテキストエディタツールのリリース。それ以外は`text_editor_20250429`と同一です。
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でツールを使用する際のレイテンシとコストを削減します。

Bashツール

Claudeでシェルコマンドを実行します。

コンピュータ使用ツール Web fetch ツール

On this page

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

はじめの手順

モデルと料金

Claudeについて学ぶ

機能

ツール

Model Context Protocol (MCP)

使用例

プロンプトエンジニアリング

テスト・評価

ガードレールを強化

法的センター

テキストエディタツール

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

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

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

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

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

view

str_replace

create

insert

undo_edit

例：テキストエディタツールで構文エラーを修正する

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

エラーを処理する

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

価格とトークン使用量

テキストエディタツールを他のツールと統合する

変更ログ

次のステップ

ツール使用概要

トークン効率的なツール使用

Bashツール

はじめの手順

モデルと料金

Claudeについて学ぶ

機能

ツール

Model Context Protocol (MCP)

使用例

プロンプトエンジニアリング

テスト・評価

ガードレールを強化

法的センター

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

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

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

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

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

​view

​str_replace

​create

​insert

​undo_edit

​例：テキストエディタツールで構文エラーを修正する

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

​エラーを処理する

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

​価格とトークン使用量

​テキストエディタツールを他のツールと統合する

​変更ログ

​次のステップ

ツール使用概要

トークン効率的なツール使用

Bashツール

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

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

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

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

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

view

str_replace

create

insert

undo_edit

例：テキストエディタツールで構文エラーを修正する

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

エラーを処理する

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

価格とトークン使用量

テキストエディタツールを他のツールと統合する

変更ログ

次のステップ