再也不用自己查文档了!AI 直接拉最新 API 文档

上周用 Claude Code 写一个 Next.js 的中间件。它很自信地给我写了一段代码：

export function middleware(request: NextRequest) {
const token = request.cookies.get('token')
if (!token) {
return NextResponse.redirect(new URL('/login', request.url))
}
return NextResponse.next()
}

我复制进去，跑了一下——报错。

查了一下文档，Next.js 14 改了 Middleware 的 API 签名。Claude 的训练数据停在 2024 年，它根本不知道这事。

它编了一个"看起来很对"的 API，然后一本正经地告诉我这是对的。

AI 为什么会"编"API？

不是 AI 故意骗你，是架构问题：

• 训练数据有截止日期——模型只"记得"发布前的 API

• 版本迭代太快——React、Next.js 几个月就一个大版本

• AI 不知道自己不知道——它会用"自信的语气"说错话

• 你也不确定对不对——因为你也还没查过最新文档

结果就是：AI 编造 API + 你无法验证 = 浪费时间调试。

Context7：实时拉文档

有个叫 context7 的工具，专门解决这个问题。

它的原理很简单：AI 写代码前，先去官网拉最新文档。

不是靠训练数据"背"，是实时去源码仓库/文档网站抓取，然后喂给 AI。

它能做什么？

安装方式

方法 1：CLI + Skill（推荐）

npx skills add upstash/context7

然后在你的 AI 编程工具里：

ctx7 setup

它会自动配置好，以后你问库相关的问题，它会自动拉文档。

方法 2：MCP Server

实际用起来什么样？

场景 1：问库问题

你直接问：

"Next.js 14 的 Middleware 怎么写？用 context7"

AI 会先调用 resolve-library-id 找到 /vercel/next.js，然后调用 query-docs 拉最新文档，最后基于文档回答你。

场景 2：指定版本

"React 19 的 use hook 怎么用？用 context7 /reactjs/react.dev/v19.0.0"

它会拉 React 19 版本的文档，不会给你混入 18 的内容。

场景 3：隔离查询

上下文快满了？用 docs-researcher agent 在独立环境查文档，不污染主上下文：

spawn docs-researcher to look up React hooks documentation

手动命令：/context7:docs

知道要查什么库，直接用命令：

/context7:docs react hooks
/context7:docs next.js authentication

GitHub MCP + Context7 组合

单用 Context7 只能查文档，加上 GitHub MCP 能直接读源码：

• Context7——查文档、API 用法、最佳实践

• GitHub MCP——读源码、查 issue、看实现细节

两个装上，AI 写出来的代码就不再是"猜测"，而是有据可查的"确认"。

我的实际体验

装了这个之后，最大的感受是：

之前：AI 给的代码要复制进去跑一下才知道对不对

之后：AI 直接告诉我"根据最新文档，这是正确的写法"

省了很多调试时间。特别是那些经常更新的库（Next.js、React、Tailwind），用起来特别爽。

免费额度

个人版完全够用，不用担心。

注意事项

• 需要 API Key——去 context7.com/dashboard 注册拿一个，免费的。

• 不是所有库都支持——主流库（React、Next.js、Vue、Tailwind 等）都有。冷门库可能没有。

• 会多一次网络请求——每次问库相关的问题，会多一次 API 调用。但一般很快，体感不明显。

哪些平台支持？

目前支持 5 大主流平台：Claude Code、Cursor、VS Code (Copilot)、Windsurf、Gemini CLI。

我的看法

这个工具解决了一个很实际的问题：AI 的训练数据 vs 最新 API 之间的鸿沟。

以前你要么手动查文档，复制给 AI；要么相信 AI，然后调试。

现在你只要在问题后面加一句"用 context7"，AI 就会自动去拉最新文档。

一句话总结：让 AI 用官方文档回答你，而不是靠记忆。

AI 的知识会过期，但文档不会。

💬 你有没有被 AI "编造"的 API 坑过？欢迎在评论区分享。

如果觉得这篇文章有用，欢迎关注「AI 阿砚」，一个科研爱好者的 AI 探索笔记。