読み込み中

テキスト編集ツール

レッスン 305 分

重要な注意事項:すべてのモデルバージョンに対応するツールバージョン文字列は、こちらで確認できます:https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

Claudeには、ゼロから作成する必要のない組み込みツールが1つ付属しています。それがテキスト編集ツールです。このツールは、標準的なテキストエディタで行うのと同じように、Claudeにファイルやディレクトリを操作する能力を与えます。

テキスト編集ツールでできること

テキスト編集ツールは、Claudeに包括的なファイル操作機能のセットを提供します。

  • ファイルまたはディレクトリの内容を表示する
  • ファイル内の特定の行範囲を表示する
  • ファイル内のテキストを置換する
  • 新しいファイルを作成する
  • ファイルの特定の行にテキストを挿入する
  • ファイルへの最近の編集を取り消す

これにより、Claudeの能力は大幅に拡張され、最初からソフトウェアエンジニアとして機能する力が本質的に与えられます。

実装要件を理解する

ここで少し混乱しやすい点があります。ツールのスキーマはClaudeに組み込まれていますが、実際の実装は自分で提供する必要があります。こう考えてみてください。Claudeはファイル操作をどのように要求するかを知っていますが、その操作を実際に実行するコードはあなたが書く必要があります。

他のツールを使用する場合、JSONスキーマと関数の実装の両方を自分で書きます。テキスト編集ツールの場合、Claudeはスキーマの知識を提供しますが、ファイルの作成、ディレクトリの読み取り、テキストの置換などに対するClaudeのリクエストを処理する関数は、あなたが書く必要があります。

スキーマバージョン

メインのスキーマはClaudeに組み込まれていますが、リクエストを行う際には小さなスキーマスタブを含める必要があります。正確なスキーマは、使用しているClaudeモデルによって異なります。

python
def get_text_edit_schema(model):
    if model.startswith("claude-3-7-sonnet"):
        return {
            "type": "text_editor_20250124",
            "name": "str_replace_editor",
        }
    elif model.startswith("claude-3-5-sonnet"):
        return {
            "type": "text_editor_20241022", 
            "name": "str_replace_editor",
        }

Claudeはこの小さなスキーマを認識し、裏側で自動的にそれを完全なテキスト編集ツールの仕様に展開します。

実践例

テキスト編集ツールの実際の動作を見てみましょう。Claudeにファイルの操作を依頼すると、必要に応じてツールを使用してファイルを読み取り、変更し、作成します。

例えば、Claudeに「./main.pyファイルを開いて、その内容を要約してください」と依頼すると、Claudeは次のことを行います。

  1. テキスト編集ツールを使用してファイルを表示する
  2. 内容を読み取る
  3. 要約を提供する

さらに進んで、Claudeにファイルの変更を依頼することもできます。例えば、「./main.pyファイルを開いて、円周率を小数第5桁まで計算する関数を書いてください。その後、実装をテストするための./test.pyファイルを作成してください」といった依頼です。

Claudeは次のことを行います。

  1. 既存のmain.pyファイルを表示する
  2. 円周率計算関数を含む新しい実装でその内容を置き換える
  3. 適切な単体テストを含む新しいtest.pyファイルを作成する

なぜテキスト編集ツールを使うのか?

最新のコードエディタにはすでにAIアシスタントが組み込まれているのに、なぜこのツールが存在するのか疑問に思うかもしれません。テキスト編集ツールは、次のようなシナリオで価値を発揮します。

  • ファイルをプログラム的に編集する必要があるアプリケーションを構築している場合
  • フル機能のコードエディタにアクセスできない環境で作業している場合
  • ファイル編集機能をClaudeを活用したアプリケーションに直接統合したい場合

本質的に、テキスト編集ツールを使用すると、高機能なAI搭載コードエディタの機能の多くを自分のアプリケーション内で再現でき、Claudeがファイルシステムとどのように相互作用するかを細かく制御できるようになります。