Claude Code 指南 v—

配置详解

/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 那份规则读不到。