- 文档
- 提示工程
- 人工智能
【免费下载链接】claude-code-system-prompts
All parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.
本指南系统讲解 Claude Code（当前仓库镜像版本对应 v2.1.234 起的系统提示词体系，仓库主体为各版本系统提示词快照）中
syncClaudeAiSkills配置项的完整行为：如何关闭 claude.ai 账户已启用技能的自动同步、不同配置作用域下的差异、本地技能文件的清理与回收机制，以及"仅 false 生效"这一反直觉的取值规则。读完本文，你将掌握在用户级、托管级、工作区级与单次调用级四种范围内正确配置技能同步的能力，并能准确预判关闭同步后~/.claude/skills/目录下各文件的去向。
一、设置的本质：账户级技能同步的总开关
Claude Code 支持把你在 claude.ai 上启用（enable）的 Skills 自动同步到本地 CLI 环境，使这些技能可以在每一次会话中直接使用。这一能力由系统提示词文档 Data: syncClaudeAiSkills setting 描述，其完整定义位于仓库的 README 索引 中：
- 该文档归属于仓库的 "Data" 分类，用于描述 Claude Code 系统提示词中出现的配置项字段语义，是帮助 Claude Code 自身（以及使用该仓库的研究者、Agent、LLM）正确理解和操作该配置的权威说明。
- 其配套的同类文档 Data: syncClaudeAiPlugins setting 描述了插件同步的平行机制（路径为
~/.claude/plugins/synced），可作为理解技能同步的参照系。
syncClaudeAiSkills的默认行为是开启的：只要用户使用 Claude 账户登录 Claude Code，账户上已启用的技能就会被同步，并在每个会话中可用。该配置的唯一作用是关闭这一同步行为，即：
设置为
false即可关闭你在 claude.ai 上已启用技能的同步。
二、仅在登录状态下生效的前提条件
原文档明确限定了该设置的适用边界：
仅在你使用 Claude 账户登录（signed in with your Claude account）时适用。
这意味着：
- 通过
ANTHROPIC_API_KEY等 API Key 方式使用 Claude Code 的会话不受此设置影响； - 未登录 claude.ai 账户的会话也不存在"账户同步技能"这一行为；
- 登录状态是技能同步的前提，
syncClaudeAiSkills只是在这个前提之上的一个控制开关。
三、逐层拆解：关闭同步后的完整行为链
原文档用一段话概括了关闭同步后的全部效果，这里逐句拆解：
3.1 用户设置或托管设置（user settings / managed settings）中的行为
在~/.claude/settings.json（用户级）或托管设置（managed settings）中设置为false时：
- 不再下载任何新内容——后续不再拉取你新启用的技能；
- 已同步技能立即失效——之前同步到
~/.claude/skills/synced目录的技能无法再运行； - 会话隐藏——此后启动的每一个会话中，这些技能都会被隐藏（不参与技能解析）；
- 下次启动时移入回收站——同步目录被移动到
~/.claude/skills/.trash； - 按清理周期最终删除——回收站内容在
cleanupPeriodDays之后被删除； - 重新启用后重新下载而非恢复——如果你在 claude.ai 上重新启用技能同步，技能会被重新下载，而不是从回收站"恢复"。
3.2 工作区设置或命令行设置中的行为
在.claude/settings.local.json（工作区本地设置）或通过--settings参数（单次调用级）设置为false时，行为更温和：
- 停止下载新技能；
- 仅在该工作区或该次调用对应的会话中，同步技能被阻止并隐藏；
- 不会移动任何本地文件（不产生
.trash目录操作）。
也就是说：越接近全局的设置，关闭动作越彻底（含本地清理）；越接近单次会话的设置，越倾向于"眼不见为净"的临时性禁用。
3.3 项目设置（project settings）不生效
该设置不会从项目设置（
.claude/settings.json）读取。
这一点对团队协作非常重要：因为项目设置通常会被提交到 Git 仓库中，若允许项目设置控制技能同步，任何仓库都能强制改变成员本地的技能可用性。因此 Claude Code 刻意将该项目排除在技能同步开关的读取范围之外。关于各设置文件的作用域差异，可参考仓库中的 Skill: Update config settings file locations 文档：
| 文件 | 作用域 | Git | 用途 |
|---|---|---|---|
~/.claude/settings.json | 全局（用户级） | 不适用 | 所有项目的个人偏好 |
.claude/settings.json | 项目 | 提交 | 团队级 hooks、权限、插件 |
.claude/settings.local.json | 项目 | gitignore | 该项目下的个人覆盖 |
设置加载顺序为 用户 → 项目 → 本地（后者覆盖前者）。syncClaudeAiSkills只在用户级与本地/调用级读取，恰好避开了"项目级"这一会被提交到代码库的中间层。
四、"Only false is honored"：一个反直觉的取值规则
原文档中最容易踩坑的一条规则：
只有
false会被采纳——该功能在你的账户侧（server-side）是默认启用的，所以设置为true并不会提前开启它。
解读：
- 技能同步由服务端账户配置决定，默认即为开启状态；
- 因此
true是"默认值"，写不写true效果完全相同，写true不会产生任何额外效果； - 唯一有实际意义的值是
false，它用于在客户端显式关闭同步； - 这与其他布尔配置"true 开启 / false 关闭"的直觉相反，务必注意。
这一设计在仓库的 CHANGELOG.md（v2.1.234 条目）中被概括为："Documents howfalsedisables account-synced skills across user, managed, workspace, and invocation scopes, including hiding, trash cleanup, re-enablement, and unsupported project-setting behavior"，与文档正文完全一致。
五、开启状态下的默认行为（对照理解）
为了准确理解关闭后的差异，原文档同样描述了开启（默认）状态下的行为：
- 已同步技能在每个会话中可用；
- 技能每 10 分钟重新同步一次（保持与 claude.ai 账户状态一致）；
- 当你在 claude.ai 上禁用某个技能时，本地对应技能会被移除。
与之对照，关闭后则完全停止这套循环：不再下载、不再刷新、不再跟随账户状态变化。同样的"同步—隐藏—移入.trash—按周期删除"模式也适用于插件，详见 Data: syncClaudeAiPlugins setting。
六、目录与回收机制速查
把涉及的关键路径与行为汇总如下，便于实际操作时对照：
| 项 | 值 / 行为 |
|---|---|
| 同步技能存放目录 | ~/.claude/skills/synced |
| 关闭后回收目录 | ~/.claude/skills/.trash |
| 回收站清理周期 | cleanupPeriodDays（参见 settings 字段说明，该字段同样用于会话 transcript 的自动清理，默认 30 天、最小 1 天） |
| 重新启用后的恢复方式 | 重新下载（非从回收站恢复） |
| 同步频率（开启时） | 每 10 分钟一次 |
| 登录前提 | 仅 Claude 账户登录会话生效 |
七、实战配置示例
7.1 全局关闭（用户级，推荐个人使用）
在~/.claude/settings.json中添加：
{ "syncClaudeAiSkills": false }效果：停止所有项目中的技能同步，下次启动时把~/.claude/skills/synced移入~/.claude/skills/.trash，并在cleanupPeriodDays后删除。
7.2 单项目 / 单次调用关闭
在项目根目录的.claude/settings.local.json中添加：
{ "syncClaudeAiSkills": false }或通过命令行启动：
claude --settings /path/to/settings.json效果：仅该工作区或该次调用中的会话隐藏并阻止同步技能，不会移动本地文件。
7.3 托管设置（managed settings）
在企业/组织托管设置中将syncClaudeAiSkills设为false，可对整个组织的 Claude Code 部署统一关闭账户技能同步，行为与用户级一致（含.trash清理流程）。
7.4 不要做的事
- 不要把该配置写进
.claude/settings.json（项目级）——该文件不会被读取，写了等于没写； - 不要试图用
true提前开启——功能在服务端默认开启，true无任何额外效果； - 不要期望回收站内容会被"恢复"——重新启用时是重新下载。
八、源码层面的定位与事实边界
本仓库是 Claude Code 系统提示词的镜像与索引仓库（README 说明其覆盖至 Claude Code v2.1.288 及 304 个版本的变更记录），并不包含 Claude Code 本体二进制源码。因此关于该设置的具体执行路径（如同步调度、.trash迁移的精确触发时机），仓库只能提供系统提示词层面的行为契约，即本文所引用的>赞
- 文档
- 提示工程
- 人工智能
【免费下载链接】claude-code-system-prompts
All parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.
相关推荐
Actual 接入 GoCardless 银行同步完整指南：密钥配置、账户关联与同步机制解析
Actual 接入 GoCardless 银行同步完整指南：密钥配置、账户关联与同步机制解析 Actual 是一款本地优先（local first）的个人财务管
金融科技本地优先PWAClaude Code 插件开发实战：深入解析 feature-dev 的 code-architect 架构设计智能体
Claude Code 插件开发实战：深入解析 feature dev 的 code architect 架构设计智能体 code architect 是 Cl
AI 应用AI 技能/插件开发工具Thunderbird for Android 账户 API 解析：AccountId、UnifiedAccountId 与功能无关的账户标识设计
Thunderbird for Android 账户 API 解析：AccountId、UnifiedAccountId 与功能无关的账户标识设计 导读 本文围
移动开发企业应用
