Claude Code 默认同步 claude.ai 技能和插件

Claude Code 2.1.275 在 2026 年 9 月 17 日把一件以前要手工对齐的事做成了默认行为：你在 claude.ai 账户里启用的技能和插件，会同步进用同一账户登录的终端会话。Changelog 写明可用 syncClaudeAiSkills: false 或 syncClaudeAiPlugins: false 退出。设置参考把这两项归在 Plugins and skills，作用域是 user、local 或 managed——仓库级关不掉。

编辑绘制：claude.ai 账户、本机 synced 目录和终端会话之间的同步路径 — 编辑绘制：同步路径与缓存目录。依据 Claude Code 2.1.275 changelog、settings-reference、skills 与 plugins-reference。

开发者原来要在网页端开一套技能，再在笔记本、CI 机器和同事电脑上各装一遍插件。漏装一次，终端里的 Claude 就跟网页里的不是同一个助手。本文只写这次默认同步改了哪一步，以及本地改文件为什么救不了账户源。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

发生了什么

技能下载到 ~/.claude/skills/synced/。Claude Code 会跳过你在企业、个人、项目位置用同名写的技能，也不要在任何大小写下把技能文件夹命名为 synced。会话启动时后台下载账户技能，运行中大约每 10 分钟再检查一次；账户里新增、修改或关闭技能时，运行中的会话会更新或移除，不必先退出。菜单里它们归在 claude.ai sync；可用全名 /anthropic-skills:<name>，短名没被占用时也能 /<name>。像 pdf、xlsx 这类 Anthropic 技能会始终同步，其余才跟你在 claude.ai 的开关走。

插件下载到 ~/.claude/plugins/synced/，加载身份是 <name>@synced，没有 marketplace，也没有 install 记录。它按 marketplace 插件同等信任加载：技能、agents、hooks、MCP 和 LSP 都会进来。终端需要 Claude Code v2.1.273 及以上；2.1.275 把默认同步写进了正式 changelog。Cowork 和云端会话在启动时下载到会话环境；普通终端在启动时后台核对账户。交互会话里增删改时会提示 Plugins changed. Run /reload-plugins to activate.

Write/Edit 这次也补了一句：改 synced 账户技能目录里的文件，结果会告诉你不会写回账户，以及该怎么保存。源仍然是 claude.ai。你在本机改的下一轮同步会被覆盖；手工删掉目录，技能在账户里仍启用的话，下次还会下回来。设置参考对两项开关的描述一致：Stop loading … and stop downloading new ones。值为 false 才停；true 和未设置一样，保持默认同步。

同一版本还改进了 ListPlugins 工具说明：Claude 现在知道它列出的是账户上启用的插件，不是本地 /plugin 装上的那批。这能减少“模型以为插件已在本机”的误判。

一个完整工作场景

你在 claude.ai 给自己打开了内部的 API 规范技能和代码审查插件，组织还把安全基线插件标成 required。第二天打开笔记本上的终端，登录同一账户，不必再跑一遍 /plugin install。启动后技能出现在 /skills 的 claude.ai sync 分组，插件以 security-baseline@synced 这类名字出现。你在仓库里让 Claude 按规范补测试，它读到的是账户里那份技能，而不是同事机器上过期的本地副本。

你随手改了 ~/.claude/skills/synced/api-spec/SKILL.md，想“先在这台电脑试一下”。2.1.275 会明确告诉你这次写入没有回到账户。十分钟后的检查，或下一次启动，账户版会覆盖你的改动。正确路径是：到 claude.ai 改技能或开关，等同步；本机只决定加不加载。

某个仓库不想要审查插件，又不能动组织 required 项。非 required 的同步插件可以在该仓库 .claude/settings.json 的 enabledPlugins 里写 "reviewer@synced": false，或运行 claude plugin disable reviewer@synced，选择会写进用户级 enabledPlugins。对 required 插件，claude plugin disable 会拒绝，并写明 Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it. 列表里这些插件标 required by your org。即便你以前 disable 过，Claude Code 仍会加载它。

同名冲突按“其他来源优先”处理。如果本地或项目里已经启用了同名插件，同步副本报未加载。要用账户那份，先关掉自己装的那份。这避免了两套 hooks 抢同一事件，但也意味着 onboarding 时要先清掉旧的手工安装。

为什么这会改变工作流

技能和插件的源从“每台机器一份目录”变成“账户一份，机器只缓存”。新电脑、新 worktree、远程 runner 只要登录同一账户，启用集就是同一套。团队不必再把插件安装写进 onboarding 清单的第一步，改为：在 claude.ai 管启用，在仓库里管例外。

信任模型也变了。同步插件按已安装 marketplace 插件同等加载。终端里同步技能更紧：不跑技能体里的 ! 命令，不按本地技能方式展开 @ 引用，${CLAUDE_PROJECT_DIR} 和 ${CLAUDE_SESSION_ID} 当字面量，控制字符会被去掉，描述里的尖括号会转义。网页端能做的自动化，到终端会被剪一截。同一版本还把 npm 来源插件改成 npm pack --ignore-scripts 并做完整性校验，安装脚本不再执行——这是相邻的安全修复，不是同步功能本身，但正好卡在“账户插件突然出现在终端”的同一天。

2.1.275 还加了网关登录时确认账户名、/status 显示该账户、以及 /plugin install <plugin> --marketplace <source> 会先询问是否加入 marketplace。这些能减少“装到了错误账户”的事故，但本文事件仍是同步，不是安装命令。

限制和人必须接管的地方

默认是开的：用 claude.ai 账户登录的会话会同步。退出只能写在 user、local 或 managed 设置；设 false 后停止下载，下次启动把已同步内容挪到 ~/.claude/skills/.trash/ 或 ~/.claude/plugins/.trash/，不再加载。组织可在 managed 设置里写同一键；在 claude.ai 关掉 Skills，插件同步也会停。仓库 .claude/settings.json 不能关掉账户同步，只能排除单个非 required 的 @synced 插件。

claude plugin install/update/uninstall 管不了同步插件；更新等下一轮同步，卸载只能去 claude.ai 关。不要把 synced/ 当 git 工作副本。人接管点：把新机器交给 Agent 之前，先跑 /skills 和 claude plugin list，确认 required 插件在、不该出现的同步插件不在。给 CI 机器关同步时，用 user 或 managed 设置。共享 runner 如果登录了个人账户，账户技能会进会话——这是权限问题，不是同步 bug。

如何试用

升级到 Claude Code 2.1.275，用 claude.ai 账户登录终端。
跑 /skills，看 claude.ai sync 分组；插件看 <name>@synced。
本机退出：用户设置写 syncClaudeAiSkills: false 或 syncClaudeAiPlugins: false。单仓库排除非 required 插件：enabledPlugins 里写 "<name>@synced": false。
改技能去 claude.ai，不要改 ~/.claude/skills/synced/。交互会话提示插件变化后执行 /reload-plugins。