# Context7: tài liệu thư viện mới nhất cho AI lập trình — hướng dẫn cài đặt và dùng

> Context7 là một nền tảng cung cấp tài liệu thư viện cập nhật cho các AI viết code như Cursor hay Claude Code, chạy qua MCP hoặc qua CLI ctx7 kèm skill. Bạn dùng nó để AI ngừng đưa ra code lỗi thời hoặc hàm không tồn tại. Cài bằng một lệnh npx ctx7 setup, cần Node.js 22.13 trở lên, nên khá dễ với người đã biết mở terminal.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-17 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/context7-tai-lieu-moi-nhat-cho-ai-lap-trinh

Context7 là một công cụ đưa tài liệu thư viện mới nhất, đúng phiên bản, vào thẳng ngữ cảnh của AI viết code. Nó chạy được theo hai kiểu: cài một skill để AI gọi lệnh `ctx7`, hoặc đăng ký một MCP server để AI gọi công cụ tài liệu trực tiếp. Hiện repo có khoảng 64.710 sao và 3.242 fork, giấy phép MIT.

Vấn đề nó giải quyết rất quen thuộc. Các mô hình AI học từ dữ liệu cũ, nên khi bạn nhờ viết code với một thư viện hay đổi phiên bản, AI hay đưa ví dụ lỗi thời, gọi hàm không tồn tại, hoặc trả lời chung chung cho bản cũ. Bạn lại phải mở tab tài liệu, tìm đúng đoạn, rồi dán lại cho AI.

Ai nên dùng? Lập trình viên mới, người làm web hoặc tự động hoá nhờ AI viết code, và cả người không chuyên nhưng đang thử vibe coding. Điểm đáng giá nhất là bạn chỉ cần thêm cụm `use context7` vào câu lệnh, hoặc để một quy tắc làm việc đó tự động. Tài liệu đúng phiên bản sẽ được kéo về cho AI mà bạn không phải làm gì thêm.

```repo
- repo | upstash/context7
- kind | MCP server
- desc | Context7 lấy tài liệu và ví dụ code đúng phiên bản mới nhất của thư viện rồi đưa thẳng cho AI viết code, để AI bớt bịa hàm và bớt dùng code cũ.
- stars | 65k
- lang | TypeScript
- license | MIT
```

## Context7 làm được gì

**Kéo tài liệu và ví dụ code đúng nguồn.** Theo README, Context7 lấy tài liệu theo phiên bản cùng ví dụ code từ nguồn rồi đưa cho agent. Lợi ích thực tế: code AI viết ra bám theo cách dùng hiện hành, ít phải sửa lại vì hàm đã bị đổi tên.

**Hai chế độ làm việc.** Chế độ CLI + Skills cài một skill để agent tự lấy tài liệu bằng lệnh `ctx7`, không cần MCP. Chế độ MCP đăng ký một MCP server để agent gọi công cụ tài liệu. Bạn chọn kiểu nào hợp với công cụ AI mình đang dùng.

**Chỉ rõ thư viện bằng ID.** Nếu biết chính xác thư viện, bạn thêm ID dạng `/supabase/supabase` vào câu lệnh. Context7 sẽ bỏ qua bước dò tìm thư viện và lấy tài liệu ngay, nên nhanh hơn và ít nhầm hơn.

**Chọn phiên bản bằng lời thường.** Bạn chỉ cần viết thẳng phiên bản vào câu hỏi, ví dụ Next.js 16. README nói Context7 sẽ tự khớp phiên bản phù hợp.

**Công cụ rõ ràng cho agent.** Phía CLI có hai lệnh: `ctx7 library` để tìm thư viện và lấy ID, `ctx7 docs` để lấy tài liệu. Phía MCP có hai công cụ tương ứng: `resolve-library-id` và `query-docs`. Công cụ `query-docs` còn có tham số tuỳ chọn `language` để xếp ví dụ code theo ngôn ngữ bạn viết lên trước.

**Hỗ trợ nhiều công cụ.** README ghi cách cài thủ công cho hơn 30 MCP client. Repo cũng có các gói riêng cho SDK TypeScript, công cụ Vercel AI SDK và extension cho pi.dev, dành cho ai muốn tích hợp sâu hơn.

## Cần chuẩn bị gì

- **Node.js 22.13 trở lên.** README ghi rõ CLI `ctx7` cần phiên bản này.
- **Một công cụ AI viết code** như Cursor, Claude Code hay OpenCode. Lệnh cài có cờ riêng cho ba công cụ này. Các client khác xem hướng dẫn thủ công.
- **Tài khoản Context7 và API key.** README khuyến nghị lấy API key miễn phí ở trang dashboard của Context7 để có giới hạn lượt dùng cao hơn. Nếu dùng lệnh `setup`, README nói công cụ sẽ đăng nhập bằng OAuth và tự tạo API key cho bạn.
- **Kết nối Internet**, vì tài liệu được lấy từ máy chủ Context7.

Tư liệu không nói gì về yêu cầu hệ điều hành hay phần cứng (như GPU), nên mình không khẳng định gì thêm.

```note
API key là chuỗi bí mật. Đừng dán nó vào ảnh chụp màn hình, tin nhắn nhóm hay kho code công khai. Nếu cấu hình thủ công, hãy giữ key trong file cấu hình trên máy bạn.
```

## Cài đặt từng bước

```steps
- Kiểm tra Node.js | Chắc chắn máy có Node.js 22.13 trở lên
- Chạy lệnh setup | Gõ npx ctx7 setup trong terminal
- Đăng nhập và chọn chế độ | Đăng nhập OAuth, chọn CLI + Skills hoặc MCP
- Thử một câu lệnh | Nhờ AI viết code và thêm use context7
- Gỡ khi không dùng nữa | Chạy npx ctx7 remove
```

### Kiểm tra Node.js

Mở terminal. Trên Windows, bạn có thể mở PowerShell hoặc Terminal. Trên macOS hoặc Linux, mở ứng dụng Terminal. Gõ lệnh dưới đây để xem phiên bản Node.js:

```bash
node --version
```

Kết quả cần là 22.13 trở lên. Nếu máy báo không tìm thấy lệnh `node`, hoặc số phiên bản thấp hơn, bạn cần cài hoặc nâng cấp Node.js trước. Đây là chỗ người mới hay vấp nhất.

### Chạy lệnh setup

Đây là cách cài một lệnh mà README đề xuất:

```bash
npx ctx7 setup
```

Lệnh này chạy gói `ctx7` bằng `npx`, nên bạn không cần cài gì trước. README mô tả nó sẽ đăng nhập qua OAuth, tạo API key và cài skill phù hợp. Bạn có thể chọn giữa CLI + Skills và MCP.

### Chọn đúng công cụ AI

Nếu máy bạn có nhiều công cụ AI và muốn cài cho một công cụ cụ thể, README cho phép thêm một trong các cờ `--cursor`, `--claude` hoặc `--opencode`. Ví dụ cho Claude Code:

```bash
npx ctx7 setup --claude
```

Mình chỉ chép các cờ có trong README. Nếu công cụ của bạn không nằm trong ba cờ này, hãy xem trang hướng dẫn cài thủ công cho các client khác trên website Context7.

### Cấu hình thủ công (khi cần)

Nếu không muốn dùng lệnh setup, README hướng dẫn dùng địa chỉ máy chủ Context7 trong MCP client của bạn:

```txt
https://mcp.context7.com/mcp
```

Và gửi API key qua header sau. Thay `YOUR_API_KEY` bằng key của bạn:

```txt
Authorization: Bearer YOUR_API_KEY
```

Cách điền vào từng phần mềm khác nhau. README chưa ghi từng định dạng file cấu hình, nên bạn xem mục Manual Installation / Other Clients trên trang tài liệu của Context7 để biết client của mình điền ở đâu.

### Thêm quy tắc để AI tự dùng Context7 (tuỳ chọn)

Nếu cài bằng `ctx7 setup`, một skill đã được cấu hình sẵn để kích hoạt Context7 khi bạn hỏi về thư viện. Nếu muốn tự đặt quy tắc, README gợi ý thêm vào Cursor Settings > Rules, hoặc vào file `CLAUDE.md` với Claude Code. Quy tắc mẫu:

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

Câu này nghĩa là: luôn dùng Context7 mỗi khi tôi cần tài liệu thư viện, sinh code hoặc các bước cài đặt, cấu hình, không cần tôi nhắc.

### Gỡ cài đặt

Khi không dùng nữa, chạy lệnh dưới đây để xoá phần cấu hình đã tạo:

```bash
npx ctx7 remove
```

Nếu bạn đã cài CLI toàn cục trước đó bằng `npm install -g ctx7`, cần gỡ gói này riêng:

```bash
npm uninstall -g ctx7
```

## Kiểm tra đã chạy được chưa

README không nêu một thông báo thành công cố định cho lệnh `setup`. Cách kiểm tra đáng tin nhất là thử trực tiếp.

**Cách 1: thử trong công cụ AI.** Mở Cursor, Claude Code hoặc OpenCode, rồi gõ một câu có cụm `use context7`:

```txt
How do I set up a Next.js 16 proxy? use context7
```

Nếu cài đúng, agent sẽ gọi Context7 để lấy tài liệu trước khi trả lời. Với chế độ MCP, bạn thường thấy agent báo đang gọi công cụ như `resolve-library-id` hoặc `query-docs`. Cách hiển thị tuỳ từng phần mềm.

**Cách 2: thử bằng lệnh CLI.** Nếu bạn dùng chế độ CLI, thử tìm một thư viện:

```bash
ctx7 library supabase "email sign-up"
```

Lệnh này nên trả về danh sách thư viện khớp cùng ID của chúng. Dạng lệnh `ctx7 library <name> <query>` đúng như README. Nếu máy báo không có lệnh `ctx7`, bạn chưa cài CLI toàn cục. Khi đó hãy để agent tự gọi, hoặc xem trang CLI Reference trên website Context7.

## Dùng vào việc thật

### Dev mới học Next.js, viết đoạn kiểm tra đăng nhập

Bạn đang học Next.js và nhờ AI viết phần chặn người chưa đăng nhập. AI thường dùng cách của bản cũ. Hãy ghi rõ phiên bản và thêm `use context7`, theo đúng mẫu README:

```txt
Create a Next.js proxy that checks for a valid JWT in cookies
and redirects unauthenticated users to `/login`. use context7
```

Kết quả: AI lấy tài liệu hiện hành rồi mới viết, nên code ít khi gọi hàm đã bị đổi hoặc bỏ.

> Đừng bắt AI nhớ tài liệu. Hãy đưa tài liệu đúng bản cho nó đọc.
>
> — Ông T

### Người làm website cho shop, cấu hình bộ nhớ đệm

Bạn làm trang bán hàng chạy trên Cloudflare Workers và muốn dữ liệu API được lưu tạm năm phút để trang tải nhanh hơn. Bạn không rành cú pháp, nên nhờ AI:

```txt
Configure a Cloudflare Worker script to cache
JSON API responses for five minutes. use context7
```

Kết quả: AI trả đoạn cấu hình dựa trên tài liệu Cloudflare đang được lập chỉ mục. Bạn vẫn cần đọc lại và thử trên môi trường kiểm thử trước khi đưa lên trang thật.

### Dev dùng Supabase, muốn chắc chắn đúng thư viện

Có nhiều thư viện tên giống nhau, AI có thể chọn nhầm. Khi bạn biết ID, hãy ghi thẳng ID để Context7 bỏ qua bước dò tìm:

```txt
Implement basic authentication with Supabase. use library /supabase/supabase for API and docs.
```

Kết quả: tài liệu lấy từ đúng thư viện bạn chỉ định. Nếu chưa biết ID, hãy dùng `ctx7 library` để tra trước, rồi dán ID vào câu lệnh.

### Nhóm nhỏ muốn AI luôn tra tài liệu mà không phải nhắc

Bạn không muốn ai trong nhóm phải nhớ gõ `use context7`. Hãy thêm quy tắc vào `CLAUDE.md` (Claude Code) hoặc mục Rules (Cursor) với nội dung mẫu ở phần cài đặt. Với người cài bằng `ctx7 setup`, README nói skill đã được cấu hình sẵn để kích hoạt Context7 cho các câu hỏi liên quan đến thư viện.

Kết quả: mọi câu hỏi về thư viện hay cấu hình đều được kèm tài liệu mới, và người mới trong nhóm không phải học thêm thủ thuật nào.

## Lỗi hay gặp và cách xử lý

### Lệnh `npx ctx7 setup` báo lỗi hoặc không chạy

Nguyên nhân hay gặp nhất là Node.js quá cũ, vì README yêu cầu 22.13 trở lên. Chạy `node --version` để kiểm tra. Nếu thấp hơn, hãy nâng cấp Node.js rồi chạy lại. Nếu lỗi không phải do phiên bản, xem trang Troubleshooting trên website Context7.

### AI vẫn không gọi Context7

Trong câu lệnh bạn chưa thêm `use context7`, hoặc chưa có quy tắc nào thúc agent dùng nó. Cách xử lý an toàn: thêm cụm đó vào câu hỏi, hoặc thêm quy tắc mẫu vào Cursor Rules hay `CLAUDE.md`. Nếu cài thủ công, kiểm tra lại địa chỉ máy chủ và header `Authorization`. Khởi động lại công cụ AI sau khi đổi cấu hình cũng là bước nên thử.

### Bị giới hạn lượt dùng hoặc báo lỗi xác thực

README khuyến nghị có API key miễn phí để được giới hạn cao hơn. Hãy chạy lại `npx ctx7 setup` để đăng nhập và tạo key. Nếu cấu hình tay, kiểm tra key có bị sai ký tự, thiếu chữ `Bearer ` phía trước hay thừa khoảng trắng không.

### Lấy nhầm thư viện hoặc sai phiên bản

Tên thư viện trùng hoặc gần giống nhau có thể khiến Context7 chọn khác ý bạn. Hãy dùng ID dạng `/tổ-chức/dự-án` trong câu lệnh, và ghi rõ phiên bản bạn cần. Cả hai mẹo này đều có trong README.

### Mạng công ty chặn kết nối

File `.env.example` trong repo có liệt kê các biến `HTTPS_PROXY` và `NODE_EXTRA_CA_CERTS`. Chúng thường liên quan đến proxy và chứng chỉ trong mạng nội bộ. README chưa giải thích chi tiết cách dùng, nên hãy hỏi bộ phận IT của bạn và xem trang Troubleshooting của Context7 trước khi tự thiết lập.

## Có nên dùng không

**Điểm mạnh.** Cài nhanh bằng một lệnh. Miễn phí ở mức cơ bản, có API key miễn phí để tăng giới hạn. Giấy phép MIT. Hoạt động được với nhiều công cụ AI. Nó giải quyết đúng một việc rất thực tế: giảm tình trạng AI viết code theo tài liệu cũ hoặc bịa API.

**Giới hạn cần biết.** Theo phần tuyên bố miễn trừ của README, các dự án trong Context7 do cộng đồng đóng góp. Chất lượng, độ đầy đủ và độ an toàn của tài liệu không được đảm bảo hoàn toàn, nên bạn vẫn phải đọc lại code AI viết. Ngoài ra repo này chỉ chứa mã nguồn của MCP server. Phần backend API, bộ phân tích và bộ thu thập tài liệu là riêng tư, không nằm trong repo, nên bạn không tự chạy toàn bộ hệ thống được.

**Khi nên chọn cách khác.** Nếu thư viện của bạn là code nội bộ, chưa có trong chỉ mục Context7, bạn nên xem trang Adding Libraries để thêm vào, hoặc dùng cách khác để đưa tài liệu cho AI. Nếu bạn không dùng AI viết code, công cụ này không có nhiều tác dụng. Còn nếu dữ liệu của bạn rất nhạy cảm, hãy tự đọc kỹ chính sách của dịch vụ vì câu lệnh của bạn được gửi tới máy chủ bên ngoài.

Nói gọn lại: nếu bạn đang dùng AI để viết code và hay gặp chuyện code cũ hoặc hàm không có thật, Context7 đáng thử. Thao tác cài ngắn, dễ gỡ, và rủi ro thấp.

## Câu hỏi thường gặp

### Context7 có miễn phí không?

Repo dùng giấy phép MIT. README khuyến nghị lấy API key miễn phí ở trang dashboard của Context7 để có giới hạn lượt dùng cao hơn. Tư liệu chưa nêu chi tiết các gói trả phí hay mức giới hạn cụ thể.

### Context7 cần cài gì trước và có cần GPU không?

README chỉ yêu cầu Node.js 22.13 trở lên cho CLI ctx7. Tư liệu không nhắc đến GPU hay phần cứng đặc biệt, vì tài liệu được lấy từ máy chủ Context7 chứ không chạy mô hình trên máy bạn.

### Cài Context7 như thế nào cho nhanh nhất?

Mở terminal và chạy npx ctx7 setup. Lệnh này đăng nhập bằng OAuth, tạo API key và cài skill phù hợp, bạn có thể chọn chế độ CLI + Skills hoặc MCP. Muốn nhắm một công cụ cụ thể, README cho dùng cờ --cursor, --claude hoặc --opencode.

### Context7 khác gì việc tự dán tài liệu cho AI?

Context7 tự tìm và lấy tài liệu cùng ví dụ code đúng phiên bản rồi đưa vào ngữ cảnh của agent, nên bạn khỏi chuyển tab và dán tay. Bạn chỉ cần thêm use context7 vào câu lệnh hoặc đặt quy tắc để làm việc đó tự động.

### Dữ liệu và code của tôi có an toàn không?

README cảnh báo rằng tài liệu trong Context7 do cộng đồng đóng góp nên không thể đảm bảo hoàn toàn về độ chính xác hay an toàn, và có nút Report để báo nội dung đáng ngờ. Tư liệu mình có chưa mô tả cụ thể cách xử lý dữ liệu câu lệnh của bạn, nên với dự án nhạy cảm bạn nên đọc kỹ chính sách của dịch vụ.

### Chạy được trên Windows không, và dùng được với công cụ AI nào?

Tư liệu không nói rõ về hệ điều hành, chỉ yêu cầu Node.js 22.13 trở lên. Lệnh cài có cờ riêng cho Cursor, Claude Code và OpenCode, và README cho biết có hướng dẫn cài thủ công cho hơn 30 MCP client.

### Tôi có thể gỡ Context7 không?

Có. Chạy npx ctx7 remove để xoá phần cấu hình đã tạo. Nếu trước đó bạn cài CLI toàn cục bằng npm install -g ctx7, hãy gỡ riêng bằng npm uninstall -g ctx7.
