从其他客户端导入
从本机已装的 Claude Code、Qoder、Codex 导入会话、技能、MCP 与项目目录;哪些内容目前不导。
如果你之前用其他智能体客户端,Klaus 能探测本机已装的那几家,把可核实格式的内容导过来(「设置 → 导入」)。导入是复制,不会改动原客户端的数据。
- 探测三家:Claude Code、Qoder、Codex。探测靠它们在本机的固定目录,没装的就不会出现。页面上只列「已核实格式」的来源——格式没核实过的客户端不会出现在列表里,而不是导到一半失败。
- 能导四类:历史会话、技能、MCP 服务器、项目根目录。可以整体导,也可以逐项挑。
- 明确不导的:设置、钩子、命令、子代理、指令文件(AGENTS.md 之类)、已启用的插件。这几类目前没有可信的跨客户端转换——不同客户端的钩子和命令语义并不等价,硬转过来等于给你埋一个会静默跑错的东西,所以宁可报错也不猜。Qoder 的原生聊天格式也还不支持。
- 落点:技能被复制进
~/.klaus/skills(或项目的.klaus/skills),目标已存在同名目录时跳过并告诉你;会话记录转成 Klaus 自己的格式写进会话存储根~/.klaus/sessions/,并标记为外部来源;项目根只是登记一下,不搬目录。 - MCP 配置按白名单归一化:只保留启动真正需要的字段(命令型的 command/args/env,HTTP 型的 url/headers/oauth),其余字段一律丢弃。但 env 和 headers 里的东西是原样带过来的——如果原来那份配置把密钥写在环境变量或请求头里,它会跟着进 Klaus。导入完去 MCP 页核对一遍这些值,见 MCP 与连接器。Codex 的项目级 MCP 还多一道要求:那个项目必须是已登记且被 Codex 标为 trusted 的。同名服务器不会覆盖你已有的那条,直接跳过。
- 重复导入会被跳过:一份导入台账记着每个来源会话文件的路径和内容哈希,没改过的文件第二次导入直接跳;源文件改过(哈希变了)可以再导一次。
- 会话导入有量的上限:一次最多 50 条,默认只看最近 30 天。
- 导完如果 MCP 配置变了,会顺手让运行中的会话重新加载 MCP,不用重启应用。但技能是在会话启动时读盘的,Klaus 也不监听那个目录——导入是直接往磁盘上写文件,走不了「在 App 里改→下回合自动重建」那条路,所以要开一个新会话才看得到(见扩展怎么被加载)。