第10集：安装方式与目录结构全景

⏱ 预计阅读 3 分钟 更新于 2026/5/7
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

搞清楚扩展文件的存放位置和配置合并逻辑，是进行高级定制和排错的基础。

三种安装方式

flowchart TB
    subgraph 方式1: 插件一键安装
        A1["claude plugin install "] --> A2[下载到 plugins/cache/]
        A2 --> A3[自动注册 Hook/MCP/Skill]
    end

    subgraph 方式2: 手动 Skill
        B1[复制 SKILL.md] --> B2["放入 ~/.claude/skills//"]
    end

    subgraph 方式3: 手动 MCP
        C1[编辑 settings.json] --> C2[添加 mcpServers 配置]
    end

关键目录全景

路径 作用
~/.claude/settings.json 全局配置：Hook、权限、全局 MCP
~/.claude/skills/ 手动 Skill 库：存放手动创建的工作流
~/.claude/plugins/ 插件中心：含注册表和 cache 源码
项目/.claude/settings.json 项目配置：项目级 Hook 和权限
项目/.claude/settings.local.json 本地私密配置：本地 MCP、数据库密钥

配置合并优先级

当多个地方都配置了同类项时，遵循以下合并规则：

  1. Hook：全部叠加。来自插件、全局和项目的 Hook 都会按顺序执行。
  2. MCP：项目覆盖全局。同名的 MCP Server，项目级配置优先。
  3. 权限：最严优先。任一层拒绝执行，该操作就会被拦截。
  4. Skill：插件优先。同名的斜杠命令，插件定义的 Skill 优先于手动 Skill。

安装流程深度拆解

当你运行 claude plugin install 时，系统会：

  1. 从 Marketplace 下载插件源码到 plugins/cache/。
  2. 在 installed_plugins.json 记录安装元数据。
  3. 下次启动时，自动扫描并合并所有组件。