Skip to content

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