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/8/13 8:57:56 阅读更多 →
Linux内核开发调试利器:QEMU沙盒环境搭建与高效调试指南

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

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

2026/8/13 8:57:56 阅读更多 →
大模型本地部署与推理加速:MiniMax H3模型与Sol Engine集成实践指南

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

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

2026/8/13 8:57:56 阅读更多 →

最新新闻

SUBTERRA音乐制作指南:从黑暗氛围到工业底噪的实战解析

SUBTERRA音乐制作指南:从黑暗氛围到工业底噪的实战解析

1. 先搞清楚“SUBTERRA”到底是什么,以及它适合谁 看到“SUBTERRA”这个标题,再配上“极致黑暗/酸性/工业底噪”这些描述,很多人的第一反应可能是某个新出的游戏、电影或者某种艺术装置。但如果你对地下音乐、特别是那些追求极致氛围和听觉冲…

2026/8/13 9:42:37 阅读更多 →
GEO技术实践观察:品牌内容语义工程与AI决策入口重构

GEO技术实践观察:品牌内容语义工程与AI决策入口重构

一、引言2026年,AI搜索已从技术概念演变为用户获取信息的核心方式之一。据中国互联网络信息中心数据,截至2025年底,我国生成式AI用户规模已达5.15亿,占中国网民总数的50%。更关键的变化发生在用户行为层面——超过60%的消费者直接…

2026/8/13 9:42:37 阅读更多 →
从工具到伙伴:AI Agent设计如何实现人机协同范式转移

从工具到伙伴:AI Agent设计如何实现人机协同范式转移

1. 从“工具”到“伙伴”:一次产品理念的范式转移最近几年,我观察到身边不少产品经理和开发者朋友,言必称“Agent”。从AI Agent到各种业务Agent,这个概念似乎成了技术产品创新的“标配”。但说实话,很多所谓的“Agent…

2026/8/13 9:42:37 阅读更多 →
Firecrawl 网页数据抓取新手入门指南

Firecrawl 网页数据抓取新手入门指南

在构建基于大模型的应用时,我们常常面临一个棘手的问题:如何让 AI 理解互联网上实时更新的网页内容?大模型的训练数据往往存在滞后性,直接喂给它一个 URL,它通常无法直接“阅读”其中的最新信息。传统的爬虫方案虽然可…

2026/8/13 9:42:37 阅读更多 →
vLLM推理服务静默失败排查:五级门禁系统解决垃圾Token生成问题

vLLM推理服务静默失败排查:五级门禁系统解决垃圾Token生成问题

1. 问题现象:服务静默,输出却“胡言乱语” 最近在线上服务里排查一个挺有意思的问题。我们基于 vLLM 0.25.1 搭建了一个大模型推理服务,用来处理一些文本生成任务。从监控上看,服务一切正常,日志里没有抛出任何错误或警…

2026/8/13 9:42:37 阅读更多 →
35岁转行网络安全:细分赛道选择与实战策略

35岁转行网络安全:细分赛道选择与实战策略

1. 大龄转行网络安全行业的真实处境35岁转行网络安全,这个决定本身就充满了勇气与挑战。作为一个在这个行业摸爬滚打多年的从业者,我必须坦诚地告诉你:这个行业确实存在35岁危机,但绝不是你想象的那种"一刀切"式的年龄歧…

2026/8/13 9:41:34 阅读更多 →

日新闻

Visual Studio新建项目解决方案为空:系统性排查与修复指南

Visual Studio新建项目解决方案为空:系统性排查与修复指南

1. 问题现象与本质剖析如果你是一位.NET开发者,或者正准备踏入这个领域,那么Visual Studio(后面简称VS)绝对是你绕不开的伙伴。但有时候,这个伙伴会跟你开一个不大不小的玩笑:你满怀期待地点击“创建新项目…

2026/8/13 0:00:09 阅读更多 →
长春建设厅网站:普通人买房办事必看的真实指南与避坑攻略

长春建设厅网站:普通人买房办事必看的真实指南与避坑攻略

说实话,每次提起“长春建设厅网站”这几个字,我心里都挺有感触的。不是因为它有多高大上,也不是因为那里藏着什么不可告人的秘密,恰恰相反,是因为它太“接地气”了,或者说,它是咱们普通人想要在这个城市好好生活、安稳买房时,必须得翻过的一座“数据山”。很多新朋友第…

2026/8/13 0:00:09 阅读更多 →
Windows家庭版远程桌面多用户破解完整指南:RDPWrap终极解决方案

Windows家庭版远程桌面多用户破解完整指南:RDPWrap终极解决方案

Windows家庭版远程桌面多用户破解完整指南:RDPWrap终极解决方案 【免费下载链接】rdpwrap.ini RDPWrap.ini for RDP Wrapper Library by StasM 项目地址: https://gitcode.com/GitHub_Trending/rd/rdpwrap.ini 你是否曾为Windows家庭版无法支持多用户远程桌面…

2026/8/13 0:00:09 阅读更多 →

周新闻

5分钟告别提取码焦虑:baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑:baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑:baidupankey如何智能破解百度网盘资源锁 【免费下载链接】baidupankey 在线查询网盘提取码(维护中 rm repo) 项目地址: https://gitcode.com/gh_mirrors/ba/baidupankey 你是否曾经在深夜寻找一份重要资料&#x…

2026/8/13 2:38:34 阅读更多 →
如何快速生成中国车牌图片:Python开源工具完整指南

如何快速生成中国车牌图片:Python开源工具完整指南

如何快速生成中国车牌图片:Python开源工具完整指南 【免费下载链接】chinese_license_plate_generator 中国车牌生成器 项目地址: https://gitcode.com/gh_mirrors/ch/chinese_license_plate_generator 中国车牌生成器是一个基于Python的开源项目&#xff0c…

2026/8/12 1:11:09 阅读更多 →
收藏!小白程序员轻松入门大模型,从Harness工程开始实践

收藏!小白程序员轻松入门大模型,从Harness工程开始实践

文章强调学习大模型不应只关注模型本身,而应重视模型外的系统搭建,即Harness。提出AgentModelHarness的实用公式,详细介绍Harness的四个层次:持久化层、执行层、控制层和观察与验证层。文章还探讨了上下文工程、工具设计、AGENTS.…

2026/8/12 1:11:08 阅读更多 →

月新闻

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南 【免费下载链接】BaiduNetdiskPlugin-macOS For macOS.百度网盘 破解SVIP、下载速度限制~ 项目地址: https://gitcode.com/gh_mirrors/ba/BaiduNetdiskPlugin-macOS 还在为百度网盘macOS版的龟速下…

2026/8/11 17:09:45 阅读更多 →
终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 还在为网易云音乐下载的NCM格式文件无法在其他播放器播放而烦恼吗?ncmdump解密工具帮你轻松解决这个困…

2026/8/12 1:11:10 阅读更多 →
HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

AgentCard 智能体卡片:为英语学习 App 打造桌面级学习助手适用平台:HarmonyOS 7.0 (API 26 Beta)一、引言 HarmonyOS 7.0(API 26 Beta)新增了 AgentCard 智能体卡片能力,这是继 HMAF(鸿蒙智能体框架&#x…

2026/8/11 17:09:45 阅读更多 →