upstash/context7 skill 本地安装使用教程(新手)

装 upstash/context7 时，新手容易把它当成普通搜索插件。它真正解决的是另一个问题：让编码代理拿到当前版本的库文档和代码示例，减少训练数据过旧、API 幻觉和版本不匹配。

这个 skill 教程适合正在用 Cursor、Claude Code、Codex、OpenCode 或其他 MCP 客户端写代码的人。它有两条路：CLI + Skills 不要求 MCP，适合先跑通；MCP 适合让客户端原生调用文档工具。要注意，API Key 虽不是每一步都强制，但官方建议配置，用来提高限额。

先用 ctx7 setup 跑通，不要手写一堆配置

Context7 的一键路径需要 Node.js 18 或更高版本。它会通过 OAuth 认证、生成 API Key，并按你的选择安装对应 skill 或 MCP 配置。

node -v
npx ctx7 setup

如果只想给特定客户端装，可以加目标参数，例如 --cursor、--claude 或 --opencode。后面想撤掉配置，用 npx ctx7 remove 清理；如果曾全局安装过 CLI，再用 npm uninstall -g ctx7 移除全局包。

MCP 手动配置只需要抓住两个点

不走一键安装时，核心是 MCP 地址和请求头。官方给出的 MCP Server URL 是 https://mcp.context7.com/mcp，API Key 放在 CONTEXT7_API_KEY header 里。不同客户端界面不一样，但这两个字段不要填错。

第一次测试不要问宽泛问题

更稳的测试方式是给出库名、版本或 Context7 ID。比如已经知道库 ID，就直接写 /supabase/supabase 这类路径，让 Context7 跳过库匹配。CLI 也可以单独验证：

ctx7 library supabase auth
ctx7 docs /supabase/supabase "email password sign up"

这些边界先放在心里

upstash/context7 仓库主要承载 MCP server 源码；官方 README 也说明后端 API、解析引擎和抓取引擎不在这个仓库里。Context7 能显著减少过期文档带来的误判，但它不是安全审计器，也不能保证社区贡献文档永远完整。新手先用一个熟悉的库跑通命中，再把规则写进自己的编码代理，会比直接在正式项目里全量启用更稳。

读完后可以按这个顺序落地：先确认 Node 版本，再跑 npx ctx7 setup，用一个固定库 ID 查到文档后，再把 MCP 或规则接进常用客户端。能稳定命中文档，才算 Context7 真正进入你的写代码流程。