Claude Code 插件与 MCP 配置指南

总览

本机 Claude Code 的装配分为四层：

层	内容
插件（Plugins）	12 个，来自 3 个 marketplace（1 官方仓库 + 2 第三方）；精简后的「必备集」10 个 + 可选 2 个
MCP 服务器	2 个 user 级独立 MCP + 若干插件自带 MCP
Hooks	通知、RTK 命令代理、skill 软链、remember 记忆等
全局配置	`~/.claude/CLAUDE.md` 规范、项目 memory、bypassPermissions

插件（Plugins）

历史上装过 50+ 插件，后按「够用就好」精简。当前必备集 10 个 + 可选 2 个（装了更好，缺失不算故障）。

官方 marketplace：anthropics/claude-plugins-official

插件	必备?	用途
superpowers	必备	结构化工作流 skill 集（brainstorming / TDD / systematic-debugging / writing-plans 等），原始项目见 obra/superpowers
skill-creator	必备	创建/优化 skill 的标准工具（本机规范：新建 skill 必须走它）
code-review	必备	代码审查（`/code-review`，含 ultra 多智能体云审查）
frontend-design	必备	前端视觉设计指导
playwright	必备	浏览器自动化 MCP，基于 microsoft/playwright-mcp
remember	必备	会话历史记忆（`.remember/` 时间线：now / today / recent / archive）
typescript-lsp	必备	TypeScript 语言服务（LSP 级跳转/诊断，替代盲改类型）
claude-md-management	必备	CLAUDE.md 审计与维护
context7	可选	实时拉取库/框架最新文档的 MCP，基于 upstash/context7
vercel	可选	Vercel 部署/环境变量/AI SDK 全家桶

第三方

插件	来源	必备?	用途
claude-hud	jarrodwatts/claude-hud	必备	状态栏 HUD（statusline，显示模型/上下文/耗时等）
context-mode	mksglu/claude-context-mode	必备	上下文窗口优化：sandbox 工具输出（最高 98% 压缩）、SQLite 会话记忆 + FTS5/BM25 检索、"think in code"。插件方式装完自带全套 hooks + 11 个 `ctx_*` MCP 工具

MCP 服务器（user 级独立注册）

MCP	安装形态	用途
codegraph	本地 CLI `codegraph serve --mcp`	代码知识图谱：符号级源码 + 调用链查询，替代 grep+read
lighthouse-mcp	全局 npm + node 直跑 dist	网页性能 / Core Web Vitals / SEO / 无障碍审计

安装心得：npm 形态的 MCP 用「全局安装 + node 直跑 dist/index.js」而不是 npx @latest——npx 冷启约 6s 会超过健康检查窗口，出现假性 "Failed to connect"；直跑 dist 压到约 1s。注意 volta 的 node 路径含版本号，node 升级后入口路径会失效，需要用 $(npm root -g) 现算。

插件自带的 MCP（随插件启用）：playwright、context7、vercel、context-mode（6 个 sandbox + 5 个 meta，共 11 个 ctx_* 工具）。其中 Playwright MCP 通过 --output-dir 把截图/日志等产物统一落到中央目录，不污染项目。

RTK（Rust Token Killer）

省 token 的命令代理：通过 PreToolUse(Bash) hook 透明拦截 git status / docker ps / 构建测试等啰嗦命令，输出进模型上下文前先过滤压缩，官方数据省 60-90% token。

rtk --version   # 0.43.0
rtk gain        # 查看累计省了多少 token

Hooks 与状态栏

RTK hook：PreToolUse(Bash) → 命令改写为 rtk <cmd>
通知：claude-island-state.py + notify 配置（任务完成/需确认时系统通知）
remember：会话时间线自动记录（now → today → recent → archive 滚动归档）
vft-ai-skill-symlink：本地 skill 软链维护
状态栏：claude-hud

全局配置

~/.claude/CLAUDE.md：全局规范（中文回复、Playwright 产物中央目录、CodeGraph 优先、文档配图统一用 co-infographic-generator 等）+ RTK.md 引用
项目 memory：~/.claude/projects/<project>/memory/，持久化跨会话经验（80+ 条）

配置基线（换机/重装后必须齐全）

以下是环境自检时逐项核对的「配置基线」，缺任一项都会拉低使用体验（多余弹窗 / 权限反复确认）：

配置项	作用	位置
`permissions.defaultMode: bypassPermissions`	免每次工具调用确认	`~/.claude/settings.json`
`bypassPermissionsModeAccepted: true`	免每次启动的 Bypass 模式警告弹窗（点过 "Yes, I accept" 后 CC 自写，未公开字段）	`~/.claude.json`
`projects["$HOME"].hasTrustDialogAccepted: true`	免在家目录起 CC 时的「是否信任此目录」弹窗	`~/.claude.json`
codegraph 只读工具白名单	`mcp__codegraph__*` 免确认直接调用	`~/.claude/settings.json` 的 `permissions.allow`
全局 `~/.claude/CLAUDE.md`	全局规范载入	`~/.claude/`

前两项和第三项都在 ~/.claude.json 里。注意 CC 会话期间会持续写这个文件，别用 jq 读改写它（会和 CC 并发写竞争丢数据）——bypassPermissionsModeAccepted 最稳的开启方式是首次启动时点一次 "Yes, I accept"，让 CC 自己写。