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 项目,以便规则更新传播到两者。