Claude_Code_插件配置指南

Claude Code 插件配置指南

本文档整理 RiceGrrain 项目配置的 Claude Code 增强插件，包含 MCP 服务器、Plugins 和 Skills。

一、MCP 服务器

1. Memory MCP Server

插件名称 : @modelcontextprotocol/server-memory

作用:

提供跨会话的持久化记忆存储
支持用户偏好、项目上下文、反馈历史的记录
支持会话历史回溯和知识检索

安装命令:

bash 复制代码

# 全局安装
claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory

# 项目安装
claude mcp add memory -s local -- npx -y @modelcontextprotocol/server-memory

配置说明 :

执行命令后自动写入对应配置文件：

全局：~/.claude/mcp.json
项目：<项目>/.claude/mcp.json

配置内容：

json 复制代码

{
  "mcpServers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

生效范围:

范围	配置位置
全局	`~/.claude/mcp.json`
项目	`.claude/mcp.json`

2. Context7 MCP Server

插件名称 : @upstash/context7-mcp

作用:

实时获取最新的库/框架文档和代码示例
支持 API 查询、版本迁移、配置指南
覆盖主流前端/后端框架（React、Next.js、Spring 等）

安装命令:

bash 复制代码

# 全局安装
claude mcp add context7 -s user -- npx -y @upstash/context7-mcp

# 项目安装（推荐）
claude mcp add context7 -s local -- npx -y @upstash/context7-mcp

配置说明 :

执行命令后自动写入对应配置文件：

json 复制代码

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

生效范围:

范围	配置位置
全局	`~/.claude/mcp.json`
项目	`.claude/mcp.json`

二、Plugins 插件

1. claude-mem

插件名称 : claude-mem (Marketplace: thedotmack)

作用:

持久化记忆系统，记录用户偏好、项目上下文、反馈历史
支持跨会话知识检索
提供计划制定、代码审查、时间线报告等技能

安装命令:

bash 复制代码

# 1. 添加 Marketplace
/plugin marketplace add thedotmack/claude-mem

# 2. 安装插件
/plugin install claude-mem

# 3. 重载插件（必须）
/reload-plugins

配置说明 :

安装后自动写入 ~/.claude/settings.json：

json 复制代码

{
  "enabledPlugins": {
    "claude-mem@thedotmack": true
  },
  "extraKnownMarketplaces": {
    "thedotmack": {
      "source": {
        "source": "github",
        "repo": "thedotmack/claude-mem"
      }
    }
  }
}

生效范围:

范围	配置位置
全局	`~/.claude/settings.json`

可用技能:

命令	作用
`/mem:do`	执行阶段性实现计划
`/mem:knowledge-agent`	构建和查询知识库
`/mem:make-plan`	创建详细实现计划
`/mem:timeline-report`	生成项目发展历程报告
`/mem:pathfinder`	映射代码库流程图
`/mem:mem-search`	搜索持久化记忆

2. superpowers

插件名称 : superpowers (Marketplace: obra/superpowers-marketplace)

作用:

提供高级开发工作流
支持计划执行、并行 Agent 调度
支持测试驱动开发、系统化调试、代码审查

安装命令:

bash 复制代码

# 1. 添加 Marketplace
/plugin marketplace add obra/superpowers-marketplace

# 2. 安装插件
/plugin install superpowers@superpowers-marketplace

# 3. 重载插件（必须）
/reload-plugins

配置说明 :

安装后自动写入 ~/.claude/settings.json：

json 复制代码

{
  "enabledPlugins": {
    "superpowers@superpowers-marketplace": true
  },
  "extraKnownMarketplaces": {
    "superpowers-marketplace": {
      "source": {
        "source": "github",
        "repo": "obra/superpowers-marketplace"
      }
    }
  }
}

生效范围:

范围	配置位置
全局	`~/.claude/settings.json`

可用技能:

命令	作用
`/superpowers:executing-plans`	执行实现计划
`/superpowers:dispatching-parallel-agents`	并行任务调度
`/superpowers:verification-before-completion`	完成前验证
`/superpowers:test-driven-development`	TDD 工作流
`/superpowers:writing-plans`	编写计划
`/superpowers:systematic-debugging`	系统化调试
`/superpowers:requesting-code-review`	请求代码审查

3. claude-hud

插件名称 : claude-hud (Marketplace: jarrodwatts)

作用:

状态行可视化显示
实时显示 Token 消耗、上下文窗口使用率
显示工具调用、Git 状态、会话持续时间、输出速度

安装命令:

bash 复制代码

# 1. 添加 Marketplace
/plugin marketplace add jarrodwatts/claude-hud

# 2. 安装插件
/plugin install claude-hud

# 3. 配置 statusLine（手动）
# 编辑 ~/.claude/settings.json 添加 statusLine 配置

配置说明:

① statusLine 配置 (~/.claude/settings.json):

json 复制代码

{
  "statusLine": {
    "type": "command",
    "command": "node C:/Users/shipe/.claude/plugins/claude-hud/dist/index.js"
  },
  "permissions": {
    "allow": [
      "Bash(node C:/Users/shipe/.claude/plugins/claude-hud/dist/index.js*)"
    ]
  }
}

② 显示配置 (~/.claude/plugins/claude-hud/config.json):

json 复制代码

{
  "language": "zh",
  "lineLayout": "expanded",
  "pathLevels": 2,
  "elementOrder": ["project", "context", "usage", "tools", "agents", "todos"],
  "gitStatus": {
    "enabled": true,
    "showDirty": true,
    "showAheadBehind": true,
    "showFileStats": false
  },
  "display": {
    "showModel": true,
    "showContextBar": true,
    "showConfigCounts": true,
    "showDuration": true,
    "showSpeed": true,
    "showUsage": true,
    "showTokenBreakdown": true,
    "showSessionTokens": true,
    "showTools": true,
    "showAgents": true,
    "showTodos": true,
    "showSessionName": true,
    "showPromptCache": true,
    "showClaudeCodeVersion": true,
    "contextValue": "both",
    "usageBarEnabled": true,
    "timeFormat": "relative",
    "showResetLabel": true,
    "sevenDayThreshold": 80
  }
}

生效范围:

范围	配置位置
全局	`~/.claude/settings.json` (statusLine)
显示配置	`~/.claude/plugins/claude-hud/config.json`

三、Skills 技能

example-skills

插件名称 : example-skills (Marketplace: anthropics/skills)

作用:

Anthropic 官方示例技能集合
涵盖文档协作、前端设计、API 集成、技能创建等

安装命令:

bash 复制代码

# 1. 添加 Marketplace
/plugin marketplace add anthropics/skills

# 2. 安装插件
/plugin install example-skills@anthropic-agent-skills

# 3. 重载插件（必须）
/reload-plugins

配置说明 :

安装后自动写入 ~/.claude/settings.json：

json 复制代码

{
  "enabledPlugins": {
    "example-skills@anthropic-agent-skills": true
  },
  "extraKnownMarketplaces": {
    "anthropic-agent-skills": {
      "source": {
        "source": "github",
        "repo": "anthropics/skills"
      }
    }
  }
}

生效范围:

范围	配置位置
全局	`~/.claude/settings.json`

可用技能:

命令	作用
`/brand-guidelines`	应用 Anthropic 品牌样式
`/frontend-design`	创建高质量前端界面
`/claude-api`	Claude API 应用开发
`/mcp-builder`	创建 MCP 服务器
`/skill-creator`	创建新技能
`/doc-coauthoring`	协作文档
`/canvas-design`	设计视觉艺术
`/theme-factory`	主题样式工具

四、配置生效范围总结

插件/服务	全局配置位置	项目配置位置
Memory MCP	`~/.claude/mcp.json`	`.claude/mcp.json`
Context7 MCP	-	`.claude/mcp.json`
claude-mem	`~/.claude/settings.json`	-
superpowers	`~/.claude/settings.json`	-
claude-hud	`~/.claude/settings.json`	-
example-skills	`~/.claude/settings.json`	-

五、快速安装所有插件

bash 复制代码

# ========== 1. 添加所有 Marketplace ==========
/plugin marketplace add thedotmack/claude-mem
/plugin marketplace add obra/superpowers-marketplace
/plugin marketplace add anthropics/skills
/plugin marketplace add jarrodwatts/claude-hud

# ========== 2. 安装 Plugins 插件 ==========
/plugin install claude-mem
/plugin install superpowers@superpowers-marketplace
/plugin install example-skills@anthropic-agent-skills
/plugin install claude-hud

# ========== 3. 重载插件（必须） ==========
/reload-plugins

# ========== 4. 安装 MCP 服务器 ==========
# Memory MCP (全局)
claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory

# Context7 MCP (项目)
claude mcp add context7 -s local -- npx -y @upstash/context7-mcp

六、验证安装

bash 复制代码

# 查看已安装插件
/plugins

# 查看可用技能
/skills

# 查看 MCP 服务器状态
claude mcp list

# 测试记忆功能
/mem:mem-search "project"

# 查看 HUD 是否显示
# 观察底部状态行是否显示 Token、上下文等信息

七、文件结构

plain 复制代码

~/.claude/
├── settings.json                    # 全局设置
│                                   # - enabledPlugins (已启用的插件)
│                                   # - extraKnownMarketplaces (Marketplace 列表)
│                                   # - statusLine (claude-hud 配置)
│                                   # - permissions (权限白名单)
├── mcp.json                         # 全局 MCP 配置
├── plugins/
│   ├── claude-hud/                  # HUD 插件目录
│   │   ├── dist/                    # 编译输出
│   │   └── config.json              # HUD 显示配置
│   └── marketplaces/                # Marketplace 缓存
│       ├── thedotmack/
│       ├── superpowers-marketplace/
│       ├── anthropic-agent-skills/
│       └── jarrodwatts/claude-hud/
└── projects/
    └── D--workspace-idea-RiceGrrain/
        └── memory/                  # 项目记忆存储

D:\workspace\idea\RiceGrrain\.claude\
├── settings.json                    # 项目设置 (可选)
└── mcp.json                         # 项目 MCP 配置

最后更新：2026-04-29