配置概览
Claude Code 的配置按优先级从高到低合并:
| 级别 | 位置 | 谁控制 |
|---|---|---|
| Managed | 组织下发 | IT / 管理员 |
| Command line | 启动参数 | 当前命令 |
| Local | .claude/settings.local.json | 你本人(勿提交) |
| Project | .claude/settings.json | 团队(可进 Git) |
| User | ~/.claude/settings.json | 你本人 |
冲突时:Managed 覆盖一切,其次是命令行参数、本地覆盖、项目配置、用户配置。具体字段仍以官方 Configuration 文档为准。
在 claude 会话中输入:
/config可图形化查看与修改部分选项。
如果你想确认当前会话到底加载了哪些配置来源,使用:
/statusStatus 面板会显示本轮会话读取到的 settings 来源,例如 User settings、Project settings 或 Managed settings。
常见需求对照
Section titled “常见需求对照”| 我想… | 看哪里 |
|---|---|
| 统一团队权限 | Project settings.json |
| 个人默认模型 | User settings |
| 本机临时覆盖 | Local settings |
| 企业强制策略 | Managed settings |
| 本次命令临时指定行为 | CLI flags |
示例:项目级 settings
Section titled “示例:项目级 settings”.claude/settings.json:
{ "permissions": { "allow": ["Read", "Grep", "Glob"], "deny": ["WebFetch"] }}字段以官方 schema 为准,升级后可能有新增项。
配置文件怎么分工?
Section titled “配置文件怎么分工?”- User:你的个人偏好,例如默认行为、常用工具规则。
- Project:团队希望每个人共享的规则,例如禁止修改某些目录、统一允许测试命令。
- Local:只适合你这台机器的内容,例如本地路径、临时实验、不能提交的覆盖项。
- Managed:组织级强制策略,通常由管理员维护。
不要把密钥写进 Project settings。项目级配置会进入 Git,适合共享规则,不适合共享凭据。