折腾了一段时间 Claude Code,总结了一套自用的 plugins + MCP 组合。这套配置让我的 AI 辅助开发工作流从"聊天写代码"变成了"有记忆、有规划、有文档、有双重验证"的完整流水线。分享给同样在用 Claude Code 的朋友们。
一、为什么要配置这些?
Claude Code 开箱即用已经很强,但默认状态下有几个明显短板:
- 没有记忆:每次新会话都从零开始,上次的背景和决策全部消失
- 没有规划:面对复杂任务容易跑偏,缺乏结构化的任务追踪
- 文档滞后:依赖训练数据,遇到新版本 API 容易给出过时代码
- 单一视角:只有 Claude 一个模型在看代码,可能存在盲点
下面这套配置分别解决这四个问题。
二、Skills(技能插件)
1. planning-with-files --- Manus 式持久化规划
安装:
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
这个插件的灵感来自 Manus 的工作方式。它让 Claude Code 在处理复杂任务时,自动创建并维护一组 Markdown 文件来追踪进度:
task_plan.md--- 任务拆解和整体规划findings.md--- 调查发现和中间结论progress.md--- 当前进度和已完成步骤
最实用的地方在于:执行 /clear 清空上下文后,Claude 能从这些文件中完整恢复状态,不会丢失之前的工作进展。对于跨多个会话的大型功能开发来说,这个特性非常关键。
安装完后,在会话中输入 /planning-with-files 即可手动触发,也可以在复杂任务开始时让 Claude 自动激活。
适合场景: 重构、多步骤功能开发、需要跨会话持续推进的项目。
2. agent-skills (by Addy Osmani) --- 生产级工程工作流
安装:
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
这是 Google Chrome 团队的 Addy Osmani 维护的一套工程技能包,包含 20 个覆盖完整开发生命周期的 skills:
DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP
/spec /plan /build /test /review /ship
这些 skills 把 Google 工程文化中的最佳实践(如测试金字塔、Hyrum 定律、Chesterton 围栏原则等)编码成 Claude 能直接执行的工作流。安装后可以直接用斜杠命令触发对应阶段:
/spec--- 在写任何代码之前,先生成一份完整的 PRD(产品需求文档)/plan--- 把需求拆解成可追踪的任务列表(生成tasks/plan.md和tasks/todo.md)/build--- 按薄垂直切片逐步实现,每步都包含测试和提交/review--- 从正确性、可读性、架构、安全、性能五个维度做代码审查/ship--- 并行运行代码审查、安全审计和测试覆盖检查,给出上线决策
插件还包含三个专家角色(Agent Personas):code-reviewer、security-auditor、test-engineer,可以作为 subagent 被独立调用。
适合场景: 想让 Claude Code 像一个有纪律的高级工程师一样工作,而不是随意地"帮你写代码"。
3. claude-mem --- 跨会话持久记忆
安装:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
这是整套配置里最"黑魔法"的一个。claude-mem 在后台运行一个本地 Worker 服务(默认端口 37777),通过 5 个生命周期钩子(SessionStart、UserPromptSubmit、PostToolUse、Summary、SessionEnd)全程监控并压缩 Claude 的行为,存入本地 SQLite 数据库。
核心能力:
- 自动捕获:每次工具调用、代码修改、架构决策都会被记录,附带前后文快照
- AI 压缩:用 Claude Agent SDK 将原始观察压缩成语义化的摘要,分类为 bugfix、decision、feature、discovery 等类型
- 智能注入:下次会话开始时,自动检索并注入相关历史上下文
- 自然语言查询:直接问 "上次我们怎么处理认证那个 bug 的?" 即可搜索历史
安装后还有一个 Web 界面(访问 http://localhost:37777),可以可视化查看整个开发时间线。
注意:claude-mem 依赖 Node.js 20+ 和 Bun,安装时会自动处理依赖。建议通过
/plugin命令安装,而不是npm install -g,后者只安装 SDK,不会注册 hooks。
适合场景: 长期项目、需要保持决策一致性、不想每次都重新解释项目背景。
三、MCP 服务
Context7 --- 实时版本文档注入
安装:
bash
claude mcp add --scope user \
--header "CONTEXT7_API_KEY: YOUR_API_KEY" \
--transport http \
context7 https://mcp.context7.com/mcp
API Key 免费获取:context7.com/dashboard,注册后即可拿到,使用 Key 后速率限制更高。
Context7 由 Upstash 开发,解决的是 LLM 一个根本性问题:训练数据会过时。当你问 Claude 如何用 Next.js 15 配置 middleware 时,它可能给你 Next.js 13 时代的写法。
Context7 提供两个核心工具:
resolve-library-id--- 将库名映射到 Context7 内部 IDquery-docs--- 根据 ID 拉取对应版本的最新文档
使用方式极简,在任何 prompt 末尾加上 use context7 即可:
如何在 Next.js 15 中配置 middleware?use context7
用 Prisma 写一个包含关联查询的例子。use context7
Supabase Row Level Security 的语法是什么?use context7
也可以指定具体库 ID 跳过解析步骤:
use context7 with /vercel/next.js for app router setup
建议在项目的 CLAUDE.md 里加一条规则,让 Context7 自动触发:
当需要查阅任何库或框架的文档时,自动使用 Context7 MCP。
适合场景: 使用快速迭代的框架(Next.js、React、Tailwind 等),或者任何需要查阅 API 文档的开发工作。
四、进阶玩法:Claude + Codex 双模型协作
这是最近才开始用的新工作流,灵感来自 OpenAI 官方发布的 codex-plugin-cc。
核心思路: 用 Claude Code 作为主力实现,用 Codex 作为独立的第二双眼睛做验证。两个来自不同公司、不同训练数据的模型,对同一份代码做独立判断,往往能发现单一模型的盲点。
安装 Codex 插件后,可以在 Claude Code 内直接调用:
/codex:review # 标准代码审查
/codex:adversarial-review # 对抗性审查,专门质疑你的设计决策
/codex:rescue # 把当前卡住的任务完全交给 Codex 处理
/codex:adversarial-review 特别有用,它会专门挑战实现中的假设、权衡和潜在失败模式(认证、数据丢失、竞态条件等),是一个很好的"魔鬼代言人"。
另一个实用模式是用 Git Worktrees 让两个工具并行处理不同任务:
bash
# 让 Claude 做认证重构,同时让 Codex 做 API 端点开发
git worktree add ../task-auth auth-refactor
git worktree add ../task-api api-endpoints
# 终端1
cd ../task-auth && claude
# 终端2
cd ../task-api && codex
这个工作流需要先安装 Codex CLI 并登录(支持 ChatGPT 账号或 OpenAI API Key)。
五、完整工作流示意
一个典型的功能开发会话看起来是这样的:
1. 启动会话 → claude-mem 自动注入相关历史上下文
2. /spec → agent-skills 生成需求文档
3. /plan → 拆解任务,生成 task_plan.md(planning-with-files 接管追踪)
4. /build → 逐步实现,context7 实时注入文档
5. /review → Claude 自我审查
6. /codex:adversarial-review → Codex 对抗性验证
7. /ship → 最终检查,生成上线报告
8. 结束会话 → claude-mem 自动压缩并存储本次工作记录
六、配置总览
| 组件 | 类型 | 解决什么问题 |
|---|---|---|
| planning-with-files | Skill | 复杂任务规划 + 跨会话进度追踪 |
| agent-skills | Skill | 生产级工程工作流 + 代码质量保障 |
| claude-mem | Plugin | 跨会话持久记忆 + 历史搜索 |
| Context7 | MCP | 实时最新文档,杜绝过时 API |
| Codex Plugin | Plugin | 双模型独立验证,提升代码可靠性 |
这套配置目前跑得很稳,如果你也在用 Claude Code,欢迎参考。有问题或者有更好的组合方案,欢迎交流。