MemoryLake
返回全部文章
Tutorial2026 年 5 月 25 日5 分钟阅读

从 Claude Code 迁移到 Windsurf:2026 记忆手册

Claude Code 的终端流程与 Windsurf 的 IDE 并不完全匹配 — 但规则内容可以干净地转移,其余部分可以在每个仓库中重建,时间少于一个小时。

简短回答

Claude Code 没有原生推送到 Windsurf。您将把 CLAUDE.md 复制到 .windsurfrules,将用户全局指导移动到 Windsurf 的全局规则中,将斜杠命令转换为 Cascade 记忆或 .windsurfrules 部分,并在 Windsurf 的 MCP 配置中重新添加 MCP 服务器。每个仓库计划 15–30 分钟。像 MemoryLake 这样的共享基于 MCP 的记忆层允许两个工具读取相同的源。

人们为什么从 Claude Code 切换到 Windsurf

2026 年的三个驱动因素:

  • Cascade 代理工作流。 经常进行多文件更改的团队通常更喜欢 Windsurf 的 IDE 中的 Cascade 循环。
  • 可视化差异和审查。 内联可视化审查优于终端补丁阅读,适用于高接触重构。
  • 编辑器稳定性。 一些团队希望 IDE 包装器支持插件和编辑器设置的平衡。

在 Claude Code 与 Windsurf 中 "记忆" 的含义

不同的形状,相关的意图。

Claude Code 记忆`CLAUDE.md` 为中心,位于仓库根目录,`~/.claude/CLAUDE.md`(用户全局),自定义斜杠命令 位于 .claude/commands/ 下,以及 Claude Code 设置中的 MCP 服务器。

Windsurf 记忆 涉及 `.windsurfrules`(项目规则)、全局规则(用户级)和 Cascade 记忆(在代理工作期间保存的持久记忆)。

一个 CLAUDE.md 变成一个 .windsurfrules。用户全局指导变成 Windsurf 的全局规则。斜杠命令变成 Cascade 记忆或 .windsurfrules 的静态部分。

步骤 1:导出您的 Claude Code 记忆

Claude Code 将所有内容存储为纯文本文件。

  1. 读取仓库的 `CLAUDE.md`。 将内容复制到一个工作文本文件中。
  2. 读取 `~/.claude/CLAUDE.md`。 将全局指导复制到 user-guidance.txt 中。
  3. *列出 `.claude/commands/.md。** 每一个都变成一个 Cascade 记忆或 .windsurfrules` 部分。
  4. 记录 MCP 服务器。 打开 Claude Code 设置,记录每个 MCP 服务器的端点 URL 和身份验证。

最终状态:每个仓库都有一个 claude-code-export/ 文件夹,包含 CLAUDE.mduser-guidance.txtcommands/mcp-list.md

步骤 2:导入到 Windsurf

Windsurf 接受重构后的等效材料。

  1. 在仓库根目录创建 `.windsurfrules`。 粘贴 CLAUDE.md 内容。
  2. 设置全局规则。 打开 Windsurf 设置,将 ~/.claude/CLAUDE.md 内容粘贴到全局规则区域。
  3. 转换斜杠命令。 静态指导(样式、约定)折叠到 .windsurfrules 中。可重用的提示在 Cascade 会话期间通过其记忆面板保存为 Cascade 记忆。
  4. 重新添加 MCP 服务器。 打开 Windsurf 的 MCP 配置,将 mcp-list.md 中的每个 MCP 服务器及其端点 URL 和 Bearer 令牌添加进去。
  5. 探测。 打开 Cascade,运行一个依赖于已移动规则的小任务。

迁移后您仍会失去的内容

  • 斜杠命令调用模式。 /<name> 快捷方式没有一对一的 Cascade 等效项。
  • 终端原生多步骤流程。 长时间运行的 CLI 任务重塑为 Cascade 运行。
  • 每个工具的聊天记录。 Claude Code 会话保留在终端中。
  • 持续同步。 下周的新 CLAUDE.md 编辑不会出现在 .windsurfrules 中,除非您重新进行复制。

更好的方式:一个记忆层,所有工具

如果您在 Claude Code 和 Windsurf 之间切换,每个工具的文件会漂移。跨仓库标准最终会出现在两个地方。

MemoryLake 只存储一次这些规则,并通过 MCP 公开它们。Claude Code 和 Windsurf 都支持 MCP,因此相同的项目上下文可以从单个端点流入两个工具。

  • 一个真实来源。 更新一次;两个工具都看到更改。
  • 跨仓库标准。 团队约定存在于任何单个仓库之上。
  • 为下一个工具提供即插即用。 通过配置更改添加 Cursor 或未来的代理。

在 3 个步骤中连接 MemoryLake

步骤 1:创建项目并加载您的上下文

登录 MemoryLake,打开项目管理,点击创建项目。命名为 "Claude Code ↔ Windsurf 共享规则"。将参考文档(样式指南、ADR 作为 PDF、Word、Markdown 或图像)拖入我的空间下的文档驱动器,然后打开文档选项卡,点击添加文档。将您的 CLAUDE.md、用户指导和斜杠命令主体粘贴到记忆选项卡中,通过添加记忆。

步骤 1:创建项目并加载您的上下文
步骤 1:创建项目并加载您的上下文

步骤 2:生成 MCP 服务器端点

在项目内打开 MCP 服务器选项卡,点击添加 MCP 服务器,描述它(例如,"共享开发规则"),然后点击生成。MemoryLake 返回一个密钥 ID、一个密钥和一个端点 URL。立即复制密钥 — 它只显示一次。

步骤 2:生成 MCP 服务器端点
步骤 2:生成 MCP 服务器端点

步骤 3:将两个工具指向端点

在 Claude Code 的设置中,添加一个 MemoryLake MCP 服务器,使用端点 URL 和密钥作为 Bearer 令牌。在 Windsurf 的 MCP 配置中,添加相同的条目。重新启动两个客户端。

步骤 3:将两个工具指向端点
步骤 3:将两个工具指向端点

原生迁移与 MemoryLake

维度原生 Claude Code → WindsurfMemoryLake 桥接
所需步骤7–10 手动3 次一次性
估计时间每个仓库 15–30 分钟~5 分钟设置
保留斜杠命令模式否(Cascade 记忆重建)记忆逐字保留
跨仓库标准每个仓库仅共享一次
同步持续更改
以后与第三个工具一起使用否(重建)是(添加 MCP)

常见问题

我可以将 `CLAUDE.md` 重命名为 `.windsurfrules` 吗?

对于简单的情况,重命名是可行的,因为两者都是纯文本。

斜杠命令会自动变成 Cascade 记忆吗?

不。您需要将每个重新创建为 Cascade 记忆或将其内容折叠到 .windsurfrules 中。

Windsurf 会看到我的 Claude Code MCP 服务器吗?

不会。它们共享 MCP 协议,但使用单独的配置文件。将每个 MCP 服务器添加到 Windsurf 的 MCP 配置中。

迁移通常需要多长时间?

每个仓库计划 15–30 分钟,如果您有很多斜杠命令或 MCP 服务器,可能会更长。

我可以在未来保持 Claude Code 和 Windsurf 的同步吗?

是的 — 通过 MCP 服务器端点将两者连接到共享 MemoryLake 项目,以便规则更新传播到两者。