註冊
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 條評論

登入 後參與評論

還沒有評論，來搶沙發～