name: 设置管理 description: Claude Code配置和设置的中心权威。涵盖settings.json文件（用户、项目、企业）、可用设置、权限设置、沙箱设置、设置优先级、插件配置、环境变量以及Claude可用的工具。帮助配置Claude Code行为、管理权限、设置企业策略和解决配置问题。100%委托给docs-management技能获取官方文档。 user-invocable: false allowed-tools: Read, Glob, Grep, Skill
配置元技能
🚨 强制：首先调用docs-management
停止 - 在提供任何关于Claude Code配置或设置的响应之前：
- 调用
docs-management技能- 查询 用户的特定主题
- 基于 官方文档加载的内容提供响应
跳过此步骤将导致过时或错误的信息。
验证检查点
在响应之前，验证：
- [ ] 我是否调用了docs-management技能？
- [ ] 官方文档是否加载？
- [ ] 我的响应是否基于官方文档？
如果任何复选框未勾选，停止并首先调用docs-management。
概述
Claude Code配置和设置的中心权威。此技能使用 100%委托给docs-management - 它不包含重复的官方文档。
架构： 纯委托与关键词注册。所有官方文档通过docs-management技能查询访问。
何时使用此技能
关键词： 设置、配置、settings.json、环境变量、权限、沙箱、企业设置、managed-settings.json、用户设置、项目设置、本地设置、工具、钩子配置、模型配置、插件设置、优先级
使用此技能当：
- 配置settings.json文件
- 理解设置层次结构和优先级
- 设置权限规则（允许、拒绝、询问）
- 配置沙箱设置
- 管理企业策略
- 设置环境变量
- 理解可用工具
- 配置插件设置
- 解决配置问题
用于docs-management查询的关键词注册表
使用这些关键词查询docs-management技能获取官方文档：
设置文件
| 主题 | 关键词 |
|---|---|
| 概述 | “设置”, “settings.json”, “配置文件” |
| 用户设置 | “用户设置”, “~/.claude/settings.json” |
| 项目设置 | “.claude/settings.json”, “项目设置” |
| 本地设置 | “settings.local.json”, “本地设置” |
| 企业 | “managed-settings.json”, “企业管理策略” |
可用设置
| 主题 | 关键词 |
|---|---|
| 设置表 | “可用设置”, “设置选项” |
| 模型设置 | “模型设置”, “模型覆盖” |
| 钩子设置 | “钩子设置”, “disableAllHooks” |
| 输出样式 | “outputStyle设置”, “输出样式配置” |
| 状态行 | “statusLine设置”, “状态行配置” |
| API密钥助手 | “apiKeyHelper”, “自定义脚本认证” |
| 键绑定 | “keybindings.json”, “键盘快捷键配置”, “自定义键绑定” |
| 计划目录 | “plansDirectory”, “计划目录设置”, “计划文件存储” |
| 轮次持续时间 | “showTurnDuration”, “轮次持续时间显示”, “定时显示” |
权限
| 主题 | 关键词 |
|---|---|
| 权限设置 | “权限设置”, “允许拒绝询问规则” |
| 允许规则 | “权限允许”, “允许工具规则” |
| 拒绝规则 | “权限拒绝”, “拒绝工具规则”, “排除敏感文件” |
| 询问规则 | “权限询问”, “确认规则” |
| 默认模式 | “defaultMode”, “权限模式” |
沙箱
| 主题 | 关键词 |
|---|---|
| 沙箱设置 | “沙箱设置”, “bash沙箱化” |
| 沙箱网络 | “沙箱网络”, “allowUnixSockets”, “allowLocalBinding” |
| 排除命令 | “excludedCommands”, “沙箱排除” |
| 自动允许 | “autoAllowBashIfSandboxed”, “自动批准沙箱化” |
优先级
| 主题 | 关键词 |
|---|---|
| 设置优先级 | “设置优先级”, “配置层次结构” |
| 覆盖顺序 | “企业项目用户优先级”, “设置覆盖” |
环境变量
| 主题 | 关键词 |
|---|---|
| 环境变量 | “环境变量”, “ANTHROPIC_API_KEY” |
| 模型变量 | “ANTHROPIC_MODEL”, “模型环境” |
| 代理变量 | “HTTP_PROXY”, “HTTPS_PROXY”, “代理配置” |
| 遥测变量 | “DISABLE_TELEMETRY”, “遥测设置” |
| Bedrock变量 | “CLAUDE_CODE_USE_BEDROCK”, “bedrock环境” |
| Vertex变量 | “CLAUDE_CODE_USE_VERTEX”, “vertex环境” |
| 临时目录 | “CLAUDE_CODE_TMPDIR”, “临时目录”, “临时文件位置” |
| 后台任务 | “CLAUDE_CODE_DISABLE_BACKGROUND_TASKS”, “禁用后台任务”, “后台进程控制” |
插件
| 主题 | 关键词 |
|---|---|
| 插件配置 | “插件配置”, “enabledPlugins” |
| 市场 | “extraKnownMarketplaces”, “插件市场配置” |
JSON模式
| 主题 | 关键词 |
|---|---|
| 自定义模式 | “设置模式”, “JSON模式”, “claude-code-settings.schema.json” |
| 模式位置 | “自定义模式”, “扩展模式”, “SchemaStore” |
| 模式更新 | “更新模式”, “模式刷新”, “/update-settings-schema” |
| 模式验证 | “验证模式”, “模式合规”, “draft-07” |
工具
| 主题 | 关键词 |
|---|---|
| 可用工具 | “Claude可用工具”, “工具表” |
| 工具权限 | “工具权限”, “需要权限的工具” |
快速决策树
你想做什么？
- 配置文件设置 -> 查询docs-management: “settings.json”, “可用设置”
- 设置权限 -> 查询docs-management: “权限设置”, “允许拒绝规则”
- 配置沙箱 -> 查询docs-management: “沙箱设置”, “bash沙箱化”
- 理解优先级 -> 查询docs-management: “设置优先级”, “配置层次结构”
- 设置环境变量 -> 查询docs-management: “环境变量”, 特定变量名
- 配置企业策略 -> 查询docs-management: “managed-settings.json”, “企业管理策略”
- 配置插件设置 -> 查询docs-management: “插件配置”, “enabledPlugins”
- 理解可用工具 -> 查询docs-management: “Claude可用工具”
- 排除敏感文件 -> 查询docs-management: “排除敏感文件”, “拒绝规则”
- 配置模型 -> 查询docs-management: “模型设置”, “ANTHROPIC_MODEL”
- 解决配置问题 -> 查询docs-management: “配置故障排除” + 特定问题
主题覆盖
⚠️ 过时警告： 以下列表仅用于导航参考。 始终查询docs-management以获取权威、当前的设置字段、环境变量和配置选项列表。这些随Claude Code版本变化。
设置文件类型
查询模式: docs-management: "settings.md 文件类型 位置"
- 用户设置、项目设置、本地设置
- 企业策略（管理设置）
- 平台特定路径
关键设置选项
查询模式: docs-management: "settings.md 可用设置表"
类别包括: 认证助手、清理、公告、环境、权限、钩子、模型、输出样式、状态行。查询docs-management获取当前设置字段的完整列表。
权限设置
查询模式: docs-management: "settings.md 权限设置 允许拒绝询问"
涵盖: 允许/拒绝/询问规则、额外目录、默认模式、绕过模式控制。
沙箱设置
查询模式: docs-management: "settings.md 沙箱设置 网络"
涵盖: 启用标志、自动允许行为、排除命令、网络设置（套接字、绑定、代理）。
设置优先级
查询模式: docs-management: "settings.md 优先级 层次结构"
顺序（查询docs-management获取当前优先级规则）。
环境变量类别
查询模式: docs-management: "settings.md 环境变量"
类别: 认证、模型配置、提供商设置、代理、遥测、工具行为。
插件配置
查询模式: docs-management: "settings.md 插件配置 enabledPlugins"
涵盖: 启用插件映射、市场来源。
Claude可用工具
查询模式: docs-management: "interactive-mode.md Claude可用工具"
类别: 文件操作、执行、用户交互、专业工具、笔记本编辑。
委托模式
标准查询模式
用户问: "如何配置权限？"
1. 调用docs-management技能
2. 使用关键词: "权限设置", "允许拒绝规则"
3. 加载官方文档
4. 基于官方文档提供指导
多主题查询模式
用户问: "我想要企业设置，带沙箱和限制权限"
1. 使用多个查询调用docs-management技能：
- "managed-settings.json", "企业管理策略"
- "沙箱设置", "bash沙箱化"
- "权限设置", "拒绝规则"
2. 从官方文档合成指导
故障排除模式
用户报告: "我的设置未生效"
1. 调用docs-management技能
2. 使用关键词: "设置优先级", "配置层次结构"
3. 根据官方文档引导用户通过优先级规则
故障排除快速参考
| 问题 | 用于docs-management的关键词 |
|---|---|
| 设置未应用 | “设置优先级”, “配置层次结构” |
| 权限被拒绝 | “权限设置”, “拒绝规则” |
| 沙箱阻止命令 | “沙箱设置”, “excludedCommands” |
| 环境变量无效 | “环境变量”, 特定变量名 |
| 企业策略覆盖 | “managed-settings.json”, “企业策略” |
| 插件未加载 | “插件配置”, “enabledPlugins” |
| 工具不可用 | “可用工具”, “工具权限” |
仓库特定注释
此仓库在.claude/settings.json中有项目级设置，包括：
- 自定义钩子配置
- 权限规则
- 模型设置
修改此仓库的设置时，确保更改与钩子管理技能的指导对齐。
审计设置
此技能提供settings-auditor代理用于正式审计的验证标准。
审计资源
| 资源 | 位置 | 目的 |
|---|---|---|
| 审计框架 | references/audit-framework.md |
查询指南和评分标准 |
评分类别
| 类别 | 分数 | 关键标准 |
|---|---|---|
| JSON有效性 | 20 | 有效语法、格式正确 |
| 模式合规 | 25 | 仅有效设置选项 |
| 权限规则 | 25 | 有效模式、适当限制 |
| 环境配置 | 15 | 有效环境变量、无秘密 |
| 优先级意识 | 15 | 正确范围使用 |
阈值： 85+ = 通过，70-84 = 通过带警告，<70 = 失败
相关代理
settings-auditor代理（Haiku模型）使用此技能执行正式审计：
- 通过
skills: settings-management自动加载此技能 - 使用审计框架和docs-management获取规则
- 生成结构化审计报告
- 通过
/audit-settings命令调用
外部技术验证
审计引用外部技术（脚本、包、运行时）的设置时，审计员必须先使用MCP服务器验证声明，再标记发现。
需要MCP验证的技术：
- .NET/C# 脚本: 使用microsoft-learn + perplexity验证
- Node.js/npm 包: 使用context7 + perplexity验证
- Python 脚本/包: 使用context7 + perplexity验证
- Shell 脚本: 使用perplexity验证
- 任何版本特定声明: 始终使用perplexity验证
验证规则：
切勿将技术使用标记为错误，除非先：
- 查询适当的MCP服务器获取当前文档
- 使用perplexity验证最近更改（特别是.NET 10+）
- 在发现中记录MCP来源
过时数据警告：
- microsoft-learn可能返回缓存/过时文档
- 始终将microsoft-learn与perplexity配对进行版本验证
- 信任perplexity获取版本号和最近发布的功能
VS Code集成
此插件提供Claude Code设置的扩展JSON模式，启用VS Code中的智能感知。
模式关联选项
选项1：工作区设置（推荐）
添加到.vscode/settings.json：
{
"json.schemas": [
{
"fileMatch": ["**/.claude/settings.json", "**/.claude/settings.local.json"],
"url": "./plugins/claude-ecosystem/skills/settings-management/references/claude-code-settings.schema.json"
}
]
}
选项2：文件内模式参考
在settings.json顶部添加：
{
"$schema": "https://raw.githubusercontent.com/melodic/claude-code-plugins/main/plugins/claude-ecosystem/skills/settings-management/references/claude-code-settings.schema.json"
}
注意： 文件内$schema参考覆盖工作区设置。使用工作区设置以获取灵活性。
环境变量智能感知
模式包括68+环境变量，带有：
- 所有官方环境变量名的完整自动完成
- 每个变量的描述和类别
enum: ["0", "1"]用于布尔标志（类型安全）- 过时变量的弃用标记
尝试： 在settings.json中，输入"env": { "A，VS Code将自动完成ANTHROPIC_API_KEY、ANTHROPIC_MODEL等。
模式版本
模式跟踪Claude Code版本并包括版本历史：
| 字段 | 目的 |
|---|---|
x-schema-version |
插件模式版本（例如，1.1.0） |
x-claude-code-version |
Claude Code版本跟踪 |
x-env-var-count |
定义的环境变量数量（68+） |
x-last-updated |
最后模式更新日期 |
保持模式更新
运行/update-settings-schema以将模式与最新规范文档同步。这从官方文档提取新环境变量和设置。
参考
官方文档（通过docs-management技能）：
- 主要: “设置” 文档
- 相关: “iam”, “钩子”, “沙箱化”, “模型配置”, “网络配置”
仓库特定：
- 项目设置:
.claude/settings.json - 钩子配置:
.claude/hooks/
版本历史
-
v1.1.0 (2026-01-16): 添加v2.1.4-v2.1.9关键词注册表条目
- 添加keybindings.json设置关键词（v2.1.7）
- 添加plansDirectory设置关键词（v2.1.9）
- 添加showTurnDuration设置关键词（v2.1.7）
- 添加CLAUDE_CODE_TMPDIR环境变量关键词（v2.1.5）
- 添加CLAUDE_CODE_DISABLE_BACKGROUND_TASKS环境变量关键词（v2.1.4）
-
v1.0.0 (2025-11-26): 初始发布
- 纯委托架构
- 全面关键词注册表
- 快速决策树
- 所有配置功能的主题覆盖
- 故障排除快速参考
最后更新
日期： 2026-01-16 模型： claude-opus-4-5-20251101