Context7 là một nền tảng giúp đư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, giúp ngăn chặn việc sinh mã dựa trên dữ liệu cũ. CLI (ctx7) chạy ngay 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 lệnh ctx7 setup.
Context7 là gì và tại sao nó lại quan trọng?
Khi dùng AI để sinh mã, rất dễ gặp tình trạng API đã lỗi thời, chữ ký hàm sai, import không còn hợp lệ, hoặc ví dụ tài liệu chỉ áp dụng cho phiên bản cũ. Điều này do LLM chỉ được huấn luyện trên dữ liệu cũ, không biết cập nhật mới nhất của thư viện.
Context7 giải quyết vấn đề đó. Đây là nền tảng do Upstash phát triển, lập chỉ mục hơn 9.000 thư viện và cung cấp tài liệu mới nhất cho tác nhân AI của bạn mỗi khi bạn hỏi. Context7 tự động lấy đúng tài liệu phiên bản hiện tại và đưa vào ngữ cảnh trả lời của AI.
Kết quả: AI sinh mã phù hợp với API hiện tại thay vì "đoán" dựa trên tài liệu cũ.
ctx7 CLI là giao diện dòng lệnh của Context7 với 3 chức năng:
- Tìm nạp tài liệu thư viện ngay trên terminal
- Quản lý kỹ năng lập trình AI (tệp prompt dùng lại cho tác nhân AI)
- Cấu hình máy chủ MCP của Context7 cho Claude Code, Cursor, OpenCode
💡
Nếu bạn xây dựng và kiểm thử API, Apidog là client miễn phí để gửi, tổ chức và tự động hóa các request API. Kết hợp Context7 (cập nhật kiến thức AI) và Apidog (xác minh call API thực tế) sẽ giúp workflow tự động hóa của bạn chắc chắn hơn.
Cài đặt ctx7
Bạn chỉ cần Node.js 18+. Kiểm tra với node --version.
Chạy không cần cài đặt
Dùng npx để chạy nhanh:
npx ctx7 --help
npx ctx7 library react
Cách này luôn kéo bản mới nhất, phù hợp cho sử dụng không thường xuyên.
Cài đặt toàn cục
Dùng thường xuyên thì nên cài toàn cục:
npm install -g ctx7
ctx7 --version
Sau đó gọi ctx7 trực tiếp, không cần npx.
Thiết lập Context7 cho tác nhân lập trình AI
Dùng ctx7 setup để kết nối Context7 với môi trường AI. Lệnh này xác thực OAuth, tạo API key và ghi cấu hình.
Thiết lập tương tác
ctx7 setup
Lệnh này sẽ hỏi bạn chọn agent và chế độ (CLI + Skills hoặc MCP). Để bỏ qua toàn bộ prompt:
ctx7 setup --yes
Chọn một tác nhân cụ thể
ctx7 setup --claude
ctx7 setup --cursor
ctx7 setup --opencode
Sử dụng API key hiện có
Nếu đã có API key từ context7.com/dashboard:
ctx7 setup --api-key YOUR_API_KEY
Thiết lập cấp dự án hoặc toàn cục
Mặc định ctx7 setup là toàn cục. Để chỉ cấu hình cho project:
ctx7 setup --project
Hai chế độ: CLI + Skills vs MCP
Chế độ CLI + Skills: Tạo tệp SKILL.md để agent tự gọi ctx7 library, ctx7 docs khi cần tài liệu. Không cần máy chủ MCP.
ctx7 setup --cli --claude
ctx7 setup --cli --cursor
ctx7 setup --cli --universal
Chế độ MCP: Đăng ký Context7 làm server MCP, agent gọi resolve-library-id và query-docs tự động. Ví dụ cấu hình MCP cho editor:
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "YOUR_API_KEY"
}
}
Thêm 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
ctx7 whoami
ctx7 logout
Có thể đặt API key qua biến môi trường:
export CONTEXT7_API_KEY=your_key_here
Đăng nhập chỉ bắt buộc để tạo skill hoặc thiết lập nâng cao. Tra cứu tài liệu cơ bản vẫn dùng được mà không cần login.
Tắt đo từ xa
Để tắt telemetry:
export CTX7_TELEMETRY_DISABLED=1
Tìm kiếm tài liệu thư viện từ terminal
Không cần AI agent vẫn có thể tra cứu tài liệu thư viện bằng ctx7. Hai lệnh 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
Lệnh này trả về ID chuẩn, số snippet, reputation, version của thư viện.
Ví dụ 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
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
Kết quả là đoạn tài liệu liên quan, lấy từ phiên bản mới nhất. Có thể xuất ra file hoặc pipe sang công cụ khác.
Nếu đã biết ID thư viện, bỏ qua ctx7 library để gọi thẳng ctx7 docs.
Quản lý kỹ năng lập trình AI
Kỹ năng là các tệp SKILL.md chứa knowledge hoặc hướng dẫn chuyên biệt cho agent AI của bạn. Context7 có kho kỹ năng cộng đồng, bạn có thể tìm kiếm, cài đặt, tạo hoặc xóa.
Tìm kiếm kỹ năng
ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Cài đặt kỹ năng
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude
Cài toàn cục (--global):
ctx7 skills install /anthropics/skills pdf --global
Nhận gợi ý dựa trên project
ctx7 skills suggest
Lệnh này quét project, phát hiện thư viện/framework đang dùng và gợi ý kỹ năng liên quan.
Liệt kê kỹ năng đã cài đặt
ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
Gỡ bỏ kỹ năng
ctx7 skills remove pdf
Tạo kỹ năng tùy chỉnh với AI
Với tài khoản trả phí, bạn có thể tạo kỹ năng tùy chỉnh từ bất kỳ thư viện nào:
ctx7 login
ctx7 skills generate
CLI hướng dẫn bạn chọn thư viện, mô tả kỹ năng, và sinh ra file SKILL.md dựa trên tài liệu mới nhất.
Kỹ năng dạng SKILL.md tuân chuẩn Agent Skills, dùng được cho Claude Code, Cursor, VS Code Copilot, OpenCode,...
Miễn phí: tạo 6 kỹ năng/tuần. Pro: 10 kỹ năng/tuần.
Bí danh thao tác nhanh:
| 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
Khi đã setup Context7, bạn có thể tận dụng trong workflow lập trình như sau:
Mẫu "use context7"
Ở chế độ MCP, thêm "use context7" vào prompt để AI lấy tài liệu mới nhất:
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
Tham chiếu thư viện cụ thể
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.
Tự động gọi không cần gõ "use context7"
Thêm rule vào agent để luôn tự động lấy tài liệu khi đụng đến mã thư viện. Ví dụ với Claude Code, thêm vào CLAUDE.md:
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.
Với Cursor, thêm vào Settings > Rules for 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 cập nhật kiến thức thư viện cho AI, nhưng bạn cũng cần xác minh call HTTP thực tế. Apidog là client miễn phí giúp gửi request, kiểm tra response, tạo môi trường, chạy test API tự động.
Workflow thực tế:
- Xây dựng Next.js gọi API bên ngoài: Context7 cung cấp tài liệu Next.js mới nhất cho AI, Apidog dùng để kiểm thử request/response thật.
- Tích hợp thư viện mới có API HTTP: Context7 lấy doc SDK, Apidog kiểm thử endpoint raw.
- Gỡ lỗi tích hợp: Dùng Apidog gửi lại request chính xác mà code tạo ra để khoanh vùng lỗi.
Thiết lập môi trường trong Apidog, lưu API key thành biến, chuyển môi trường dev/prod nhanh, chạy test trên mọi response. Kết hợp Context7 + Apidog cho cả tài liệu cập nhật và test API thực tế.
Giá cả và giới hạn tần suất
ctx7 CLI miễn phí. Giới hạn phụ thuộc vào gói Context7:
| 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) |
Lưu ý gói miễn phí:
- Hết quota tháng, mỗi ngày vẫn được thêm 20 lệnh API cho đến khi reset tháng
- Truy cập repo private cần gói Pro trở lên
- Tạo kỹ năng: miễn phí 6 lần/tuần, Pro 10 lần/tuần
- Pro tối đa 20 thành viên/team
Giới hạn quan trọng: Context7 dùng server Upstash, không có chế độ offline. Không có internet sẽ không dùng được. Trả về doc có thể lớn, giảm context window của LLM với dự án phức tạp.
Nhận API key miễn phí tại context7.com/dashboard. Dùng API key để tăng quota so với không xác thực.
Câu hỏi thường gặp
Context7 có gửi mã của tôi lên server không? Không. Chỉ tên thư viện và truy vấn được gửi, không gửi code, history, hay dữ liệu nhạy cảm.
Context7 hỗ trợ thư viện nào? Trên 9.000 thư viện/framework công khai. Tra cứu tại context7.com. Gửi thêm thư viện qua /add-library trên web UI.
Tài liệu cập nhật đến đâu? Thư viện được index lại định kỳ, bản phát hành mới nhất thường được cập nhật. Có thể trễ vài ngày với release rất mới.
Dùng không cần API key được không? Có, với quota thấp. Đăng ký và set CONTEXT7_API_KEY để tăng thông lượng.
Hỗ trợ editor/agent nào? Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop, và client nào hỗ trợ MCP hoặc Agent Skills.
Khác biệt giữa CLI + Skills và MCP? CLI + Skills: agent được hướng dẫn chạy ctx7 khi cần doc. MCP: agent gọi tool Context7 qua MCP, user không cần prompt "use context7".
Dùng ctx7 không cần AI agent được không? Được. ctx7 library và ctx7 docs là lệnh độc lập tra cứu doc.
Top comments (0)