配置详解
/config 面板逐项讲解
这是 Claude Code 里 /config 打开的设置面板。下面按作用分成五组,
把每一项讲清楚三件事:它控制什么、该怎么取舍、以及
它对应 settings.json 里的哪个字段——最后这点让你可以直接
写进配置文件,而不必每次进面板点。
关于「直接编辑配置文件」这一列。
面板里的开关最终都会落成 settings.json 的字段。标识为
— 的几项没有稳定的配置字段名,只在面板里可调;
具体字段名以你当前 CLI 版本为准,本页基于 — 整理。
用户级配置在 ~/.claude/settings.json,项目级在
<项目>/.claude/settings.json(可入库、团队共享)。
↔ 表格较宽,可左右滑动查看「怎么选」和「settings.json 字段」两列
一份最小可用的 settings.json
下面是这台机器上用户级配置的实际内容(token 与地址已脱敏)。可以直接拿去做起点—— 把不需要的字段删掉,只有你写进去的才会覆盖默认值。
两个容易被忽略的坑。
其一,permissions.defaultMode 是最影响日常体验的一项,
设成 auto 能挡掉绝大多数无意义的权限弹窗。
其二,多 Agent 项目里 projectInstructions 要设成
claude-md-or-agents-md,否则 AGENTS.md 那份规则读不到。