概述

有没有这种经历：让 AI 写一段代码，它噼里啪啦写完了，一运行报错。或者调用的 API，文档里明明写着有，AI 却说"不存在"。

不是 AI 笨，是它学的东西有保质期——训练数据可能是几个月甚至一年前的，框架早就更新了好几版。

Context7 就是干这个的。它由 Upstash 团队开发，你提问时它去拉最新的官方文档，塞进 AI 的上下文里，让 AI 基于当前版本回答。

用法也简单，提问末尾加一句 use context7 就行。相当于告诉 AI：“别瞎猜，先翻翻最新文档再回我。”

为什么需要它？

💥 一个例子就够了

你想给个人网站加个「回到顶部」按钮——页面往下滑，右下角出现一个按钮，点一下回到最上面。

AI 凭旧知识写出来的是： 先加载一个几十 KB 的第三方库，再写一堆代码去调它。功能做出来了，但为了一个按钮，网页变慢、代码啰嗦。

实际上现在用不着这么麻烦： 浏览器自己就带了平滑滚动和滚动监听，几行代码搞定，不需要任何额外库。

AI 不知道这些，因为它学的是几年前的教材。

加上 use context7 后，Context7 先去查了最新文档，发现原生功能已经够用了。于是 AI 选了更轻量的方案，而不是拿老套路糊弄你。

这就像让朋友帮忙修手机，他凭记忆拆机，记的却是 3 年前的步骤——螺丝位置早变了。动手前先看一眼最新教程，就不会拆坏。

有没有 Context7 的区别

🔄 工作原理

操作就几步：

1
2
3
4
5
6
7
8
9

你提问（末尾加 use context7）
    ↓
Context7 认出你问的是哪个代码包
    ↓
去 GitHub、官方文档站扒最新内容
    ↓
筛选出最相关的几段，塞进 AI 的"上下文"
    ↓
AI 拿着最新文档回答你

“上下文"就是你跟 AI 当前对话里它能"看到"的内容。塞文档进去，相当于聊天时在桌上摊开一本参考书，AI 边看边答。

文档从哪来？GitHub 仓库、官方文档站，还有项目维护者写的 llms.txt（一种专门给 AI 看的文档索引文件）。

搜到一堆结果后，Context7 会用 LLM（大语言模型）再做一次智能排序，把最相关的那几段挑出来给你。

两种用法：

核心能力

智能匹配：你说名字，它去找地方

你要问 AI 某个工具怎么用，Context7 得先去网上找到这个工具的最新说明书。但网上叫同一个名字的东西可能有好几个，它得知道你到底说哪个。

一般的名字它能自己认出来。万一名字太常见、容易搞混，就用 谁/什么 的格式精确告诉它：

1

用 /tailwindlabs/tailwindcss 给我的网页加一个导航栏。use context7

这里的 tailwindlabs 是作者名，tailwindcss 是项目名。就像你搜"苹果”，可能是水果也可能是手机——说清楚就错不了。

支持哪些库

热门的都收录了：React、Next.js、Vue、Tailwind CSS、Express、Prisma、Supabase、TypeScript……完整列表在 context7.com/rankings。

版本感知

不同版本的 API 差别可能很大。直接说版本号，Context7 查对应版本的文档：

1
2
3

用 Vue 3 写一个计数器。use context7
用 Next.js 14 的 Pages Router 写 API 路由。use context7
用 Tailwind CSS v4 配置暗色模式。use context7

你要 iPhone 12 的拆机教程，别人就不会给你拿 iPhone 15 的来。

安装

一键安装

1

npx ctx7 setup

npx 是 Node.js 自带的命令，不需要额外安装。如果你还没装 Node.js，先去 nodejs.org 下载安装，装完就有 npx 了。

运行后它会：

1. 弹出浏览器让你登录授权（OAuth）
2. 生成一串 API Key（相当于你的"身份凭证"）
3. 自动配置好对应编辑器

三步走完，搞定。

想指定编辑器就加个参数：

1
2
3

npx ctx7 setup --claude      # Claude Code
npx ctx7 setup --cursor      # Cursor
npx ctx7 setup --opencode    # OpenCode

卸载：npx ctx7 remove

手动配置

自动安装不生效的话，手动加 MCP Server（可以理解为一个帮你查文档的后台服务）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "你的API密钥"
      }
    }
  }
}

不同工具的配置文件位置（~ 代表你电脑的用户目录，比如 Windows 上的 C:\Users\你的用户名）：

API Key 去 context7.com/dashboard 注册，格式是 ctx7sk...，免费用户也有额度。

✅ 验证

发一条测试：

1

写一个带按钮的计数器网页。use context7

AI 如果给出的是干净现代的代码，没有加载额外库，说明生效了。

使用方法

基础用法

提问末尾加 use context7：

1
2

写一个简洁的个人简历网页。use context7
写一个倒计时工具，输入秒数开始倒数。use context7

精确指定库

用 /owner/repo 格式跳过名称匹配：

1

用 /tailwindlabs/tailwindcss 给我的网页加一个导航栏。use context7

库名有歧义时推荐这么用。

指定版本

1
2

用 Bootstrap 4 而不是 5 的写法，写一个卡片布局。use context7
用 Vue 3 的 Composition API 写一个待办事项列表。use context7

组合多个库

1

用 Bootstrap + Font Awesome 做一个图标展示页。use context7

配置自动触发

不想每次都手打 use context7 的话，在规则文件里配一下：

→ Cursor 在 .cursorrules 里写：

1

当用户提问涉及第三方框架/库的 API 用法时，自动使用 Context7 查询最新文档。

→ Claude Code 在 CLAUDE.md 里写：

1
2
3

## 文档查询规则
- 涉及第三方库/框架时，先用 Context7 查询最新文档
- 优先基于 Context7 返回的内容生成代码

CLI 命令

如果你只在 AI 对话里用 Context7，这部分可以跳过。CLI 是给喜欢在终端敲命令的人用的。

npm 是 Node.js 自带的包管理器，-g 表示"全局安装"，装一次所有地方都能用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

# 安装 CLI
npm install -g ctx7

# 搜索库
ctx7 library react
ctx7 library nextjs "middleware"

# 获取文档
ctx7 docs /facebook/react "hooks state management"
ctx7 docs /vercel/next.js "middleware authentication"

# Skills 管理
ctx7 skills search        # 搜索可用 Skill
ctx7 skills install       # 安装 Skill
ctx7 skills list          # 查看已安装
ctx7 skills remove        # 卸载

# 认证
ctx7 login                # 登录
ctx7 whoami               # 查看状态
ctx7 logout               # 退出

❓ 常见问题

和 AI 自带的联网搜索有什么区别？

联网搜索搜到的是博客、论坛帖子，质量参差不齐，还得自己判断靠不靠谱。Context7 只从官方文档拿内容，用 LLM 筛选出最相关的片段，给 AI 直接用。

💰 use context7 会多花钱吗？

不会。虽然多了一步查文档，但 AI 拿到的信息准了，就不用瞎猜、反复改、写又长又错的代码。整体算下来花的钱（Token 消耗，AI 的计价单位）反而更少。

没收录我用的库怎么办？

去 context7.com 点 “Add Docs” 提交，或者不加 use context7，AI 会退回用自己的知识回答。

装好了但没效果？

逐项排查：

• npx ctx7 setup 有没有报错
• MCP 配置文件 JSON 格式对不对（多一个逗号都不行）
• API Key 是不是有效的（ctx7sk... 开头）
• 编辑器有没有完全关掉再打开
• MCP 列表状态亮绿灯了吗
• 提问时有没有写 use context7

会影响回答速度吗？

会多等一两秒，但换来答案准了、不用反复改。跑一次报错再修的时间，可比这一两秒长多了。

总结

装好之后，再也不用担心 AI 拿旧版知识来糊弄你了。