モデル互換性
| モデル | ツールバージョン |
|---|---|
| Claude 4.x モデル | text_editor_20250728 |
| Claude Sonnet 3.7 | text_editor_20250124 |
| Claude Sonnet 3.5 (非推奨) | text_editor_20241022 |
Claude Sonnet 3.5 (非推奨)では、テキストエディタツールを使用する際に
computer-use-2024-10-22ベータヘッダーが必要です。テキストエディタツールは、Claude 4モデルとClaude Sonnet 3.7で一般利用可能です。Claude 4モデル用の
text_editor_20250728ツールにはundo_editコマンドが含まれていません。この機能が必要な場合は、それぞれのツールバージョンでClaude Sonnet 3.7またはSonnet 3.5を使用する必要があります。古いツールバージョンは新しいモデルとの後方互換性が保証されていません。常にモデルバージョンに対応するツールバージョンを使用してください。
テキストエディタツールを使用する場面
テキストエディタツールを使用する場面の例:- コードデバッグ: Claudeにコードのバグを特定・修正してもらう(構文エラーからロジックの問題まで)
- コードリファクタリング: Claudeに対象を絞った編集を通じてコード構造、可読性、パフォーマンスを改善してもらう
- ドキュメント生成: Claudeにコードベースにdocstring、コメント、READMEファイルを追加してもらう
- テスト作成: Claudeに実装の理解に基づいてコードの単体テストを作成してもらう
テキストエディタツールの使用
Messages APIを使用してテキストエディタツール(
str_replace_based_edit_toolという名前)をClaudeに提供します。大きなファイルを表示する際の切り捨てを制御するために、オプションでmax_charactersパラメータを指定できます。max_charactersはtext_editor_20250728以降のバージョンのテキストエディタツールでのみ互換性があります。1
Claudeにテキストエディタツールとユーザープロンプトを提供
- APIリクエストにテキストエディタツールを含める
- ファイルの検査や変更が必要な可能性があるユーザープロンプトを提供する(例:「コードの構文エラーを修正してもらえますか?」)
2
Claudeがツールを使用してファイルやディレクトリを検査
- Claudeは何を確認する必要があるかを評価し、
viewコマンドを使用してファイル内容を検査したり、ディレクトリ内容をリストアップしたりする - APIレスポンスには
viewコマンドを含むtool_useコンテンツブロックが含まれる
3
viewコマンドを実行して結果を返す
- Claudeのツール使用リクエストからファイルまたはディレクトリパスを抽出する
- ファイルの内容を読み取るか、ディレクトリの内容をリストアップする
- ツール設定で
max_charactersパラメータが指定されている場合は、ファイル内容をその長さまで切り捨てる tool_resultコンテンツブロックを含む新しいuserメッセージで会話を続けることで、結果をClaudeに返す
4
Claudeがツールを使用してファイルを変更
- ファイルやディレクトリを検査した後、Claudeは
str_replaceなどのコマンドを使用して変更を行ったり、insertを使用して特定の行番号にテキストを追加したりする場合がある - Claudeが
str_replaceコマンドを使用する場合、Claudeは古いテキストと置き換える新しいテキストを含む適切にフォーマットされたツール使用リクエストを構築する
5
編集を実行して結果を返す
- Claudeのツール使用リクエストからファイルパス、古いテキスト、新しいテキストを抽出する
- ファイル内でテキスト置換を実行する
- 結果をClaudeに返す
6
Claudeが分析と説明を提供
- ファイルを検査し、場合によっては編集した後、Claudeは発見したことと行った変更の完全な説明を提供する
テキストエディタツールコマンド
テキストエディタツールは、ファイルの表示と変更のためのいくつかのコマンドをサポートしています:view
viewコマンドにより、Claudeはファイルの内容を検査したり、ディレクトリの内容をリストアップしたりできます。ファイル全体または特定の行範囲を読み取ることができます。
パラメータ:
command: “view”である必要がありますpath: 表示するファイルまたはディレクトリのパスview_range(オプション): 表示する開始行番号と終了行番号を指定する2つの整数の配列。行番号は1から始まり、終了行の-1はファイルの最後まで読み取ることを意味します。このパラメータはファイルを表示する場合にのみ適用され、ディレクトリには適用されません。
viewコマンドの例
viewコマンドの例
str_replace
str_replaceコマンドにより、Claudeはファイル内の特定の文字列を新しい文字列で置き換えることができます。これは正確な編集を行うために使用されます。
パラメータ:
command: “str_replace”である必要がありますpath: 変更するファイルのパスold_str: 置き換えるテキスト(空白とインデントを含めて正確に一致する必要があります)new_str: 古いテキストの代わりに挿入する新しいテキスト
str_replaceコマンドの例
str_replaceコマンドの例
create
createコマンドにより、Claudeは指定された内容で新しいファイルを作成できます。
パラメータ:
command: “create”である必要がありますpath: 新しいファイルを作成する場所のパスfile_text: 新しいファイルに書き込む内容
createコマンドの例
createコマンドの例
insert
insertコマンドにより、Claudeはファイル内の特定の場所にテキストを挿入できます。
パラメータ:
command: “insert”である必要がありますpath: 変更するファイルのパスinsert_line: テキストを挿入する行番号(ファイルの先頭の場合は0)new_str: 挿入するテキスト
insertコマンドの例
insertコマンドの例
undo_edit
undo_editコマンドにより、Claudeはファイルに対して行われた最後の編集を元に戻すことができます。
このコマンドはClaude Sonnet 3.7とClaude Sonnet 3.5(非推奨)でのみ利用可能です。
text_editor_20250728を使用するClaude 4モデルではサポートされていません。command: “undo_edit”である必要がありますpath: 最後の編集を元に戻すファイルのパス
undo_editコマンドの例
undo_editコマンドの例
例:テキストエディタツールで構文エラーを修正
この例では、Claude 4モデルがテキストエディタツールを使用してPythonファイルの構文エラーを修正する方法を示します。まず、アプリケーションがClaudeにテキストエディタツールと構文エラー修正のプロンプトを提供します:Claudeは最初にテキストエディタツールを使用してファイルを表示します:アプリケーションはファイルを読み取り、その内容をClaudeに返す必要があります:Claudeは構文エラーを特定し、アプリケーションは編集を行い、結果を返す必要があります:最後に、Claudeは修正の完全な説明を提供します:
行番号上記の例では、
viewツールの結果に各行の前に行番号が付いたファイル内容が含まれています(例:「1: def is_prime(n):」)。行番号は必須ではありませんが、view_rangeパラメータを使用してファイルの特定のセクションを検査し、insert_lineパラメータを使用して正確な場所にコンテンツを追加するために不可欠です。str_replaceコマンドを使用して修正します:テキストエディタツールの実装
テキストエディタツールはスキーマレスツールとして実装されています。このツールを使用する際、他のツールのように入力スキーマを提供する必要はありません。スキーマはClaudeのモデルに組み込まれており、変更できません。 ツールタイプはモデルバージョンによって異なります:- Claude 4:
type: "text_editor_20250728" - Claude Sonnet 3.7:
type: "text_editor_20250124" - Claude Sonnet 3.5 (非推奨):
type: "text_editor_20241022"
1
エディタ実装の初期化
ファイルの読み取り、書き込み、変更などのファイル操作を処理するヘルパー関数を作成します。ミスから回復するためのバックアップ機能の実装を検討してください。
2
エディタツール呼び出しの処理
コマンドタイプに基づいてClaudeからのツール呼び出しを処理する関数を作成します:
3
セキュリティ対策の実装
検証とセキュリティチェックを追加します:
- ディレクトリトラバーサルを防ぐためのファイルパスの検証
- 変更前のバックアップ作成
- エラーの適切な処理
- 権限チェックの実装
4
Claudeのレスポンスの処理
Claudeのレスポンスからツール呼び出しを抽出して処理します:
テキストエディタツールを実装する際は、以下の点に留意してください:
- セキュリティ: ツールはローカルファイルシステムにアクセスできるため、適切なセキュリティ対策を実装してください。
- バックアップ: 重要なファイルの編集を許可する前に、常にバックアップを作成してください。
- 検証: 意図しない変更を防ぐため、すべての入力を検証してください。
- 一意のマッチング: 意図しない編集を避けるため、置換が正確に1箇所にマッチすることを確認してください。
エラーの処理
テキストエディタツールを使用する際、さまざまなエラーが発生する可能性があります。以下にその処理方法のガイダンスを示します:ファイルが見つからない
ファイルが見つからない
Claudeが存在しないファイルを表示または変更しようとした場合、
tool_resultで適切なエラーメッセージを返します:置換の複数マッチ
置換の複数マッチ
Claudeの
str_replaceコマンドがファイル内の複数の場所にマッチした場合、適切なエラーメッセージを返します:置換のマッチなし
置換のマッチなし
Claudeの
str_replaceコマンドがファイル内のテキストにマッチしない場合、適切なエラーメッセージを返します:権限エラー
権限エラー
ファイルの作成、読み取り、変更に権限の問題がある場合、適切なエラーメッセージを返します:
実装のベストプラクティスに従う
明確なコンテキストを提供
明確なコンテキストを提供
Claudeにコードの修正や変更を依頼する際は、どのファイルを検査する必要があるか、どの問題に対処する必要があるかを具体的に指定してください。明確なコンテキストにより、Claudeは適切なファイルを特定し、適切な変更を行うことができます。あまり役に立たないプロンプト: 「コードを修正してもらえますか?」より良いプロンプト: 「primes.pyファイルに実行を妨げる構文エラーがあります。修正してもらえますか?」
ファイルパスを明示的に指定
ファイルパスを明示的に指定
特に複数のファイルや異なるディレクトリのファイルを扱う場合は、必要に応じてファイルパスを明確に指定してください。あまり役に立たないプロンプト: 「ヘルパーファイルをレビューしてください」より良いプロンプト: 「utils/helpers.pyファイルのパフォーマンスの問題をチェックしてもらえますか?」
編集前にバックアップを作成
編集前にバックアップを作成
特に重要なファイルや本番コードについて、Claudeによる編集を許可する前にファイルのコピーを作成するバックアップシステムをアプリケーションに実装してください。
一意のテキスト置換を慎重に処理
一意のテキスト置換を慎重に処理
str_replaceコマンドは置き換えるテキストの正確なマッチを必要とします。アプリケーションは古いテキストに正確に1つのマッチがあることを確認するか、適切なエラーメッセージを提供する必要があります。変更を検証
変更を検証
Claudeがファイルに変更を加えた後、テストを実行したり、コードが期待通りに動作することを確認したりして変更を検証してください。
価格とトークン使用量
The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you’re using. In addition to the base tokens, the following additional input tokens are needed for the text editor tool:| 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 |
テキストエディタツールと他のツールの統合
テキストエディタツールは他の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が自動的にコードを文書化するワークフローを設定