Claude Code / 参考
Claude Code 配置
配置用于管理权限、默认行为、项目规则、工具连接和输出偏好。
设置文件层级
Claude Code 设置可以来自用户、项目、本地、托管设置和环境变量。不同层级有不同范围，企业托管设置可能强制覆盖或限制本地配置。
| 设置来源 | 适合内容 |
|---|---|
| 用户设置 | 个人默认模式、环境、偏好。 |
| 项目设置 | 团队共享的权限、Hooks、项目行为。 |
| 本地设置 | 不提交的个人覆盖或机器相关值。 |
| 托管设置 | 组织强制策略和安全边界。 |
| 环境变量 | 一次性或运行时配置。 |
常见关键设置
常见设置包括 defaultMode、autoCompactEnabled、autoMemoryEnabled、availableModels、env、hooks、permissions、model、output style 和插件相关配置。
- permissions.defaultMode 决定默认权限模式。
- autoCompactEnabled 影响长会话是否自动压缩。
- env 可以为 Claude 进程设置环境变量。
- hooks 定义工具调用前后的自动化。
- availableModels 可限制用户可选模型。
安全编辑设置
不要把密钥写进可提交项目设置。仓库签入的设置应保守，个人 token、临时环境变量和本机路径放本地或用户级配置。
{
"permissions": {
"defaultMode": "plan"
},
"env": {
"NODE_ENV": "development"
}
}完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
Settings 细节
Claude Code 设置来源包括用户、项目、本地、托管设置和环境变量。它们共同决定默认权限模式、环境变量、hooks、availableModels、autoCompact、autoMemory、output style、插件和工具行为。
项目可提交设置应保守，适合团队共享的默认行为和安全边界；本地设置适合个人机器路径或临时覆盖；托管设置适合组织强制策略；环境变量适合一次性运行或 CI。
安全原则：不要提交密钥；不要把 bypass 或高风险权限作为项目默认；涉及生产系统、删除、部署、迁移的操作应由权限规则或 Hooks 明确控制。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“Claude Code 配置”放回 Claude Code 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是配置或参考页面，要特别确认配置放在哪里、是否会被提交、是否包含敏感信息、是否会扩大默认权限，以及如何在失败时排查实际生效的设置。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 CLAUDE.md，哪些运行行为应该交给 settings、permissions、Hooks、Skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Claude Code 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。