Claude Code /config：一文搞懂所有可调设置

什么是 /config

Claude Code 里有几十个可调设置，散落在不同地方：全局配置、项目配置、settings.json……如果每个都要手动去改 JSON 文件，那也太折腾了。

/config 就是 Claude Code 的”控制面板”。 输入这一条命令，会弹出一个交互式的设置面板，所有常用配置都在这里，用方向键选择，回车切换，所见即所改。

它的别名是 /settings，两个命令效果完全一样。

怎么打开

在 Claude Code 交互模式下输入：

/config

会弹出一个带三个 Tab 的面板：

• Status —— 当前环境的诊断信息（模型、账户、MCP 连接状态等）
• Config —— 所有可调设置（本文重点）
• Usage —— 用量和额度信息

用 Tab 键或左右方向键切换标签页，Esc 退出面板。

Config 标签页还内置了搜索功能——直接打字就能过滤设置项，在几十个选项里快速定位。

配置项全解

下面按类别逐一拆解 Config 面板里的所有设置。

模型与推理

Model（模型选择）

选择当前会话使用的模型。点击后会弹出模型选择器。

常见选项：

• claude-opus-4-6 —— 最强大脑，复杂任务首选
• claude-sonnet-4-6 —— 速度与智能的平衡
• claude-haiku-4-5 —— 极速低成本

和 /model 命令效果一样，只是入口不同。

Thinking mode（思考模式）

控制是否启用 Extended Thinking（深度思考）。默认开启。

开启后，Claude Code 在回答前会先进行一轮”内心独白”式的推理，适合复杂逻辑和多步骤任务。关闭后响应更快，但推理深度可能下降。

Fast mode（快速模式）

切换快速输出模式。开启后使用同一个模型但输出速度更快。

和 /fast 命令效果一样。

上下文管理

Auto-compact（自动压缩）

控制是否在上下文接近上限时自动压缩对话。默认开启。

开启后，Claude Code 会在 token 快满的时候自动总结历史对话，释放空间。关闭的话你就得手动跑 /compact，否则可能遇到上下文溢出的问题。

建议：保持开启。 除非你有特殊需求（比如调试 compact 行为），否则没有理由关。

Rewind code (checkpoints)（代码回退检查点）

控制是否在 Claude Code 修改文件前自动创建检查点快照。默认开启。

开启后，你可以用 /rewind 命令回退到任意一次修改之前的状态。关闭后 /rewind 将无法回退代码改动——只能回退对话。

建议：保持开启。 这是你的安全网。

权限与安全

Default permission mode（默认权限模式）

这是 /config 里最重要的设置之一，决定了 Claude Code 执行操作时的默认审批策略。

可选值：

• default —— 标准模式，危险操作会弹窗询问你
• plan —— 规划模式，Claude Code 会先制定计划，确认后再执行

权限模式决定了 Claude Code 的”自主程度”。新手建议用 default，熟练后可以根据场景切换。

编辑器与交互

Editor mode（编辑器模式）

选择输入框的编辑模式：

• normal —— 标准模式，常规快捷键
• vim —— Vim 模式，支持 Vim 键位

和 /vim 命令切换效果一样。

Language（语言）

设置 Claude Code 的界面和回复语言。点击后弹出语言选择器。默认为 English。

如果你希望 Claude Code 用中文回复，可以在这里设置。

输出与显示

Theme（主题）

切换 Claude Code 的终端配色主题。点击后弹出主题选择器。

和 /theme 命令效果一样。

Output style（输出风格）

控制 Claude Code 的回复风格。点击后弹出风格选择器。

和 /output-style 命令效果一样。你可以选择更简洁或更详细的回复风格。

Verbose output（详细输出）

开启后，Claude Code 会显示更多的调试信息——比如工具调用的详细参数、API 请求的元信息等。

默认关闭。 除非你在排查问题，否则不需要开启。

Show turn duration（显示回合耗时）

开启后，每次 Claude Code 回复完毕会显示这轮回复花了多长时间（类似 “Cooked for 1m 6s”）。

默认关闭。 想知道 Claude Code 每次思考了多久就打开它。

Show tips（显示提示）

控制 Claude Code 在加载/思考时是否显示 tips 提示。默认开启。

那些在等待时弹出来的小知识和小技巧——如果你觉得太啰嗦，可以关掉。

Reduce motion（减少动效）

开启后减少终端中的动画效果。如果你用的终端对动画支持不好，或者你单纯觉得动画分散注意力，可以开启。

Terminal progress bar（终端进度条）

控制是否在终端标题栏或标签页中显示进度信息。默认开启。

开启后你在终端的标签上就能一眼看到 Claude Code 当前的状态，不用切过去。

Show PR status footer（显示 PR 状态栏）

控制是否在底部显示当前 PR 的状态信息。默认开启。

如果你的工作流涉及 GitHub PR，这个信息很有用。

文件与版本控制

Respect .gitignore in file picker（文件选择器遵循 .gitignore）

控制 Claude Code 在搜索和浏览文件时是否忽略 .gitignore 中列出的文件。默认开启。

开启后，node_modules、dist 等目录不会出现在 Claude Code 的搜索结果里。如果你确实需要 Claude Code 看到这些文件，可以关闭。

复制与分享

Always copy full response（总是复制完整回复）

控制 /copy 命令的行为：

• 关闭（默认） —— /copy 会弹出选择器让你选复制哪部分
• 开启 —— /copy 直接复制整个最后回复，跳过选择

如果你每次 /copy 都是选”全部”，那就开启它省一步。

通知

Notifications（通知渠道）

设置 Claude Code 完成任务后的通知方式：

• auto —— 自动检测终端类型，选择最佳通知方式
• iterm2 —— 使用 iTerm2 的通知系统
• terminal_bell —— 使用终端响铃
• iterm2_with_bell —— iTerm2 通知 + 终端响铃
• kitty —— 使用 Kitty 终端通知
• ghostty —— 使用 Ghostty 终端通知
• notifications_disabled —— 关闭通知

如果你经常在后台跑 Claude Code 任务，选一个适合你终端的通知方式会很有用。

自动更新

Auto-update channel（自动更新频道）

控制 Claude Code 的自动更新行为：

• latest —— 默认，自动更新到最新稳定版
• beta —— 更新到 beta 频道，提前体验新功能
• 也可以降级到特定频道

如果你更看重稳定性，保持 latest 就好。想尝鲜就切到 beta。

IDE 集成

External includes（外部引用）

如果你的 CLAUDE.md 中引用了外部文件（通过 @import 语法），这个开关控制是否加载这些外部内容。

配置的存储位置

/config 里修改的设置会自动保存到对应的配置文件中。理解这些文件的关系对高级用户很有帮助：

配置文件层级

Claude Code 的设置来自 5 个层级，后面的覆盖前面的：

层级	文件路径	说明
User	~/.claude/settings.json	全局用户设置，影响所有项目
Project	<项目>/.claude/settings.json	项目级设置，可以提交到 Git 和团队共享
Local	<项目>/.claude/settings.local.json	项目级本地设置，已 gitignore，不共享
Flag	--settings 参数指定的文件	命令行临时指定
Managed	企业托管设置	企业管理员远程下发，优先级最高

全局配置

除了 settings.json，Claude Code 还有一个全局配置文件 ~/.claude/config.json，存储一些全局偏好：

• 主题、编辑器模式
• 自动压缩开关
• 详细输出开关
• 通知渠道偏好
• 检查点开关
• 回合耗时显示
• 等等

/config 面板里修改的大部分布尔开关都写在这个文件里。

手动编辑 vs /config 面板

你完全可以直接编辑这些 JSON 文件来修改配置。但 /config 面板的好处是：

• 不用记字段名 —— 面板里列出了所有可调项，选就是了
• 即时生效 —— 修改后立即生效，不需要重启
• 有安全校验 —— 面板只会写入合法的值，不会搞坏配置文件
• Esc 可回退 —— 如果改了不满意，Esc 退出会自动撤销本次所有修改

实用技巧

技巧一：用搜索快速定位

Config 面板默认就在搜索模式。直接打字就能过滤——比如输入 compact 立刻定位到自动压缩的开关，不用在几十个选项里翻找。

技巧二：Esc 是你的后悔药

在 /config 面板里改了一堆设置，突然不想要了？直接按 Esc，所有修改会自动回退到进入面板前的状态。这个设计很贴心——你可以放心地试各种配置，不满意就 Esc 全部撤销。

技巧三：团队协作时善用分层配置

如果你的团队要统一某些 Claude Code 配置：

1. 把共享设置写到项目的 .claude/settings.json，提交到 Git
2. 把个人偏好写到 .claude/settings.local.json，不会被提交
3. 全局通用的设置放在 ~/.claude/settings.json

这样团队有统一的基线配置，每个人又能保留自己的偏好，互不干扰。

技巧四：结合 /status 看全局状态

/config 面板的 Status 标签页其实就是 /status 命令的内容。在改配置之前，先切到 Status 看看当前环境的整体状态——模型、账户、MCP 连接、诊断信息——心里有数再动手改。

/config vs 直接编辑 JSON vs 其他命令

方式	适用场景
/config 面板	日常调整，可视化浏览所有选项
编辑 settings.json	批量配置权限规则、hooks、MCP 服务器等复杂结构
/theme /model /vim 等	只想改某一个特定设置，更快
claude --settings <file>	临时使用特定配置启动

写在最后

/config 是 Claude Code 里最容易被忽略的命令之一——很多人用了几个月都没打开过。但它其实是你和 Claude Code “磨合”的关键入口。

每个人的开发习惯不同：有人喜欢 Vim 键位，有人讨厌动画，有人希望通知响铃，有人想要更详细的输出……这些”小偏好”累积起来，直接决定了你用 Claude Code 舒不舒服。

花两分钟打开 /config，过一遍所有选项，把它调成你最顺手的样子。好工具值得被认真配置。