注册
Claude

Claude Code 配 Context7 MCP 查最新文档：两种安装方式、use context7 怎么写、指定库和版本

Claude Code 写出来的代码用了旧版 API？Context7 是一个把库的最新文档喂给编程助手的 MCP 服务。本文按 Context7 官方仓库和文档，讲两种安装方式、在 Claude Code 里的添加命令、use context7 与 library ID 的写法，以及使用时的注意事项。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-05 · 依据官方文档与公开资料整理 Pro 账号
本文根据 Context7 官方仓库与文档、Claude Code 官方《Connect Claude Code to tools via MCP》整理，资料核对于 2026-11-05。配图为本站整理的示意图，不是界面截图。本站（bigolab.com）不是 Anthropic 或 Context7 官方网站。

适用于谁

  • 发现 Claude Code 写的代码用了过时的 API、不存在的函数的人；
  • 常用 Next.js、Supabase、Cloudflare 这类更新很快的框架，想让它写代码前先看当前文档的人；
  • 已经会 claude mcp add，想要一个具体的文档类 MCP 例子的人。MCP 的基础配置见 /guides/claude-code-mcp-setup。

结论先说

  1. Context7 是第三方服务。 官方 README 的说法：它从源头拉取按版本区分的文档和代码示例，放进你的编程助手的上下文里，目的是避免过时示例和并不存在的 API。
  2. 有两种工作方式： 「CLI + Skills」（装一个让助手去调用 ctx7 命令的技能，不需要 MCP），或者「MCP」（注册一个 MCP 服务器，助手直接调用文档工具）。本文讲 MCP 方式。
  3. 一条命令安装： npx ctx7 setup，会用 OAuth 登录、生成 API Key 并安装对应的技能；可以选 CLI + Skills 或 MCP 模式，用 --claude 指定 Claude Code。官方说该 CLI 需要 Node.js 22.13 或更新版本。
  4. 手动添加： Context7 文档页给 Claude Code 的远程服务器写法是一条 claude mcp add，需要 API Key。
  5. 用的时候在提示词里写 use context7，或者装好技能 / 加规则让它自动用。

Context7 在 Claude Code 里的工作流程

图：本站根据 Context7 官方仓库 整理的示意图

一、安装方式 A：npx ctx7 setup

官方 README 给的是：

bash
npx ctx7 setup --claude

README 说明：它通过 OAuth 登录、生成 API Key 并安装合适的技能；--cursor、--claude、--opencode 用来指定目标助手。想撤销，运行 npx ctx7 remove；如果你还用 npm install -g ctx7 全局装过 CLI，要另外 npm uninstall -g ctx7。

二、安装方式 B：手动加到 Claude Code

Context7 文档的 Claude Code 一节给了两种写法。远程（HTTP）连接：

bash
claude mcp add --scope user --header "Authorization: Bearer YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

本地（stdio）连接：

bash
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

把 YOUR_API_KEY 换成你在 Context7 网站上生成的密钥。请自己保管，不要写进会提交到 Git 的文件，也不要贴给别人。

按 Claude Code 官方 MCP 文档，关于参数要知道三点：

  • --scope 有三档：local（默认，只在当前项目、只你自己）、project（写进项目根的 .mcp.json，通过版本控制与团队共享）、user（你所有项目都可用，只你自己）。上面用 user 是 Context7 文档的写法，个人用方便；若是团队项目，不要把 API Key 写进共享的 .mcp.json。
  • --transport 和 --header 也可以写成短形式 -t、-H。
  • Context7 文档还提到：如果你的客户端支持 MCP OAuth，可以把地址从 /mcp 改为 /mcp/oauth，这样用浏览器授权而不用手填密钥；官方说 OAuth 只用于远程 HTTP 连接，本地 stdio 要用 API Key。这条我没有在 Claude Code 里逐步验证，请自己试一次。

三、检查有没有装好

bash
claude mcp list

能看到 context7。进入会话后输入 /mcp，可以查看服务器状态。Claude Code 官方说明：认证类的问题会在 /mcp 里标出。

Context7 装好后没反应时先查什么

图：本站根据官方文档整理的示意图

四、怎么用：三个写法

1）在提示词末尾写 use context7。 README 的示例：

text
创建一个 Next.js 中间件，检查 cookie 里是否有有效的 JWT，没有就重定向到 /login。use context7

2）指定库的 ID。 README 说，如果你已经知道要用哪个库，直接在提示词里写它的 Context7 ID，就能跳过库匹配这一步。斜杠写法如下：

text
用 Supabase 实现邮箱密码登录。use library /supabase/supabase for API and docs.

3）写明版本。 README 说只要提示词里提到版本，Context7 会自动匹配合适的版本，例如「Next.js 16 的 proxy 怎么配置？use context7」。

想每次自动用，不想每次写： README 给了两个办法：用 ctx7 setup 装的技能会在遇到库相关问题时自动触发；或者手动加一条规则，Claude Code 放进 CLAUDE.md，例如：

text
需要库或 API 文档、生成代码、安装或配置步骤时，始终使用 Context7，不用我每次提醒。

CLAUDE.md 的写法见 /guides/claude-md-agents-md。

五、它实际提供哪些工具

官方 README 列出的 MCP 工具有两个：

  • resolve-library-id：把一个库名解析成 Context7 的库 ID，参数有 query（你的问题）和 libraryName（库名），都是必填；
  • query-docs：用库 ID 取文档，参数 libraryId 和 query 必填，language 可选，用于把某种语言的示例排在前面。

所以你会在 Claude Code 的输出里看到它先调 resolve-library-id 再调 query-docs，这是正常流程；写了库 ID 就可以省去第一步。

六、注意事项

  • 文档质量不由 Anthropic 担保。 Context7 在 README 的免责声明里说，其中的项目由社区贡献，不能保证所有库文档的准确、完整和安全；发现可疑内容可以用页面上的 Report 按钮举报。Claude Code 官方也提醒：连接前要确认你信任这个服务，能拉取外部内容的服务器可能带来提示注入风险。选型和审查思路见 /guides/mcp-servers-how-to-choose-audit。
  • 拿到文档不等于代码一定对。 让它改完之后仍然要跑测试、看 diff；工作流可参考 /guides/claude-code-best-practices。
  • 占用上下文。 取回来的文档会进入对话。只在需要查资料的任务里用，别在所有对话里都带上；省 token 的做法见 /guides/claude-code-context-compact。
  • 价格与额度 以 Context7 官网为准；官方价格页写明免费方案涵盖 MCP 服务器和 CLI，具体限额本文不写。

常见问题

Q：不装 MCP 能用吗？

可以。ctx7 setup 里的「CLI + Skills」模式不需要 MCP，是装一个技能，让助手去执行 ctx7 library <名字> <问题> 和 ctx7 docs <库ID> <问题> 两个命令。

Q：和 Claude Code 自带的网页搜索有什么区别？

本文只能说官方 README 的定位：Context7 提供的是按库、按版本整理好的文档片段。是否比网页搜索更适合你的场景，请自己对比，本文不下结论。

Q：订阅额度够用吗？

取回的文档会占用对话上下文，请留意用量；订阅选择见 /chongzhi/claude-code，价格和额度以官方页面当前显示为准。

相关教程

参考资料

  • Context7 GitHub：https://github.com/upstash/context7
  • Context7 文档：Install in clients — https://context7.com/docs/resources/all-clients
  • Claude Code 文档：Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp

Nathaniel 的更多内容

  1. 01

    Claude Personal Finance 是什么：连银行账户问花销、怎么开、只读权限、谁能用、怎么解除

    Claude 的 Personal Finance（beta）通过 Plaid 只读连接你的银行、信用卡、贷款和投资账户，在一页里看余额和花销并用自然语言提问。本文按官方帮助页讲谁能用（仅美国、Pro/Max/Ultra）、连接与解除步骤、Claude 能看什么，以及它做不到的事。

    Claude0
  2. 02

    Claude Code 离开一小时回来对话被「压缩」了：Idle compaction 是什么、条件、怎么关

    Claude Code 的 idle compaction 会在你离开约一小时后，把 200K token 以上的长对话先压缩成摘要，下一条消息就不用重新处理整段历史。本文按官方文档讲触发条件、看到什么提示、用 /config 或 idleCompaction 关闭、调阈值，以及恢复旧对话的用量警告。

    Claude0
  3. 03

    ChatGPT Computer History 是什么：Mac 桌面端的活动记忆怎么开、怎么暂停和清除、谁能用

    Computer History 是 ChatGPT macOS 桌面应用里默认关闭的可选功能，把你在应用和网站里的活动整理成记忆和时间线，供 ChatGPT 与 Codex 引用。本文按官方文档讲怎么开、记录什么不记录什么、怎么暂停与清除、数据存哪、谁能用，以及提示注入风险。

    ChatGPTCodex0
  4. 04

    Codex 输入框出现灰色建议：Composer predictions 是什么、Tab 接受、怎么关、谁能用

    Codex 桌面 App 的 Composer predictions（beta）会在 Codex 回完后，根据当前对话在输入框里给出下一条消息的建议，按 Tab 接受、不会自动发送。本文按官方帮助页讲谁能用、哪些线程支持、怎么关、算不算额度，以及没出现时怎么查。

    ChatGPTCodex0
  5. 05

    ChatGPT 隐私中心（Privacy Center）在哪里：隐私设置入口、三大分类和哪些套餐有

    ChatGPT 的 Privacy Center 把记忆、广告、位置、临时对话、锁定对话、两步验证、模型改进、数据导出和删号等入口集中到一页。本文按官方帮助页讲怎么打开、三大分类各有什么、哪些套餐有，以及它不会替你改任何设置。

    ChatGPT0
  6. 06

    Claude Code 处理大仓库：怎么让它只看需要的目录（子目录 CLAUDE.md、claudeMdExcludes、deny 规则）

    仓库太大，Claude Code 总在读无关文件、读进别的包的规则？本文按官方大仓库指南讲：从哪个目录启动、子目录 CLAUDE.md、claudeMdExcludes、Read 的 deny 规则、worktree.sparsePaths、additionalDirectories，以及一份合并后的配置示例。

    Claude0

同产品的其他教程

  1. 01

    Claude Code 在 CI 里跑：从本机 claude -p 到 GitHub Actions 的完整例子（自动审 PR、控成本）

    一条线走完 Claude Code 的 CI 用法：先在本机用 claude --bare -p 配 --json-schema 跑通，再写进 GitHub Actions 用 claude-code-action@v1 自动审 PR，最后加上 --max-turns、超时、并发限制来控成本，并附上常见故障的排查顺序。

    Claude0
  2. 02

    Claude Code 自定义 subagent 实例：测试员、调试员、只读调研员、只读数据库员怎么写

    四个可直接改的 subagent 实例：跑测试的 test-runner、找根因的 debugger、只读调研员、用 PreToolUse hook 限成只读 SQL 的 db-reader；讲 tools、disallowedTools、model、maxTurns 怎么配，怎么点名调用。

    Claude0
  3. 03

    Claude Code 的 CLAUDE.md 模板：前端、后端、数据分析各一份，附拆分与自检方法

    直接拿去改的三份 CLAUDE.md 模板（前端、后端、数据分析），每份都控制在官方建议的 200 行以内；再讲怎么用 .claude/rules 的 paths 拆出专属规则、用 @ 导入长文档，以及用 /context all 和 /doctor prompt-audit 检查是否生效。

    Claude0
  4. 04

    Claude Code 自己写一个插件并发布到 marketplace：plugin.json、marketplace.json、validate 到团队安装的完整流程

    想把自己写的 Skill、Hook 打包给团队用？按 Claude Code 官方 Plugins 文档，从目录结构、plugin.json、claude plugin validate，到写 marketplace.json、推到 Git、让同事一条命令安装，再到版本更新，走完一遍完整流程。

    Claude0
  5. 05

    Claude Code 写一个会自动触发的 Skill：从需求到触发，用 description、when_to_use 和 paths 控制它什么时候出场

    写好的 Skill 总是不触发，或者什么都触发？本文按 Claude Code 官方「Extend Claude with skills」走一遍完整实例：把「改数据库迁移前先检查」写成一个会自动出场的 Skill，包含 description、when_to_use、paths、附带脚本、触发测试和评估。

    Claude0
  6. 06

    Claude Code 配 Sentry MCP 排查线上报错：添加命令、浏览器授权、贴 issue 链接修 bug 和插件子智能体

    线上报错只能手动复制堆栈给 Claude Code？Sentry 官方提供 MCP 服务，可以让它直接读 issue、堆栈和 trace。本文按 Claude Code 官方 MCP 文档和 Sentry MCP 官方说明，讲添加命令、/mcp 授权、典型排查流程、插件方式和自托管注意事项。

    Claude0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～