2026 Cursor Agent Skills 换 Mac 后怎么继续用于 Claude Code？

旧 Mac 能用，换到临时 Mac 后 Claude Code 出现两套同名技能。
最快解法：先确认旧环境只有一个来源；项目文件版随仓库迁移，plugin 版在新 Mac 重新安装，不要两套一起搬。

最后更新于 2026 年 8 月 27 日，安装命令、路径和插件规则核实自 mattpocock/skills README、skills CLI 文档及 Claude Code 官方插件文档。

这篇适合三类人：正在把 Cursor 项目迁移到新 Mac、又想保留技能定制的个人开发者；需要临时或云端 Mac 的工程团队；以及准备在同一台新 Mac 上并用 Cursor 和 Claude Code 的开发者。

先按新 Mac 的用途，选唯一技能来源

你在旧 Mac 上使用的可能是项目里的 SKILL.md 文件，也可能是 Claude Code plugin。两者都能继续使用，但迁移方式完全不同。

官方 README 将它们定义为两条路线：

• 项目文件版：技能写入项目目录，文件归你所有，可以自行修改；更新由你主动执行。
• Claude Code plugin：由 Claude Code 管理，适合直接使用维护中的技能包；技能内容不应从旧机器手动复制。
• README 明确警告：两种方式同时安装，会让每个技能出现两份。(github.com)

你在旧 Mac 上先执行一次记录，不要急着复制目录：

npx skills list

同时检查项目和用户级目录：

find . -path "*/skills/*/SKILL.md" -print
find ~/.cursor ~/.claude -path "*/skills/*/SKILL.md" -print 2>/dev/null

命令用于确认现状，不是让你把所有结果都搬到新机器。迁移前先在表格里做决定：

当前 CLI 文档列出的项目路径中，Cursor 使用 .agents/skills/，用户级路径是 ~/.cursor/skills/；Claude Code 使用 .claude/skills/。这些路径会随 CLI 支持矩阵变化，交付脚本不要把路径写死后多年不维护。(github.com)

长期使用的新 Mac：项目文件版比用户目录复制更稳

如果你需要保留自定义技能，或者团队希望通过代码审查控制技能变化，优先把 mattpocock/skills 的项目文件版纳入仓库管理。

官方安装入口是：

npx skills@latest add mattpocock/skills

如果只想面向某个 agent 或挑选技能，CLI 支持 --agent、--skill、--copy 和 --yes 等选项。以写作当天文档为准，不要直接套用旧文章里的参数。(npmjs.com)

建议按以下步骤在新 Mac 操作：

第一步：先拉取仓库，再处理技能

git clone <你的项目仓库>
cd <你的项目目录>
git status

不要从旧 Mac 打包整个用户目录。用户目录里可能混有旧的 agent 缓存、登录状态、临时文件和已经被删除的技能。

第二步：确认仓库内的技能目录

find .agents/skills -name SKILL.md -print 2>/dev/null
find .claude/skills -name SKILL.md -print 2>/dev/null

Cursor 项目通常看 .agents/skills/，Claude Code 项目文件版看 .claude/skills/。如果两处都有同名目录，先停下来。你需要判断它们是有意共享，还是之前安装造成的重复。

第三步：比较自定义改动

git diff -- .agents/skills .claude/skills
git log --all -- SKILL.md

重点核对：

• 你改过的技能说明和执行步骤；
• 技能引用的相邻文件；
• setup-matt-pocock-skills 生成的项目配置；
• 团队约定的 CLAUDE.md、AGENTS.md 或其它上下文文件；
• 是否存在只在旧 Mac 上生成、但没有提交进仓库的配置。

第四步：按仓库要求重新初始化

mattpocock/skills README 要求在每个仓库运行一次 /setup-matt-pocock-skills。这个流程会询问 issue tracker、triage 标签和文档保存位置。(github.com)

你不要把旧 Mac 上的初始化结果默认视为正确。新仓库的分支、路径和团队配置可能已经变化。

第五步：更新只交给仓库流程

项目文件版不会在后台自动更新。README 给出的更新方式是：

npx skills update

更新后立即查看 Git 差异，再决定是否提交。CLI 的项目级和全局级更新范围不同，写自动化脚本时要明确使用项目范围，避免误改个人目录。(github.com)

临时或云端 Mac：重建环境，不要克隆旧用户目录

临时 Mac 的目标不是“复制旧机器”，而是从仓库重新生成一个可销毁环境。这样做可以减少三类隐性成本：

1. 机器级状态不可见：技能可能藏在 ~/.cursor/skills/ 或 ~/.claude/，项目成员无法从 Git 看见。
2. 权限和所有者混乱：旧用户目录复制到新环境后，文件权限、路径和登录用户可能不同。
3. 销毁后无法复盘：临时环境结束时，如果没有提交技能改动和验收记录，下一台机器只能重新猜。

临时 Mac 的选择可以这样判断：

项目文件版的典型重建命令可以从仓库根目录开始：

npx skills@latest add mattpocock/skills --agent cursor
npx skills list

如果 Claude Code 也要读取同一份项目文件，先确认仓库结构是否符合 .claude/skills/ 规则，再决定是否指定 --agent claude-code。不要为了“让两个工具都能发现”而让 CLI 自动向多个位置各写一份副本。

Claude Code 官方文档说明，marketplace plugin 会复制到本地缓存目录 ~/.claude/plugins/cache，而不是直接使用 marketplace 仓库中的目录。这个缓存是运行机制的一部分，不是项目资产。(code.claude.com)

如果你需要临时 Mac 的环境初始化、交付和销毁流程，可以把本文清单放进你的开发环境操作记录，不要只保存一张旧机器截图。

只用 Claude Code plugin：新 Mac 上重新安装

如果旧 Mac 采用的是 plugin 路线，恢复逻辑很简单：重新安装，不复制内容。

mattpocock/skills README 当前给出的 Claude Code 安装入口包括：

claude plugins install mattpocock-skills

或者在 Claude Code 会话中执行：

/plugin install mattpocock-skills

如果新环境提示找不到插件，先打开 /plugin 查看 Discover 和 Installed 页面，再根据当前 marketplace 状态更新或重新添加。Claude Code 官方插件流程区分“添加 marketplace”和“安装 plugin”两个动作；添加目录本身不会自动安装其中所有插件。(code.claude.com)

恢复后按这个顺序检查：

1. 执行 /plugin，确认 plugin 出现在 Installed。
2. 确认 plugin 没有被禁用，也没有出现在 Errors。
3. 检查技能是否以命名空间形式出现，例如 /插件名:技能名。
4. 在目标仓库运行 /setup-matt-pocock-skills，确认项目初始化仍满足当前仓库要求。
5. 如果安装摘要提示需要激活，运行：

/reload-plugins

官方文档还提供了 claude plugin install、claude plugin uninstall 等非交互命令。安装范围可以是 user、project 或 local，共 3 种 scope；团队共享时要谨慎选择 project scope，因为它会写入项目的 .claude/settings.json。(code.claude.com)

发现同名项目文件版时不要继续配置。 先卸载或移除重复来源，再重新启动会话。通过叠加安装来“覆盖”问题，通常只会让技能发现、命名空间和更新状态更难判断。

同一台新 Mac 并用 Cursor 与 Claude Code：工具可以并用，来源不能并存

Cursor 与 Claude Code 可以同时打开同一个项目，但这不等于你要给它们分别安装两份同名技能。

最稳的两种方案：

方案 A：共享一套项目文件

适合你需要修改技能、希望 Cursor 和 Claude Code 读取相同上下文的情况。

• 技能文件只放在仓库认可的目录；
• Cursor 通过 .agents/skills/ 发现；
• Claude Code 通过 .claude/skills/ 发现，或按项目规则做统一配置；
• 不安装同名 plugin。

方案 B：Cursor 使用项目文件，Claude Code 单独使用 plugin

只适合你明确接受两套维护边界的情况。两边不能提供同名技能，否则你很难判断实际调用的是哪一份。

分别完成低风险验收：

Cursor：请只读取项目上下文，说明当前技能目录和项目约定。
Claude Code：请列出当前可发现的技能，并执行一个只读的代码结构检查。

不要直接用改代码、提交、删除文件作为首次测试。你要验证的是“发现来源正确”，不是让 agent 立即执行高风险动作。

新 Mac 交付前：用证据验收，再决定是否回滚

交付时至少保留以下 5 类证据：

• 唯一安装来源：项目文件版或 plugin 版；
• 可见技能清单；
• 一次真实但低风险的调用结果；
• 自定义技能内容与旧 Mac 已验证版本一致；
• 重启 Claude Code 或重建临时环境后的状态。

可以直接勾选：

• [ ] 已记录旧 Mac 使用的是项目文件版还是 plugin 版；
• [ ] 新 Mac 没有同时存在两份同名技能；
• [ ] 项目文件已通过 Git 仓库交付；
• [ ] .agents/skills/、.claude/skills/ 的实际内容已核对；
• [ ] plugin 已启用，且 Errors 中没有加载失败；
• [ ] 已运行一次 /setup-matt-pocock-skills 或确认无需重新初始化；
• [ ] Cursor 能发现预期技能；
• [ ] Claude Code 能发现预期技能；
• [ ] 已完成一次只读测试任务；
• [ ] 重启会话后技能仍可发现；
• [ ] 临时 Mac 销毁前已保存配置和验收记录；
• [ ] 回滚点是旧 Mac 已验证的仓库提交或单一 plugin 来源。

如果验收失败，回滚到上一个已验证的仓库版本，或者恢复为单一 plugin 来源。不要再次叠加安装，也不要把 ~/.claude/plugins/cache 或旧 Mac 的整个用户目录当成补救方案。

对长期项目来说，直接把仓库、依赖和验收记录带到新 Mac，比依赖某台机器上的隐藏状态更容易审查。若你还在比较临时 Mac 和长期 Mac，可以结合Mac 环境选择与使用说明判断：短期验证、跨设备复现、临时团队成员接入，更适合先用可销毁环境；长期稳定重负载或需要固定物理接口，则应评估自购 Mac。

如果你只是想在一段任务周期内验证 Cursor 与 Claude Code 的并用方式，租赁 Mac 的优势在于环境可以按任务创建和销毁，不必为一次迁移长期维护机器；但它也有真实限制：网络和远程会话会增加一层依赖，物理接口能力不等同于本地设备，长期固定负载的总成本也未必低于自购。完成本文的唯一来源判断后，再按你的任务周期查看MacHTML 的使用方案，并用这份验收清单决定是否值得把临时环境交付给团队。

延伸阅读: Cursor Agent Skills 安装与团队配置：项目级技能、Rules 分工和复现验收 迁移到新 Mac 或云端 Mac：SSH、远程开发与文件同步配置指南