PhoenixM
LiFengMing
2026-04-12
目录

Claude Code 插件安装与使用指南

# Claude Code 插件安装与使用指南

通过插件扩展 Claude Code 的能力，让 AI 助手拥有持久记忆和更多专业功能

# 目录

# 插件系统概述

# 什么是 Claude Code 插件

Claude Code 插件是可扩展的功能模块，可以为 AI 助手添加新的能力：

  • 持久记忆：跨会话保持上下文
  • 专业工具：领域特定的功能增强
  • 自动化流程：简化重复性任务
  • 外部集成：连接第三方服务

# 插件目录结构

.claude-plugin/
├── marketplace.json    # 插件市场元数据
├── commands/           # 自定义命令
├── hooks/              # 生命周期钩子
└── skills/             # 专业技能包
1
2
3
4
5

# 插件安装方法

# 方法一：命令行安装（推荐）

# 使用 npx 一键安装
npx claude-mem install
1
2

# 方法二：插件市场安装

# 1. 打开插件市场
/plugin marketplace

# 2. 搜索并添加插件
/plugin marketplace add thedotmack/claude-mem

# 3. 安装插件
/plugin install claude-mem
1
2
3
4
5
6
7
8

# 方法三：全局安装

# 全局安装（仅安装 SDK，不注册钩子）
npm install -g claude-mem
1
2

# 方法四：项目本地安装

# 在当前项目安装
npm install claude-mem --save-dev
1
2

# 针对特定 IDE 安装

# 为 Gemini CLI 安装
npx claude-mem install --ide gemini-cli

# 为 VS Code 安装
npx claude-mem install --ide vscode

# 为 JetBrains 安装
npx claude-mem install --ide jetbrains
1
2
3
4
5
6
7
8

# OpenClaw 网关安装

# 在 OpenClaw 网关上安装
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
1
2

重要提示：npm install -g claude-mem 仅安装 SDK/库，不会注册插件钩子或设置 worker 服务。始终使用 npx claude-mem install 或 /plugin 命令进行安装。

# 插件完整分类列表

每个插件都是一个带有其自身配置的文件夹。您可以浏览可用的插件并从中安装。

# 技术类插件（开发者专用）

插件名 功能描述 适用场景
typescript-lsp TypeScript 语言服务器集成。支持类型检查、跳转定义和错误诊断 TypeScript 项目开发
playwright 浏览器自动化和测试。启动浏览器、导航页面、截图、填写表单、E2E 测试 前端开发和测试
security-guidance 扫描常见漏洞。检测硬编码密钥、身份验证绕过模式和注入风险 代码安全审查
code-review 结构化代码审查，带有质量评分。提供 PR 审查框架 代码质量检查
pr-review-toolkit 专注于 PR 工作流程。生成审查评论、建议更改、检查常见问题 团队协作审查
commit-commands 标准化提交消息。支持常规提交和一致的 git 历史 Git 工作流规范化
code-simplifier 识别过于复杂的代码并建议简化。测量圈复杂度，标记复杂函数 代码重构优化
context7 文档查找。获取最新的库文档，不依赖训练数据 使用快速发展的框架

# 非技术类插件（工作流/风格/项目管理）

插件名 功能描述 适用场景
claude-md-management 自动维护 CLAUDE.md 项目文件。保持结构化，更新部分，防止混乱 项目文档维护
explanatory-output-style 改变输出风格，使其更具教育性。解释决策背后的"为什么" 学习和文档编写
learning-output-style 针对教学的输出风格。渐进式分解内容，检查理解情况 教学和知识传递
frontend-design UI/UX 设计模式和指导。参考设计系统和可访问性标准 前端界面开发
claude-code-setup 项目搭建。帮助以适当的结构、配置和样板代码设置新项目 新项目初始化
feature-dev 特性开发工作流。结构化需求、设计、实施、测试流程 新功能开发

提示：还有约 13 个插件未列出，因为它们要么非常小众，要么测试不够充分。您可以自己浏览完整目录。

# 插件推荐与选择指南

# 高影响插件（强烈推荐）

排名 插件 推荐理由
1 typescript-lsp 代码质量差异明显，Claude 停止猜测类型，实际进行检查
2 security-guidance 能在未标记代码中发现真实安全问题（如身份验证绕过）
3 context7 再也不会有过时 API 建议，实时查找当前文档
4 playwright 如果有前端功能，能通过 Claude 运行真实浏览器测试是显著提升

# 值得尝试的插件（视工作流而定）

排名 插件 适用人群
5 code-review 独立开发者，需要第二双眼睛审查代码
6 claude-md-management CLAUDE.md 经常变得混乱的用户
7 explanatory-output-style 希望理解 Claude 编写的代码，而不仅仅是使用它
8 frontend-design 构建 UI 并希望有更好的默认设置

# 安装建议

对于 TypeScript 开发者：

npx typescript-lsp install
npx context7 install
npx security-guidance install
1
2
3

对于前端开发者：

npx playwright install
npx frontend-design install
npx context7 install
1
2
3

对于独立开发者：

npx code-review install
npx security-guidance install
npx claude-md-management install
1
2
3

# 实战案例：claude-mem 持久记忆插件

# 插件介绍

claude-mem (opens new window) 是为 Claude Code 构建的持久记忆压缩系统。

核心功能：

  • 自动捕获工具使用观察
  • 生成语义摘要
  • 跨会话保持项目上下文
  • 渐进式上下文披露
  • 基于技能的搜索

# 安装步骤

# 1. 基础安装

npx claude-mem install
1

# 2. 验证安装

# 检查插件状态
/plugin list

# 查看已安装插件
/plugin status
1
2
3
4
5

# 3. 重启 Claude Code

# 退出当前会话
/exit

# 重新启动
claude
1
2
3
4
5

# 核心功能详解

# 功能 1：持久记忆

# 自动捕获会话上下文
# 新会话自动恢复之前上下文

# 示例工作流
# 会话 1：分析项目架构
claude "帮我分析这个项目的架构"

# 会话 2：继续之前的工作（上下文自动恢复）
claude "基于之前的分析，帮我实现这个功能"
1
2
3
4
5
6
7
8
9

# 功能 2：搜索工具

# 使用自然语言搜索项目历史
mem-search "上次我们讨论的数据库设计"

# 搜索特定主题
mem-search "API 接口定义"

# 搜索代码片段
mem-search "用户认证函数"
1
2
3
4
5
6
7
8

# 功能 3：隐私控制

# 使用 <private> 标签排除敏感内容
# Claude 会自动忽略标记的内容

# 示例
<private>
这里的内容不会被存储到记忆中
</private>
1
2
3
4
5
6
7

# 功能 4：Web 查看器

# 启动 Web 查看器
# 访问 http://localhost:37777

# 实时查看记忆流
http://localhost:37777

# 查看特定观察
http://localhost:37777/api/observation/{id}
1
2
3
4
5
6
7
8

# 使用示例

# 示例 1：项目管理

# 会话 1：项目分析
claude "分析当前项目的依赖关系"
# claude-mem 自动捕获分析结果

# 会话 2：继续开发
claude "基于之前的依赖分析，添加新的功能模块"
# 上下文自动注入，无需重复说明
1
2
3
4
5
6
7

# 示例 2：代码审查

# 会话 1：审查代码
claude "审查当前分支的代码变更"
# 审查结果被记忆

# 会话 2：修复问题
claude "修复之前审查发现的问题"
# AI 记得之前的审查结果
1
2
3
4
5
6
7

# 配置选项

在 .claude/settings.json 中配置：

{
  "mem": {
    "enabled": true,
    "autoCapture": true,
    "maxMemorySize": 10000,
    "excludedPaths": [
      "node_modules",
      ".git",
      "dist"
    ],
    "privacyMode": false,
    "compressionLevel": "medium"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 插件管理命令

# 插件市场操作

# 打开插件市场
/plugin marketplace

# 搜索插件
/plugin marketplace search "memory"

# 添加插件到本地
/plugin marketplace add thedotmack/claude-mem

# 查看市场中的热门插件
/plugin marketplace trending
1
2
3
4
5
6
7
8
9
10
11

# 插件安装与卸载

# 安装插件
/plugin install claude-mem

# 卸载插件
/plugin uninstall claude-mem

# 更新插件
/plugin update claude-mem

# 更新所有插件
/plugin update --all
1
2
3
4
5
6
7
8
9
10
11

# 插件状态查看

# 列出已安装插件
/plugin list

# 查看插件详细信息
/plugin info claude-mem

# 检查插件状态
/plugin status

# 查看插件日志
/plugin logs claude-mem
1
2
3
4
5
6
7
8
9
10
11

# 插件启用与禁用

# 启用插件
/plugin enable claude-mem

# 禁用插件
/plugin disable claude-mem

# 临时禁用所有插件
/plugin disable --all
1
2
3
4
5
6
7
8

# 插件配置与设置

# 全局配置

位置：~/.claude/settings.json

{
  "plugins": {
    "autoUpdate": true,
    "allowUnverified": false,
    "marketplace": {
      "enabled": true,
      "registry": "https://plugins.claude.com"
    }
  },
  "claude-mem": {
    "enabled": true,
    "autoCapture": true,
    "maxContextSize": 50000
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 项目配置

位置：.claude/settings.local.json

{
  "plugins": {
    "claude-mem": {
      "enabled": true,
      "projectSpecific": true,
      "excludedPaths": ["secret/", "config/"]
    }
  }
}
1
2
3
4
5
6
7
8
9

# 环境变量配置

# 设置插件配置
export CLAUDE_MEM_ENABLED=true
export CLAUDE_MEM_AUTO_CAPTURE=true
export CLAUDE_MEM_MAX_MEMORY=10000
1
2
3
4

# 常见问题与排查

# 问题 1：插件安装失败

症状：

Error: Failed to install plugin
1

解决方案：

# 1. 检查网络连接
ping plugins.claude.com

# 2. 清除缓存
/plugin cache clean

# 3. 重新安装
npx claude-mem install --force
1
2
3
4
5
6
7
8

# 问题 2：插件加载失败

症状：

Plugin marketplace not found
1

解决方案：

# 1. 检查 .claude-plugin 目录
ls -la .claude-plugin/

# 2. 创建 marketplace.json
mkdir -p .claude-plugin
echo '{"name": "claude-mem"}' > .claude-plugin/marketplace.json

# 3. 重启 Claude Code
/exit && claude
1
2
3
4
5
6
7
8
9

# 问题 3：插件冲突

症状：

Plugin conflict detected
1

解决方案：

# 1. 查看冲突详情
/plugin conflict info

# 2. 禁用冲突插件
/plugin disable conflicting-plugin

# 3. 更新到兼容版本
/plugin update --all
1
2
3
4
5
6
7
8

# 问题 4：内存泄漏

症状：

Memory usage increasing
1

解决方案：

# 1. 检查内存使用
/plugin memory claude-mem

# 2. 清理记忆
mem-clear all

# 3. 调整配置
# 在 settings.json 中减小 maxMemorySize
1
2
3
4
5
6
7
8

# 问题 5：权限问题

症状：

Permission denied
1

解决方案：

# 1. 检查权限设置
cat ~/.claude/settings.json

# 2. 添加插件权限
{
  "permissions": {
    "allow": [
      "Plugin(claude-mem:*)"
    ]
  }
}

# 3. 以管理员身份运行（如需）
sudo npx claude-mem install
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 调试技巧

# 启用插件调试模式
/plugin debug claude-mem --enable

# 查看插件日志
/plugin logs claude-mem --tail 100

# 检查插件依赖
/plugin deps claude-mem

# 验证插件完整性
/plugin verify claude-mem
1
2
3
4
5
6
7
8
9
10
11

# 热门插件推荐

# 1. claude-mem - 持久记忆

功能： 跨会话保持上下文 安装： npx claude-mem install 适用场景： 大型项目、长期开发

# 2. code-review - 代码审查

功能： 自动化代码审查 安装： /plugin install code-review 适用场景： PR 审查、代码质量检查

# 3. deploy-helper - 部署助手

功能： 自动化部署流程 安装： /plugin install deploy-helper 适用场景： CI/CD、生产部署

# 4. security-scan - 安全扫描

功能： 代码安全漏洞检测 安装： /plugin install security-scan 适用场景： 安全审计、合规检查

# 5. test-runner - 测试运行器

功能： 自动化测试执行 安装： /plugin install test-runner 适用场景： 单元测试、集成测试

# 插件开发指南

# 创建新插件

# 1. 创建插件目录
mkdir my-plugin && cd my-plugin

# 2. 初始化插件
/plugin init

# 3. 编写插件逻辑
# 在 commands/ 目录中添加命令
# 在 hooks/ 目录中添加钩子

# 4. 发布插件
/plugin publish
1
2
3
4
5
6
7
8
9
10
11
12

# 插件结构

my-plugin/
├── package.json          # 插件包信息
├── .claude-plugin/
│   └── marketplace.json  # 市场元数据
├── commands/
│   └── my-command.js     # 自定义命令
├── hooks/
│   ├── pre-read.js       # 读取前钩子
│   └── post-edit.js      # 编辑后钩子
└── skills/
    └── my-skill/
        └── SKILL.md      # 专业技能
1
2
3
4
5
6
7
8
9
10
11
12

# 发布到插件市场

# 1. 注册开发者账号
/plugin developer register

# 2. 提交插件审核
/plugin submit my-plugin

# 3. 等待审核通过
# 4. 插件自动发布到市场
1
2
3
4
5
6
7
8

# 最佳实践

# 1. 插件管理

  • 定期更新插件
  • 禁用不需要的插件
  • 检查插件权限
  • 备份配置文件

# 2. 性能优化

  • 限制插件数量
  • 调整内存配置
  • 使用缓存机制
  • 监控资源使用

# 3. 安全建议

  • 仅从官方市场安装
  • 检查插件权限
  • 定期安全扫描
  • 及时更新修复

# 4. 故障预防

  • 定期备份配置
  • 记录安装日志
  • 测试插件兼容性
  • 准备回滚方案

# 资源链接

  • claude-mem 官方仓库：https://github.com/thedotmack/claude-mem
  • claude-mem 文档：https://docs.claude-mem.ai/
  • 插件市场：https://plugins.claude.com
  • Claude Code 文档：https://docs.anthropic.com/claude-code

# 版本信息

  • 文档版本: 1.0
  • 更新日期: 2026年4月12日
  • 适用版本: Claude Code 4.5+
  • 测试平台: macOS, Linux

本文档以 claude-mem 为例，演示了 Claude Code 插件的完整安装与使用流程

编辑 (opens new window)
#Claude#AI#CLI#插件#扩展
上次更新: 2026/04/13, 00:01:03
Claude Code 使用手册

←

最近更新
01
Anthropic 官方 Skills 介绍与使用指南
04-12
02
AI资源
04-02
03
LLM 技术体系
03-15
更多文章>
Theme by Vdoing | Copyright © 2018-2026 LiFengMing | MIT License