大多数开发者装完 Claude Code 之后，直接开始敲提示词，从来没看过有哪些可配置的选项。这其实是个不小的浪费——默认安装虽然能用，但错过了很多"如果早知道就会打开"的功能。
Claude Code 的配置分布在两处：一部分在 /settings 菜单里可见，另一部分藏在配置文件中，涉及权限管理、记忆、通知、上下文处理等方方面面。把该开的选项开好，能显著减少日常使用中的摩擦感。
下面这 12 项配置，建议现在就动手设置。
配置文件放在哪儿
Claude Code 的配置分两层：
- 全局设置
：~/.claude/settings.json，作用于本机所有项目
- 项目设置
：项目根目录下的 .claude/settings.json，只作用于当前项目，可以覆盖全局设置
这两个文件都能直接编辑,也可以在会话中用 /settings 命令交互式修改。部分设置还支持环境变量,少数行为则要靠启动时的命令行参数(比如 --verbose)来控制。
1. 打开桌面通知
作用:任务跑完后弹出系统级通知。
这个设置听着不起眼,用起来却很实在。当 Claude 在重构大型代码库或跑长时间分析时,原本你得时不时切回终端看进度。开了通知之后,任务一完成系统就会提醒你,可以放心去做别的事,不用干等着。
开启方式:在 ~/.claude/settings.json 中加入
{ "notifications": true }
也可以用 /settings 交互式开启。macOS 用户可能还需要在系统设置里单独允许终端发通知。
2. 配置 Bash 黑名单(deny rules)
作用:禁止 Claude 执行指定的 bash 命令,哪怕任务逻辑上"需要"用到它。
这是目前最实用的安全设置之一。你可以列出一份 Claude 永远不能执行的命令清单,常见的有 rm -rf、git push --force、sudo、chmod 777,以及各种破坏性的数据库操作。
{
"bash": {
"deniedCommands": [
"rm -rf",
"git push --force",
"sudo",
"DROP TABLE",
"truncate"
]
}
}
匹配到黑名单里的命令会被直接拦截,Claude 会告诉你它不能执行,剩下的交给你手动判断。在生产环境或某些操作绝不该自动触发的代码库里,项目级黑名单尤其有用。
3. 设置 Bash 白名单(allow rules)
作用:自动放行指定命令,不用每次都手动确认。
这是黑名单的反面。如果你反复要跑同样的安全命令——比如 npm test、git status、ls、cat——可以直接告诉 Claude Code 无需询问、直接放行。
{
"bash": {
"allowedCommands": [
"npm test",
"npm run lint",
"git status",
"git diff",
"ls",
"cat",
"echo"
]
}
}
粒度可以设得很细,比如 git status 和 git push 是两回事,放行前者完全不影响后者仍需确认。
4. 调整自动压缩阈值(Auto-Compact Threshold)
作用:控制 Claude Code 何时自动压缩对话上下文以释放 token 空间。
Claude Code 的上下文窗口是有限的。会话进行得久了,容易触及上限,导致响应变慢甚至丢失关键上下文。自动压缩会在真正撞墙之前介入,把前面的对话内容总结精简,腾出空间。
{ "autoCompactThreshold": 80 }
数值是百分比(0-100)。设成 80 意味着上下文占用达到 80% 时开始压缩。数值越低(比如 60)压缩越激进,预留的余量越大;数值越高(比如 90)则能保留更多原始上下文。做复杂的多文件重构时建议调低阈值以保持会话稳定;做简单问答时调高一些也无妨。
5. 锁定指定模型
作用:把 Claude Code 固定在某个具体模型上,而不是跟着 Anthropic 的默认推荐走。
Claude Code 可以运行在不同的模型变体上,并且随着新模型发布还会不断更新。默认情况下它通常会使用官方推荐的模型,但这个推荐可能随更新而变化。如果你需要跨会话保持行为一致,锁定模型是值得的。
{ "model": "claude-sonnet-4-5" }
模型字符串要和 Anthropic API 里的写法完全一致,建议去官方模型文档核对最新的可用列表。另外,如果你的使用量比较大,把默认模型锁定在 Sonnet 而不是 Opus,对大多数编码任务来说也是一种更快、更省钱的选择。
6. 为项目创建 CLAUDE.md 文件
作用:给 Claude 一份持久化的、项目专属的说明书,每次会话开始时都会读取。
这不算严格意义上的"设置文件",但可能是影响力最大的一项配置。项目根目录下的 CLAUDE.md 相当于该项目专属的持久系统提示词。
你可以在里面写清楚:
项目使用的技术栈
命名规范和代码风格
哪些文件或目录不能碰
常见任务及你偏好的处理方式
业务领域的背景知识
示例:
# 项目:支付 API
## 技术栈
- Node.js 20, TypeScript 5.3
- PostgreSQL 15,通过 Prisma ORM
- Express 4.x
## 规范
- 使用 async/await,不用 .then() 链式调用
- 所有数据库调用放在 /src/db,不要写在 controller 里
- 错误必须使用自定义的 AppError 类
- 绝不记录敏感数据(卡号、PAN、CVV)
## 禁区
- 不要直接修改 /migrations——一律用 `prisma migrate dev`
- 不要动 /src/legacy——已废弃,即将删除
## 测试
- 提交前先跑 `npm test`
- 覆盖率不能低于 80%
每次在该目录下开新会话,Claude 都会自动读取这份文件,这样你就不用每次都重新解释一遍项目情况了。
7. 开启详细模式(Verbose Mode)
作用:展示 Claude 每次工具调用的完整细节——执行了什么命令、结果是什么、接下来打算做什么。
默认情况下 Claude Code 只给你一份相对精简的摘要。详细模式会把完整过程都摊开:每一条 bash 命令、文件读写、工具调用及其原始输出。这对调试 Claude 的行为、审查它在某次会话里到底做了什么、或者排查问题根源非常有用。
{ "verbose": true }
或者启动时加参数:
claude --verbose
如果只是偶尔需要详细模式而不想一直开着,用启动参数比全局设置更干净。
8. 配置 MCP 服务器连接
作用:通过 Model Context Protocol(模型上下文协议)把 Claude Code 接入外部工具和数据源。
MCP 是一个开放标准,让 Claude 能够连接数据库、API、文档系统、内部工具等外部系统,并把它们当作会话中的一等工具来使用。默认情况下 Claude Code 只能读文件、跑 bash;配置好 MCP 服务器后,它还能直接查询 Postgres 数据库、拉取 Notion 工作区内容、检查 GitHub issue,或调用任何提供了 MCP 服务器的服务。
配置写在 ~/.claude/claude_desktop_config.json(具体路径视你的安装方式而定):
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}
Anthropic 维护着一份不断增长的官方 MCP 服务器列表,社区也贡献了很多。如果你的工作涉及多个系统协同,这块配置的投入产出比非常高。
9. 打开自动更新
作用:让 Claude Code 保持自动更新,始终用上最新版本。
道理很简单。Claude Code 更新频繁——新模型支持、bug 修复、新功能、性能优化,手动更新很容易被忘掉。
{ "autoUpdate": true }
如果是需要锁定特定版本的环境(比如 CI 系统),建议关闭这项、手动管理更新版本;而本地开发机上开启自动更新通常是更合理的选择。
10. 设置终端主题
作用:调整 Claude Code 在终端里的显示效果,对使用浅色背景终端或自定义配色方案的用户尤其有用。
默认主题是为深色终端设计的,如果你用的是浅色背景,部分输出可能几乎看不清。
{ "theme": "light" }
可选项通常有 "dark"、"light" 和 "auto"(自动检测系统偏好)。这属于外观层面的调整,但如果你要长时间盯着输出看,这一点其实很重要。
11. 添加全局系统提示词
作用:在每次会话前都自动附加一段固定指令,不区分具体项目。
和 CLAUDE.md 类似,但作用在全局层面。适合放跨项目通用的偏好设置——比如沟通风格、个人编码习惯、你希望处处遵守的通用约束。
可以通过 --system-prompt 参数传入,也可以写进全局设置。部分版本支持 systemPrompt 字段:
{
"systemPrompt": "你是一名资深工程师。
做出重大修改前先说明取舍。优先采用小步增量修改,而非大规模重写。
标注出任何可能影响现有测试的改动。"
}
项目里的 CLAUDE.md 是对这份全局提示词的补充,而不是替代。
12. 配置 CI/自动化场景下的权限模式
作用:让 Claude Code 能在 CI 流水线或脚本中非交互式运行,不必每一步都等待人工确认。
默认情况下,Claude Code 遇到某些操作会主动请求你的批准,这在交互式使用中是合理的,但会打断自动化流水线。在受信任、受控的环境里,可以跳过这个交互确认环节:
claude --dangerously-skip-permissions "run the test suite and report failures"
这个参数要谨慎使用。名字里的"dangerously"不是随便加的——它去掉了人工把关这道保险。建议只在以下场景使用:
范围受到严格控制的 CI/CD 环境
操作集合已知且有限的自动化脚本
出错影响范围可控的沙箱容器
在生产系统里,建议把这个参数和第 2 条的 bash 黑名单搭配使用,这样即便跳过了权限确认,Claude 依然无法执行破坏性命令。
综合起来:一份推荐的起始配置
给大多数开发者的合理基线 ~/.claude/settings.json:
{
"notifications": true,
"verbose": false,
"autoUpdate": true,
"theme": "auto",
"autoCompactThreshold": 75,
"bash": {
"deniedCommands": [
"rm -rf",
"git push --force",
"sudo",
"DROP TABLE"
],
"allowedCommands": [
"git status",
"git diff",
"npm test",
"npm run lint",
"ls",
"cat",
"echo"
]
}
}
在此基础上,再为每个项目加一份专属的 CLAUDE.md,并按需配置 MCP 服务器。
配置 Claude Code 时常见的几个坑
只用全局设置,不做项目级配置全局设置只是打底,真正的精细化控制要靠项目级的 .claude/settings.json。稍微正式一点的项目都应该有自己的独立配置。
白名单设得太宽泛如果直接把 git 整个加进白名单,相当于连 git push、git reset --hard 都一并放行了。应该按具体命令来:git status、git diff 是安全的,git push、git rebase 大概率不该被自动批准。
忘了把 CLAUDE.md 提交到版本库CLAUDE.md 里的内容很有价值,记得把它纳入版本控制,这样团队里其他人用 Claude Code 时也能获得一致的行为。
开发阶段就用 --dangerously-skip-permissions本地开发时跳过确认提示看起来很诱人,但不建议这么做。这些确认环节存在的意义,正是为了拦住 Claude 理解偏差的情况。交互式会话中,还是让确认机制保持开启比较稳妥。
小结
- 通知和详细模式
是立竿见影的小改动,能明显减少日常使用中的摩擦。
- Bash 黑白名单
能让你对 Claude 能做什么、不能做什么有精细的掌控,建议优先设置。
- CLAUDE.md 文件
是让 Claude 在项目中保持一致、贴合上下文的行为的最有效手段,没有之一。
- 自动压缩阈值
能避免长会话中因上下文问题导致的失败——如果你经常做复杂的多文件工作,建议调低阈值。
- MCP 服务器配置
是 Claude Code 能力真正被放大的地方,基础配置稳定之后值得深入研究。
- --dangerously-skip-permissions 只在受控、沙箱化的环境中使用
,并且一定要搭配黑名单规则。
更多transformer，VIT，swin tranformer 参考头条号：人工智能研究所 v号：人工智能研究Suo, 启示AI科技动画详解transformer 在线视频教程
