Context7 là một nền tảng đưa tài liệu thư viện cập nhật trực tiếp vào ngữ cảnh của trợ lý lập trình AI của bạn, giúp nó ngừng tạo mã dựa trên dữ liệu đào tạo lỗi thời. CLI (ctx7) chạy với npx ctx7 (không cần cài đặt) và kết nối với Claude Code, Cursor, hoặc OpenCode chỉ với một lệnh ctx7 setup.
Context7 là gì và tại sao nó lại quan trọng?
Đây là một vấn đề mà mọi nhà phát triển sử dụng công cụ lập trình AI đều gặp phải: bạn yêu cầu trợ lý của mình viết mã bằng một thư viện mà bạn hiểu rõ, và nó đưa ra thứ gì đó có vẻ đúng nhưng lại sử dụng các API không còn tồn tại. Chữ ký hàm sai. Đường dẫn import đã thay đổi từ hai phiên bản chính trước đó. Ví dụ hoạt động trong tài liệu cho phiên bản 12, nhưng bạn đang dùng phiên bản 15.
Điều này xảy ra vì LLM được đào tạo trên dữ liệu có ngày cắt. Chúng không biết những gì đã thay đổi vào tháng trước. Chúng không biết rằng Next.js 15 đã tái cấu trúc cách bố cục hoạt động, hoặc một thư viện bạn tin cậy đã loại bỏ một nửa bề mặt API của nó kể từ ảnh chụp nhanh đào tạo.
Context7 giải quyết vấn đề này. Đây là một nền tảng được xây dựng bởi Upstash, lập chỉ mục tài liệu cho hơn 9.000 thư viện và cung cấp cho trợ lý AI của bạn theo thời gian thực. Khi bạn hỏi tác nhân lập trình một câu hỏi, Context7 sẽ tìm nạp các tài liệu hiện tại, cụ thể theo phiên bản và đặt chúng vào cửa sổ ngữ cảnh trước khi mô hình tạo phản hồi.
Kết quả: công cụ lập trình AI của bạn ngừng tạo ra các API ảo và bắt đầu tạo ra mã khớp với những gì thư viện thực sự làm hiện nay.
ctx7 CLI là giao diện dòng lệnh cho Context7. Nó thực hiện ba việc:
- Tìm nạp tài liệu thư viện trực tiếp trong terminal của bạn
- Quản lý kỹ năng lập trình AI (các tệp prompt có thể tái sử dụng giúp tăng cường tác nhân của bạn)
- Cấu hình máy chủ MCP của Context7 cho Claude Code, Cursor, hoặc OpenCode
Cài đặt ctx7
Yêu cầu duy nhất là Node.js 18 trở lên. Kiểm tra phiên bản của bạn với node --version.
Chạy mà không cần cài đặt
Cách nhanh nhất để thử ctx7 là với npx:
npx ctx7 --help
npx ctx7 library react
Thao tác này sẽ kéo phiên bản mới nhất mỗi khi bạn chạy. Tốt cho việc sử dụng không thường xuyên.
Cài đặt toàn cục
Để sử dụng thường xuyên, hãy cài đặt toàn cục:
npm install -g ctx7
ctx7 --version
Sau đó, mọi lệnh ctx7 sẽ chạy cục bộ mà không có phí tổn của npx.
Thiết lập Context7 cho tác nhân lập trình AI của bạn
Lệnh ctx7 setup kết nối Context7 với môi trường lập trình AI của bạn. Nó xác thực qua OAuth, tạo khóa API và ghi cấu hình vào đúng vị trí.
Thiết lập tương tác
ctx7 setup
Thao tác này sẽ nhắc bạn chọn tác nhân và chế độ ưu tiên của bạn (CLI + Skills hoặc MCP). Nếu bạn muốn bỏ qua các lời nhắc:
ctx7 setup --yes
Chọn một tác nhân cụ thể
ctx7 setup --claude # Claude Code (~/.claude/skills hoặc cấu hình MCP)
ctx7 setup --cursor # Cursor (~/.cursor/skills hoặc cấu hình MCP)
ctx7 setup --opencode # OpenCode
Sử dụng khóa API hiện có
Nếu bạn đã có khóa API Context7 từ context7.com/dashboard:
ctx7 setup --api-key YOUR_API_KEY
Thiết lập cấp dự án so với cấp toàn cục
Theo mặc định, ctx7 setup cài đặt toàn cục. Để cấu hình chỉ cho dự án hiện tại:
ctx7 setup --project
Hai chế độ: CLI + Skills so với MCP
Chế độ CLI + Skills cài đặt một tệp SKILL.md thông báo cho tác nhân AI của bạn tìm nạp tài liệu bằng cách chạy các lệnh CLI của ctx7. Tác nhân của bạn đọc hướng dẫn kỹ năng và tự động chạy ctx7 library và ctx7 docs khi cần tài liệu thư viện. Không yêu cầu máy chủ MCP.
ctx7 setup --cli --claude # Cài đặt kỹ năng vào ~/.claude/skills
ctx7 setup --cli --cursor # Cài đặt kỹ năng vào ~/.cursor/skills
ctx7 setup --cli --universal # Cài đặt vào ~/.config/agents/skills
Chế độ Máy chủ MCP đăng ký Context7 làm máy chủ Giao thức Ngữ cảnh Mô hình (Model Context Protocol). Tác nhân của bạn gọi các công cụ resolve-library-id và query-docs một cách tự nhiên mà không cần chạy bất kỳ lệnh CLI nào. Việc tìm nạp tài liệu là vô hình.
Đối với chế độ MCP, cấu hình trông như thế này (thêm vào cài đặt MCP của trình chỉnh sửa của bạn):
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "YOUR_API_KEY"
}
}
Hoặc thêm nó vào Claude Code qua CLI:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
Xác thực
ctx7 login # Đăng nhập trình duyệt OAuth
ctx7 whoami # Xác nhận bạn đã đăng nhập với tư cách ai
ctx7 logout # Xóa thông tin đăng nhập đã lưu
Bạn cũng có thể đặt khóa API làm biến môi trường:
export CONTEXT7_API_KEY=your_key_here
Đăng nhập chỉ bắt buộc để tạo kỹ năng và một số luồng thiết lập nhất định. Các tra cứu tài liệu cơ bản hoạt động mà không cần nó.
Dữ liệu đo từ xa
Context7 thu thập dữ liệu sử dụng ẩn danh theo mặc định. Để tắt nó:
export CTX7_TELEMETRY_DISABLED=1
Tìm kiếm tài liệu thư viện từ terminal
Ngay cả khi không có tác nhân AI tham gia, ctx7 vẫn hữu ích như một công cụ tra cứu tài liệu độc lập. Hai lệnh thực hiện công việc chính.
Giải quyết tên thư viện
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json # Đầu ra JSON
Thao tác này tìm kiếm chỉ mục Context7 và trả về ID chuẩn của thư viện, cùng với siêu dữ liệu: số lượng đoạn mã, uy tín nguồn, điểm chuẩn và mã định danh phiên bản.
Ví dụ đầu ra cho ctx7 library nextjs:
Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0
Tìm nạp tài liệu
Khi bạn có ID thư viện, hãy chuyển nó cho ctx7 docs cùng với một truy vấn chủ đề:
ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
ctx7 docs /facebook/react "hooks" --json
Đầu ra là các đoạn tài liệu liên quan đến truy vấn của bạn, được lấy từ phiên bản hiện tại của thư viện. Bạn có thể chuyển đầu ra này vào một tệp hoặc một công cụ khác.
Nếu bạn đã biết ID thư viện, bạn có thể bỏ qua ctx7 library và chuyển thẳng đến ctx7 docs.
Quản lý kỹ năng lập trình AI
Kỹ năng là các tệp SKILL.md cung cấp cho tác nhân AI của bạn kiến thức hoặc hành vi chuyên biệt. Hãy coi chúng như những cuốn sổ tay hướng dẫn nhỏ mà tác nhân của bạn đọc trước khi giải quyết một loại tác vụ cụ thể.
Context7 lưu trữ một kho kỹ năng do cộng đồng đóng góp. Bạn có thể tìm kiếm, cài đặt kỹ năng vào môi trường tác nhân của mình, tạo kỹ năng tùy chỉnh và loại bỏ những gì bạn không cần.
Tìm kiếm kỹ năng
ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Cài đặt một kỹ năng
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor # Cài đặt cụ thể cho Cursor
ctx7 skills install /anthropics/skills pdf --claude # Cài đặt cho Claude Code
Khi bạn cài đặt toàn cục (--global), kỹ năng sẽ khả dụng trên tất cả các dự án của bạn:
ctx7 skills install /anthropics/skills pdf --global
Nhận gợi ý dựa trên dự án của bạn
ctx7 skills suggest quét thư mục dự án của bạn, phát hiện các thư viện và framework bạn đang sử dụng, và đề xuất các kỹ năng liên quan:
ctx7 skills suggest
Điều này hoạt động tốt khi bạn bắt đầu một dự án mới và muốn cung cấp kiến thức liên quan cho tác nhân của mình ngay từ đầu.
Liệt kê các kỹ năng đã cài đặt
ctx7 skills list # Tất cả kỹ năng đã cài đặt
ctx7 skills list --claude # Chỉ các kỹ năng đã cài đặt cho Claude Code
ctx7 skills list --cursor # Chỉ các kỹ năng của Cursor
Gỡ bỏ một kỹ năng
ctx7 skills remove pdf
Tạo kỹ năng tùy chỉnh với AI
Đây là tính năng mạnh mẽ nhất. Với tài khoản trả phí, bạn có thể tạo một kỹ năng tùy chỉnh từ bất kỳ thư viện nào trong chỉ mục Context7:
ctx7 login
ctx7 skills generate
CLI sẽ hướng dẫn bạn qua một lời nhắc tương tác: chọn một thư viện, mô tả những gì bạn muốn kỹ năng đó dạy cho tác nhân của bạn, và Context7 sẽ tạo một tệp SKILL.md được điều chỉnh theo tài liệu hiện tại của thư viện đó.
Các kỹ năng được tạo ra có tính di động. Định dạng SKILL.md tuân theo tiêu chuẩn Kỹ năng Tác nhân (Agent Skills), nghĩa là một kỹ năng bạn tạo cho Claude Code sẽ hoạt động không thay đổi trong Cursor, VS Code Copilot, OpenCode và bất kỳ công cụ tương thích Kỹ năng Tác nhân nào khác.
Tài khoản miễn phí được 6 lần tạo kỹ năng mỗi tuần. Tài khoản Pro được 10 lần.
Bí danh viết tắt để gõ nhanh hơn:
| Lệnh đầy đủ | Bí danh |
|---|---|
ctx7 skills install | ctx7 si |
ctx7 skills search | ctx7 ss |
ctx7 skills generate | ctx7 skills gen hoặc ctx7 skills g |
Sử dụng Context7 trong các lời nhắc AI của bạn
Khi Context7 được thiết lập, bạn có một vài cách để sử dụng nó trong quy trình làm việc lập trình hàng ngày của mình.
Mẫu "use context7"
Trong chế độ MCP, thêm "use context7" vào bất kỳ lời nhắc nào mà bạn muốn có tài liệu hiện tại:
Tạo một middleware Next.js kiểm tra JWT hợp lệ trong cookies và chuyển hướng
người dùng chưa xác thực đến /login. use context7
Thiết lập một schema Prisma với các mô hình user và post và mối quan hệ một-nhiều. use context7
Làm cách nào để cấu hình bố cục App Router trong Next.js 15? use context7
Tác nhân sẽ tự động gọi các công cụ resolve-library-id và query-docs của Context7, tìm nạp tài liệu hiện tại và sử dụng chúng làm cơ sở cho phản hồi của nó.
Tham chiếu một thư viện cụ thể
Nếu lời nhắc của bạn liên quan đến nhiều thư viện và bạn muốn Context7 tập trung vào một:
Triển khai xác thực Supabase trong một ứng dụng Next.js.
use library /supabase/supabase cho Supabase và /vercel/next.js cho định tuyến Next.js.
Thao tác này bỏ qua bước khớp thư viện và chuyển thẳng đến tài liệu.
Tự động gọi mà không cần gõ "use context7"
Thêm một quy tắc vào tác nhân AI của bạn để nó tự động tìm nạp tài liệu bất cứ khi nào nó chạm vào mã thư viện. Trong Claude Code, hãy thêm vào CLAUDE.md của bạn:
Luôn sử dụng các công cụ Context7 MCP khi tạo mã sử dụng các thư viện bên thứ ba.
Giải quyết ID thư viện và tìm nạp tài liệu hiện tại trước khi viết bất kỳ triển khai nào.
Thực hiện việc này mà không cần chờ tôi yêu cầu.
Trong Cursor, thêm vào Cài đặt > Quy tắc cho AI:
Khi viết mã sử dụng các thư viện hoặc framework bên ngoài, luôn gọi
Context7 để tìm nạp tài liệu hiện tại trước khi tạo triển khai.
Kết hợp với Apidog để hoàn toàn tự tin về API
Context7 giữ cho kiến thức thư viện của trợ lý AI của bạn luôn cập nhật. Nhưng tài liệu chính xác chỉ là một nửa của bức tranh. Khi bạn đang xây dựng một tích hợp API, bạn cũng cần xác minh rằng các lệnh gọi HTTP thực tế của bạn hoạt động như mong đợi.
Apidog bao gồm điều đó. Đây là một client API miễn phí nơi bạn có thể gửi yêu cầu, kiểm tra phản hồi, thiết lập môi trường và tự động hóa các bộ kiểm thử. Nó xử lý mọi thứ từ khám phá điểm cuối ad-hoc đến các kiểm thử tích hợp có thể lặp lại.
Đây là cách chúng bổ trợ lẫn nhau trong một quy trình làm việc thực tế:
Bạn đang xây dựng một ứng dụng Next.js gọi một API bên thứ ba. Context7 cung cấp cho tác nhân AI của bạn tài liệu Next.js hiện tại để các gợi ý mã của nó là chính xác. Apidog cho phép bạn kiểm thử trực tiếp API bên thứ ba, xác minh cấu trúc phản hồi và xác nhận rằng các payload mà mã của bạn gửi khớp với những gì API mong đợi.
Bạn đang tích hợp một thư viện mới có API HTTP riêng. Context7 cung cấp cho tác nhân của bạn tài liệu SDK hiện tại của thư viện. Apidog cho phép bạn kiểm thử các điểm cuối API thô để hiểu hành vi ở cấp độ HTTP trước khi bạn viết bất kỳ mã ứng dụng nào.
Bạn đang gỡ lỗi một tích hợp. Bạn có thể gửi yêu cầu chính xác mà mã của bạn tạo trong Apidog, kiểm tra phản hồi thô và phân lập xem vấn đề nằm ở logic yêu cầu của bạn hay hành vi của API.
Thiết lập một môi trường trong Apidog với các khóa API của bạn được lưu trữ dưới dạng biến, chuyển đổi giữa dev và production chỉ bằng một cú nhấp chuột và chạy các xác nhận kiểm thử trên mọi phản hồi. Context7 + Apidog cung cấp cho bạn cả tài liệu hiện tại và hành vi API đã được xác minh.
Giá cả và giới hạn tần suất
CLI ctx7 miễn phí để sử dụng. Giới hạn tần suất và quyền truy cập tính năng phụ thuộc vào gói Context7 của bạn:
| Gói | Giá | Lệnh gọi API/tháng | Giới hạn tần suất | Repo riêng tư |
|---|---|---|---|---|
| Miễn phí | $0 | 1.000 | 60 yêu cầu/giờ | Không |
| Pro | $7/người dùng/tháng | 5.000/người dùng | 60/giờ/người dùng | Có ($15/1M token để phân tích) |
| Doanh nghiệp | Tùy chỉnh | 5.000/người dùng | Tùy chỉnh | Có ($25/1M token) |
Ghi chú gói miễn phí:
- Khi bạn đạt giới hạn hàng tháng, bạn sẽ nhận được 20 lệnh gọi API bổ sung mỗi ngày cho đến khi tháng đặt lại
- Truy cập kho lưu trữ riêng tư yêu cầu gói Pro hoặc cao hơn
- Tạo kỹ năng: 6 lần/tuần trên gói Miễn phí, 10 lần/tuần trên gói Pro
- Gói Pro hỗ trợ tối đa 20 thành viên
Giới hạn quan trọng: Context7 định tuyến tất cả các truy vấn thông qua máy chủ của Upstash. Không có chế độ ngoại tuyến. Nếu bạn đang ở trong môi trường không có truy cập internet, công cụ sẽ không hoạt động. Phản hồi tài liệu cũng có thể lớn, điều này làm giảm cửa sổ ngữ cảnh của LLM. Trên các dự án phức tạp với nhiều truy vấn thư viện, điều này sẽ tích lũy.
Nhận khóa API miễn phí tại context7.com/dashboard. Khóa API cung cấp cho bạn giới hạn tần suất cao hơn so với các yêu cầu không xác thực.
Câu hỏi thường gặp
Context7 có gửi mã của tôi đến máy chủ của nó không?
Không. Chỉ tên thư viện và văn bản truy vấn được gửi đến máy chủ của Context7, không phải mã của bạn, lịch sử hội thoại hoặc bất kỳ dữ liệu nhạy cảm nào. Mã nguồn của bạn vẫn nằm trong nhà cung cấp LLM của bạn.
Context7 hỗ trợ những thư viện nào?
Chỉ mục bao gồm hơn 9.000 thư viện và framework công khai. Bạn có thể tìm kiếm chỉ mục tại context7.com để kiểm tra xem một thư viện cụ thể có khả dụng không. Các thư viện mới có thể được gửi qua /add-library trong giao diện Context7.
Tài liệu cập nhật đến mức nào?
Các thư viện được lập chỉ mục lại định kỳ. Các bản phát hành rất gần đây (trong vài ngày qua) có thể chưa có sẵn. Đối với các thư viện ổn định, tài liệu thường được cập nhật theo bản phát hành mới nhất.
Nó có hoạt động mà không cần khóa API không?
Sử dụng cơ bản hoạt động mà không cần khóa API nhưng với giới hạn tần suất thấp hơn. Để sử dụng thường xuyên, hãy đăng ký tại context7.com và đặt CONTEXT7_API_KEY để có thông lượng tốt hơn.
Nó hỗ trợ những trình chỉnh sửa và tác nhân nào?
Context7 hoạt động với Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop và bất kỳ client nào khác hỗ trợ MCP hoặc tiêu chuẩn Agent Skills.
Sự khác biệt giữa chế độ CLI + Skills và chế độ MCP là gì?
Trong chế độ CLI + Skills, một tệp kỹ năng thông báo cho tác nhân của bạn chạy các lệnh ctx7 một cách rõ ràng khi nó cần tài liệu. Trong chế độ MCP, tác nhân của bạn gọi các công cụ của Context7 một cách tự nhiên thông qua giao thức MCP. Chế độ MCP minh bạch hơn với người dùng và không yêu cầu bất kỳ lời nhắc "use context7" rõ ràng nào sau khi được cấu hình.
Tôi có thể sử dụng ctx7 mà không cần tác nhân lập trình AI không?
Có. ctx7 library và ctx7 docs hoạt động như các lệnh terminal độc lập. Bạn có thể tra cứu tài liệu thư viện trực tiếp mà không cần bất kỳ tác nhân AI nào.