メッセージツール

テキストエディタツール

この機能はZero Data Retention（ZDR）の対象です。組織がZDR契約を締結している場合、この機能を通じて送信されたデータは、APIレスポンスが返された後に保存されることはありません。

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

モデルのサポートについては、ツールリファレンスを参照してください。

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

テキストエディタツールを使用する場面の例は次のとおりです。

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

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

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

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

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

client = anthropic.Anthropic()

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

print(response)

テキストエディタツールは、次の方法で使用できます。

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を指定するとファイルの末尾まで読み取ります。このパラメータは、ディレクトリではなくファイルを表示する場合にのみ適用されます。

str_replace

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

パラメータ：

command：「str_replace」である必要があります
path：変更するファイルへのパス
old_str：置き換えるテキスト（空白やインデントを含め、完全に一致する必要があります）
new_str：古いテキストの代わりに挿入する新しいテキスト

create

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

パラメータ：

command：「create」である必要があります
path：新しいファイルを作成するパス
file_text：新しいファイルに書き込む内容

insert

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

パラメータ：

command：「insert」である必要があります
path：変更するファイルへのパス
insert_line：テキストを挿入する行番号（ファイルの先頭の場合は0）
insert_text：挿入するテキスト

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

この例では、ClaudeがテキストエディタツールをどのようにPythonファイルの構文エラーの修正に使用するかを示します。

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

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "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は、まずテキストエディタツールを使用してファイルを表示します。

Output

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-8",
  "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-8",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "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()',
                }
            ],
        },
    ],
)

print(response)

行番号

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

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

Output

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-4-8",
  "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-8",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "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.",
                }
            ],
        },
    ],
)

print(response)

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

Output

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-8",
  "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のモデルに組み込まれており、変更できません。

Claude 4モデルの場合、ツールタイプはtype: "text_editor_20250728"です。

エディタ実装を初期化する
ファイルの読み取り、書き込み、変更などのファイル操作を処理するヘルパー関数を作成します。ミスから回復できるように、バックアップ機能の実装を検討してください。

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

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

def handle_editor_tool(tool_call):
    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

セキュリティ対策を実装する
検証とセキュリティチェックを追加します。
- ディレクトリトラバーサルを防ぐためにファイルパスを検証する
- 変更を加える前にバックアップを作成する
- エラーを適切に処理する
- 権限チェックを実装する

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で使用される他のツールと同じ料金体系を採用しています。使用しているClaudeモデルに基づいた標準の入力および出力トークン料金に従います。

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

ツール	追加入力トークン
`text_editor_20250429`（Claude 4.x）	700トークン

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

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

テキストエディタツールは、他の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で使用するツールワークフローの実装方法を学びます。

Bashツール

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

Was this page helpful?

メッセージツール

テキストエディタツール

モデルのサポートについては、ツールリファレンスを参照してください。

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

テキストエディタツールを使用する場面の例は次のとおりです。

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

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

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

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

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

client = anthropic.Anthropic()

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

print(response)

テキストエディタツールは、次の方法で使用できます。

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

パラメータ：

command：「view」である必要があります
path：表示するファイルまたはディレクトリへのパス
view_range（オプション）：表示する開始行番号と終了行番号を指定する2つの整数の配列。行番号は1から始まり、終了行に-1を指定するとファイルの末尾まで読み取ります。このパラメータは、ディレクトリではなくファイルを表示する場合にのみ適用されます。

str_replace

パラメータ：

command：「str_replace」である必要があります
path：変更するファイルへのパス
old_str：置き換えるテキスト（空白やインデントを含め、完全に一致する必要があります）
new_str：古いテキストの代わりに挿入する新しいテキスト

create

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

パラメータ：

command：「create」である必要があります
path：新しいファイルを作成するパス
file_text：新しいファイルに書き込む内容

insert

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

パラメータ：

command：「insert」である必要があります
path：変更するファイルへのパス
insert_line：テキストを挿入する行番号（ファイルの先頭の場合は0）
insert_text：挿入するテキスト

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

この例では、ClaudeがテキストエディタツールをどのようにPythonファイルの構文エラーの修正に使用するかを示します。

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

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "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は、まずテキストエディタツールを使用してファイルを表示します。

Output

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-4-8",
  "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-8",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "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()',
                }
            ],
        },
    ],
)

print(response)

行番号

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

Output

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-4-8",
  "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-8",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "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.",
                }
            ],
        },
    ],
)

print(response)

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

Output

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-4-8",
  "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モデルの場合、ツールタイプはtype: "text_editor_20250728"です。

エディタ実装を初期化する
ファイルの読み取り、書き込み、変更などのファイル操作を処理するヘルパー関数を作成します。ミスから回復できるように、バックアップ機能の実装を検討してください。

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

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

def handle_editor_tool(tool_call):
    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

セキュリティ対策を実装する
検証とセキュリティチェックを追加します。
- ディレクトリトラバーサルを防ぐためにファイルパスを検証する
- 変更を加える前にバックアップを作成する
- エラーを適切に処理する
- 権限チェックを実装する

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か所にのみ一致することを確認してください。

エラーを処理する

テキストエディタツールを使用する際、さまざまなエラーが発生する可能性があります。それらの処理方法に関するガイダンスは次のとおりです。

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

料金とトークン使用量

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

ツール	追加入力トークン
`text_editor_20250429`（Claude 4.x）	700トークン

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

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

テキストエディタツールは、他の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で使用するツールワークフローの実装方法を学びます。

Bashツール

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

Was this page helpful?

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

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

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

view

viewコマンドの例

str_replace

str_replaceコマンドの例

create

createコマンドの例

insert

insertコマンドの例

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

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

エラーを処理する

ファイルが見つからない

置換対象が複数一致する

置換対象が一致しない

権限エラー

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

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

ファイルパスを明示する

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

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

変更を検証する

料金とトークン使用量

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

変更履歴

次のステップ

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

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

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

view

viewコマンドの例

str_replace

str_replaceコマンドの例

create

createコマンドの例

insert

insertコマンドの例

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

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

エラーを処理する

ファイルが見つからない

置換対象が複数一致する

置換対象が一致しない

権限エラー

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

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

ファイルパスを明示する

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

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

変更を検証する

料金とトークン使用量

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

変更履歴

次のステップ

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

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

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

view

str_replace

create

insert

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

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

エラーを処理する

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

料金とトークン使用量

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

変更履歴

次のステップ

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

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

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

view

str_replace

create

insert

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

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

エラーを処理する

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

料金とトークン使用量

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

変更履歴

次のステップ