Claude Code 设置文件作用域揭秘

在项目目录下的 .claude/settings.json 中添加 autoMode 等键时，发现无效。原因是 Claude Code 的配置键有作用域限制，只有在对应作用域文件中才生效。
- ~/.claude/settings.json：用户作用域
- settings.local.json：本地作用域
- ~/.claude.json：全局作用域

例如 autoMode 只能在用户或本地作用域中使用，放在 settings.json（共享文件）会被忽略。
同理，useAutoModeDuringPlan、syncClaudeAiSkills、skipDangerousModePermissionPrompt 等键也只在 settings.local.json 有效。

如何正确配置
1. 将需要的键放入对应作用域文件。
2. 若想团队共享，先在 settings.local.json 验证无误，再迁移到 ~/.claude/settings.json。
3. 使用 npx @quintetkit/ccheck 检查键是否在正确作用域。

实用工具
- quartet：将 Claude Code 拆分为 Architect、Coder、Reviewer、Conflict Resolver 等角色，MIT 许可。
- mdlinkcheck：基于同一工作流构建的链接检查工具。

资源
GitHub
GitHub

#开发者 #工具 #ClaudeCode #设置作用域 #quartet #mdlinkcheck
@DevToolboxHub