Context7 MCP Claude Code 指南
用 Context7 MCP 文档支撑 Claude Code：确认库和版本、核对来源，并针对已安装依赖测试代码。
Claude Code 使用 Context7 MCP 的核心摘要
Context7 检索当前软件库文档和示例，避免 Claude Code 仅凭模型记忆处理快速变化的 API。
使用指定软件包实现功能前应先调用，尤其是语法、配置或行为会随版本变化时。
确认解析出的软件包、目标版本、引用文档，并依据项目实际安装的依赖检查最终代码。
检索文档无法证明代码库假设、依赖解析、生成代码、编译、测试或运行时行为一定正确。
Context7 是面向软件库文档的依据层，不是通用网页搜索，也不是代码验证器。Claude Code 可以先解析软件库并检索与版本相关的聚焦文档，再制定方案或修改文件。可靠顺序是：识别项目实际依赖、解析准确库、只检索一个明确主题、说明相关依据、做最小代码修改，最后在本地验证。解析出的项目或版本不正确时，应先纠正检索，再生成代码。
如何形成以文档为依据的闭环
Claude Code 先检查 package.json、锁定文件、清单、导入和现有配置等仓库证据；Context7 再解析软件库身份，并围绕一个明确主题检索页面。随后 Claude 将文档上下文与实际安装版本对照，提出变更，只修改获批文件，再运行仓库检查。这个顺序可以避免宽泛文档结果覆盖代码库中的真实事实。
准确写出依赖名称；若行为可能随版本变化，还应提供锁定文件中的版本。让 Claude Code 说明 Context7 最终解析到哪个文档源。
修改文件前，先索要一份以文档为依据的简短方案，并要求区分文档中的事实与根据代码库作出的推断。
围绕某个方法、配置项、迁移或框架模式提出一个具体问题，并说明运行环境、语言和目标产物。不要用“把 React 全部讲一遍”之类请求稀释有效上下文。
核对包名、安装版本、模块格式、框架模式、配置惯例与现有抽象，记录文档与项目一致之处，以及代码库额外施加的约束。
完成最小获批修改后，运行类型检查、lint、单元或集成测试、构建检查和聚焦运行测试。文档依据只能减少猜测，最终实现必须由仓库证据验证。
判断任务是否适合 Context7
| 任务 | Context7 用途 | 还要检查 | 停止条件 |
|---|---|---|---|
| API 用法 | 当前签名、选项、返回类型与示例。 | 安装版本、类型、封装代码与测试。 | 解析库或版本不匹配时停止。 |
| 框架配置 | 支持的配置键、文件位置、模式与迁移说明。 | 现有配置、构建工具、环境与部署目标。 | 文档假设了其他路由、运行时或主版本时停止。 |
| 版本迁移 | 破坏性变化、替代 API 与升级顺序。 | 变更日志、锁定文件、对等依赖、codemod 与 CI。 | 资料未覆盖当前与目标版本时停止。 |
| 错误诊断 | 已记录限制与正确配置模式。 | 准确堆栈、复现步骤、源码与运行日志。 | 没有证据把错误与检索主题关联时停止。 |
| 仓库专属行为 | 仅用于外部库契约。 | 本地源码、架构决策、测试与 Git 历史。 | 答案主要依赖私有代码而非库文档时停止。 |
配置 Context7 MCP，并准确提出请求
当前官方推荐命令是 npx ctx7 setup --claude。它会通过 OAuth 授权、创建或选择 API 密钥，并让用户在 CLI + Skills 与 MCP 模式之间选择。Context7 CLI 要求 Node.js 18 或更高版本。如果远程服务器、无界面虚拟机或 SSH 会话中的浏览器无法回到同一台机器，应通过安全交互或密钥系统向 --api-key 传入已有密钥。
| 步骤 | 操作 | 适合场景 | 使用边界 |
|---|---|---|---|
| 配置 | 运行 npx ctx7 setup --claude，完成授权并选择 CLI + Skills 或 MCP。 | Claude Code 的官方引导式路径。 | 审查生成文件，不要把 API 密钥提交到版本控制。 |
| 插件 | 添加 Context7 marketplace，再安装 context7-plugin@context7-marketplace。 | Skill、docs-researcher Agent 与 /context7:docs 命令。 | 只从 Upstash 官方 marketplace 来源安装。 |
| 手动 MCP | 通过远程 HTTP 使用 https://mcp.context7.com/mcp；需要时通过客户端支持的安全请求头传入 API 密钥。 | 受控的手动配置，或不在引导流程中的客户端。 | 不要把密钥嵌入共享地址或已提交 JSON。 |
| 提示词 | 说明软件包、版本、问题和预期产物，并明确要求使用 Context7。 | API 迁移、配置、框架模式以及不熟悉的 SDK 方法。 | 请求过于宽泛时，可能检索到无关文档或错误的软件包。 |
| 验证 | 将答案与软件包元数据、锁定文件、测试和引用文档相互核对。 | 所有依赖特定版本行为的代码变更。 | 检索到的上下文能让答案更有依据，但不能替代代码库测试。 |
依赖检索结果前先验证安装
MCP 模式检查 claude mcp list、claude mcp get context7 与 /mcp；插件模式则确认 marketplace、插件状态、可用 Skill、docs-researcher Agent 和 /context7:docs 命令。
选择仓库中已经锁定的一个依赖，提出一个与版本相关的具体问题，并要求 Claude 说明解析到的 Context7 软件库身份、检索主题和实际使用的文档事实。
通过锁定文件与类型确认安装版本，再运行一个小型示例。即使工具成功返回，如果解析成了名称相似的其他软件包，也不能算验证通过。
Context7 已注册却不可用时，先检查 claude mcp logs context7、Node.js、代理或 TLS 限制、API 密钥状态与所选模式，再考虑重新安装。
提示词模板：“检查锁定文件，确认 [package] 的准确安装版本。使用 Context7 解析该软件库，并且只检索 [topic] 主题。报告解析结果、文档覆盖版本、文档事实，以及与当前仓库的任何不一致。提出最小变更，然后在编辑前停止。”
QVeris 如何补充 Context7 MCP 工作流
Context7 专注于软件库文档。当前 QVeris Tool 与 Provider 搜索均没有返回完全对应的 Context7 条目。只有任务还涉及其他外部能力时，才需要查阅 QVeris 文档，并在 演练场 中继续寻找合适工具。
- 使用 Context7 获取当前软件包文档和版本相关示例。
- 只有当前检索返回独立能力时才使用 QVeris，并先检查供应商、参数结构、约束与成本。
- 在文档检索、代码库修改、外部调用及结果回写之间保留明确的人工批准节点。
常见问题
不能。它能改善 Claude Code 可用的文档依据，但仍需核对软件包解析、代码库假设、编译结果、测试和运行时行为。
个人经常使用时可选用户范围；团队需要相同服务器定义时宜选项目范围，但凭据必须保存在提交文件之外。
MCP 为 Claude 提供原生文档工具；CLI + Skills 可以让工具面和上下文更聚焦。通过引导配置选择，再验证实际安装模式。
基础使用可能无需密钥，免费密钥可获得更高额度，私有仓库则需要密钥。应保存在版本控制之外，泄露后立即轮换。
请提供准确包名、生态、版本与主题，并在接受文档或生成代码前检查解析出的软件库身份。
重新安装前先检查 Claude MCP 日志、Node.js、网络与 TLS 规则、API 密钥、服务器配置和会话重载。