Claude Code 扩展点：配置与插件 —— settings.json 全解

前两篇讲了怎么装、怎么用、怎么用 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并行分工干活