読み込み中

テキスト編集ツール

レッスン 325 分

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

読み込み中

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

テキストエディタ ツールでできること

テキストエディタ ツールは、包括的なファイル操作機能をClaudeに提供します。

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

テキストエディタ ツールはClaudeに組み込まれていますが、そのスキーマのみであり、実際のツールの実装はあなたが提供します。

これによりClaudeの能力は劇的に拡張され、最初からソフトウェアエンジニアとして機能する力を事実上与えられることになります。

実装要件を理解する

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

text_editor_tool_schema JSONスキーマと、3つのクエスチョンマークが示された「Function」ボックス。これはあなたが書かなければならない関数です。

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

スキーマバージョン

テキストエディタ ツールを使用する際には、小さなスキーマのスタブを含める必要があり、正確なスキーマは使用しているClaudeモデルによって異なります。

python
def get_text_edit_schema(model):
    if model.startswith("claude-haiku-4-5"):
        return {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
        }

Claudeは、この小さなスキーマのスタブを、「command」「path」「view_range」「old_str」「new_str」「file_text」を含む、より長いものに展開します。

Claudeはこの小さなスキーマを、利用可能なすべてのパラメータと操作を含む、はるかに大きく詳細な仕様へと自動的に展開します。

実践例

テキストエディタ ツールが実際に動作する様子を見てみましょう。ファイルを操作するようClaudeに依頼すると、必要に応じてこのツールを使ってファイルの読み取り、変更、作成を行います。

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

  1. テキストエディタ ツールを使ってファイルを表示する
  2. 内容を読み取る
  3. 要約を提供する

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

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

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

テキストエディタ ツールを使う理由

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

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

要するに、テキストエディタ ツールを使うことで、高機能なAI搭載コードエディタの機能の多くを自分のアプリケーション内で再現でき、Claudeにファイルシステム上のファイルを読み取り、書き込み、修正できる真のコーディングアシスタントとしての能力を与えることができます。