Alat memori

Alat memori memungkinkan Claude untuk menyimpan dan mengambil informasi di seluruh percakapan melalui direktori file memori. Claude dapat membuat, membaca, memperbarui, dan menghapus file yang bertahan di antara sesi, memungkinkannya membangun pengetahuan seiring waktu tanpa menyimpan semuanya di jendela konteks.

Alat memori beroperasi di sisi klien—Anda mengontrol di mana dan bagaimana data disimpan melalui infrastruktur Anda sendiri.

Kasus penggunaan

• Pertahankan konteks proyek di seluruh eksekusi agen yang berbeda
• Belajar dari interaksi, keputusan, dan umpan balik masa lalu
• Bangun basis pengetahuan seiring waktu
• Aktifkan pembelajaran lintas percakapan di mana Claude meningkat dalam alur kerja berulang

Cara kerjanya

Ketika diaktifkan, Claude secara otomatis memeriksa direktori memorinya sebelum memulai tugas. Claude dapat membuat, membaca, memperbarui, dan menghapus file di direktori /memories untuk menyimpan apa yang dipelajarinya saat bekerja, kemudian mereferensikan memori tersebut dalam percakapan masa depan untuk menangani tugas serupa dengan lebih efektif atau melanjutkan dari tempat ia berhenti.

Karena ini adalah alat sisi klien, Claude membuat panggilan alat untuk melakukan operasi memori, dan aplikasi Anda menjalankan operasi tersebut secara lokal. Ini memberi Anda kontrol penuh atas di mana dan bagaimana memori disimpan. Untuk keamanan, Anda harus membatasi semua operasi memori ke direktori /memories.

Contoh: Cara kerja panggilan alat memori

Ketika Anda meminta Claude untuk membantu dengan tugas, Claude secara otomatis memeriksa direktori memorinya terlebih dahulu. Berikut adalah apa yang terlihat seperti interaksi khas:

1. Permintaan pengguna:

"Bantu saya merespons tiket layanan pelanggan ini."

2. Claude memeriksa direktori memori:

"Saya akan membantu Anda merespons tiket layanan pelanggan. Biarkan saya memeriksa memori saya untuk konteks sebelumnya apa pun."

Claude memanggil alat memori:

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

3. Aplikasi Anda mengembalikan isi direktori:

{
  "type": "tool_result",
  "tool_use_id": "toolu_01C4D5E6F7G8H9I0J1K2L3M4",
  "content": "Directory: /memories\n- customer_service_guidelines.xml\n- refund_policies.xml"
}

4. Claude membaca file yang relevan:

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

5. Aplikasi Anda mengembalikan isi file:

{
  "type": "tool_result",
  "tool_use_id": "toolu_01D5E6F7G8H9I0J1K2L3M4N5",
  "content": "<guidelines>\n<addressing_customers>\n- Always address customers by their first name\n- Use empathetic language\n..."
}

6. Claude menggunakan memori untuk membantu:

"Berdasarkan panduan layanan pelanggan Anda, saya dapat membantu Anda menyusun respons. Silakan bagikan detail tiket..."

Model yang didukung

Alat memori tersedia di:

• Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
• Claude Sonnet 4 (claude-sonnet-4-20250514)
• Claude Haiku 4.5 (claude-haiku-4-5-20251001)
• Claude Opus 4.5 (claude-opus-4-5-20251101)
• Claude Opus 4.1 (claude-opus-4-1-20250805)
• Claude Opus 4 (claude-opus-4-20250514)

Memulai

Untuk menggunakan alat memori:

1. Sertakan header beta context-management-2025-06-27 dalam permintaan API Anda
2. Tambahkan alat memori ke permintaan Anda
3. Implementasikan penangan sisi klien untuk operasi memori

Penggunaan dasar

Perintah alat

Implementasi sisi klien Anda perlu menangani perintah alat memori ini:

view

Menampilkan isi direktori atau isi file dengan rentang baris opsional:

{
  "command": "view",
  "path": "/memories",
  "view_range": [1, 10]  // Opsional: lihat baris tertentu
}

create

Buat atau timpa file:

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

str_replace

Ganti teks dalam file:

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

insert

Sisipkan teks pada baris tertentu:

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

delete

Hapus file atau direktori:

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

rename

Ubah nama atau pindahkan file/direktori:

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

Panduan prompting

Kami secara otomatis menyertakan instruksi ini ke prompt sistem ketika alat memori disertakan:

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.

Jika Anda mengamati Claude membuat file memori yang berantakan, Anda dapat menyertakan instruksi ini:

Catatan: saat mengedit folder memori Anda, selalu coba simpan kontennya tetap terbaru, koheren, dan terorganisir. Anda dapat mengubah nama atau menghapus file yang tidak lagi relevan. Jangan buat file baru kecuali diperlukan.

Anda juga dapat memandu apa yang Claude tulis ke memori, misalnya, "Hanya tulis informasi yang relevan dengan <topic> dalam sistem memori Anda."

Pertimbangan keamanan

Berikut adalah kekhawatiran keamanan penting saat mengimplementasikan penyimpanan memori Anda:

Informasi sensitif

Claude biasanya akan menolak untuk menuliskan informasi sensitif dalam file memori. Namun, Anda mungkin ingin mengimplementasikan validasi yang lebih ketat yang menghilangkan informasi yang berpotensi sensitif.

Ukuran penyimpanan file

Pertimbangkan pelacakan ukuran file memori dan mencegah file tumbuh terlalu besar. Pertimbangkan menambahkan jumlah karakter maksimum yang dapat dikembalikan perintah baca memori, dan biarkan Claude membuka halaman konten.

Kedaluwarsa memori

Pertimbangkan untuk menghapus file memori secara berkala yang belum diakses dalam waktu yang lama.

Perlindungan traversal jalur

Pertimbangkan perlindungan ini:

• Validasi bahwa semua jalur dimulai dengan /memories
• Selesaikan jalur ke bentuk kanonik mereka dan verifikasi mereka tetap berada dalam direktori memori
• Tolak jalur yang berisi urutan seperti ../, ..\\, atau pola traversal lainnya
• Perhatikan urutan traversal yang dikodekan URL (%2e%2e%2f)
• Gunakan utilitas keamanan jalur bawaan bahasa Anda (misalnya, pathlib.Path.resolve() dan relative_to() Python)

Penanganan kesalahan

Alat memori menggunakan pola penanganan kesalahan yang sama dengan alat editor teks. Kesalahan umum termasuk file tidak ditemukan, kesalahan izin, dan jalur tidak valid.

Menggunakan dengan Context Editing

Alat memori dapat digabungkan dengan context editing, yang secara otomatis menghapus hasil alat lama ketika konteks percakapan tumbuh melampaui ambang yang dikonfigurasi. Kombinasi ini memungkinkan alur kerja agen jangka panjang yang sebaliknya akan melampaui batas konteks.

Cara mereka bekerja bersama

Ketika context editing diaktifkan dan percakapan Anda mendekati ambang pembersihan, Claude secara otomatis menerima notifikasi peringatan. Ini mendorong Claude untuk menyimpan informasi penting dari hasil alat ke file memori sebelum hasil tersebut dihapus dari jendela konteks.

Setelah hasil alat dihapus, Claude dapat mengambil informasi yang disimpan dari file memori kapan pun diperlukan, secara efektif memperlakukan memori sebagai perpanjangan dari konteks kerjanya. Ini memungkinkan Claude untuk:

• Melanjutkan alur kerja multi-langkah yang kompleks tanpa kehilangan informasi kritis
• Mereferensikan pekerjaan dan keputusan masa lalu bahkan setelah hasil alat dihapus
• Mempertahankan konteks yang koheren di seluruh percakapan yang akan melampaui batas konteks khas
• Membangun basis pengetahuan seiring waktu sambil menjaga jendela konteks aktif tetap dapat dikelola

Contoh alur kerja

Pertimbangkan proyek refaktorisasi kode dengan banyak operasi file:

1. Claude membuat banyak edit ke file, menghasilkan banyak hasil alat
2. Ketika konteks tumbuh dan mendekati ambang Anda, Claude menerima peringatan
3. Claude merangkum perubahan yang dibuat sejauh ini ke file memori (misalnya, /memories/refactoring_progress.xml)
4. Context editing menghapus hasil alat yang lebih lama secara otomatis
5. Claude terus bekerja, mereferensikan file memori ketika perlu mengingat perubahan apa yang sudah selesai
6. Alur kerja dapat berlanjut tanpa batas, dengan Claude mengelola konteks aktif dan memori persisten

Konfigurasi

Untuk menggunakan kedua fitur bersama:

Anda juga dapat mengecualikan panggilan alat memori dari pembersihan untuk memastikan Claude selalu memiliki akses ke operasi memori terbaru:

context_management={
    "edits": [
        {
            "type": "clear_tool_uses_20250919",
            "exclude_tools": ["memory"]
        }
    ]
}