它到底是什么

/config 是 Claude Code 会话内的 slash 命令，输入后立即打开一个分 tab 的交互式设置界面，无需手动编辑 JSON 文件即可查看并修改偏好项。变更自动持久化到对应作用域的 settings.json，且运行中的会话对大多数键(most keys)无需重启即可热加载——少数键例外:model 在会话启动时读取一次、下次重启才生效(会话内切换用 /model),outputStyle 需 /clear 或重启。

官方文档将其归类于会话内命令，强调它是"不想直接改 JSON 时"修改常用配置的首选入口。截至 2026-06-14 可访问的官方文档未记录 /settings 作为此命令的别名。

怎么触发 / 怎么使用

在 Claude Code 交互式 REPL 中输入：

/config

回车后进入设置 UI，可用键盘导航各 tab 和选项。此命令不接受任何参数。

保存 / 配置 / 集成

设置的持久化范围

/config 界面内的更改根据作用域写入不同文件：

优先级（高 → 低,官方共 5 层）：Managed/policy（托管设置）> Command line arguments（命令行参数,本次会话临时覆盖）> Local（.claude/settings.local.json,个人项目覆盖）> Project（.claude/settings.json,团队共享）> User（~/.claude/settings.json,全局用户）。注意 Local 优先级高于 Project,个人本地覆盖会盖过团队共享设置。

界面内可配置项（已验证）

以下选项来自官方 settings 文档对各字段的描述。注意:model(默认模型)不是 /config UI 里的可选项——官方 settings 文档明确把 model 列为"会话启动时读取一次、下次重启才生效"的 settings.json 键,会话中切换模型要用 /model,不在 /config 界面内:

官方 settings 文档用「Appears in /config as …」逐项标注了出现在 UI 里的设置,下表只收录有此明确标注或明确记录的项(model、Theme/配色方案均不在其中):

CLI 非交互式替代方案

不进入 UI 时，可在终端直接读写配置项：

claude config list                          # 列出所有配置项及当前值
claude config get <key>                     # 查询单项
claude config set <key> <value>             # 写入用户配置

注:claude config set 的具体作用域行为以 claude config --help 实测为准,官方 settings/commands 页面未逐字记录 --global 等标志。

跟同类原语对比

官方文档:会话内切换模型用 /model(/config UI 不含 model 项);需要持久化默认模型时,直接在 settings.json 写入 model 键(下次会话启动生效),或用 claude config set model <id>。

经典使用场景

• 首次使用 Claude Code 时，快速配置主题、默认模型和 vim 键位等个人偏好，避免反复在每次会话内临时切换
• 将 extended thinking 设为默认开启，无需每轮手动启用
• 在协作项目中，通过 /config 将团队约定的设置写入项目级 .claude/settings.json 并提交

常见坑

1. 仅限交互式 REPL：在管道模式（echo "..." | claude）或 headless 环境中，/config 无法打开 UI；此时应改用 claude config set。
2. 热加载有范围：官方文档说明是"大多数键"（most keys）热加载生效，少数选项可能仍需重启会话——文档未列出例外项，遇到修改不生效时重开会话即可。

来源

• Settings — Claude Code 官方文档
• Commands — Claude Code 官方文档
• Claude Code Complete Command Reference | SmartScope