Claude Code 配置全解析（24 项）
输入 /config 会打开 Claude Code 的交互式配置菜单，共 24 个配置项。本文将按实际顺序逐一解析每个选项的含义、可选值、以及根据使用场景的设定建议。
配置层级
| 层级 | 文件 | 作用范围 |
|---|---|---|
| 全局 | ~/.claude/settings.json |
所有项目 |
| 项目级 | <项目>/.claude/settings.local.json |
仅当前项目 |
/config 修改的是全局配置。如果某个项目需要不一样的设置，手动编辑项目级 settings.local.json 覆盖即可。
配置项详解（按 /config 菜单顺序）
1. Auto-compact — 自动压缩上下文
当对话历史接近上下文窗口上限时，是否自动触发压缩（总结历史、释放空间）。
| 值 | 行为 |
|---|---|
true |
自动压缩，避免对话因超出上下文窗口而中断 |
false |
不自动压缩，需要手动执行 /compact |
如何选择：
- 推荐
false— 自动压缩会不可逆地丢失对话细节，手动/compact更有掌控感 - 如果你经常开超长对话（连续几小时不停）且懒得管，可以开
true
2. Show tips — 显示操作提示
是否在界面中展示使用技巧提示（如快捷键提醒、新功能引导）。
| 值 | 行为 |
|---|---|
true |
界面中偶尔出现提示信息 |
false |
关闭所有提示 |
建议： 新手开 true，上手后关掉（false），界面更干净。
3. Reduce motion — 减少动画动效
减少终端中的 UI 动画效果（如加载动画、过渡效果）。
| 值 | 行为 |
|---|---|
true |
禁用或减弱动效 |
false |
正常动效 |
建议： 一般开 false 即可。如果你对动画敏感或用性能较弱的终端，开 true。
4. Thinking mode — 思考模式（思维链）
是否展示 Claude 的"思考过程"——即在给出最终回复前，模型内部推理的中间步骤。
| 值 | 行为 |
|---|---|
true |
显示模型的思考过程（思维链），可以看到它分析问题的步骤 |
false |
只显示最终回复 |
如何选择：
- 强烈推荐
true— 这是 Claude Code 最独特的体验之一，你能看到模型"怎么想的"：它读了哪些文件、如何分析问题、为什么选择了这个方案。对学习和审核都极有帮助 - 如果你只想要结果、不想被思考过程干扰，可以关掉
5. Session recap — 会话回顾
在每次会话结束时，是否自动生成该次对话的摘要回顾。
| 值 | 行为 |
|---|---|
true |
会话结束时输出摘要 |
false |
不输出 |
建议： 开 true，有助于回顾这一轮做了什么改动、解决了什么问题。
6. Rewind code (checkpoints) — 代码回退（检查点）
Claude Code 在每次编辑文件前自动保存检查点，出错后可回退到之前的代码状态。
| 值 | 行为 |
|---|---|
true |
每次编辑前建检查点，支持 /rewind 回退 |
false |
不建检查点，改了就改了 |
如何选择：
- 强烈推荐
true— 这是安全网。Claude 改了你不想要的东西，用/rewind直接撤销，不需要手动 git checkout - 开启后几乎无性能开销
7. Verbose output — 详细输出
是否输出更底层的调试信息（API 请求详情、内部日志）。
| 值 | 行为 |
|---|---|
true |
输出详细调试信息，适合排查问题 |
false |
正常输出 |
建议： 日常 false。调试 Skill、排查 API 问题、或者好奇 Claude Code 内部做了什么时临时开 true。
8. Terminal progress bar — 终端进度条
是否在长时间操作时显示进度条（如模型下载、大文件处理）。
| 值 | 行为 |
|---|---|
true |
显示进度条 |
false |
不显示 |
建议： 开 true，能看到任务进展，不会误以为卡住了。
9. Show turn duration — 显示每轮耗时
每次 Claude 回复后，是否显示该轮花费的时间。
| 值 | 行为 |
|---|---|
true |
显示耗时（如 “Turn completed in 12.3s”） |
false |
不显示 |
建议： 开 true，对评估模型速度很有用（比如对比 haiku vs sonnet 的响应时间）。
10. Default permission mode — 默认权限模式 ⚠️ 核心安全项
Claude 执行文件编辑、Bash 命令等工具时，是否先征求你的同意。
| 模式 | 行为 | 风险 |
|---|---|---|
Don't Ask |
跳过一切权限弹窗，直接执行所有操作 | ★★★ |
Ask |
每种类型操作首次执行时询问 | ★★☆ |
Plan |
Claude 先生成执行计划，等你审批后再动手 | ★☆☆ |
如何选择：
- 日常使用最推荐
Ask— 首次同类操作确认后，同类操作不再弹窗；兼顾安全和效率 - 刚入门 →
Plan，每步都经过你审查，最安全 - 信任 Claude 且代码已提交 →
Don't Ask（你当前的设定），开发体验最流畅，但务必确保：- 代码有 Git 版本控制
- 不在生产服务器上使用此模式
- 定期检查改动内容
⚠️
Don't Ask= Claude 可以自由编辑任何文件、执行任何命令。只建议在个人开发机 + 代码已提交的环境下使用。
11. Worktree base ref — 工作树基准分支
当使用工作树（worktree）隔离功能时，新工作树基于哪个引用创建。
| 值 | 行为 |
|---|---|
fresh |
从 origin/<默认分支>（通常是 main/master）创建 |
head |
从你当前的本地 HEAD 创建 |
建议：
- 大部分情况用
fresh，确保工作树环境干净 - 如果需要在当前分支基础上做实验，选
head
12. Respect .gitignore in file picker — 文件选择器遵循 .gitignore
使用 /add 或文件选择器时，是否自动隐藏 .gitignore 中的文件（如 node_modules/、dist/）。
| 值 | 行为 |
|---|---|
true |
忽略 .gitignore 中的文件，保持选择器干净 |
false |
显示所有文件 |
建议： 开 true，避免把 node_modules、.env 等不该出现的东西误加入上下文。
13. Skip the /copy picker — 跳过 /copy 选择器
执行 /copy 命令时，是否跳过交互式文件选择器，直接复制最后输出的内容。
| 值 | 行为 |
|---|---|
true |
跳过选择器，直接复制 |
false |
弹出选择器让你选要复制什么 |
建议： false（默认），保留选择器的灵活性。如果你频繁用 /copy 且每次都选同一项，可以开 true。
14. Auto-update channel — 自动更新通道
决定 Claude Code 从哪个通道接收自动更新。
| 值 | 说明 |
|---|---|
stable |
稳定版，经过充分测试 |
beta |
测试版，提前体验新功能但不保证稳定 |
dev |
开发版，每天更新，可能有 bug |
建议：
- 主力工作环境 →
stable - 想尝鲜、能接受偶尔出问题 →
beta
15. Theme — 主题
终端 UI 的配色方案。
| 值 | 说明 |
|---|---|
Dark mode |
深色背景，适合暗色终端 |
Light mode |
浅色背景 |
System |
跟随系统设置 |
建议： 你用的是 Dark mode，和大多数开发者的终端一致，保持即可。
16. Local notifications — 本地通知
Claude 完成长任务后如何通知你。
| 值 | 行为 |
|---|---|
Terminal Bell (\a) |
终端响铃 |
System notification |
系统桌面通知 |
None |
不通知 |
建议：
- 终端始终在眼前的 →
Terminal Bell - 常切到其他窗口等结果 →
System notification
17. Output style — 输出风格
控制 Claude 输出的文字排版风格。
| 值 | 说明 |
|---|---|
default |
标准输出风格 |
compact |
精简输出，减少换行和装饰 |
explanation |
详细解释模式 |
建议： default 即可。如果你觉得 Claude 话太少，切 explanation；话太多，切 compact。
18. Language — 语言
Claude 回复你所用的语言。
| 值 | 说明 |
|---|---|
中文 |
始终用中文回复 |
English |
始终用英文 |
auto |
匹配用户输入的语言 |
建议： 中文 适合你当前的使用场景。做国际项目时切 English。
19. Editor mode — 编辑器模式
输入框的编辑行为模式。
| 值 | 说明 |
|---|---|
normal |
标准文本输入，像普通聊天框一样 |
vim |
Vim 键绑定（hjkl 移动、Esc 切换模式等） |
emacs |
Emacs 键绑定 |
建议：
- 不写 Vim / Emacs →
normal - Vim 用户 →
vim，在 Claude Code 输入框里享受熟悉的编辑体验
20. Show last response in external editor — 在外部编辑器中显示最后回复
是否允许将上一次 Claude 的回复内容发送到外部编辑器（如 VS Code、Notepad++）中查看和编辑。
| 值 | 行为 |
|---|---|
true |
可以用外部编辑器打开 Claude 的回复 |
false |
不支持此功能 |
建议： 如果你经常需要复制大段 Claude 回复去别的地方用 → 开 true。否则 false 即可。
21. Show PR status footer — 显示 PR 状态页脚
在 Claude Code 底部状态栏是否显示关联 Pull Request 的状态（打开/合并/关闭）。
| 值 | 行为 |
|---|---|
true |
底部显示 PR 状态 |
false |
不显示 |
建议： 如果你用 GitHub/GitLab 且经常让 Claude 处理 PR → 开 true。纯写代码不用 PR 功能 → false 省空间。
22. Model — 模型选择
决定驱动 Claude Code 的 AI 模型。
| 可选值 | 特点 | 适用场景 |
|---|---|---|
haiku |
最快、最便宜 | 简单问答、小修改 |
sonnet |
速度与质量均衡 | 日常开发（推荐） |
opus |
推理能力最强 | 架构设计、代码审查 |
deepseek-v4-pro 等自定义 |
取决于 API 代理 | 使用第三方 API |
你当前用的是 deepseek-v4-pro，通过自定义 API 端点接入。
⚠️ 切换模型会清空当前会话上下文，切换前建议先
/compact。
23. Auto-connect to IDE (external terminal) — 自动连接到 IDE
从 VS Code 或 JetBrains 的外部终端启动 Claude Code 时，是否自动建立与 IDE 的通信连接。
| 值 | 行为 |
|---|---|
true |
自动连接 IDE，Claude 可以直接读取 IDE 中打开的文件 |
false |
不自动连接 |
建议：
- 在 IDE 的内置终端中使用 Claude Code → 开
true，体验更好 - 在独立终端窗口（如 Windows Terminal）中 →
false即可
24. Claude in Chrome enabled by default — 默认启用在 Chrome 中使用 Claude
是否默认启用 Claude Code 的 Chrome 浏览器集成（允许 Claude 操控浏览器，如自动测试网页）。
| 值 | 行为 |
|---|---|
true |
Claude 可以通过浏览器工具与 Chrome 交互 |
false |
禁用 Chrome 集成 |
建议：
- 需要 Claude 帮你测试网页、截图、操作 Web 应用 → 开
true - 不做 Web 开发 →
false
场景化推荐配置
场景一：安全第一（新手 / 谨慎型）
Auto-compact: false
Default permission mode: Ask
Verbose output: false
Thinking mode: true
Rewind code: true
Show tips: true
Auto-update channel: stable
Theme: Dark mode
Language: 中文
Editor mode: normal
Model: sonnet
场景二：高效开发（你的当前设定）
Auto-compact: false
Default permission mode: Don't Ask
Thinking mode: true
Rewind code: true
Show tips: false
Terminal progress bar: true
Show turn duration: true
Auto-update channel: stable
Theme: Dark mode
Language: 中文
Model: deepseek-v4-pro
场景三：写文档 / 非代码任务
Default permission mode: Don't Ask
Thinking mode: false
Verbose output: false
Terminal progress bar: false
Show turn duration: false
Output style: compact
Model: haiku
总结：24 项分类速查
| 分类 | 包含项 |
|---|---|
| 会话管理 | Auto-compact、Session recap、Rewind code |
| 显示与 UI | Show tips、Reduce motion、Terminal progress bar、Show turn duration、Theme、Show PR status footer |
| 思考与输出 | Thinking mode、Verbose output、Output style |
| 权限与安全 | Default permission mode |
| 编辑器集成 | Editor mode、Show last response in external editor、Auto-connect to IDE |
| Git 相关 | Worktree base ref、Respect .gitignore in file picker |
| 更新与通知 | Auto-update channel、Local notifications |
| 文件操作 | Skip the /copy picker |
| 核心引擎 | Model、Language |
| 浏览器集成 | Claude in Chrome enabled by default |
这 24 项覆盖了 Claude Code 的全部图形化配置。更高级的功能（hooks、permissions 白名单、env 环境变量）需要直接编辑 settings.json，不在 /config 菜单中。
汇聚全球AI编程工具，助力开发者即刻编程。
更多推荐
10
0- 0
已为社区贡献1条内容
所有评论(0)