农民伯伯抱着 Claude 图标

讲给长辈听的 Claude Code

保留原导航结构,逐页翻成能听懂的大白话。

Configuration

Configuration 各种配置

各种设置项怎么调。

原页来源: 官方 Settings

一句人话

这一页讲的是 Claude Code 身上那些旋钮、开关、挡位,到底该去哪里拧、谁说了算。

像一台拖拉机,不只是会不会点火,还得知道油门、离合、档位、限速器分别在哪儿,不然不是跑不动,就是冲沟里去。

官方先讲了一件很重要的事:配置有先后顺序

不是所有设置都平起平坐。一般是谁离当前项目越近,谁说话越响。

项目里的配置,通常比全局配置更管用;命令行临时带上的参数,又可能比文件里的默认值更优先。

你可以把它理解成三层规矩:村里总规矩、你家院里规矩、眼前这次临时交代。离现场越近,优先级往往越高。

常见配置都在管什么

模型和推理相关

比如默认用哪个模型、是否启用某些实验特性。这决定它脑子用哪种档位。

权限和安全相关

比如默认能不能执行某类命令、哪些目录能碰、危险操作要不要再确认。这决定它拿到多大一把钥匙。

输出和交互相关

比如界面怎么显示、日志怎么记、通知怎么发。这决定你看它干活时顺不顺眼。

网络和服务相关

比如 API 地址、代理、第三方服务入口。这决定它出门能不能找到路。

官方为什么还要分本地、全局、项目级

因为有些规矩是你个人习惯,有些规矩是整个团队的共识,有些规矩只适合这一个仓库。

比如“我喜欢某种显示方式”适合放全局;“这个仓库必须先跑测试再提交”更适合放项目里。

这么分层的好处,是既不让每个项目都从零配,也不至于一条全局配置把所有仓库都绑死。

配置时最容易犯的错

1. 不知道优先级,改了全局还纳闷为什么项目里没反应。

2. 想图省事,把权限开得太大,结果帮工能动的地方比你预想得多。

3. 把团队规则只写在自己机器上,别人一拉仓库根本接不到这些约束。

4. 配置文件堆太多、太散,最后连自己都不知道哪个开关在哪儿。

实用记法

个人口味放全局,项目规矩放项目,临时试验用命令行参数盖一下。

牵涉权限和安全的配置,宁可先收紧,再按需要慢慢放开。

一句话记住:配置不是越多越高级,而是越清楚、越分层、越不容易误伤,才越好用。