メッセージツール

メモリツール

メモリツールのファイル操作をアプリケーションに実装することで、Claudeが会話をまたいで情報を保存・取得できるようにします。

メモリツールを使用すると、Claudeはメモリファイルのディレクトリ内で、会話をまたいで情報を保存・取得できます。Claudeはセッション間で永続するファイルを作成、読み取り、更新、削除でき、すべてをコンテキストウィンドウに保持することなく、時間をかけて知識を蓄積していきます。

メモリはジャストインタイムのコンテキスト取得をサポートします。関連するすべての情報を事前に読み込むのではなく、エージェントは学習した内容をメモリファイルに記録し、必要に応じて読み戻します。これにより、アクティブなコンテキストが現在のタスクに集中した状態に保たれます。これは、そうしなければコンテキストウィンドウを圧迫してしまう長時間実行セッションにおいて重要です。より広範なパターンについては、効果的なコンテキストエンジニアリングを参照してください。

メモリツールはクライアントサイドで動作します。Claudeがファイル操作をリクエストし、アプリケーションがそれを実行します。データの保存場所と方法は、独自のインフラストラクチャを通じて制御できます。

この機能に関するフィードバックは、フィードバックフォームからお寄せください。

「zero data retention」（ゼロデータ保持）、すなわちZDRがこの機能にどのように適用されるかについては、APIとデータ保持を参照してください。

ユースケース

複数のエージェントセッションにわたってプロジェクトのコンテキストを維持する
過去のやり取り、決定、フィードバックから得た教訓を新しいタスクに適用する
時間をかけてナレッジベースを構築する

仕組み

メモリツールが有効になっている場合、Claudeはタスクを開始する前に自動的にメモリディレクトリを確認します。作業を進めながら、Claudeは学習した内容を/memories配下のファイルに保存し、後の会話でそれらを読み戻して以前の作業を継続します。

メモリツールはクライアントサイドであるため、Claudeはメモリ操作をリクエストするだけです。アプリケーションは各リクエストを自身が制御するストレージに対して実行し、結果をtool_resultブロックで返します（ツール呼び出しの処理を参照）。/memoriesパスは、ハンドラーが実際のストレージ（ユーザーごとのディレクトリやデータベースのキーなど）にマッピングするプレフィックスです。メモリは完全にアプリケーション内に存在します。後の会話が同じtoolsエントリを送信し、ハンドラーが同じストアを提供する場合、同じメモリから継続されます。セキュリティのため、すべてのメモリ操作を/memoriesディレクトリに制限してください（パストラバーサル保護を参照）。

例：メモリツール呼び出しの動作

典型的なやり取りは次のようになります。

1. ユーザーのリクエスト：

"Help me respond to this customer service ticket."

2. Claudeがメモリディレクトリを確認：

"I'll help you respond to the customer service ticket. Let me check my memory for any previous context."

Claudeがメモリツールを呼び出します：

{
  "type": "tool_use",
  "id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "name": "memory",
  "input": {
    "command": "view",
    "path": "/memories"
  }
}

3. アプリケーションがディレクトリの内容を返す：

{
  "type": "tool_result",
  "tool_use_id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "content": "Here're the files and directories up to 2 levels deep in /memories, excluding hidden items and node_modules:\n4.0K\t/memories\n1.5K\t/memories/customer_service_guidelines.xml\n2.0K\t/memories/refund_policies.xml"
}

4. Claudeが関連ファイルを読み取る：

{
  "type": "tool_use",
  "id": "toolu_01D5E6F7G8H9I0J1K2L3M4N5",
  "name": "memory",
  "input": {
    "command": "view",
    "path": "/memories/customer_service_guidelines.xml"
  }
}

5. アプリケーションがファイルの内容を返す：

{
  "type": "tool_result",
  "tool_use_id": "toolu_01D5E6F7G8H9I0J1K2L3M4N5",
  "content": "Here's the content of /memories/customer_service_guidelines.xml with line numbers:\n     1\t<guidelines>\n     2\t<addressing_customers>\n     3\t- Always address customers by their first name\n     4\t- Use empathetic language\n..."
}

6. Claudeがメモリを使って支援する：

"Based on your customer service guidelines, I can help you craft a response. Please share the ticket details..."

メモリツールは、Claude 4以降のすべてのモデルで利用できます。Anthropicが提供するツールの完全なリストについては、ツールリファレンスを参照してください。

はじめに

メモリツールはMessages APIで一般提供されており、ベータヘッダーは不要です。使用には2つのステップがあります。

リクエストにメモリツールを追加します。toolsエントリ{"type": "memory_20250818", "name": "memory"}が設定のすべてです。nameはmemoryである必要があり、Anthropicが提供するツールに対して入力スキーマを定義する必要はありません。
各メモリコマンドに対するクライアントサイドのハンドラーを実装します。ハンドラーは/memoriesの外側のパスを拒否する必要があるため、実装前にパストラバーサル保護をお読みください。

基本的な使い方

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=2048,
    messages=[
        {
            "role": "user",
            "content": "Help me respond to this customer service ticket.",
        }
    ],
    tools=[{"type": "memory_20250818", "name": "memory"}],
)

print(message)

メモリハンドラーの実装

前述のようなリクエストに対するClaudeの応答は、view /memoriesなどのメモリ操作をリクエストするtool_useブロックで終わります。アプリケーションはその操作を実行し、結果をtool_resultブロックで返してから、Claudeが続行できるように会話を送り返します。これは標準的なツール使用ループです。

4つのSDKは、ツールインターフェースとループを処理するメモリツールヘルパーを提供しています。BetaAbstractMemoryToolをサブクラス化する（PythonおよびC#）、betaMemoryToolを使用する（TypeScript）、またはBetaMemoryToolHandlerを実装する（Java）ことで、ディスク上のファイル、データベース、クラウドストレージ、暗号化ファイルなど、独自のストレージでメモリをバックアップできます。PythonとTypeScriptには、すぐに使えるローカルファイルシステム実装BetaLocalFilesystemMemoryToolも付属しています。メモリツール自体は一般提供されていますが、ヘルパーとツールランナーのインターフェースは各SDKのベータ名前空間にあります。GoとRubyのSDKにはメモリヘルパーがないため、これらの例ではツール使用ループを自前で実行し、PHPはハンドラークロージャを汎用のBetaRunnableToolでラップします。3つとも、独自のストレージに置き換えるべきインメモリストアを使用しています。

import anthropic
from anthropic.tools import BetaLocalFilesystemMemoryTool

client = anthropic.Anthropic()
memory = BetaLocalFilesystemMemoryTool(base_path="./memory")

runner = client.beta.messages.tool_runner(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Remember that customer Acme Corp prefers email follow-ups.",
        }
    ],
    tools=[memory],
)

final_message = runner.until_done()
print(final_message.content)

Go、PHP、Rubyの例のインメモリストアは、例を自己完結型に保つためのものです。それぞれtool_useブロックのinputにあるcommandフィールドでディスパッチし、ツールコマンドで説明されている文字列を返します。本番用のハンドラーには、これらのデモ用ストアが省略しているパス検証も必要です。SDK自体の完全な例については、以下を参照してください。

Python: examples/memory/basic.py
TypeScript: examples/tools-helpers-memory.ts
C#: MemoryToolExample
Java: BetaMemoryToolExample.java

ツールコマンド

クライアントサイドの実装では、以下のコマンドを処理する必要があります。これらの仕様は推奨される動作と戻り文字列を説明しています。Claudeはツール結果に含まれるテキストをそのまま読み取るため、アプリケーションの必要に応じて異なる文字列を返すこともできます。

view

ディレクトリの内容、またはオプションの行範囲を指定したファイルの内容を表示します：

{
  "command": "view",
  "path": "/memories/notes.txt",
  "view_range": [1, 10]
}

view_rangeはオプションで、テキストファイルの表示に適用されます。[start_line, end_line]はその範囲の行を返し、[start_line, -1]はstart_lineからファイルの末尾までのすべてを返します。

戻り値

ディレクトリの場合： ファイルとディレクトリをサイズとともに示すリストを返します：

Here're the files and directories up to 2 levels deep in {path}, excluding hidden items and node_modules:
{size}\t{path}
{size}\t{path}/{filename1}
{size}\t{path}/{filename2}

最大2階層までのファイルをリストします
人間が読みやすいサイズを表示します（例：5.5K、1.2M）
隠しアイテム（.で始まるファイル）とnode_modulesを除外します
サイズとパスの間にタブ文字を使用します

空のストアに対する最初の/memoriesのviewはエラーではありません。SDKのローカルファイルシステムメモリツール（BetaLocalFilesystemMemoryTool）は、Claudeの最初の呼び出しの前にメモリルートを作成し、リストのヘッダーに続いて、空のディレクトリ自体のサイズとパスの1行を返します。

ファイルの場合： ヘッダーと行番号付きでファイルの内容を返します：

Here's the content of {path} with line numbers:
{line_numbers}{tab}{content}

行番号のフォーマット：

幅： 6文字、スペースパディングで右揃え
区切り文字： 行番号と内容の間はタブ文字
インデックス： 1始まり（最初の行が1行目）
行数制限： 999,999行を超えるファイルはエラーを返す必要があります："File {path} exceeds maximum line limit of 999,999 lines."

出力例：

Here's the content of /memories/notes.txt with line numbers:
     1	Hello World
     2	This is line two
    10	Line ten
   100	Line one hundred

Claudeのツール説明には、viewが画像ファイル（.jpg、.jpeg、.png）を表示し、16,000文字を超えるファイルのテキスト表示を切り詰めることも記載されています。画像パスに対するview呼び出しや、長いファイルに対する範囲指定のフォローアップ表示を想定してください。

エラー処理

ファイルまたはディレクトリが存在しない： "The path {path} does not exist. Please provide a valid path."

create

新しいファイルを作成します：

{
  "command": "create",
  "path": "/memories/notes.txt",
  "file_text": "Meeting notes:\n- Discussed project timeline\n- Next steps defined\n"
}

戻り値

成功： "File created successfully at: {path}"

エラー処理

ファイルがすでに存在する： "Error: File {path} already exists"

Claudeのツール説明には、createはファイルを「作成または上書きする」と記載されているため、すでに存在するパスに対するcreate呼び出しを想定してください。エラーを返すのがリファレンス動作ですが、代わりに上書きするのも有効な実装の選択肢です。

str_replace

ファイル内のテキストを置換します：

{
  "command": "str_replace",
  "path": "/memories/preferences.txt",
  "old_str": "Favorite color: blue",
  "new_str": "Favorite color: green"
}

str_replaceではnew_strはオプションです。省略された場合、old_strは置換なしで削除されます。

戻り値

成功： "The memory file has been edited."に続いて、行番号付きの編集済みファイルのスニペット

エラー処理

ファイルが存在しない： "Error: The path {path} does not exist. Please provide a valid path."
テキストが見つからない： "No replacement was performed, old_str `\{old_str}` did not appear verbatim in {path}."
テキストの重複： old_strが複数回出現する場合は次を返します："No replacement was performed. Multiple occurrences of old_str `\{old_str}` in lines: {line_numbers}. Please ensure it is unique"

ディレクトリの処理

パスがディレクトリの場合は、「ファイルが存在しない」エラーを返します。

insert

特定の行にテキストを挿入します：

{
  "command": "insert",
  "path": "/memories/todo.txt",
  "insert_line": 2,
  "insert_text": "- Review memory tool documentation\n"
}

insert_textはinsert_line行の後に挿入され、0はファイルの先頭に挿入します。

戻り値

成功： "The file {path} has been edited."

エラー処理

ファイルが存在しない： "Error: The path {path} does not exist"
無効な行番号： "Error: Invalid `insert_line` parameter: {insert_line}. It should be within the range of lines of the file: [0, {n_lines}]"

ディレクトリの処理

パスがディレクトリの場合は、「ファイルが存在しない」エラーを返します。

delete

ファイルまたはディレクトリを削除します：

{
  "command": "delete",
  "path": "/memories/old_file.txt"
}

戻り値

成功： "Successfully deleted {path}"

エラー処理

ファイルまたはディレクトリが存在しない： "Error: The path {path} does not exist"

ディレクトリの処理

ディレクトリとその内容をすべて再帰的に削除します。ツール説明はClaudeに/memoriesディレクトリ自体は削除できないと伝えているため、パスがメモリルートであるdeleteは拒否してください。

rename

ファイルまたはディレクトリの名前変更または移動を行います：

{
  "command": "rename",
  "old_path": "/memories/draft.txt",
  "new_path": "/memories/final.txt"
}

戻り値

成功： "Successfully renamed {old_path} to {new_path}"

エラー処理

移動元が存在しない： "Error: The path {old_path} does not exist"
移動先がすでに存在する： エラーを返します（上書きしないでください）："Error: The destination {new_path} already exists"

ディレクトリの処理

ディレクトリの名前を変更します。ツール説明はClaudeに/memoriesディレクトリ自体の名前は変更できないと伝えているため、old_pathがメモリルートであるrenameは拒否してください。

プロンプトのガイダンス

リクエストのtoolsにメモリツールが含まれている場合、APIは自動的にこの指示をシステムプロンプトに追加します。自分で送信する必要はありません：

IMPORTANT: ALWAYS VIEW YOUR MEMORY DIRECTORY BEFORE DOING ANYTHING ELSE.
MEMORY PROTOCOL:
1. Use the `view` command of your `memory` tool to check for earlier progress.
2. ... (work on the task) ...
   - As you make progress, record status / progress / thoughts etc in your memory.
ASSUME INTERRUPTION: Your context window might be reset at any moment, so you risk losing any progress that is not recorded in your memory directory.

Claudeのツール説明には、メモリディレクトリを整理された状態に保つようすでに記載されているため、その指示を繰り返す必要はありません。それでもClaudeが雑然としたメモリファイルを作成する場合は、プロンプトで補強できます：

Note: when editing your memory folder, always try to keep its content up-to-date, coherent and organized. You can rename or delete files that are no longer relevant. Do not create new files unless necessary.

Claudeがメモリに書き込む内容をガイドすることもできます。例：「メモリシステムには<topic>に関連する情報のみを書き留めてください。」

セキュリティに関する考慮事項

アプリケーションはClaudeがリクエストするすべてのファイル操作を実行するため、以下の安全対策はあなたの責任です。

機密情報

Claudeは通常、機密情報をメモリファイルに書き込むことを拒否します。より強力な保証のために、ハンドラーがファイルを書き込む前に機密データを除去する検証を追加してください。

ファイルストレージのサイズ

メモリファイルのサイズを追跡し、ファイルの最大サイズに上限を設けてください。viewコマンドが返す文字数に上限を設け、残りはview_rangeでClaudeにページングさせることも検討してください。

メモリの有効期限

長期間アクセスされていないメモリファイルを定期的に削除してください。

パストラバーサル保護

/memories/../../secrets.envのような悪意のあるパスは、/memoriesディレクトリの外側のファイルに到達する可能性があります。ディレクトリトラバーサル攻撃を防ぐため、実装ではすべてのコマンドのすべてのパスを検証する必要があります。

以下の安全対策を検討してください：

すべてのパスが/memoriesで始まることを検証する
パスを正規形に解決し、メモリディレクトリ内に留まっていることを確認する
../、..\\などのトラバーサルパターンを含むパスを拒否する
URLエンコードされたトラバーサルシーケンス（%2e%2e%2f）に注意する
使用する言語の組み込みパスセキュリティユーティリティを使用する（例：Pythonのpathlib.Path.resolve()とrelative_to()）

エラー処理

メモリツールは、テキストエディタツールと同様のエラー処理パターンを使用します。各コマンドのエラーメッセージはツールコマンドに記載されています。Claudeにエラーを返すには、ツール結果のis_errorをtrueに設定し、メッセージをcontentに入れます：

{
  "type": "tool_result",
  "tool_use_id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "content": "Error: The path /memories/notes.txt does not exist",
  "is_error": true
}

コンテキスト編集との統合

メモリツールはコンテキスト編集と組み合わせて、長時間実行される会話を管理できます。詳細については、コンテキスト編集を参照してください。

コンパクションとの併用

メモリツールは、古い会話コンテキストをサーバーサイドで要約するコンパクションと組み合わせることもできます。コンテキスト編集はクライアント側で特定のツール結果をクリアします。コンパクションは、会話がコンテキストウィンドウの制限に近づいたときに、サーバー上で会話全体を自動的に要約します。

長時間実行されるエージェントでは、両方の使用を検討してください。コンパクションはクライアントサイドの管理なしでアクティブなコンテキストを小さく保ち、メモリは要約後も残す必要がある情報を保持します。

マルチセッションソフトウェア開発パターン

複数のエージェントセッションにまたがるソフトウェアプロジェクトでは、作業の進行に合わせて場当たり的に書くのではなく、メモリファイルを意図的にセットアップしてください。以下のパターンは、メモリを復旧メカニズムに変えます。各新しいセッションは、前のセッションが記録した状態から再開します。

パターンの仕組み

初期化セッション： 最初のセッションは、実質的な作業を開始する前にメモリファイルをセットアップします。これには、進捗ログ（完了したことと次に行うことの追跡）、機能チェックリスト（作業範囲の定義）、プロジェクトに必要な起動または初期化スクリプトへの参照が含まれます。
後続のセッション： 各新しいセッションは、これらのメモリファイルを読み取ることから始まります。これにより、コードベースを再探索したり、以前の決定をたどり直したりすることなく、プロジェクトの状態が復元されます。
セッション終了時の更新： セッションが終了する前に、完了したことと残っていることで進捗ログを更新します。これにより、次のセッションが正確な開始点を持つことが保証されます。

重要な原則

一度に1つの機能に取り組んでください。機能を完了とマークするのは、コードが書かれたときではなく、エンドツーエンドの検証で動作が確認された後だけにしてください。これにより、セッション間で進捗ログの正確性が保たれます。

初期化スクリプト、進捗ファイルの構造、gitベースの復旧を含む、このパターンの実践的な詳細なケーススタディについては、長時間実行エージェントのための効果的なハーネスを参照してください。

次のステップ

Bashツール

永続的なbashセッションでシェルコマンドを実行します。

コンテキスト編集

コンテキスト編集により、会話コンテキストの増大を自動的に管理します。

コンパクション

コンテキストウィンドウの制限に近づく長い会話を管理するためのサーバーサイドのコンテキストコンパクション。

ツールリファレンス

Anthropicが提供するツールの一覧と、オプションのツール定義プロパティのリファレンス。

Was this page helpful?

メッセージツール

メモリツール

メモリツールのファイル操作をアプリケーションに実装することで、Claudeが会話をまたいで情報を保存・取得できるようにします。

この機能に関するフィードバックは、フィードバックフォームからお寄せください。

「zero data retention」（ゼロデータ保持）、すなわちZDRがこの機能にどのように適用されるかについては、APIとデータ保持を参照してください。

ユースケース

複数のエージェントセッションにわたってプロジェクトのコンテキストを維持する
過去のやり取り、決定、フィードバックから得た教訓を新しいタスクに適用する
時間をかけてナレッジベースを構築する

仕組み

例：メモリツール呼び出しの動作

典型的なやり取りは次のようになります。

1. ユーザーのリクエスト：

"Help me respond to this customer service ticket."

2. Claudeがメモリディレクトリを確認：

"I'll help you respond to the customer service ticket. Let me check my memory for any previous context."

Claudeがメモリツールを呼び出します：

{
  "type": "tool_use",
  "id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "name": "memory",
  "input": {
    "command": "view",
    "path": "/memories"
  }
}

3. アプリケーションがディレクトリの内容を返す：

{
  "type": "tool_result",
  "tool_use_id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "content": "Here're the files and directories up to 2 levels deep in /memories, excluding hidden items and node_modules:\n4.0K\t/memories\n1.5K\t/memories/customer_service_guidelines.xml\n2.0K\t/memories/refund_policies.xml"
}

4. Claudeが関連ファイルを読み取る：

{
  "type": "tool_use",
  "id": "toolu_01D5E6F7G8H9I0J1K2L3M4N5",
  "name": "memory",
  "input": {
    "command": "view",
    "path": "/memories/customer_service_guidelines.xml"
  }
}

5. アプリケーションがファイルの内容を返す：

{
  "type": "tool_result",
  "tool_use_id": "toolu_01D5E6F7G8H9I0J1K2L3M4N5",
  "content": "Here's the content of /memories/customer_service_guidelines.xml with line numbers:\n     1\t<guidelines>\n     2\t<addressing_customers>\n     3\t- Always address customers by their first name\n     4\t- Use empathetic language\n..."
}

6. Claudeがメモリを使って支援する：

"Based on your customer service guidelines, I can help you craft a response. Please share the ticket details..."

はじめに

メモリツールはMessages APIで一般提供されており、ベータヘッダーは不要です。使用には2つのステップがあります。

リクエストにメモリツールを追加します。toolsエントリ{"type": "memory_20250818", "name": "memory"}が設定のすべてです。nameはmemoryである必要があり、Anthropicが提供するツールに対して入力スキーマを定義する必要はありません。
各メモリコマンドに対するクライアントサイドのハンドラーを実装します。ハンドラーは/memoriesの外側のパスを拒否する必要があるため、実装前にパストラバーサル保護をお読みください。

基本的な使い方

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=2048,
    messages=[
        {
            "role": "user",
            "content": "Help me respond to this customer service ticket.",
        }
    ],
    tools=[{"type": "memory_20250818", "name": "memory"}],
)

print(message)

メモリハンドラーの実装

import anthropic
from anthropic.tools import BetaLocalFilesystemMemoryTool

client = anthropic.Anthropic()
memory = BetaLocalFilesystemMemoryTool(base_path="./memory")

runner = client.beta.messages.tool_runner(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Remember that customer Acme Corp prefers email follow-ups.",
        }
    ],
    tools=[memory],
)

final_message = runner.until_done()
print(final_message.content)

Python: examples/memory/basic.py
TypeScript: examples/tools-helpers-memory.ts
C#: MemoryToolExample
Java: BetaMemoryToolExample.java

ツールコマンド

view

ディレクトリの内容、またはオプションの行範囲を指定したファイルの内容を表示します：

{
  "command": "view",
  "path": "/memories/notes.txt",
  "view_range": [1, 10]
}

戻り値

ディレクトリの場合： ファイルとディレクトリをサイズとともに示すリストを返します：

Here're the files and directories up to 2 levels deep in {path}, excluding hidden items and node_modules:
{size}\t{path}
{size}\t{path}/{filename1}
{size}\t{path}/{filename2}

最大2階層までのファイルをリストします
人間が読みやすいサイズを表示します（例：5.5K、1.2M）
隠しアイテム（.で始まるファイル）とnode_modulesを除外します
サイズとパスの間にタブ文字を使用します

ファイルの場合： ヘッダーと行番号付きでファイルの内容を返します：

Here's the content of {path} with line numbers:
{line_numbers}{tab}{content}

行番号のフォーマット：

幅： 6文字、スペースパディングで右揃え
区切り文字： 行番号と内容の間はタブ文字
インデックス： 1始まり（最初の行が1行目）
行数制限： 999,999行を超えるファイルはエラーを返す必要があります："File {path} exceeds maximum line limit of 999,999 lines."

出力例：

Here's the content of /memories/notes.txt with line numbers:
     1	Hello World
     2	This is line two
    10	Line ten
   100	Line one hundred

エラー処理

ファイルまたはディレクトリが存在しない： "The path {path} does not exist. Please provide a valid path."

create

新しいファイルを作成します：

{
  "command": "create",
  "path": "/memories/notes.txt",
  "file_text": "Meeting notes:\n- Discussed project timeline\n- Next steps defined\n"
}

戻り値

成功： "File created successfully at: {path}"

エラー処理

ファイルがすでに存在する： "Error: File {path} already exists"

str_replace

ファイル内のテキストを置換します：

{
  "command": "str_replace",
  "path": "/memories/preferences.txt",
  "old_str": "Favorite color: blue",
  "new_str": "Favorite color: green"
}

str_replaceではnew_strはオプションです。省略された場合、old_strは置換なしで削除されます。

戻り値

成功： "The memory file has been edited."に続いて、行番号付きの編集済みファイルのスニペット

エラー処理

ファイルが存在しない： "Error: The path {path} does not exist. Please provide a valid path."
テキストが見つからない： "No replacement was performed, old_str `\{old_str}` did not appear verbatim in {path}."
テキストの重複： old_strが複数回出現する場合は次を返します："No replacement was performed. Multiple occurrences of old_str `\{old_str}` in lines: {line_numbers}. Please ensure it is unique"

ディレクトリの処理

パスがディレクトリの場合は、「ファイルが存在しない」エラーを返します。

insert

特定の行にテキストを挿入します：

{
  "command": "insert",
  "path": "/memories/todo.txt",
  "insert_line": 2,
  "insert_text": "- Review memory tool documentation\n"
}

insert_textはinsert_line行の後に挿入され、0はファイルの先頭に挿入します。

戻り値

成功： "The file {path} has been edited."

エラー処理

ファイルが存在しない： "Error: The path {path} does not exist"
無効な行番号： "Error: Invalid `insert_line` parameter: {insert_line}. It should be within the range of lines of the file: [0, {n_lines}]"

ディレクトリの処理

パスがディレクトリの場合は、「ファイルが存在しない」エラーを返します。

delete

ファイルまたはディレクトリを削除します：

{
  "command": "delete",
  "path": "/memories/old_file.txt"
}

戻り値

成功： "Successfully deleted {path}"

エラー処理

ファイルまたはディレクトリが存在しない： "Error: The path {path} does not exist"

ディレクトリの処理

rename

ファイルまたはディレクトリの名前変更または移動を行います：

{
  "command": "rename",
  "old_path": "/memories/draft.txt",
  "new_path": "/memories/final.txt"
}

戻り値

成功： "Successfully renamed {old_path} to {new_path}"

エラー処理

移動元が存在しない： "Error: The path {old_path} does not exist"
移動先がすでに存在する： エラーを返します（上書きしないでください）："Error: The destination {new_path} already exists"

ディレクトリの処理

プロンプトのガイダンス

IMPORTANT: ALWAYS VIEW YOUR MEMORY DIRECTORY BEFORE DOING ANYTHING ELSE.
MEMORY PROTOCOL:
1. Use the `view` command of your `memory` tool to check for earlier progress.
2. ... (work on the task) ...
   - As you make progress, record status / progress / thoughts etc in your memory.
ASSUME INTERRUPTION: Your context window might be reset at any moment, so you risk losing any progress that is not recorded in your memory directory.

Note: when editing your memory folder, always try to keep its content up-to-date, coherent and organized. You can rename or delete files that are no longer relevant. Do not create new files unless necessary.

Claudeがメモリに書き込む内容をガイドすることもできます。例：「メモリシステムには<topic>に関連する情報のみを書き留めてください。」

セキュリティに関する考慮事項

アプリケーションはClaudeがリクエストするすべてのファイル操作を実行するため、以下の安全対策はあなたの責任です。

機密情報

ファイルストレージのサイズ

メモリの有効期限

長期間アクセスされていないメモリファイルを定期的に削除してください。

パストラバーサル保護

以下の安全対策を検討してください：

すべてのパスが/memoriesで始まることを検証する
パスを正規形に解決し、メモリディレクトリ内に留まっていることを確認する
../、..\\などのトラバーサルパターンを含むパスを拒否する
URLエンコードされたトラバーサルシーケンス（%2e%2e%2f）に注意する
使用する言語の組み込みパスセキュリティユーティリティを使用する（例：Pythonのpathlib.Path.resolve()とrelative_to()）

エラー処理

{
  "type": "tool_result",
  "tool_use_id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "content": "Error: The path /memories/notes.txt does not exist",
  "is_error": true
}

コンテキスト編集との統合

コンパクションとの併用

マルチセッションソフトウェア開発パターン

パターンの仕組み

初期化セッション： 最初のセッションは、実質的な作業を開始する前にメモリファイルをセットアップします。これには、進捗ログ（完了したことと次に行うことの追跡）、機能チェックリスト（作業範囲の定義）、プロジェクトに必要な起動または初期化スクリプトへの参照が含まれます。
後続のセッション： 各新しいセッションは、これらのメモリファイルを読み取ることから始まります。これにより、コードベースを再探索したり、以前の決定をたどり直したりすることなく、プロジェクトの状態が復元されます。
セッション終了時の更新： セッションが終了する前に、完了したことと残っていることで進捗ログを更新します。これにより、次のセッションが正確な開始点を持つことが保証されます。

重要な原則

次のステップ

Bashツール

永続的なbashセッションでシェルコマンドを実行します。

コンテキスト編集

コンテキスト編集により、会話コンテキストの増大を自動的に管理します。

コンパクション

コンテキストウィンドウの制限に近づく長い会話を管理するためのサーバーサイドのコンテキストコンパクション。

ツールリファレンス

Anthropicが提供するツールの一覧と、オプションのツール定義プロパティのリファレンス。

Was this page helpful?

ユースケース

仕組み

例：メモリツール呼び出しの動作

はじめに

基本的な使い方

メモリハンドラーの実装

ツールコマンド

view

戻り値

エラー処理

create

戻り値

エラー処理

str_replace

戻り値

エラー処理

ディレクトリの処理

insert

戻り値

エラー処理

ディレクトリの処理

delete

戻り値

エラー処理

ディレクトリの処理

rename

戻り値

エラー処理

ディレクトリの処理

プロンプトのガイダンス

セキュリティに関する考慮事項

機密情報

ファイルストレージのサイズ

メモリの有効期限

パストラバーサル保護

エラー処理

コンテキスト編集との統合

コンパクションとの併用

マルチセッションソフトウェア開発パターン

パターンの仕組み

重要な原則

次のステップ

ユースケース

仕組み

例：メモリツール呼び出しの動作

はじめに

基本的な使い方

メモリハンドラーの実装

ツールコマンド

view

戻り値

エラー処理

create

戻り値

エラー処理

str_replace

戻り値

エラー処理

ディレクトリの処理

insert

戻り値

エラー処理

ディレクトリの処理

delete

戻り値

エラー処理

ディレクトリの処理

rename

戻り値

エラー処理

ディレクトリの処理

プロンプトのガイダンス

セキュリティに関する考慮事項

機密情報

ファイルストレージのサイズ

メモリの有効期限

パストラバーサル保護

エラー処理

コンテキスト編集との統合

コンパクションとの併用

ユースケース

仕組み

例：メモリツール呼び出しの動作

はじめに

基本的な使い方

メモリハンドラーの実装

ツールコマンド

view

戻り値

エラー処理

create

戻り値

エラー処理

str_replace

戻り値

エラー処理

ディレクトリの処理

insert

戻り値

エラー処理

ディレクトリの処理

delete

戻り値

エラー処理

ディレクトリの処理

rename

戻り値

エラー処理

ディレクトリの処理

プロンプトのガイダンス

セキュリティに関する考慮事項

機密情報

ファイルストレージのサイズ

メモリの有効期限

パストラバーサル保護

エラー処理

コンテキスト編集との統合

コンパクションとの併用

マルチセッションソフトウェア開発パターン

パターンの仕組み

重要な原則

次のステップ

ユースケース

仕組み

例：メモリツール呼び出しの動作

はじめに

基本的な使い方

メモリハンドラーの実装

ツールコマンド

view

戻り値

エラー処理

create

戻り値

エラー処理

str_replace

戻り値

エラー処理

ディレクトリの処理

insert

戻り値

エラー処理

ディレクトリの処理

delete

戻り値

エラー処理

ディレクトリの処理

rename

戻り値

エラー処理

ディレクトリの処理

プロンプトのガイダンス

セキュリティに関する考慮事項

機密情報

ファイルストレージのサイズ

メモリの有効期限

パストラバーサル保護

エラー処理

コンテキスト編集との統合

コンパクションとの併用