输入 /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每种类型操作首次执行时询问★★☆
PlanClaude 先生成执行计划,等你审批后再动手★☆☆

如何选择:

  • 日常使用最推荐 Ask — 首次同类操作确认后,同类操作不再弹窗;兼顾安全和效率
  • 刚入门Plan,每步都经过你审查,最安全
  • 信任 Claude 且代码已提交Don't Ask(你当前的设定),开发体验最流畅,但务必确保:
    • 代码有 Git 版本控制
    • 不在生产服务器上使用此模式
    • 定期检查改动内容

⚠️ Don't Ask = Claude 可以自由编辑任何文件、执行任何命令。只建议在个人开发机 + 代码已提交的环境下使用。


11. Worktree base ref — 工作树基准分支

当使用工作树(worktree)隔离功能时,新工作树基于哪个引用创建。

行为
freshorigin/<默认分支>(通常是 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标准文本输入,像普通聊天框一样
vimVim 键绑定(hjkl 移动、Esc 切换模式等)
emacsEmacs 键绑定

建议:

  • 不写 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 操控浏览器,如自动测试网页)。

行为
trueClaude 可以通过浏览器工具与 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
显示与 UIShow 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 菜单中。

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐