How to Add Persistent Memory to Claude Code

Claude Code is powerful but forgets everything between sessions. This guide shows you how to give it persistent memory using HippoDid in under 5 minutes.

What you will get

After setup, Claude Code will be able to:

• Remember facts you share across sessions (preferences, decisions, project context)
• Recall relevant context at the start of each session
• Sync files like CLAUDE.md to cloud storage for backup and cross-device access

Prerequisites

• A HippoDid account (free tier works)
• An API key from the dashboard
• Claude Code installed

Step 1 — Connect HippoDid

The fastest way is hosted mode. Add this to your project’s .mcp.json:

{
  "hippodid": {
    "type": "http",
    "url": "https://api.hippodid.com/mcp",
    "headers": {
      "Authorization": "Bearer hd_sk_YOUR_KEY_HERE"
    }
  }
}

Replace hd_sk_YOUR_KEY_HERE with your API key.

Step 2 — Verify

Restart Claude Code and ask:

What HippoDid tools do you have?

You should see 19 tools listed, including add_memory, search_memories, and list_characters.

Step 3 — Create a character

Ask Claude Code:

Use hippodid to create a character called "my-project"

This creates a memory namespace for your project.

Step 4 — Store a memory

Use hippodid to remember: I prefer functional programming style,
immutable data structures, and Optional over null returns.

HippoDid extracts structured facts from your text and stores them with appropriate categories and salience scores.

Step 5 — Recall across sessions

Close Claude Code. Open it again tomorrow. Ask:

Use hippodid to recall: what are the coding preferences for this project?

Your preferences are back — no re-explaining needed.

What about CLAUDE.md?

If you use a CLAUDE.md file for project context, you can sync it to HippoDid cloud:

Use hippodid to sync my CLAUDE.md file

This uploads the file content to cloud storage. If you switch machines or the file is lost, you can retrieve it.

Next steps

• MCP Setup — detailed per-client configuration
• Quick Start — REST API examples
• Tiers & Limits — what is available on each plan