让您的 Agent 快速拥有长期记忆

第一步：准备服务与连接信息

先在控制台开通 Context0 实例，或使用团队已部署的服务。还没有实例时，按快速入门完成开通与API Key创建。

将 API Key 放入环境变量 CTXDB0_API_KEY。下面以 Claude Code 为例，替换地址和用户标识后执行一次即可。

第二步：安装并连接到现有 Agent

# 安装 ctxdb0 CLI（要求 Node.js ≥ 22）
npm install -g @polardbx/ctxdb0

# 通过 stdin 传入 API Key，建立连接 profile（替换 endpoint 与 user-id）
printf '%s' "$CTXDB0_API_KEY" | ctxdb0 connect \
  --profile default \
  --endpoint 'http://您的实例域名' \
  --user-id 'your-user-id' \
  --api-key-stdin --json

# 把插件挂载到 Claude Code（其他 Agent 替换 --host 值即可）
ctxdb0 attach --host claude --json
# 运行诊断，确认连接正常、Host 已激活
ctxdb0 doctor --host claude --json

• 远程服务使用HTTP地址，本机开发可使用 http://localhost:4040。

• attach 安装 Hook 和内置 Skill。按 doctor 提示完成 Host 激活或信任步骤，再开启一个新会话，就可以开始正常使用。其他 Agent 只需替换 --host，见下方支持表。

• 这些命令用于一次性接入。接入后，日常记忆读写交给 Agent，不需要您反复执行命令。

第三步：正常对话，开始积累记忆

1. 首次写入项目约定：

   您：这个项目统一使用 Vitest，测试放在 __tests__ 目录，以后按这个约定来。
   Agent：好的，后续会按这个测试约定开发。

   回合结束后，本轮对话自动提交到 Context0，后台异步提炼。处理完成后，可尝试跨会话召回记忆。

2. 跨会话召回已存储的记忆：

   您：按我们之前的测试约定，帮我给订单模块加单元测试。
   Agent：查到之前的约定是 Vitest，测试放在 __tests__ 目录。
          我会按这个结构补充订单模块的测试。

   这就是日常使用方式。无需手动搜索、复制记忆或拼接提示词。如果是刚刚写入的新内容，给后台留出处理时间即可。

技术选型跨会话延续

两次会话之间的技术栈约定自动延续，无需重新粘贴。

[第一次讨论]
您：这个项目用 TypeScript + Prisma，接口放在 /app/api 下。
Agent：了解，后续按这个技术栈和目录约定开发。

[几天后的新会话]
您：按项目之前的技术约定，加一个用户查询接口。
Agent：之前确定的是 TypeScript + Prisma，接口放在 /app/api 下。
       我会在那里添加查询接口，并使用 Prisma 读取用户数据。

您不需要重新粘贴之前的对话，Agent 根据任务使用已有记忆。

代码风格持续生效

编码风格写入后，后续会话自动沿用。

您：组件统一使用函数组件和 Hooks，不用 class 组件。
Agent：好的，后续遵循这个风格。

[后续会话]
您：按之前的组件风格，新建一个 UserProfile 页面。
Agent：我会使用函数组件和 Hooks，并沿用项目已有组件结构。

找回历史决定

Agent 检索历史记忆，返回之前讨论的具体方案和细节。

您：之前我们怎么处理鉴权的来着？
Agent：之前确定了 JWT + HttpOnly Cookie 方案：
       access token 15 分钟过期，refresh token 7 天，
       刷新入口是 /api/auth/refresh。

内置 Skill 会帮助 Agent 检索有关鉴权的历史记忆，再结合命中内容回答。

约定发生变化

当项目约定需要变更时，用自然语言通知 Agent 更新记忆。

您：现在发布先做 5% 灰度，替换之前 10% 的约定，请更新记忆。
Agent：我会找到原来的发布约定，将灰度比例更新为 5%。

需要主动管理时，也可以直接用自然语言要求 Agent 查找、补充或修订记忆。