MemoryLake
返回全部文章
Tutorial2026 年 10 月 14 日·11 分钟阅读

如何在不丢失上下文的情况下从 Lovable 迁移到 Claude Code(2026)

一个 Lovable 项目通常会达到一个阶段,让你想要直接对其进行开发。你希望代码保存在自己的仓库中,在终端中使用 Claude Code,并拥有做出 Lovable 聊天界面不适合进行的修改的自由。Lovable 支持这条路径。它会将你的代码同步到 GitHub、GitLab 或 Bitbucket,并发布一个 Claude Code 可以连接的 MCP 服务端。

不会自动迁移的是上下文。你写入 Lovable 知识(Knowledge)中的规则、工作区构建的技能以及在项目聊天中做出的决策都保存在 Lovable 内部。Git 同步传输的是代码。Claude Code 读取的是指令文件。从一端过渡到另一端就是迁移的过程。

本指南涵盖了每一端所保留的内容、Lovable 的 MCP 服务端可以为你读取什么,以及如何设置一个两个工具在并肩使用时都能遵循的指令文件。如果你要迁移到 Cursor,请参阅我们关于从 Lovable 迁移到 Cursor 的指南。关于工作区和项目知识如何在 Lovable 内部进行分层,请参阅我们关于分层 Lovable 工作区和项目知识的指南。

实际传输的内容

Git 同步传输的内容

Lovable 的文档从你的代码存放位置开始说明:"当你使用 Lovable 进行构建时,你的项目代码将存储并管理在 Lovable 平台内部。" Git 同步将项目链接到你拥有的仓库,此后,"你在 Lovable 中所做的更改将被提交到你的仓库,而推送到同步分支的提交将重新出现在你的 Lovable 项目中。"

这使得代码层面的迁移变得非常直接。任何编码助手都可以与其配合使用:"无论是由哪个工具生成的,Lovable 都会接收你推送到同步分支的提交,因此支持任何与 Git 配合使用的 IDE 或编码助手。" 在付费计划中,你还可以在不连接 Git 的情况下下载代码库。

有一些限制决定了你如何进行设置:

  • 一次只能处理一个分支。 Lovable 仅编辑和同步已同步的分支。在合并之前,其他分支上的提交不会出现在 Lovable 中。
  • 仅限导出。 Lovable 的文档指出 "你无法将现有仓库导入到 Lovable 中。" 连接时总是会创建一个新仓库。
  • 无数据,无密钥。 仓库包含你项目的代码,"包括定义其结构的数据库迁移文件,但绝不包含数据库中的数据。" 并且 "你存储在 Lovable 中的密钥不会进入仓库"。

保留在 Lovable 中的内容

知识(Knowledge)是主要内容。Lovable 将其描述为 "向 Lovable 智能体提供持久指令和上下文" 的方式,它分为两个级别。工作区知识(Workspace knowledge)保存共享规则,例如编码标准和命名规范。项目知识(Project knowledge)保存特定于某个应用的内容,例如其用途、数据库模式、架构决策和领域术语。每个级别最多支持 10,000 个字符。

知识是一个设置字段,而不是你仓库中的文件。Lovable 关于 Git 同步的指南间接指出了这一点:"Lovable 对你编写的代码和它生成的代码一视同仁,并且它可以在以后的请求中修改其中任何一个。" 它的建议是将应该在多个请求之间保持的约束放入项目知识中,并保留针对你所依赖的行为的测试。在 Lovable 内部,这是很好的建议,这也意味着最重要的约束恰恰是那些不会出现在你的克隆版本中的约束。

技能(Skills)是第二项内容。工作区技能是针对重复性任务的命名剧本(playbooks),它们是按需加载而不是始终加载。它们存在于工作区设置中,而不是仓库中。

项目聊天是第三项内容。Git 同步文档涵盖的是代码,而不是产生代码的对话。在聊天中做出的决策只有在有人将其记录下来时才会进入仓库。

Claude Code 读取的替代内容

Claude Code 在每次会话开始时都会读取指令文件。最主要的是 CLAUDE.md。它也可以读取 AGENTS.md,但有一个对本次迁移很重要的条件:"默认情况下,只有当你的工作目录或其上级目录中没有 CLAUDE.md 时,Claude 才会读取 AGENTS.md。" 我们关于 Claude Code 的 AGENTS.md 默认设置指南涵盖了适用于该检查的文件。Anthropic 指出 "直接读取 AGENTS.md 需要 Claude Code v2.1.277 或更高版本。"

技能的迁移更为直接。"Claude Code 技能遵循 Agent Skills 开放标准,该标准适用于多种 AI 工具。" 项目技能保存在 .claude/skills/<skill-name>/SKILL.md,Anthropic 对项目技能的建议是 "将其提交,以便你的团队也能获取"。

Claude Code 还会保留自动记忆(auto memory),即 Claude 根据你的纠正和偏好自己编写的笔记。这些笔记来自你的 Claude Code 会话,因此在你自己记录下来之前,Lovable 聊天中学到的任何内容都不会包含在其中。

两者的交汇点:Lovable 的 MCP 服务端

Lovable 运行着一个外部客户端可以连接的 MCP 服务端,而 Claude Code 是 Lovable 文档中支持的客户端之一。"Lovable MCP 服务端在所有计划中均可用。" 这与 Lovable 的聊天连接器相反:不是 Lovable 访问你的工具,而是你的工具访问 Lovable。

对于迁移来说,有用的部分是读取工具。文档中列出的工具包括 get_workspace_knowledge 和 get_project_knowledge(返回知识文本);list_workspace_skills 和 get_workspace_skill(返回技能 "包括其完整内容");list_messages(描述为 "列出项目中的最新消息,最新优先");以及用于项目历史和文件的 list_edits 和 read_file。

这意味着 Claude Code 可以直接读取你的知识和技能,而无需你手动复制。但随之而来的是两个注意事项。知识的写入工具是替换而不是追加。set_project_knowledge 的描述最后写道 "完全替换现有内容",因此如果你仍在使用 Lovable,请不要让智能体随意写回知识。此外,list_messages 返回的是最近的消息,因此它是一种审查最新决策的方法,而不是整个聊天的存档。

开始前需要检查的事项

企业工作区。 第三方 MCP 访问 "在企业工作区中默认禁用。" 所有者或管理员必须先启用它。

范围和成本。 Lovable 警告称,该连接 "不限于一个项目",并且 "工具调用会消耗实际额度并编辑实际项目。" 其常见问题解答指出,额度适用于 create_project 和 send_message,其他工具是免费的,因此读取知识和技能应该不会消耗额度。但向 Lovable 智能体发送消息会消耗额度。

谁能看到什么。 "只有工作区所有者和管理员才能管理工作区知识。" 编辑及以上权限的用户可以下载自定义技能。对于 Lovable 的内置技能,其常见问题解答指出 "只有你添加到工作区的技能才能被下载。" 如果你不是管理员,请向管理员索取当前的工作区知识。

你组织的规则。 知识通常包含内部引用,项目聊天可能包含客户详细信息。在将其移入新工具或文件之前,请检查允许的内容。

手动迁移

步骤 1:同步代码,然后从 Lovable 中提取知识和技能

在“项目设置”的“Git”下将项目连接到仓库,并让任何正在进行的 Lovable 编辑完成。同步状态卡会告诉你 Lovable 和你的托管商何时处于相同的提交。克隆仓库并在功能分支上进行开发,这样 Lovable 的同步分支就能保持干净。

接下来,提取上下文。使用 Lovable 文档中的设置步骤将 Claude Code 连接到 Lovable 的 MCP 服务端。然后让 Claude Code 读取项目知识和工作区知识,并将它们分别保存到一个临时文件中。在开始使用之前,请自己阅读这两个文件。几个月前编写的知识往往包含你后来已经修改的规则。如果你不想连接 MCP,可以手动从“项目设置”的“Knowledge”下复制文本。

对于技能,Lovable 允许你在“工作区设置”的“Skills”下将自定义技能下载为 zip 压缩包。Lovable 表示其技能 "使用与 Anthropic 的 Claude 以及任何其他遵循 Agent Skills 规范的工具相同的 SKILL.md 格式",因此不需要进行转换。

最后,审查最近的聊天。让 Claude Code 通过 MCP 列出项目最近的消息,或者你自己滚动浏览聊天记录,并写下从未进入知识库的决策:为什么选择某个库、尝试过并放弃了什么、哪些行为绝对不能改变。为每一项写上日期。

步骤 2:编写一个两个工具都能读取的指令文件,并将技能移入仓库

这两个工具默认读取不同的文件。Lovable 的知识常见问题解答指出 "无论会话长度如何,Lovable 智能体始终会读取根目录下的 AGENTS.md 文件",并且像 CLAUDE.md 这样的指令文件也可以引导它。而 Claude Code 只有在没有 CLAUDE.md 时才会读取 AGENTS.md。

因此,如果你打算在并肩使用 Claude Code 的同时继续使用 Lovable,请将共享规则放在根目录下的 AGENTS.md 中。两个工具都会读取它。如果你需要特定于 Claude 的指令,Anthropic 文档中推荐的模式是,通过在旁边的 CLAUDE.md 中放入 @AGENTS.md 导入,从而将 AGENTS.md "保留为每个工具共享的唯一文件"。保持该 CLAUDE.md 简短,因为 Lovable 也可能会读取它。

然后转换 Lovable 上下文的每个部分:

  • 项目知识变为 AGENTS.md。 将其重写为简短、直接的规则。Anthropic 的建议是 "每个 CLAUDE.md 文件控制在 200 行以内",同样的原则在这里也适用。
  • 工作区知识变为共享规则。 将适用于每个项目的规则放入每个仓库의 AGENTS.md 中,或者将你的个人规则保留在用户级别的 Claude Code 指令中。
  • 聊天决策变为决策文件。 一个文件,带日期的条目,最新优先。在 AGENTS.md 中链接到它。
  • 技能移入 .claude/skills/。 将每个下载的技能解压到其自己的文件夹中并提交。

Lovable 还发布了一个技能,用于教客户端如何操作其 MCP 服务端,其文档建议将 .claude/skills/lovable-mcp/SKILL.md 作为 Claude Code 的存放位置。只有当你计划继续从 Claude Code 在 Lovable 中进行构建时,才添加它。

启动一个 Claude Code 会话并确认加载了什么。如果只有 AGENTS.md,交互式会话会显示一行,说明未找到 CLAUDE.md 且已加载 AGENTS.md。如果有 CLAUDE.md,运行 /context 并检查它是否出现在 Memory files(记忆文件)下。然后让 Claude 总结它加载的规则。如果遗漏了某些内容,请修改文件,而不是聊天记录。

如果你以前从其他基于浏览器的构建工具迁移过,我们关于从 Replit 迁移到 Claude Code 的指南也遵循相同的模式。

更好的方法:将项目决策保存在两个工具都可以使用的一个地方

手动迁移将 Lovable 的知识和聊天记录转换为了 Claude Code 读取的文件。决策文件是最有价值的部分。它也是最容易发生偏差的部分,因为 Lovable 和 Claude Code 都会继续在相同的代码上进行开发。

MemoryLake 是一个记忆层,用于将这些决策保存在你维护的一个列表中,供 Claude Code 和你使用的其他助手使用。

你自己用自己的话编写这些条目。不会从你的 Lovable 知识、你的工作区技能、你的 Claude Code 记忆或任何供应商的存储中读取、写入或删除任何内容。在将项目详细信息复制到任何地方之前,请检查你组织的政策。

步骤 1:创建 API 密钥

登录并从控制面板生成一个密钥。该密钥属于你的 MemoryLake 工作区,与你的 Lovable 和 Anthropic 账户分开。

MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以在智能体中使用
MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以在智能体中使用

步骤 2:上传你的第一批记忆

从你在手动迁移的步骤 1 中记录下的决策开始。每个条目包含一个决策,注明日期和原因。

已上传首批文档的 MemoryLake 工作区,列出了每个文件成为可搜索记忆时的状态
已上传首批文档的 MemoryLake 工作区,列出了每个文件成为可搜索记忆时的状态

步骤 3:连接你的 AI 和智能体

连接 Claude Code 和你使用的其他助手。这样,在连接的每个工具中都可以使用相同的决策,而不用保存在单个工具的设置中。

MemoryLake 集成屏幕,列出了可以连接到记忆层的 AI 客户端和智能体框架
MemoryLake 集成屏幕,列出了可以连接到记忆层的 AI 客户端和智能体框架

这在实践中带来了什么改变

第一个区别是 Lovable 的上下文变成了你可以阅读和审查的内容。以前知识保存在设置字段中。现在它是你仓库中的一个文件,与你的代码一起进行版本控制。

第二个区别是减少了代码被推翻的情况。Lovable 可能会在以后的请求中修改你编写的代码。当约束存在于两个工具都会读取的根目录 AGENTS.md 中时,它对 Lovable 和 Claude Code 同样可见。

第三个区别是技能可以继续发挥作用。因为两个工具都使用相同的 SKILL.md 格式,你在 Lovable 中优化过的工作区工作流可以在 Claude Code 中直接运行,无需重写。不过,技能承载的是程序,而不是决策,这就是为什么技能不能替代记忆,而决策文件仍然至关重要。

第四个区别是减少了重复解释。一个以正确的指令文件开始的会话不需要你重新解释项目,我们关于 Claude Code 遗忘项目上下文的指南涵盖了这种情况。

从 Lovable 迁移到 Claude Code 的最佳实践

将 Lovable 保持在独立的分支上。 在功能分支上进行开发,然后合并到同步分支中。

不要重写已同步的历史记录。 Lovable 的文档指出,不要对已在同步分支上的提交进行强制推送(force-push)、变基(rebase)或压缩(squash)。

在复制知识之前先阅读它。 旧规则往往是错误的规则。

使用一个根目录 AGENTS.md。 两个工具都会读取它。

谨慎对待 MCP 写入。 知识写入会替换整个字段。

将技能提交到仓库。 这就是 Claude Code 寻找项目技能的地方。

记录下聊天决策。 聊天记录不会随代码一起迁移,正如我们关于 Lovable 遗忘项目上下文的指南所解释的那样。

结论

从 Lovable 迁移到 Claude Code,对于代码来说很容易,但对于上下文来说需要深思熟虑。Git 同步为你提供了一个 Claude Code 可以工作的仓库。除非你将它们提取出来,否则 Lovable 的知识、技能和聊天记录将保留在 Lovable 中。

Lovable 的 MCP 服务端使这一过程变得更容易。只要你谨慎对待写入工具,Claude Code 就可以直接读取项目和工作区知识、自定义技能以及最近的消息。技能可以原样迁移,因为两个工具都使用相同的 SKILL.md 格式。

将共享规则放在根目录下的 AGENTS.md 中,如果需要特定于 Claude 的指令,可以添加一个导入它的简短 CLAUDE.md,并保留一个带日期的决策文件。否则,你将不得不通过一次又一次的纠正来重新构建这些上下文。

常见问题

Lovable 的 GitHub 同步是否包含知识(Knowledge)?

不包含。Git 同步传输的是你项目的代码。知识是 Lovable 中的一个设置字段,因此你需要自己将其复制出来,或者通过 Lovable 的 MCP 服务端进行读取。

Claude Code 可以连接到 Lovable 吗?

可以。Lovable 的文档将 Claude Code 列为其 MCP 服务端支持的客户端,该服务端在所有计划中均可用。在企业工作区中,管理员必须先启用第三方 MCP 客户端。

我可以在 Claude Code 中使用 Lovable 技能吗?

可以。Lovable 表示其技能使用与 Claude 和其他 Agent Skills 工具相同的 SKILL.md 格式。将自定义技能下载为 zip 压缩包,并将每个技能放入 .claude/skills/ 中。Lovable 指出,只有你添加到工作区的技能才能被下载,因此其内置技能仍保留在 Lovable 中。

对于 Lovable 项目,我应该使用 AGENTS.md 还是 CLAUDE.md?

如果你打算继续使用这两个工具,请使用根目录下的 AGENTS.md 来保存共享规则。Lovable 始终会读取它,而 Claude Code 会在没有 CLAUDE.md 时读取它,或者在有 CLAUDE.md 时通过 @AGENTS.md 导入来读取它。

我可以将我的 GitHub 仓库重新导入到 Lovable 中吗?

不能。Lovable 的 Git 同步仅限导出。连接项目会创建一个新仓库,同步分支上的提交会流回该项目中。

通过 MCP 读取 Lovable 知识会消耗额度吗?

Lovable 的常见问题解答指出,额度适用于 create_project 和 send_message 调用,其他工具是免费的。读取知识和技能使用的是其他工具。