context-mode: giảm dữ liệu vào context — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về mksglu/context-mode — 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: context-mode: giảm 99% dữ liệu vào context — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
context-mode là plugin miễn phí, chạy local cho nhiều coding agent như Claude Code, Codex, Gemini CLI và Copilot CLI. Plugin lưu kết quả vào SQLite, cho agent tìm đúng phần cần dùng nên có thể giảm đáng kể dữ liệu đi vào context; cài đặt cần Node.js từ 24.15.0 và thêm Git for Windows nếu dùng Windows.
context-mode là plugin local giúp giữ kết quả từ công cụ bên ngoài context window của coding agent. Thay vì đưa toàn bộ nội dung file, log, trang web hoặc kết quả lệnh vào agent, plugin lưu dữ liệu vào SQLite trên máy rồi chỉ trả về phần agent cần.
Repo này phù hợp với bạn dùng Claude Code, Codex, Gemini CLI, Copilot CLI hoặc các agent được hỗ trợ khác để đọc nhiều dữ liệu, chạy lệnh dài, xem log và tra tài liệu. Giá trị lớn nhất là giảm lượng dữ liệu đi vào context, trong khi dữ liệu và chỉ mục vẫn nằm trên máy. Repo hiện có khoảng 34.020 sao và 2.336 fork.
Plugin miễn phí, không gửi telemetry và có thể hoạt động offline sau khi cài. README mô tả mức giảm trung vị 99,4% số byte trong 36 mẫu có đầu ra từ 10 KB trở lên. Con số thực tế còn tùy loại công việc và cách agent sử dụng công cụ.
mksglu/context-mode
Plugin local giúp giữ kết quả công cụ ngoài context của coding agent, giảm dữ liệu phải đọc và giữ thông tin trên máy.
I.context-mode làm được gì
Giữ đầu ra lớn ngoài context: Khi agent đọc file dài, chạy lệnh nhiều dòng, lấy log hoặc tải trang web, toàn bộ kết quả được giữ trong sandbox và chỉ phần cần thiết được đưa lại cho agent. Context vì vậy ít bị lấp bởi dữ liệu thô.
Tìm kiếm trong dữ liệu cục bộ: Plugin dùng SQLite FTS5 để lập chỉ mục và tìm kiếm. Agent có thể yêu cầu tìm đoạn liên quan trong kết quả đã lưu thay vì đọc lại toàn bộ dữ liệu.
Chạy xử lý trong sandbox: Với cách “Thinking in Code”, agent viết một đoạn script ngắn để lọc, đếm hoặc tổng hợp dữ liệu. Chỉ kết quả script in ra đi vào context, phù hợp với JSON lớn, log dài và danh sách nhiều bản ghi.
Tích hợp với nhiều coding agent: README liệt kê Claude Code, Codex, Gemini CLI, Qwen Code, Pi, OpenCode, Copilot CLI, Kiro, VS Code và ZCode. Mỗi agent có lệnh cài riêng; ngoài ra có thể dùng đường cài npm chung.
Có hook, MCP và skill: Tùy agent, plugin cung cấp hook qua package, hook file hoặc chính plugin của agent. README ghi cả 10 agent đều có hook, MCP và skill sau khi cài theo cách tương ứng.
Theo dõi mức tiết kiệm: Sau khi chạy prompt, skill thống kê cho biết bao nhiêu dữ liệu thô đã được giữ ngoài context. Báo cáo có số byte trước và sau, phần trăm tiết kiệm và ước tính số token đã tránh đưa vào context.
Lưu riêng theo dự án: Chỉ mục nằm trong
~/.context-mode, với một filecontext.dbcho mỗi dự án. Điều này giúp dữ liệu tìm kiếm gắn với dự án đang làm.Có công cụ kiểm tra và sửa cấu hình: Lệnh
doctorkiểm tra tình trạng cài đặt và đưa ra lệnh sửa khi cần. Lệnhsetupcũng được dùng để sửa lại cấu hình; README nói công cụ sẽ hiển thị kế hoạch, lưu cấu hình cũ rồi áp dụng kế hoạch.
II.Cần chuẩn bị gì
- Máy chạy Windows, macOS hoặc Linux. README cho biết CI kiểm tra quy trình setup, doctor, hook và MCP trên cả ba hệ điều hành.
- Node.js từ phiên bản
24.15.0trở lên. Đây là yêu cầu trong trườngenginescủapackage.json. - npm để cài gói
context-modenếu dùng đường cài npm. - Nếu dùng Windows, cần cài Git for Windows. README nói các công cụ shell chạy trong Git Bash và doctor sẽ kiểm tra thành phần này.
- Một coding agent được repo hỗ trợ, chẳng hạn Claude Code, Codex, Gemini CLI, Qwen Code, Pi, OpenCode, Copilot CLI, Kiro, VS Code hoặc ZCode.
- Không cần API key riêng cho plugin theo nội dung README. Plugin chạy các hook, sandbox và tìm kiếm như các tiến trình local cạnh agent. Tuy vậy, agent hoặc công cụ bên ngoài mà bạn dùng có thể có yêu cầu tài khoản riêng; README được cung cấp không mô tả các yêu cầu đó.
- Không có yêu cầu GPU trong README. Dữ liệu chỉ mục dùng SQLite local và plugin có thể hoạt động offline sau khi cài.
- Giấy phép của repo không được phần tư liệu cung cấp ghi rõ. README gọi đây là source-available và miễn phí, nhưng bạn nên xem file
LICENSEtrong repo để biết điều khoản áp dụng cụ thể.
III.Cài đặt từng bước
- Chuẩn bị môi trườngKiểm tra Node.js và Git for Windows nếu dùng Windows
- Chọn agentXác định coding agent bạn đang dùng
- Cài pluginDùng lệnh cài riêng hoặc đường npm chung
- Thiết lập hookChạy setup nếu agent cần cấu hình qua npm
- Khởi động lại và kiểm traMở lại agent rồi chạy doctor hoặc lệnh kiểm tra
A.Chuẩn bị terminal và môi trường
Mở terminal tại nơi bạn thường làm việc. Nếu dùng Windows, mở Git Bash sau khi cài Git for Windows. Bạn cần Node.js từ 24.15.0 trở lên trước khi cài gói.
README không đưa lệnh kiểm tra phiên bản Node.js cụ thể. Bạn có thể kiểm tra bằng lệnh phổ thông sau:
node --version
npm --versionNếu Node.js thấp hơn yêu cầu, hãy nâng cấp Node.js trước. Người mới hay vấp ở chỗ mở PowerShell nhưng thiếu Git Bash; theo README, các shell tool trên Windows chạy trong Git Bash.
B.Cài theo đường npm chung
Đây là cách README ghi là hoạt động cho mọi agent. Lệnh đầu tiên cài gói toàn cục, lệnh thứ hai chạy thiết lập:
npm i -g context-mode
context-mode setupnpm i -g context-mode cài gói npm và lệnh context-mode. context-mode setup tạo kế hoạch cấu hình cho các agent mà plugin nhận diện. README nói setup cũng là cách sửa cấu hình: công cụ hiển thị kế hoạch, lưu cấu hình trước đó rồi áp dụng kế hoạch; nếu một bước kết thúc sớm, cấu hình đã lưu sẽ được khôi phục.
Nếu bạn chỉ muốn thiết lập một số agent, README đưa ví dụ như sau:
context-mode setup --agents copilot-cli
context-mode setup --agents kiro
context-mode setup --agents vscodeHãy thay tên agent đúng với phần mềm bạn đang dùng. Không tự đổi tên tham số hoặc thêm agent chưa được README ghi rõ.
C.Cài trực tiếp cho Claude Code
Nếu dùng Claude Code, chạy hai lệnh sau trong terminal của bạn:
claude plugin marketplace add mksglu/context-mode
claude plugin install context-mode@context-modeLệnh đầu thêm marketplace của repo. Lệnh thứ hai cài plugin từ release branch context-mode. README ghi cách này đã có hooks, MCP và skills.
D.Cài trực tiếp cho Codex
Với Codex, chạy:
codex plugin marketplace add mksglu/context-mode
codex plugin add context-mode@context-mode
npm i -g context-mode
context-mode setup --agents codexHai lệnh đầu cài plugin từ marketplace. Hai lệnh sau là bước một lần để cài gói npm và tin cậy hook của plugin cho Codex. Đây là điểm người mới dễ bỏ qua: cài plugin chưa đủ nếu chưa chạy bước setup hook được README nêu.
E.Cài trực tiếp cho các agent khác
README cung cấp các lệnh sau. Chọn đúng nhóm tương ứng với agent của bạn.
Gemini CLI:
gemini extensions install https://github.com/mksglu/context-mode
gemini extensions update context-mode
gemini extensions uninstall context-modeQwen Code:
qwen extensions install https://github.com/mksglu/context-mode:context-mode
qwen extensions update context-mode
qwen extensions uninstall context-modePi:
pi install npm:context-mode
pi update --extensions
pi remove npm:context-modeOpenCode:
opencode plugin add context-mode
opencode plugin update
opencode plugin remove context-modeCopilot CLI, Kiro và VS Code dùng npm cùng lệnh setup theo từng agent:
npm i -g context-mode
context-mode setup --agents copilot-clinpm i -g context-mode
context-mode setup --agents kironpm i -g context-mode
context-mode setup --agents vscodeZCode:
zcode plugins marketplace add mksglu/context-mode
zcode plugins install context-mode@context-modeMỗi agent có hệ thống cấu hình riêng. Không chạy lẫn lệnh của agent này cho agent khác. Nếu cần gỡ cài đặt đường npm chung, README ghi:
context-mode setup --remove
npm rm -g context-modeF.Khởi động lại và chạy kiểm tra
Sau khi cài xong, khởi động lại coding agent rồi chạy /ctx-doctor trong agent. README nói mỗi kiểm tra sẽ in PASS hoặc một lệnh sửa. Với các agent dùng lệnh doctor riêng, có thể chạy:
context-mode doctor --agents copilot-clicontext-mode doctor --agents kirocontext-mode doctor --agents vscodeNếu dùng Claude Code, Codex hoặc agent khác, dùng lệnh kiểm tra tương ứng trong README. Ví dụ:
claude plugin list
codex mcp list
gemini mcp list
qwen extensions list
pi list
opencode mcp list --pure
copilot mcp list
zcode plugins listVới OpenCode 2, README ghi biến thể:
opencode mcp list --standaloneIV.Kiểm tra đã chạy được chưa
Dấu hiệu cơ bản là /ctx-doctor trong agent trả về các dòng PASS, không có bước sửa bắt buộc. Bạn cũng có thể kiểm tra danh sách plugin, MCP hoặc extension bằng lệnh đúng với agent. Nếu plugin xuất hiện trong danh sách và doctor không báo lỗi, phần cài đặt chính đã hoạt động.
Cách kiểm tra chức năng thực tế là gửi một prompt có đầu ra lớn, chẳng hạn yêu cầu agent lấy dữ liệu JSON, lọc dữ liệu rồi trả về vài kết quả. Sau đó chạy skill thống kê. Các lệnh trong README gồm:
/ctx-statsVới Codex:
$ctx-statsVới Pi:
/skill:ctx-statsGemini CLI, Kiro, OpenCode, Qwen Code và ZCode dùng yêu cầu gọi ctx_stats rồi hiển thị báo cáo. Báo cáo mẫu có dạng “raw bytes became fewer bytes”, phần trăm được giữ ngoài context và ước tính token đã tránh đưa vào cửa sổ context.
V.Dùng vào việc thật
A.Chủ shop cần lọc dữ liệu sản phẩm
Một chủ shop có thể yêu cầu agent lấy một API JSON lớn, tìm sản phẩm theo điều kiện rồi chỉ trả về mã và tên. Prompt mẫu trong README là:
Fetch https://jsonplaceholder.typicode.com/photos. Which photo has the longest title (give its id and title), and how many photos have a title that contains the word "est"?Agent xử lý 5.000 bản ghi trong sandbox và trả về hai thông tin ngắn. Đây là kiểu việc context-mode làm tốt: dữ liệu đầu vào rất lớn nhưng câu trả lời cuối chỉ có vài sự kiện cần thiết.
B.Nhân viên văn phòng cần đọc log và tìm nguyên nhân
Nhân viên vận hành có thể đưa một file log dài cho agent, yêu cầu đếm lỗi và nhóm theo nguồn. Prompt README minh họa việc đếm lỗi xác thực trong syslog và tìm ba host từ xa gây ra nhiều lỗi nhất:
Here is a Linux syslog sample: https://raw.githubusercontent.com/logpai/loghub/master/Linux/Linux_2k.log. How many authentication failures does it contain, and which 3 remote hosts caused the most?Agent xử lý 1.999 dòng trong sandbox rồi chỉ đưa số liệu tổng hợp vào context. Bạn có thể áp dụng cùng cách cho log ứng dụng của mình, nhưng nên kiểm tra kỹ dữ liệu trước khi gửi và tránh đưa thông tin bí mật không cần thiết.
C.Dev cần tra tài liệu web dài
Dev có thể yêu cầu agent lấy một trang tài liệu rồi tìm đúng ví dụ hoặc quy tắc cần đọc:
On https://react.dev/reference/react/useEffect, show me the example that connects to a chat server and cleans up, and list the rules for the dependency array.Hook gửi WebFetch vào sandbox, sau đó agent tìm ví dụ và quy tắc trên trang. Cách này hữu ích khi tài liệu dài hơn phần bạn muốn xem, vì agent không cần đưa cả trang vào context.
D.Dev muốn biết plugin có thực sự tiết kiệm context không
Sau một prompt đọc file, chạy test hoặc lấy dữ liệu web, hãy chạy skill thống kê của agent. Ví dụ với Claude Code:
/ctx-statsBáo cáo cho biết số lần gọi, dung lượng trước và sau, lượng dữ liệu được giữ ngoài context và phần trăm tiết kiệm. Với một công việc thực tế, đây là cách dễ nhất để biết plugin có lợi cho dự án của bạn hay không.
Khi dữ liệu lớn, hãy để agent tìm đúng phần cần dùng thay vì đưa cả khối dữ liệu vào context.
Ông T
Plugin giữ dữ liệu trên máy, nhưng quyền truy cập vẫn phụ thuộc vào agent, shell và các công cụ bạn cấp cho agent. Không đưa API key, thông tin khách hàng hoặc dữ liệu nội bộ vào prompt nếu công việc không cần chúng.
VI.Lỗi hay gặp và cách xử lý
A.Node.js không đủ phiên bản
Nếu npm từ chối cài hoặc lệnh không chạy, hãy kiểm tra Node.js. package.json yêu cầu từ 24.15.0; nâng cấp Node.js rồi cài lại gói context-mode.
B.Windows thiếu Git for Windows
README nói shell tools trên Windows chạy trong Git Bash và doctor sẽ kiểm tra Git for Windows. Nếu hook hoặc lệnh shell không hoạt động, cài Git for Windows, mở Git Bash rồi chạy lại doctor hoặc setup.
C.Cài plugin nhưng hook chưa được tin cậy
Trường hợp này đặc biệt dễ gặp với Codex. Hãy chạy lại các lệnh npm và setup cho Codex:
npm i -g context-mode
context-mode setup --agents codexSau đó khởi động lại Codex và kiểm tra bằng codex mcp list hoặc /ctx-doctor.
D.Kiểm tra sai lệnh theo agent
Mỗi agent có cú pháp riêng. Ví dụ OpenCode có opencode mcp list --pure cho OpenCode 1.19 và opencode mcp list --standalone cho OpenCode 2. Không dùng lẫn lệnh claude, codex, qwen hoặc zcode nếu bạn đang kiểm tra agent khác.
E.Không thấy mức tiết kiệm như ví dụ
Các số trong README là kết quả benchmark trên những mẫu cụ thể, không phải cam kết cho mọi prompt. Hãy chạy đúng công việc của bạn rồi gọi skill thống kê. Đầu ra nhỏ hơn 10 KB hoặc yêu cầu trả lại nhiều nội dung có thể cho tỷ lệ tiết kiệm thấp hơn.
VII.Có nên dùng không
Bạn nên dùng context-mode nếu thường xuyên làm việc với coding agent và gặp các đầu ra dài như log, JSON, trang tài liệu, danh sách issue, kết quả test hoặc file nguồn lớn. Plugin miễn phí, chạy local, có SQLite FTS5, không telemetry và hỗ trợ nhiều agent. Việc cài tương đối rõ ràng nếu máy đã có Node.js đúng phiên bản.
Giới hạn chính là plugin không tự làm cho dữ liệu nhỏ trở nên hữu ích hơn; nó chủ yếu tối ưu cách dữ liệu lớn đi vào context. Bạn cũng cần hiểu cấu hình hook và MCP của agent đang dùng. README không ghi rõ giấy phép, nên nếu dùng trong doanh nghiệp hãy xem file LICENSE trước khi triển khai.
Nếu dự án yêu cầu toàn bộ nội dung luôn hiện trực tiếp trong context, hoặc agent của bạn không nằm trong danh sách hỗ trợ, lợi ích có thể không đáng kể. Nếu bạn cần dịch vụ lưu nhớ hội thoại hoặc chia sẻ kiến thức giữa nhiều phiên, README phân biệt đó là Context Mode Gateway, một dịch vụ hosted riêng có tài khoản và gói đăng ký; plugin trong repo này không phải dịch vụ đó.
Câu hỏi thường gặp
context-mode có miễn phí không?
Có. README mô tả plugin là miễn phí lâu dài và chạy local. Context Mode Gateway là dịch vụ hosted riêng, có tài khoản và gói đăng ký, không phải plugin trong repo này.
Có cần GPU để chạy không?
README không nêu yêu cầu GPU. Plugin dùng các tiến trình local, SQLite và runtime của máy; dữ liệu chỉ mục được lưu trong `~/.context-mode`.
Có chạy được trên Windows không?
Có. README cho biết CI kiểm tra trên Windows. Bạn cần Git for Windows vì shell tools chạy trong Git Bash, và Node.js từ 24.15.0.
Dữ liệu có được gửi lên máy chủ không?
Plugin giữ chỉ mục và dữ liệu sử dụng trên máy, đồng thời README nêu không có telemetry. Tuy nhiên, các agent hoặc công cụ bên ngoài mà bạn gọi có thể có chính sách riêng; README không mô tả chi tiết từng công cụ.
context-mode hỗ trợ những agent nào?
README liệt kê Claude Code, Codex, Gemini CLI, Qwen Code, Pi, OpenCode, Copilot CLI, Kiro, VS Code và ZCode. Mỗi agent có lệnh cài và cách kiểm tra riêng.
Có cần API key riêng không?
README không nêu API key riêng cho context-mode. Các agent hoặc dịch vụ bạn sử dụng cùng plugin có thể có yêu cầu tài khoản riêng, nhưng tư liệu được cung cấp không nói cụ thể.
Vì sao mức tiết kiệm của mình khác benchmark?
Benchmark trong README dùng các mẫu cụ thể, mỗi dòng có dữ liệu đầu vào và cách chạy riêng. Đầu ra nhỏ, hoặc yêu cầu agent trả lại nhiều nội dung, có thể cho tỷ lệ tiết kiệm khác; hãy chạy skill thống kê trên phiên của bạn.


