#Context7 实时文档

Context7 是 Upstash 推出的实时文档平台，为 LLM 和 AI 编程助手提供最新的、版本特定的库文档和代码示例。它解决了 LLM 依赖过时训练数据导致的 API 幻觉、过时代码示例和错误配置问题。

#为什么需要 Context7

Claude Code 的训练数据有截止日期，当你使用较新的库或 API 时，可能会遇到：

• 使用已废弃的 API（如 Next.js 14 的旧路由模式）
• 生成不存在的函数或参数
• 给出错误的配置步骤
• 引用不存在的 npm 包版本

Context7 从源仓库实时拉取文档，注入到 Claude Code 的上下文中，确保生成的代码基于最新文档。

#安装

#方式一：一键安装（推荐）

npx ctx7 setup --claude

这会自动：

1. 通过 OAuth 认证获取 API Key
2. 配置 MCP 服务器到 ~/.claude.json
3. 安装 Skill 和规则文件

#方式二：手动配置 MCP

# 本地服务器（stdio）
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

# 远程服务器（HTTP）
claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

或手动编辑 .mcp.json：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

#方式三：通过 Claude Code Plugin 安装

> /plugin marketplace add upstash/context7
> /plugin install context7-plugin@context7-marketplace

Plugin 模式会同时安装 MCP 服务器、Skill、Agent 和 Slash 命令。

#方式四：通过 CC-Switch 管理

如果你已安装 CC-Switch，可以通过它管理 Context7 的 MCP 服务器配置：

1. 打开 CC-Switch Desktop
2. 进入 MCP 服务器管理
3. 添加 Context7 MCP 服务器配置
4. CC-Switch 会自动同步到 Claude Code

#获取 API Key

免费获取 API Key（提高速率限制）：

1. 访问 context7.com/dashboard
2. 注册并获取 API Key
3. 设置环境变量：export CONTEXT7_API_KEY=your-key

#MCP 工具

MCP 模式下，Context7 为 Claude Code 提供 2 个工具：

#工作流程

1. 用户: "用 Next.js 15 的 Server Actions 实现表单"
2. Claude Code 调用 resolve-library-id → 找到 /vercel/next.js
3. Claude Code 调用 query-docs → 获取 Next.js 15 Server Actions 文档
4. Claude Code 基于最新文档生成代码

#CLI 命令

CLI 模式下，使用 ctx7 命令行工具：

# 搜索库
ctx7 library next.js "server actions"

# 获取文档
ctx7 docs /vercel/next.js "how to use server actions"

# 认证
ctx7 login
ctx7 logout
ctx7 whoami

# Skills 管理
ctx7 skills search react
ctx7 skills install /owner/repo
ctx7 skills suggest          # 根据项目依赖自动推荐
ctx7 skills list
ctx7 skills remove <name>
ctx7 skills generate         # AI 生成自定义 Skill（需登录）

# 设置和移除
ctx7 setup --claude
ctx7 remove

#使用示例

#示例一：使用最新 API

> 用 Next.js 15 的 Server Actions 实现一个联系表单

Claude Code 会自动查询 Context7 获取 Next.js 15 的最新 Server Actions 文档，生成基于最新 API 的代码。

#示例二：避免废弃 API

> 帮我用 React Router v7 配置路由

Claude Code 会获取 React Router v7 的文档，避免使用 v6 的旧 API。

#示例三：版本特定文档

> 用 Tailwind CSS v4 的新语法配置主题

Context7 支持指定版本（/tailwindlabs/tailwindcss/v4），确保获取正确版本的文档。

#手动查询

安装 Plugin 后，可以使用 Slash 命令手动查询：

> /context7:docs
> 查询 Prisma 的关系查询文档

#CLAUDE.md 集成

在项目的 CLAUDE.md 中添加以下规则，让 Claude Code 自动使用 Context7：

## Context7

Always use Context7 when I need library/API documentation, code generation,
setup or configuration steps without me having to explicitly ask.

#配置

#环境变量

#Library ID 格式

Context7 使用 /org/project 格式的库 ID：

#卸载

npx ctx7 remove

#相关资源

• Context7 GitHub — 项目仓库（56k+ Stars）
• Context7 官网 — 文档和 API Key 获取
• Context7 Dashboard — API Key 管理
• Context7 npm — CLI 包

#下一步

• MCP 服务器 — 深入了解 MCP 服务器配置
• CC-Switch 配置管理 — 管理 MCP 服务器和 API Provider
• 技巧与最佳实践 — 更多高效使用技巧