前两篇讲了怎么装、怎么用、怎么用 Skills 定制。这篇拆解 Claude Code 的配置体系settings 三层结构、核心字段、插件机制以及一个状态栏 HUD 的实战案例。全文基于真实配置凭据与内部地址已脱敏。1. 配置体系总览CC 的配置以JSON 文件 目录约定为主分成三层~/.claude/ ← 全局所有项目生效 ├── settings.json ← 全局配置env / permissions / mcp / plugins ├── settings.local.json ← 本机私有配置不进 git ├── CLAUDE.md ← 全局项目指令 ├── skills/ ← 全局 skill ├── agents/ ← 全局子 Agent ├── keybindings.json ← 快捷键 └── ... 项目/.claude/ ← 项目级该项目生效 ├── settings.json ← 项目配置mcp / 项目专属 ├── skills/ ← 项目 skill └── ... 项目/CLAUDE.md ← 项目指令CC 每次启动必读优先级项目级 全局 内置默认。同名配置后者覆盖前者或合并视字段而定。分层原则通用的放全局项目的放项目级私密的放 settings.local.json。2. settings.json 字段拆解一个典型的全局~/.claude/settings.json核心字段{env:{},permissions:{},statusLine:{},enabledPlugins:{},extraKnownMarketplaces:{},mcpServers:{},alwaysThinkingEnabled:false,skipDangerousModePermissionPrompt:true}字段作用env环境变量鉴权 token、模型、后端 URL、超时permissions权限规则如defaultMode: bypassPermissionsstatusLine状态栏statusline 命令enabledPlugins启用的插件extraKnownMarketplaces额外插件市场源mcpServersMCP 工具集合详见 MCP 篇alwaysThinkingEnabled是否总是开启思考skipDangerousModePermissionPrompt跳过危险模式确认2.1 settings.local.json 与 settings.json 的区别文件用途特点settings.json常规配置可能被同步/分享settings.local.json本机私有不上传适合放凭据类、本机专属经验token / API key 放settings.local.json如ANTHROPIC_AUTH_TOKEN避免同步泄漏。3. 插件Plugins机制3.1 插件是什么Plugin 一组 skill / agent / hook / 配置的打包分发单元。从 marketplace 安装一次启用带来一整套能力。3.2 常用插件示例插件提供什么superpowers一整套方法论 skillTDD / 排障 / 计划执行 / Code Review code-reviewer agentclaude-hud终端状态栏 HUD见 §4code-review代码审查工具多维度/多级审查3.3 插件与 skill 的关系插件打包分发skill/agent/hookskill 是内容本体插件装好 → skill 出现在可用列表 → CC 按触发条件加载插件内嵌 agent 定义如 superpowers 的 code-reviewer→ 成为子 Agent 类型3.4 自定义 marketplace通过extraKnownMarketplaces可以接自定义插件市场源包括内网 git 仓库——团队可以把定制 skill/agent 打包成插件通过内网 git 分发避免外网依赖。这在企业/内网环境尤其有用。4. 实战案例状态栏 HUDstatusLine可以用 claude-hud 插件实现终端状态栏 HUD在终端底部常驻显示会话状态模型、token 用量、模式等不打断主界面。参考效果配置位置settings.json的statusLine.type: commandstatusLine.command安装marketplace 安装 enabledPlugins启用或插件自带/configure命令调布局原理statusLine 命令从终端取列数算出可用宽度再从插件缓存目录定位 claude-hud 的最新版本exec启动它的 index.js状态栏这类装饰性但高频的能力做成插件比自己维护脚本省心——这就是插件的价值。5. 常用配置操作操作方式改配置直接编辑settings.json或/config keyvalue查配置/config查看当前生效配置装插件/plugin浏览 marketplace 安装管理 MCP/mcp或claude mcp add/list/remove权限/permissions查看/编辑快捷键~/.claude/keybindings.json可用/keybindings引导排障--safe-mode禁用所有定制CLAUDE.md/plugins/skills/hooks/MCP6. 最佳实践密钥进 settings.local.json不进会同步的 settings.json按需装插件插件的 skill 会挤占可用 skill 列表装太多反而触发不准内网环境插件 marketplace 用内网 git 源别依赖外网 GitHub定期审视CC 高频迭代升级后检查配置兼容性结语配置分层 插件生态是 Claude Code越用越懂你的底盘。把通用配置放全局、项目专属放项目级、私密凭据放 local再按需装插件扩展能力——这套组合能让 CC 在不同项目里都恰到好处地干活。扩展点系列其余篇章Skills让 AI 按你的规范办事已发MCP外部工具接入Hooks事件钩子与自动化护栏子 Agent并行分工干活
前两篇讲了怎么装、怎么用、怎么用 Skills 定制。这篇拆解 Claude Code 的配置体系settings 三层结构、核心字段、插件机制以及一个状态栏 HUD 的实战案例。全文基于真实配置凭据与内部地址已脱敏。1. 配置体系总览CC 的配置以JSON 文件 目录约定为主分成三层~/.claude/ ← 全局所有项目生效 ├── settings.json ← 全局配置env / permissions / mcp / plugins ├── settings.local.json ← 本机私有配置不进 git ├── CLAUDE.md ← 全局项目指令 ├── skills/ ← 全局 skill ├── agents/ ← 全局子 Agent ├── keybindings.json ← 快捷键 └── ... 项目/.claude/ ← 项目级该项目生效 ├── settings.json ← 项目配置mcp / 项目专属 ├── skills/ ← 项目 skill └── ... 项目/CLAUDE.md ← 项目指令CC 每次启动必读优先级项目级 全局 内置默认。同名配置后者覆盖前者或合并视字段而定。分层原则通用的放全局项目的放项目级私密的放 settings.local.json。2. settings.json 字段拆解一个典型的全局~/.claude/settings.json核心字段{env:{},permissions:{},statusLine:{},enabledPlugins:{},extraKnownMarketplaces:{},mcpServers:{},alwaysThinkingEnabled:false,skipDangerousModePermissionPrompt:true}字段作用env环境变量鉴权 token、模型、后端 URL、超时permissions权限规则如defaultMode: bypassPermissionsstatusLine状态栏statusline 命令enabledPlugins启用的插件extraKnownMarketplaces额外插件市场源mcpServersMCP 工具集合详见 MCP 篇alwaysThinkingEnabled是否总是开启思考skipDangerousModePermissionPrompt跳过危险模式确认2.1 settings.local.json 与 settings.json 的区别文件用途特点settings.json常规配置可能被同步/分享settings.local.json本机私有不上传适合放凭据类、本机专属经验token / API key 放settings.local.json如ANTHROPIC_AUTH_TOKEN避免同步泄漏。3. 插件Plugins机制3.1 插件是什么Plugin 一组 skill / agent / hook / 配置的打包分发单元。从 marketplace 安装一次启用带来一整套能力。3.2 常用插件示例插件提供什么superpowers一整套方法论 skillTDD / 排障 / 计划执行 / Code Review code-reviewer agentclaude-hud终端状态栏 HUD见 §4code-review代码审查工具多维度/多级审查3.3 插件与 skill 的关系插件打包分发skill/agent/hookskill 是内容本体插件装好 → skill 出现在可用列表 → CC 按触发条件加载插件内嵌 agent 定义如 superpowers 的 code-reviewer→ 成为子 Agent 类型3.4 自定义 marketplace通过extraKnownMarketplaces可以接自定义插件市场源包括内网 git 仓库——团队可以把定制 skill/agent 打包成插件通过内网 git 分发避免外网依赖。这在企业/内网环境尤其有用。4. 实战案例状态栏 HUDstatusLine可以用 claude-hud 插件实现终端状态栏 HUD在终端底部常驻显示会话状态模型、token 用量、模式等不打断主界面。参考效果配置位置settings.json的statusLine.type: commandstatusLine.command安装marketplace 安装 enabledPlugins启用或插件自带/configure命令调布局原理statusLine 命令从终端取列数算出可用宽度再从插件缓存目录定位 claude-hud 的最新版本exec启动它的 index.js状态栏这类装饰性但高频的能力做成插件比自己维护脚本省心——这就是插件的价值。5. 常用配置操作操作方式改配置直接编辑settings.json或/config keyvalue查配置/config查看当前生效配置装插件/plugin浏览 marketplace 安装管理 MCP/mcp或claude mcp add/list/remove权限/permissions查看/编辑快捷键~/.claude/keybindings.json可用/keybindings引导排障--safe-mode禁用所有定制CLAUDE.md/plugins/skills/hooks/MCP6. 最佳实践密钥进 settings.local.json不进会同步的 settings.json按需装插件插件的 skill 会挤占可用 skill 列表装太多反而触发不准内网环境插件 marketplace 用内网 git 源别依赖外网 GitHub定期审视CC 高频迭代升级后检查配置兼容性结语配置分层 插件生态是 Claude Code越用越懂你的底盘。把通用配置放全局、项目专属放项目级、私密凭据放 local再按需装插件扩展能力——这套组合能让 CC 在不同项目里都恰到好处地干活。扩展点系列其余篇章Skills让 AI 按你的规范办事已发MCP外部工具接入Hooks事件钩子与自动化护栏子 Agent并行分工干活
