OpenViking接入Claude Code：让编码Agent拥有持久记忆的完整教程

OpenViking接入Claude Code让编码Agent拥有持久记忆的完整教程【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenVikingOpenViking 是一个面向 AI Agent 的自进化上下文数据库Self-evolving Context Database统一了 Agent 记忆、知识 RAG 与技能管理。本教程带你用一条命令为 Claude Code 装上持久记忆跨项目、跨会话自动召回相关记忆并捕获新内容全程无需模型主动调用任何工具。为什么编码 Agent 需要持久记忆上面的场景你一定很熟悉让 AI 助手按之前的风格把看板做完结果它回答非常抱歉我没有保留上一次对话的内容。这就是没有记忆系统时 Coding Agent 的普遍痛点上下文随会话消失关掉终端之前讨论过的架构决策、命名约定、审美偏好全部丢失内置记忆有容量天花板Claude Code 自带的MEMORY.md是扁平 markdown 文件约 200 行就要靠手动维护且只能整体塞进上下文无法跨项目复用经验在 A 项目里踩过的坑、定下的规范到 B 项目里又要重新教一遍OpenViking 的思路是把记忆从文件升级为数据库服务端做向量化存储 LLM 驱动的实体/偏好/事件抽取客户端每轮对话自动检索相关记忆注入上下文、自动回写新内容。多个 Agent需求拆解、代码生成、审查可以共享同一份 MEMORY 记忆体形成闭环插件工作原理挂载到 Claude Code 的生命周期节点官方记忆插件源码位于examples/claude-code-memory-plugin通过 hooks 挂载到 Claude Code 的多个生命周期节点实现无感记忆生命周期节点插件行为每次用户输入前检索 OpenViking在 token 预算内注入相关记忆块每轮回复结束后自动捕获并异步存储新对话内容会话启动时注入用户画像与记忆索引上下文压缩 / 会话结束时提交所有待归档的消息记录启动子代理时为子 Agent 分配相互隔离的记忆会话记忆在服务端组织成语义化的层级树——偏好、事件、实体各有相关度打分召回时按需展开所有写入操作都是异步的不会阻塞对话注入的记忆块在回写前会被自动剥离避免记忆自污染。一键安装步骤3 分钟搞定1. 运行安装脚本Claude Code 与 Codex 共用同一个安装脚本它会依次询问界面语言、要安装的 harness、下载源和 OpenViking 凭据所有步骤幂等重复执行安全bash (curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) --harness claude脚本会自动完成三件事写入~/.openviking/ovcli.conf连接配置、从远程 marketplace 安装openviking-memory插件、注册状态栏。若你已在云端或远程部署了 OpenViking 服务把 API Key 贴进向导即可纯本地模式http://127.0.0.1:1933无鉴权可直接跳过配置。提示也可以先 clone 仓库https://gitcode.com/GitHub_Trending/op/OpenViking后在仓库根目录执行claude plugin marketplace add $(pwd)/examples注册本地 marketplace——开发场景下这样改 hook 脚本下次触发即生效无需重装。2. 启动并验证claude重启后输入以下命令即可确认接入成功/plugins→ Installed 列表中出现openviking-memory子项openvikingMCP 显示已连接/mcp→ 显示你的服务器 URL 与有效认证信息/openviking-memory:ov→ 查看服务健康、召回/注入统计装好之后即便在全新会话里随口提起几周前的话题Claude Code 也能准确想起来。你在多轮里随口说的背景要深色科技感、列表左右分栏这类偏好都会被抽取进记忆体下次直接命中状态栏与常用配置插件会在输入框下方渲染一行状态栏一眼掌握记忆工作状况OV ✓ │ ↩ 6 mem · 50ms表示刚注入 6 条记忆、耗时 50msOV ✗ offline则表示服务器不可达。最常用的一批环境变量完整清单见examples/claude-code-memory-plugin/README_CN.md环境变量默认值作用OPENVIKING_AUTO_RECALLtrue每次输入前自动召回记忆OPENVIKING_AUTO_CAPTUREtrue每轮结束后自动捕获新记忆OPENVIKING_BYPASS_SESSIONfalse设为1一次性跳过当前会话的全部 hooksOPENVIKING_DEBUGfalse设为1输出调试日志到~/.openviking/logs/cc-hooks.log多租户场景再补上OPENVIKING_ACCOUNT和OPENVIKING_USER即可实现团队内按人隔离的记忆空间。故障排查清单现象修复方法插件未激活重跑安装脚本或检查~/.openviking/ovcli.conf是否存在召回为空执行curl http://localhost:1933/health检查服务器连通性MCP 连到 127.0.0.1 而非远程修正ovcli.conf中的url字段后重启 Claude Code401 / 403 认证失败核对 API Key多租户还需确认 account / user 配置总结用一句话回顾OpenViking 记忆插件 一条安装命令 零模型改动的持久记忆。它把 Agent 记忆从手动维护的 markdown 文件升级为服务端向量数据库 自动抽取与 Claude Code 内置MEMORY.md互补共存。核心模块都在examples/claude-code-memory-plugin/目录下hooks、MCP 代理、配置脚本结构清晰非常适合想深入定制召回策略的读者阅读。现在就把你的编码 Agent 的记忆升级起来吧 【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考