Claudeがテキストファイルを表示・編集するためのAnthropic定義のテキストエディタツールの使用方法
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
ベータヘッダーが必要です。テキストエディタツールはClaude 4モデルとClaude Sonnet 3.7で一般利用可能です。text_editor_20250728
ツールにはundo_edit
コマンドが含まれていません。この機能が必要な場合は、それぞれのツールバージョンでClaude Sonnet 3.7またはSonnet 3.5を使用する必要があります。str_replace_based_edit_tool
という名前)をClaudeに提供します。大きなファイルを表示する際の切り捨てを制御するために、オプションでmax_characters
パラメータを指定できます。max_characters
はtext_editor_20250728
以降のバージョンのテキストエディタツールでのみ互換性があります。Claudeにテキストエディタツールとユーザープロンプトを提供する
Claudeがツールを使用してファイルやディレクトリを検査する
view
コマンドを使用してファイル内容を検査したりディレクトリ内容をリストしたりするview
コマンドを含むtool_use
コンテンツブロックが含まれるviewコマンドを実行して結果を返す
max_characters
パラメータが指定されている場合、ファイル内容をその長さに切り詰めるtool_result
コンテンツブロックを含む新しいuser
メッセージで会話を続けることで結果をClaudeに返すClaudeがツールを使用してファイルを変更する
str_replace
などのコマンドを使用して変更を行ったり、insert
を使用して特定の行番号にテキストを追加したりする場合があるstr_replace
コマンドを使用する場合、Claudeは古いテキストと置き換える新しいテキストを含む適切にフォーマットされたツール使用リクエストを構築する編集を実行して結果を返す
Claudeが分析と説明を提供する
view
コマンドを使用すると、Claudeはファイルの内容を検査したり、ディレクトリの内容をリストしたりできます。ファイル全体または特定の行範囲を読み取ることができます。
パラメータ:
command
: “view”である必要がありますpath
: 表示するファイルまたはディレクトリのパスview_range
(オプション): 表示する開始行番号と終了行番号を指定する2つの整数の配列。行番号は1から始まり、終了行の-1はファイルの最後まで読み取ることを意味します。このパラメータはファイルを表示する場合にのみ適用され、ディレクトリには適用されません。viewコマンドの例
str_replace
コマンドを使用すると、Claudeはファイル内の特定の文字列を新しい文字列に置き換えることができます。これは正確な編集を行うために使用されます。
パラメータ:
command
: “str_replace”である必要がありますpath
: 変更するファイルのパスold_str
: 置き換えるテキスト(空白とインデントを含めて正確に一致する必要があります)new_str
: 古いテキストの代わりに挿入する新しいテキストstr_replaceコマンドの例
create
コマンドを使用すると、Claudeは指定された内容で新しいファイルを作成できます。
パラメータ:
command
: “create”である必要がありますpath
: 新しいファイルを作成する場所のパスfile_text
: 新しいファイルに書き込む内容createコマンドの例
insert
コマンドを使用すると、Claudeはファイル内の特定の場所にテキストを挿入できます。
パラメータ:
command
: “insert”である必要がありますpath
: 変更するファイルのパスinsert_line
: テキストを挿入する行番号の後(ファイルの先頭の場合は0)new_str
: 挿入するテキストinsertコマンドの例
undo_edit
コマンドを使用すると、Claudeは最後にファイルに行った編集を元に戻すことができます。
text_editor_20250728
を使用するClaude 4モデルではサポートされていません。command
: “undo_edit”である必要がありますpath
: 最後の編集を元に戻すファイルのパスundo_editコマンドの例
view
ツールの結果には各行に行番号が前置されたファイル内容が含まれています(例:「1: def is_prime(n):」)。行番号は必須ではありませんが、view_range
パラメータを使用してファイルの特定のセクションを検査したり、insert_line
パラメータを使用して正確な場所にコンテンツを追加したりするために不可欠です。str_replace
コマンドを使用して修正します:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
エディタ実装を初期化する
エディタツール呼び出しを処理する
セキュリティ対策を実装する
Claudeのレスポンスを処理する
ファイルが見つからない
tool_result
で適切なエラーメッセージを返します:置換の複数マッチ
str_replace
コマンドがファイル内の複数の場所にマッチした場合、適切なエラーメッセージを返します:置換のマッチなし
str_replace
コマンドがファイル内のテキストにマッチしない場合、適切なエラーメッセージを返します:権限エラー
明確なコンテキストを提供する
ファイルパスを明示的にする
編集前にバックアップを作成する
一意のテキスト置換を慎重に処理する
str_replace
コマンドは置換されるテキストの正確なマッチを必要とします。アプリケーションは古いテキストに対して正確に1つのマッチがあることを確認するか、適切なエラーメッセージを提供する必要があります。変更を検証する
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 |
日付 | バージョン | 変更内容 |
---|---|---|
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 コマンドを通じてファイルの表示、作成、編集機能を提供します。 |