ai使用的工具 Claude Code / Codex MCP 与 Plugins 配置指南本文档整理我当前使用的 MCP 和 Plugins，方便后续查阅、维护和扩展。适用环境：Claude Code（终端）+ Codex（终端）1. MCP1.1 codegraph — 代码智能知识图谱提供代码的 符号、依赖关系和文件结构 索引查询。项目地址：https://github.com/colbymchenry/codegraph包名：@colbymchenry/codegraph能力一览工具作用典型问题codegraph_context按任务描述返回入口、关键符号、调用关系和代码上下文"这个功能怎么实现？"codegraph_search按名称搜索符号"有没有 login 方法？"codegraph_node查看单个符号详情"UserService 在哪？"codegraph_explore一次查看多个相关符号/文件源码"认证相关函数一起看"codegraph_callers查询"谁调用了这个符号""谁在用这个函数？"codegraph_callees查询"这个符号调用了谁""函数内部依赖了什么？"codegraph_trace追踪从 A 到 B 的调用路径"请求怎么走到数据库？"codegraph_impact评估修改某个符号的影响范围"改这个方法会波及哪？"codegraph_files查看文件树和符号分布"项目目录结构？"codegraph_status查看索引状态"索引是否正常？"适用场景阅读陌生项目时快速建立结构认知调试时梳理调用链重构前评估影响面比 grep + Read 更快地定位关键实现安装# 第一步：全局安装 npm install -g @colbymchenry/codegraph # 第二步：运行，自动配置 Claude Code 和 Codex npx @colbymchenry/codegraphnpx @colbymchenry/codegraph 会自动向 Claude Code 和 Codex 的配置文件写入 MCP server，无需手动编辑 settings.json。更新npm install -g @colbymchenry/codegraph@latest npx @colbymchenry/codegraph更新后重新执行一次自动配置，确保 Claude Code / Codex 的配置与新版本一致。卸载npm uninstall -g @colbymchenry/codegraph卸载后还需手动清理 Claude Code 和 Codex 配置文件中对应的 MCP server 条目：~/.claude/settings.json → 删除 mcpServers.codegraph验证在 Claude Code 会话中调用 codegraph_status，能正常返回即说明接入成功检查 ~/.claude/settings.json 中是否包含 codegraph 的 MCP server 配置使用方式初始化索引codegraph init -i用途：在当前项目中初始化 codegraph 索引为后续的符号查询、调用链分析、影响面分析建立本地数据适用场景：第一次在某个仓库中使用 codegraph新仓库还没有建立索引时建议：进入项目根目录后执行初始化完成后，再在 Claude Code 或 Codex 中使用相关 MCP 工具同步索引codegraph sync用途：同步当前项目代码到 codegraph 索引在代码新增、修改较多后，刷新索引内容适用场景：拉取新代码后大量修改代码后发现查询结果与当前代码不一致时建议：在重要改动后执行一次如果怀疑索引过旧，优先先执行 codegraph sync使用建议场景推荐工具理解某个功能怎么实现codegraph_context → codegraph_explore追踪调用链codegraph_trace → codegraph_callers / codegraph_callees评估改动影响codegraph_impact → codegraph_callers按名字定位符号codegraph_search → codegraph_node2. Plugins2.1 Superpowers — 终端 Agent 工作流技能包为 Claude Code / Codex 提供系统化的工作流方法论，覆盖从规划到验收的完整开发周期。主要 Skills流程与规划Skill作用superpowers:using-superpowers总控规则，约束 skill 使用流程superpowers:brainstorming需求梳理、方案设计前的脑暴superpowers:writing-plans多步骤任务的实施计划superpowers:executing-plans按计划执行并检查superpowers:subagent-driven-development多子 agent 协作开发superpowers:dispatching-parallel-agents并行分派独立任务开发与调试Skill作用superpowers:test-driven-developmentTDD 工作流superpowers:systematic-debugging系统化排查 bugsuperpowers:verification-before-completion完工前验证评审与收尾Skill作用superpowers:requesting-code-review主动请求代码审查superpowers:receiving-code-review处理收到的 review 意见superpowers:finishing-a-development-branch分支收尾：合并、提 PR配套增强Skill作用superpowers:using-git-worktreesgit worktree 隔离工作区superpowers:writing-skills编写/修改 skill 本身安装# Claude Code claude plugins install superpowers安装完成后，相关 skills 会出现在可用技能列表中。Codex 也会自动配置。更新claude plugins update superpowers卸载claude plugins uninstall superpowers验证在 Claude Code 会话中输入 /superpowers:brainstorming，能正常触发即说明安装成功使用建议场景推荐组合新功能开发brainstorming → writing-plans → test-driven-development → verification-before-completion修 bugsystematic-debugging → verification-before-completion代码审查requesting-code-review / receiving-code-review分支收尾finishing-a-development-branch3. Superpowers 与 Codegraph 配合使用Superpowers 决定“应该怎么做”Codegraph 帮助“快速看清代码结构”场景流程做功能前brainstorming → codegraph_context → writing-plans修 bug 时systematic-debugging → codegraph_trace → verification-before-completion改公共模块codegraph_impact → writing-plans → requesting-code-review