読み込み中

テキストエディタツール

レッスン 327 分
読み込み中

テキストエディタツールは、Claudeに組み込まれた機能で、ファイルシステムへのアクセスとテキスト編集機能を提供します。スキーマと実装の両方を自分で記述する他のツールとは異なり、Claudeはすでにテキストエディタの操作をリクエストする方法を知っています。あなたはそれらのリクエストを処理すればよいだけです。

テキストエディタツールが行うこと

このツールは、ソフトウェアエンジニアのようにファイルやディレクトリを操作するための能力をClaudeに与えます。

  • ファイルやディレクトリの内容を表示する
  • ファイル内の特定の行範囲を表示する
  • ファイル内のテキストを置換する
  • 新しいファイルを作成する
  • 特定の行番号にテキストを挿入する

仕組み

テキストエディタツールは、JSONスキーマのみがClaudeに組み込まれているという点で、カスタムツールとは異なります。実際の実装は、あなたが自分で用意する必要があります。

各カスタムツールはJSONスキーマと関数をペアにしたもの: add_duration_to_datetime、get_current_datetime、set_reminder。

カスタムツールを作成する場合、あなたは両方の側を記述します。つまり、ツールについてClaudeに伝えるスキーマと、実際の作業を行う関数です。テキストエディタツールの場合、Claudeはすでにスキーマを持っていますが、Claudeからのファイル表示、編集、または作成のリクエストを処理する関数は、あなたが記述する必要があります。

ツールのセットアップ

テキストエディタツールを使用するには、使用するモデルに対応したツールのバージョンを指定する必要があります。

python
# Claude 4以降のモデル向け
text_editor = "text_editor_20250728"

# それ以前のClaudeモデル向け
text_editor = "text_editor_20250124"

このレッスンの残りの部分では、Claude 4以降のバージョンを使用します。text_editor_20250124の場合、ツール名はstr_replace_editorとなり、undo_editコマンドも存在します。

また、チャット関数を変更して、テキストエディタのパラメータを受け入れ、それをモデル設定に含める必要があります。

ツールコマンド

Claudeがテキストエディタを使用したいとき、特定のコマンドを含むツール使用リクエストを送り返します。

run_toolがstr_replace_editorのコマンド「view」「str_replace」「create」「insert」「undo_edit」を処理するノートブックセル。

あなたの実装は、view、str_replace、create、insertという4つのコマンドすべてを処理する必要があります。以下は、これらのリクエストを処理する基本的な構造です。

python
def run_tool(tool_name, tool_input):
    if tool_name == "str_replace_based_edit_tool":
        command = tool_input.get("command", "")
        if command == "view":
            path = tool_input.get("path", "")
            return text_editor_tool.view(path)
        elif command == "str_replace":
            path = tool_input.get("path", "")
            old_str = tool_input.get("old_str", "")
            new_str = tool_input.get("new_str", "")
            return text_editor_tool.str_replace(path, old_str, new_str)
        # ...その他のコマンドを処理する

例: ファイル分析

このツールが実際にどのように機能するかを見てみましょう。「./main.pyファイル内のコードについて一文で説明してください」とClaudeに依頼すると、次のことが起こります。

ToolUse、ToolResult、Textの各パート: Claudeは「hi there」を出力するhello関数を取得し、それが挨拶を出力するものだと返答します。

Claudeは{"command": "view", "path": "./main.py"}というツール使用リクエストを送信します。あなたのサーバーはTextEditorToolクラスを使用してファイルを読み取り、その内容を返します。Claudeは、読み取ったコードに基づいて分析結果を提供します。

実用的な用途

テキストエディタツールは、本質的にClaudeを次のようなことができるコードアシスタントに変えます。

  • 既存のコードを読み取り、分析を提供する
  • 新しいファイルや関数を作成する
  • 既存のコードを変更する
  • テストファイルをセットアップする
  • 複数のファイルにまたがってコードをリファクタリングする

例えば、Claudeに「main.pyで円周率を小数点第5位まで計算する関数を書き、それをテストするtest.pyファイルを作成してください」と依頼できます。Claudeは既存のファイルを読み取り、新しい関数を追加し、テストファイルを作成して、包括的なテストを書きます。これらはすべて、テキストエディタコマンドを使用して自動的に行われます。

これにより、AIを統合した現代的なコードエディタに似た、AIを活用した開発ツールを構築することが可能になり、コードの変更を依頼すれば、それをファイルシステムに直接実装してもらうことができます。