Bỏ qua tới nội dung
Ông T.vn

Context7: cho AI viết code đúng tài liệu mới nhất — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về upstash/context7 — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Context7: cập nhật tài liệu cho AI — hướng dẫn cài đặt và dùng →

Context7: cho AI viết code đúng tài liệu mới nhất — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Context7 là công cụ của Upstash giúp trợ lý AI viết code đọc tài liệu mới nhất, đúng phiên bản của thư viện bạn đang dùng. Bạn dùng nó qua MCP hoặc qua CLI ctx7 kèm skill. Cài đặt chỉ cần một lệnh npx ctx7 setup và Node.js 22.13 trở lên, nên không khó.

Context7 là một nền tảng giúp trợ lý AI viết code (Cursor, Claude Code, OpenCode…) đọc tài liệu mới nhất của thư viện, đúng phiên bản bạn đang dùng, thay vì dựa vào trí nhớ cũ của mô hình. Repo này chứa mã nguồn của máy chủ MCP và công cụ dòng lệnh ctx7. Hiện có khoảng 64.710 sao và 3.242 fork, giấy phép MIT, ngôn ngữ chính là TypeScript.

Vấn đề nó giải quyết rất quen thuộc. AI thường học từ dữ liệu đã cũ cả năm. Kết quả là code mẫu lỗi thời, hàm không hề tồn tại, hoặc câu trả lời dành cho phiên bản cũ của gói. Bạn dán code vào chạy thì báo lỗi, rồi phải mở tab tài liệu ra tự đọc lại.

Context7 xử lý bằng cách kéo tài liệu và ví dụ code mới, theo từng phiên bản, đưa vào ngữ cảnh của AI ngay lúc nó trả lời. Bài này hợp với lập trình viên mới, người đang “vibe coding” với AI, và dân văn phòng thỉnh thoảng nhờ AI viết script. Điểm đáng giá nhất là bạn chỉ cần thêm hai chữ use context7 vào câu lệnh, hoặc cài một lần rồi để AI tự gọi.

MCP server

upstash/context7

Context7 lấy tài liệu thư viện đúng phiên bản, mới nhất và đưa thẳng cho AI viết code, để AI bớt bịa hàm và bớt dùng code cũ.

★ 65kTypeScriptMIT
Xem repo trên GitHub

I.Context7 làm được gì

Lấy tài liệu đúng phiên bản. Bạn ghi rõ phiên bản trong câu hỏi, ví dụ Next.js 16. Context7 tự khớp tài liệu tương ứng. Bạn không phải lo AI trả lời theo cách của bản cũ.

Giảm tình trạng bịa API. Vì AI được đưa tài liệu lấy từ nguồn, nó ít phải đoán tên hàm. Thứ AI viết ra bám theo tài liệu thật, nên bạn ít phải sửa lỗi “hàm này không tồn tại”.

Hai chế độ dùng. Chế độ thứ nhất là CLI + Skills. Nó cài một skill hướng dẫn AI gọi lệnh ctx7 để lấy tài liệu, không cần MCP. Chế độ thứ hai là MCP. Nó đăng ký một máy chủ Context7 để AI gọi công cụ tài liệu một cách tự nhiên. Bạn chọn cái nào hợp với công cụ AI mình đang dùng.

Chỉ định thư viện bằng ID. Nếu bạn biết chính xác thư viện, hãy ghi ID dạng /supabase/supabase. Context7 bỏ qua bước đoán thư viện và lấy tài liệu luôn. Cách này nhanh và ít nhầm hơn.

Có công cụ cho cả người lẫn AI. Dòng lệnh có ctx7 library để tìm thư viện và ctx7 docs để lấy tài liệu. Phía MCP có hai công cụ tương ứng là resolve-library-id và query-docs. Công cụ query-docs còn nhận tham số language (không bắt buộc) để xếp ví dụ theo ngôn ngữ bạn viết lên đầu.

Một vài gói đi kèm. Repo còn có SDK TypeScript, công cụ cho Vercel AI SDK và một extension cho pi.dev. Người mới chưa cần đụng tới các gói này.

II.Cần chuẩn bị gì

Theo README, bạn cần:

  • Node.js 22.13 trở lên. Đây là yêu cầu của CLI ctx7. Lệnh npx đi kèm Node.js nên cài Node là có luôn.
  • Một trợ lý AI viết code để gắn Context7 vào. README nhắc tới Cursor, Claude Code và OpenCode, và nói trang hướng dẫn riêng hỗ trợ hơn 30 ứng dụng.
  • API key (nên có, không bắt buộc). README khuyên lấy key miễn phí ở trang dashboard của Context7 để có giới hạn lượt dùng cao hơn. Lệnh setup cũng tự tạo key giúp bạn sau khi đăng nhập.
  • Một tài khoản để đăng nhập. Lệnh setup xác thực bằng OAuth, nên sẽ mở trình duyệt cho bạn đăng nhập.

Tư liệu không nói gì về hệ điều hành cụ thể hay phần cứng. Máy chủ xử lý tài liệu nằm ở phía dịch vụ, nên có vẻ bạn không cần GPU. Tuy vậy README không khẳng định điều này.

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

  1. Kiểm tra Node.jsChắc chắn máy có Node.js 22.13 trở lên
  2. Chạy lệnh setupGõ npx ctx7 setup trong terminal
  3. Đăng nhập và chọn chế độĐăng nhập OAuth, chọn CLI + Skills hoặc MCP
  4. Thêm hướng dẫn cho AIDùng use context7 hoặc đặt một rule cố định
  5. Gỡ khi không cầnChạy npx ctx7 remove

A.Kiểm tra Node.js

Mở terminal. Trên Windows là PowerShell hoặc Terminal. Trên macOS hoặc Linux là Terminal. Gõ lệnh sau để xem phiên bản Node:

Terminal
node --version

Nếu số hiện ra nhỏ hơn 22.13, bạn cần cài bản Node mới hơn trước. README không hướng dẫn cách cài Node, bạn tải từ trang chủ Node.js như bình thường.

B.Chạy lệnh setup

Đây là cách cài chính theo README. Một lệnh duy nhất làm hết các việc: đăng nhập, tạo API key, cài skill phù hợp.

Terminal
npx ctx7 setup

Bạn có thể thêm cờ để chỉ cấu hình cho một công cụ cụ thể: --cursor, --claude hoặc --opencode. Ví dụ nếu bạn chỉ dùng Claude Code:

Terminal
npx ctx7 setup --claude

Chỗ người mới hay vấp: lệnh này chạy ở terminal bất kỳ, không cần vào thư mục dự án. Chỉ cần máy có kết nối mạng.

C.Đăng nhập và chọn chế độ

Lệnh setup sẽ xác thực bằng OAuth. Làm theo màn hình, thường là đăng nhập trên trình duyệt rồi quay lại terminal. Sau đó bạn chọn giữa hai chế độ:

  • CLI + Skills: AI dùng lệnh ctx7 theo hướng dẫn của skill, không cần MCP.
  • MCP: AI gọi công cụ tài liệu trực tiếp qua máy chủ MCP.

Nếu chưa biết chọn gì, bạn cứ thử chế độ mà công cụ của mình hỗ trợ tốt hơn. Muốn đổi, chạy lại setup.

D.Cài thủ công (nếu không dùng setup)

Nếu muốn tự cấu hình, README nói dùng địa chỉ máy chủ Context7 và gửi API key trong header Authorization:

txt
URL máy chủ: https://mcp.context7.com/mcp
Header: Authorization: Bearer YOUR_API_KEY

Thay YOUR_API_KEY bằng key của bạn. Cách khai báo trong từng ứng dụng khác nhau. README chưa ghi từng mẫu cấu hình ngay trong repo, nên hãy xem trang “Manual Installation / Other Clients” trên context7.com/docs/resources/all-clients.

API key là thông tin riêng của bạn. Đừng dán key vào tin nhắn công khai, ảnh chụp màn hình hay file code đưa lên GitHub. Nếu lỡ lộ, vào trang dashboard của Context7 để tạo key mới.

E.Thêm hướng dẫn cho AI

Có hai cách để AI dùng Context7. Cách thứ nhất là thêm use context7 vào cuối câu lệnh mỗi lần cần. Cách thứ hai là đặt một rule cố định để AI tự dùng. Nếu bạn đã chạy ctx7 setup, skill được cài sẵn và tự kích hoạt cho các câu hỏi về thư viện. Còn nếu muốn đặt rule tay, README gợi ý thêm vào Cursor Settings > Rules, hoặc vào file CLAUDE.md với Claude Code, hoặc chỗ tương đương ở công cụ khác. Rule mẫu của README:

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

F.Gỡ cài đặt

Khi không muốn dùng nữa, xoá phần cấu hình do setup tạo ra:

Terminal
npx ctx7 remove

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

Terminal
npm uninstall -g ctx7

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

README không mô tả một màn hình “thành công” cụ thể. Bạn có thể tự kiểm tra bằng hai cách đơn giản.

Cách 1: hỏi thử AI. Mở trợ lý AI và gõ một câu có use context7:

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

Nếu cài đúng, AI sẽ gọi công cụ của Context7 (hoặc chạy lệnh ctx7) để lấy tài liệu, rồi mới trả lời. Với nhiều công cụ AI, bạn sẽ thấy dòng thông báo về việc gọi công cụ. Câu trả lời cũng nên bám đúng phiên bản bạn nêu.

Cách 2: chạy CLI trực tiếp. Nếu bạn chọn chế độ CLI + Skills, thử tìm một thư viện:

Terminal
ctx7 library nextjs "proxy authentication"

Kết quả mong đợi là danh sách thư viện khớp cùng ID của chúng, ví dụ dạng /vercel/next.js. Nếu lệnh ctx7 không được nhận ra, bạn có thể gọi qua npx ctx7 ... hoặc cài toàn cục bằng npm install -g ctx7.

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

A.Dev mới viết đăng nhập bằng JWT trong Next.js

Bạn là lập trình viên mới, đang làm web bán hàng bằng Next.js. Bạn cần chặn người chưa đăng nhập vào trang quản lý. Thay vì copy code từ bài blog cũ, bạn nhờ AI kèm Context7. Đây là câu mẫu từ 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 Next.js mới về, rồi viết code theo cách của phiên bản hiện hành. Bạn đỡ phải đoán xem tên file hay hàm còn dùng được không.

Dùng AI viết code mà không cho nó đọc tài liệu mới, giống nhờ người đi vắng cả năm chỉ đường trong thành phố vừa đổi tên đường.

Ông T

B.Chủ shop tự chỉnh Cloudflare Worker

Bạn có trang bán hàng nhỏ và dùng Cloudflare Worker để trả dữ liệu JSON. Trang bị chậm vì mỗi lần khách vào đều gọi API lại. Bạn nhờ AI:

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

Kết quả: một đoạn script cache lại phản hồi trong năm phút, viết theo tài liệu hiện hành của Cloudflare. Bạn vẫn nên đọc qua và thử trên môi trường thử trước khi áp dụng cho trang thật.

C.Chỉ định đúng thư viện bằng ID

Bạn làm phần đăng ký tài khoản bằng email và mật khẩu cho một ứng dụng nội bộ, dùng Supabase. Bạn biết rõ mình dùng Supabase, nên thêm luôn ID để Context7 khỏi phải đoán:

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

Kết quả: AI lấy thẳng tài liệu của /supabase/supabase, bỏ qua bước tìm kiếm thư viện. Cách này giảm nguy cơ AI lấy nhầm một thư viện tên gần giống.

D.Tự tra tài liệu bằng dòng lệnh

Đôi khi bạn muốn tự đọc tài liệu, không qua AI. Chẳng hạn bạn là nhân viên kỹ thuật đang tìm cách gọi API đăng ký của Supabase. Trước hết, tìm ID thư viện:

Terminal
ctx7 library supabase "email password sign-up"

Rồi lấy tài liệu bằng ID vừa có:

Terminal
ctx7 docs /supabase/supabase "email and password sign-up"

Kết quả: các đoạn tài liệu và ví dụ code liên quan được in ra terminal. Bạn đọc, copy hoặc đưa tiếp cho AI.

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

A.Lệnh báo lỗi vì Node.js quá cũ hoặc không có Node

README yêu cầu Node.js 22.13 trở lên. Nếu npx không có, hoặc node --version ra số thấp hơn, lệnh setup có thể không chạy. Cách xử lý an toàn: cài hoặc nâng cấp Node.js, mở terminal mới rồi chạy lại npx ctx7 setup.

B.AI vẫn trả lời như cũ, không gọi Context7

Đây là tình huống phổ biến. Thử thêm use context7 vào cuối câu lệnh. Nếu muốn khỏi gõ mỗi lần, đặt rule như mẫu ở trên (trong Cursor Settings > Rules hoặc CLAUDE.md). Nếu bạn cài bằng ctx7 setup thì skill đã tự kích hoạt cho câu hỏi về thư viện, nên hãy kiểm tra lại xem setup có chọn đúng công cụ AI của bạn không. Có thể chạy lại với cờ --cursor, --claude hoặc --opencode.

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

Tên thư viện đôi khi trùng nhau. Dùng ctx7 library <tên> <câu hỏi> để xem danh sách kèm ID, chọn ID đúng rồi ghi vào câu lệnh theo dạng use library /org/project. Nếu cần phiên bản cụ thể, ghi thẳng phiên bản trong câu hỏi.

D.Hết lượt dùng hoặc bị giới hạn tốc độ

README khuyên có API key miễn phí để được giới hạn cao hơn. Nếu bạn chạy thủ công thì chắc chắn đã điền key vào header Authorization: Bearer .... Nếu cài bằng setup, key đã được tạo giúp bạn. README không nói con số giới hạn cụ thể, nên bạn xem trên trang dashboard của dịch vụ.

E.Máy công ty chặn mạng hoặc dùng proxy

File .env.example trong repo có liệt kê các biến HTTPS_PROXY và NODE_EXTRA_CA_CERTS, nghĩa là mạng có proxy là một tình huống đã được tính tới. Tuy nhiên README chưa giải thích cách đặt cụ thể. Bạn nên xem trang Troubleshooting trên context7.com/docs/resources/troubleshooting hoặc hỏi bộ phận IT trước khi tự chỉnh.

VII.Có nên dùng không

Điểm mạnh. Cài nhanh, chỉ một lệnh. Miễn phí (có key miễn phí cho giới hạn cao hơn). Giấy phép MIT. Hỗ trợ cả hai kiểu dùng: MCP và CLI + Skills. Và hỗ trợ nhiều công cụ AI phổ biến. Với người mới, lợi ích thấy ngay: code AI viết ít lỗi “hàm không tồn tại” hơn.

Giới hạn cần biết. Thứ nhất, repo này chỉ chứa mã nguồn của máy chủ MCP. README nói rõ phần backend API, bộ phân tích và bộ thu thập tài liệu là private, không nằm trong repo. Nghĩa là bạn không tự dựng toàn bộ hệ thống được chỉ từ repo. Thứ hai, README nhấn mạnh tài liệu trong Context7 do cộng đồng đóng góp. Nhóm phát triển không đảm bảo hoàn toàn về độ chính xác, đầy đủ hay an toàn của từng thư viện. Nếu thấy nội dung đáng ngờ, bạn dùng nút “Report” trên trang dự án. Bạn dùng theo quyết định và rủi ro của mình, nên với code quan trọng vẫn phải đọc lại và thử kỹ. Thứ ba, tư liệu chưa cho biết cụ thể chuyện dữ liệu hay câu hỏi của bạn được xử lý và lưu thế nào. Nếu bạn làm việc với mã nguồn nhạy cảm, hãy tự đọc điều khoản trên trang chủ.

Khi nào chọn cách khác. Nếu bạn không dùng trợ lý AI viết code thì Context7 không có nhiều giá trị. Nếu thư viện bạn dùng quá nhỏ hoặc nội bộ, có thể nó chưa được lập chỉ mục. README có trang “Adding Libraries” để gửi thư viện lên. Nếu cần chạy hoàn toàn offline, bạn nên xem “Developer Guide” để biết cách chạy máy chủ MCP cục bộ, nhưng các phần phía sau vẫn là dịch vụ riêng. Với người mới, mình khuyên cứ thử npx ctx7 setup. Cài thấy không hợp thì npx ctx7 remove là xong.

5.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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 lấy API key miễn phí trên trang dashboard của Context7 để có giới hạn lượt dùng cao hơn. Tư liệu không nêu chi tiết gói trả phí hay con số giới hạn, nên bạn xem trang chủ để biết thêm.

Cài Context7 có khó không?

Không khó. README chỉ cần một lệnh là npx ctx7 setup, với điều kiện máy có Node.js 22.13 trở lên. Lệnh này đăng nhập bằng OAuth, tạo API key và cài skill phù hợp cho bạn.

Context7 có cần GPU không?

Tư liệu không nhắc tới yêu cầu GPU hay phần cứng riêng. Phần xử lý tài liệu nằm ở dịch vụ của Context7, bạn chỉ cần máy chạy được Node.js và công cụ AI viết code của mình.

Context7 chạy trên Windows được không?

README không nêu rõ hệ điều hành nào được hỗ trợ. Điều kiện duy nhất được ghi là Node.js 22.13 trở lên cho CLI ctx7. Vì vậy nếu máy bạn cài được Node.js đúng phiên bản thì có thể thử, còn thông tin chính thức hơn thì xem trên trang tài liệu của dự án.

Khác nhau giữa chế độ CLI + Skills và MCP là gì?

Với CLI + Skills, bạn cài một skill để AI chạy lệnh ctx7 lấy tài liệu, không cần MCP. Với MCP, bạn đăng ký máy chủ Context7 để AI gọi công cụ resolve-library-id và query-docs trực tiếp. Lệnh npx ctx7 setup cho bạn chọn một trong hai.

Làm sao để AI dùng đúng thư viện và đúng phiên bản?

Ghi phiên bản ngay trong câu hỏi, ví dụ Next.js 16, Context7 sẽ tự khớp. Nếu biết chính xác thư viện, thêm ID dạng /supabase/supabase vào câu lệnh để bỏ qua bước đoán. Bạn cũng có thể dùng ctx7 library để tìm ID trước.

Dữ liệu và tài liệu trong Context7 có an toàn, chính xác không?

README nói các dự án trong Context7 do cộng đồng đóng góp, nhóm phát triển không đảm bảo hoàn toàn độ chính xác, đầy đủ hay an toàn. Bạn dùng theo quyết định và rủi ro của mình, và có nút Report để báo nội dung đáng ngờ. Tư liệu chưa có thông tin chi tiết về cách xử lý dữ liệu của bạn.

Chuyển nhanh tới mục

  1. I.Context7 làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js
    2. B.Chạy lệnh setup
    3. C.Đăng nhập và chọn chế độ
    4. D.Cài thủ công (nếu không dùng setup)
    5. E.Thêm hướng dẫn cho AI
    6. F.Gỡ cài đặt
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới viết đăng nhập bằng JWT trong Next.js
    2. B.Chủ shop tự chỉnh Cloudflare Worker
    3. C.Chỉ định đúng thư viện bằng ID
    4. D.Tự tra tài liệu bằng dòng lệnh
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh báo lỗi vì Node.js quá cũ hoặc không có Node
    2. B.AI vẫn trả lời như cũ, không gọi Context7
    3. C.Lấy nhầm thư viện hoặc nhầm phiên bản
    4. D.Hết lượt dùng hoặc bị giới hạn tốc độ
    5. E.Máy công ty chặn mạng hoặc dùng proxy
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.