update-config — 配置管理
- 触发方式:
/update-config或关键词「配置」「settings」「权限」「allow」「环境变量」 - 适用场景: 修改 settings.json、配置权限、设置环境变量、管理 hooks
- 不适用场景: 修改代码逻辑、Skill 内容修改
功能概述
update-config 管理 Claude Code 的配置系统。它可以配置:
- 权限 — 允许/禁止特定工具和命令
- Hooks — 自动化行为触发器
- 环境变量 — 设置运行时变量
- 设置项 — 主题、模型等偏好
触发条件
以下情况会自动触发 update-config:
- 提到「配置」「设置」「权限」
- 需要修改 settings.json
- 使用
/update-config命令
使用示例
示例 1:添加命令权限
/update-config 允许自动运行 npm install 和 npm test 命令示例 2:设置环境变量
/update-config 设置 DEBUG=true 和 API_BASE_URL=https://api.example.com示例 3:配置 Hook
/update-config 在每次对话开始时自动运行 git status示例 4:移动权限范围
/update-config 把 Bash 工具的权限从项目级移到全局设置示例 5:权限故障排查
/update-config 为什么 npm publish 命令总是需要确认?帮我检查 hook 配置配置层级
| 层级 | 位置 | 作用域 |
|---|---|---|
| User | ~/.claude/settings.json | 所有项目 |
| Project | .claude/settings.json | 当前项目 |
| Local | .claude/settings.local.json | 本地覆盖(不提交) |
注意���项
- 项目级配置优先级高于用户级
settings.local.json应加入.gitignore,不提交到仓库- Hooks 的脚本在 Claude Code 进程外执行,注意安全性
- 权限配置尽量最小化 — 只开放必要的权限
- 环境变量中不要存储密钥和 Token — 用系统的密钥管理工具
相关 Skills
- write-a-skill — 创建 Skill 后需要配置权限
- fewer-permission-prompts — 分析并减少权限提示
- keybindings-help — 配置键盘快捷键