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并行分工干活

相关新闻

数学建模竞赛选题策略:从题型分析到团队决策的实战指南

数学建模竞赛选题策略:从题型分析到团队决策的实战指南

1. 选题前的“定盘星”:从竞赛本质出发的底层逻辑又到了一年一度高教社杯全国大学生数学建模竞赛(以下简称“国赛”)的备战季。对于所有参赛队伍来说,拿到赛题后那关键的24-48小时,最核心、最煎熬的环节莫过于选题。选…

2026/10/25 18:02:09 阅读更多 →
Linux内核开发调试利器:QEMU沙盒环境搭建与高效调试指南

Linux内核开发调试利器:QEMU沙盒环境搭建与高效调试指南

如果你在 Linux 内核开发这条路上已经走了一段时间,大概率会遇到一个绕不开的困境:你写了一个驱动,或者修改了某个核心模块,编译出的内核镜像(比如bzImage)看起来一切正常,但怎么验证它真的能跑…

2026/10/27 20:51:59 阅读更多 →
大模型本地部署与推理加速:MiniMax H3模型与Sol Engine集成实践指南

大模型本地部署与推理加速:MiniMax H3模型与Sol Engine集成实践指南

这次我们来看一个近期在开发者社区和AI应用圈引起关注的技术动态:MiniMax H3模型获得了Sol Engine的首日加速支持。对于关心大模型本地部署、推理性能优化和硬件加速的开发者来说,这无疑是一个值得深入探究的信号。它意味着,一个强大的闭源模…

2026/10/26 22:32:27 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/10/27 17:33:32 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/10/27 4:06:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/10/27 7:21:53 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/10/27 18:20:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/10/27 6:20:47 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/10/27 4:06:50 阅读更多 →

日新闻

周新闻

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/27 13:55:19 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/27 7:21:50 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/27 19:19:37 阅读更多 →