使用文档/Web 与局域网

使用说明 · 2.2.0 正式版

桌面 Agent 迁移

让 Claude Code、Codex 直接写入记忆与提示词

读取 Markdown
本页目录

它是什么#

如果你习惯在电脑上用 Claude Code、Codex 等桌面 agent,它们积累的记忆和自定义指令(如 CLAUDE.md、AGENTS.md)可以由 agent 自己迁移进 Cube Agent:agent 通过 Web 服务器的接口读取接入说明,再直接写入全局记忆、助手记忆和系统提示词。不需要复制粘贴,也不需要在网页聊天里让它代为输入,Markdown 格式原样保留。

怎么使用#

  1. 打开 设置 → 连接与高级 → Web 服务器 并启动服务。电脑与手机不在同一设备时,关闭「仅本机访问」,并设置访问密码、开启「访问需要密码」。
  2. 点访问地址下方的 复制桌面 Agent 迁移指令。
  3. 把指令粘贴给电脑上的 agent。它会先读取 /api/agent/guide 了解规则,需要密码时会向你索取。
  4. agent 列出准备写入的内容后,确认无误再让它执行。完成后可在记忆管理页和系统提示词页查看结果。

会写到哪里#

  • 记忆:适合长期有效的个人信息和偏好,按「一条一个事实」写入。默认写入全局记忆,也可以指定某个助手;助手需开启记忆(使用全局记忆时还要开启「使用全局记忆」)才会生效。
  • 系统提示词:适合行为规则、回答风格等指令,可写入全局系统提示词或某个助手的提示词,标题、列表和代码块保持原样。

规则与限制#

  • 记忆只追加并自动去重,重复执行不会产生重复条目;删除的记忆进入回收站,可以恢复。
  • 接口不提供整体替换或批量删除。需要合并精简时,请在 App 内用「智能整理」,可先预览再保存。
  • 批量写入记忆与 App 内批量导入一样是 Pro 功能;读取记忆、单条修改或删除,以及系统提示词的读写不限。
  • 写入系统提示词会覆盖原内容,迁移指令已要求 agent 写入前先向你确认。
  • 隐私助手需先在 App 内解锁,否则无法读取或修改它的记忆与提示词。

最佳实践#

  • 让 agent 把个人事实写进记忆、把工作规则写进系统提示词,不要把长篇规则拆成记忆。
  • 不在电脑上用 agent 时,也可以在系统提示词页和记忆导入页点 从文件导入,直接读取 .md / .txt 文件。
  • 迁移完成后可以修改访问密码,旧令牌会立即失效。