Caveman

1. Caveman là gì?

Caveman là một bộ quy tắc khiến trợ lý AI lập trình của bạn trả lời thật ngắn, kiểu "người tiền sử": bỏ lời chào, bỏ câu dẫn dắt, chỉ giữ lại ý chính. Các dịch vụ AI tính tiền theo "token" (đơn vị gần bằng ba phần tư một từ) cho cả phần AI đọc lẫn phần AI viết, nên viết ít đi thì tốn ít hơn và đọc kết quả cũng nhanh hơn.

Nói thẳng: đây là công cụ cho người đang dùng trợ lý AI lập trình như Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Cline hay Copilot. Nó không phải ứng dụng riêng, và không dùng được với ChatGPT trên web.

Caveman có hai phần:

• Skill (phần nhỏ): một file quy tắc làm AI nói ngắn lại. Miễn phí, giấy phép MIT, không cần tài khoản hay khóa API, chạy được với hơn 30 trợ lý.
• Proxy (phần lớn, tùy chọn): một chương trình chạy trên máy bạn, đứng giữa trợ lý và nhà cung cấp AI, rút gọn những thứ AI phải đọc (log, kết quả kiểm thử, JSON, diff). Bản gốc luôn được lưu trên máy để AI lấy lại khi cần. Phần lõi của proxy dùng giấy phép BSL-1.1: xem được mã nguồn và tự chạy miễn phí cho việc của mình.

Caveman không rút gọn code, lệnh, đường dẫn file hay thông báo lỗi. Cảnh báo bảo mật và các câu hỏi xác nhận vẫn được viết đầy đủ.

Hợp với bạn nếu:

• Bạn đọc câu trả lời của AI nhiều và thấy nó dài dòng.
• Bạn trả tiền theo token, hoặc hay chạm giới hạn sử dụng.
• Phiên làm việc của bạn dài, nhiều log và kết quả kiểm thử (khi đó proxy mới đáng cài).

Chưa hợp nếu:

• Bạn bị tính tiền theo số lượt yêu cầu chứ không theo token (ví dụ gói premium request của GitHub Copilot): trả lời ngắn hơn vẫn là một lượt.
• Công việc của bạn gần như chỉ là sinh code, ít văn xuôi để cắt.
• Bạn chỉ hỏi những câu rất ngắn. Bộ quy tắc tự nó chiếm khoảng 1.000 token mỗi lần gọi, có lúc tốn hơn phần tiết kiệm được.

2. Cần chuẩn bị gì?

• Một trợ lý AI lập trình đã cài sẵn trên máy. Caveman bọc ngoài trợ lý bạn đang dùng chứ không thay thế nó.
• Node.js: phần mềm nền để chạy các công cụ viết bằng JavaScript; cài xong bạn có lệnh npx và npm. Trình cài đặt đầy đủ của Caveman yêu cầu Node.js 22.13 trở lên. Tải miễn phí ở https://nodejs.org
• Windows: PowerShell 5.1 trở lên (có sẵn trên Windows 10 và 11) nếu dùng trình cài đặt đầy đủ.
• Không cần tài khoản, không cần khóa API, không mất tiền cho phần skill.

Phiên bản mới nhất lúc viết bài là v2.7.0, phát hành ngày 15/9/2026.

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

Caveman không có file cài .exe hay bản trên cửa hàng ứng dụng; mọi cách cài đều qua dòng lệnh. Hãy bắt đầu từ phần nhỏ (Bước 1 đến 3). Các bước sau là tùy chọn.

Bước 1: Kiểm tra Node.js

node --version

Thấy gì là đúng: một số phiên bản bắt đầu bằng v. Nếu máy báo không tìm thấy lệnh, cài Node.js từ https://nodejs.org rồi mở lại cửa sổ dòng lệnh.

Bước 2: Cài skill bằng một lệnh

npx skills add JuliusBrussee/caveman -g

Phần -g nghĩa là cài vào thư mục kỹ năng chung của người dùng, áp dụng cho mọi dự án. Bỏ -g thì skill chỉ thuộc về dự án đang mở. Lần đầu chạy, npx có thể hỏi bạn có đồng ý tải công cụ skills không; trả lời đồng ý rồi làm theo các câu hỏi trên màn hình.

Thấy gì là đúng: trình cài đặt báo đã thêm skill cho trợ lý mà nó tìm thấy trên máy.

Bước 3: Bật Caveman trong trợ lý

Mở trợ lý AI của bạn. Nếu nó chưa tự nói ngắn lại, gõ:

/caveman

Thấy gì là đúng: trợ lý xác nhận bằng một câu rất ngắn, và từ đó các câu trả lời không còn lời dẫn.

Bước 4 (tùy chọn): Trình cài đặt đầy đủ

Trình này tự tìm mọi trợ lý được hỗ trợ trên máy, cài cho từng cái theo cách riêng của nó, và với Claude Code thì gắn thêm "hook" (đoạn mã tự chạy khi mở phiên) cùng nhãn trạng thái. Chạy lại nhiều lần vẫn an toàn. Cần Node.js 22.13 trở lên.

Windows (PowerShell):

irm https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.7.0/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.7.0/install.sh | bash

Lưu ý: Hai lệnh trên tải một đoạn mã về và chạy ngay. Nếu muốn biết trước nó sẽ làm gì, trên macOS/Linux bạn chạy thử ở chế độ xem trước, không ghi gì vào máy:

curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.7.0/install.sh | bash -s -- --dry-run

Nếu chỉ dùng Claude Code, bạn có thể cài riêng cho nó bằng hai lệnh:

claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman

Thấy gì là đúng với Claude Code: gõ /caveman thì trợ lý trả lời cụt lủn, và dòng trạng thái ở cuối màn hình hiện chữ [CAVEMAN].

Bước 5 (tùy chọn): Cài proxy để AI đọc ít đi

Chỉ nên làm bước này khi bạn đã quen với skill và có các phiên làm việc dài. Chạy lần lượt hai lệnh:

npm install -g @caveman-ai/cli
caveman setup --install

Sau đó mở trợ lý qua Caveman. Ví dụ với Claude Code:

caveman claude

Các tên khác được hỗ trợ: codex, gemini, aider, kilo, qwen, opencode, hermes, openclaw, pi.

Thấy gì là đúng: trợ lý mở ra như thường lệ. Từ lúc này, log, kết quả kiểm thử, JSON và diff được rút gọn trước khi gửi tới nhà cung cấp AI. Đăng nhập của bạn với nhà cung cấp được chuyển qua nguyên vẹn.

4. Dùng lần đầu

Hỏi trợ lý một câu lập trình bất kỳ, ví dụ vì sao một thành phần giao diện bị vẽ lại liên tục. Trước đây bạn nhận một đoạn giải thích dài vài câu. Với Caveman, câu trả lời chỉ còn nguyên nhân và cách sửa trong một hai dòng, tên hàm và đoạn code giữ nguyên.

Những lệnh nên thử ngay trong trợ lý:

Gõ	Kết quả
/caveman lite	Ngắn gọn nhưng vẫn là câu đầy đủ, lịch sự
/caveman ultra	Cực ngắn, gần như chỉ còn từ khóa
/caveman-commit	Viết thông điệp commit (ghi chú lưu thay đổi code) trong một dòng
/caveman-review	Nhận xét code, mỗi phát hiện một dòng
/caveman-compress CLAUDE.md	Rút gọn file ghi nhớ của trợ lý, giữ nguyên tiêu đề, đường dẫn, lệnh; bản gốc được sao lưu
/caveman-help	Bảng nhắc toàn bộ chế độ và lệnh
stop caveman	Tắt, trợ lý viết bình thường trở lại

Nếu bạn đã cài proxy (Bước 5), việc đáng làm đầu tiên là xem token của mình đang đi đâu:

caveman learn

Lệnh này đọc lịch sử làm việc của trợ lý đang có sẵn trên máy bạn (chỉ đọc, ngay trên máy) rồi xếp hạng những chỗ tốn token nhất kèm gợi ý sửa. Xem lịch sử và ước tính mức dùng bằng:

caveman stats

Về mức tiết kiệm, tác giả công bố cả số tốt lẫn số xấu. Một thử nghiệm độc lập của JetBrains trên 86 tác vụ lập trình thật, chỉ dùng skill, cho thấy giảm 8,5% token đầu ra và chất lượng không đổi. Với proxy, bộ đo của chính repo giảm 33,2% token đầu vào, trong đó có một trường hợp tăng 9,9%. Con số của bạn sẽ khác; tác giả khuyên tự đo trên công việc của mình.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Gõ npx hoặc npm thì máy báo không tìm thấy lệnh	Chưa cài Node.js hoặc chưa mở lại cửa sổ dòng lệnh	Cài Node.js từ https://nodejs.org , mở lại Terminal
Trình cài đặt đầy đủ báo lỗi về Node.js	Node.js cũ hơn 22.13	Nâng cấp Node.js rồi chạy lại. Trình cài đặt không tự cài Node.js giúp bạn
Cài xong nhưng trợ lý vẫn trả lời dài	Phiên đang mở chưa nạp skill; ở nhiều trợ lý, skill chỉ bật theo từng phiên	Gõ /caveman. Với Claude Code, khởi động lại vì hook chỉ chạy lúc bắt đầu phiên
Cửa sổ này nói kiểu Caveman, cửa sổ kia thì không	Đúng thiết kế: chế độ được lưu riêng cho từng cửa sổ	Gõ /caveman ở cửa sổ bạn muốn bật
Trên Windows, lệnh cài ở Bước 4 bị chặn vì chính sách chạy script	PowerShell hạn chế chạy script	Chạy Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass trong chính cửa sổ đó rồi chạy lại lệnh cài. Thiết lập này chỉ có hiệu lực cho cửa sổ đang mở
Trên Windows, hook không chạy	Dùng install.sh thay vì install.ps1, hoặc PowerShell quá cũ	Dùng install.ps1. Kiểm tra phiên bản bằng $PSVersionTable.PSVersion (cần 5.1 trở lên)
claude plugin update caveman báo không tìm thấy plugin	Tên đầy đủ của plugin gồm cả tên kho	Dùng claude plugin update caveman@caveman
File settings.json của Claude Code bị hỏng sau khi cài	Lỗi khi gộp cấu hình	Trình cài đặt luôn tạo bản sao lưu settings.json.bak cùng thư mục trước khi sửa; khôi phục từ đó
caveman trial báo không đo được	Phép thử cần proxy riêng trong khi trợ lý đang được bọc	Chạy caveman disable claude, thử lại, xong thì caveman enable claude

Nếu cài đặt hỏng mà không rõ lý do, tác giả gợi ý mở chính trợ lý AI của bạn trong thư mục repo Caveman và nhờ nó đọc hai file CLAUDE.md và INSTALL.md rồi cài giúp. Vẫn không được thì báo lỗi ở https://github.com/JuliusBrussee/caveman/issues

6. Gỡ cài đặt / cập nhật

Cập nhật

• Skill cài bằng npx skills add: chạy lại đúng lệnh ở Bước 2, nó ghi đè bản cũ.
• Plugin Claude Code: claude plugin update caveman@caveman, rồi khởi động lại Claude Code.
• Những thứ do trình cài đặt đầy đủ tạo ra: chạy lại trình cài đặt.

npx -y github:JuliusBrussee/caveman

Gỡ cài đặt

Thứ tự quan trọng nếu bạn đã cài proxy: chạy lệnh gỡ của Caveman trước, rồi mới gỡ CLI. Lệnh gỡ cần CLI còn trên máy để trả các trợ lý về cấu hình cũ.

npx -y github:JuliusBrussee/caveman -- --uninstall

Sau đó mới gỡ CLI:

npm uninstall -g @caveman-ai/cli

Lệnh gỡ ở trên không xóa skill đã cài bằng npx skills add. Gỡ skill bằng:

npx skills remove caveman

Hai thứ còn lại phải xóa tay nếu muốn sạch hẳn: các file quy tắc mà trình cài đặt đã chép vào từng dự án (nếu bạn dùng tùy chọn --with-init), và file lịch sử thống kê .caveman-history.jsonl trong thư mục cấu hình của Claude Code.

7. Câu hỏi hay gặp

Có mất tiền không? Skill miễn phí (MIT). CLI cũng theo giấy phép MIT, còn phần lõi proxy theo BSL-1.1: tự chạy cho việc của chính bạn thì miễn phí, cung cấp làm dịch vụ cho bên thứ ba mới cần giấy phép thương mại. Bạn vẫn trả tiền cho nhà cung cấp AI như bình thường.

Có cần mạng không? Cần mạng lúc cài. Skill và hook chạy hoàn toàn trên máy bạn. Trợ lý AI thì vẫn cần mạng để gọi mô hình.

Dữ liệu của tôi có bị gửi đi đâu không? Trợ lý của bạn vẫn nói chuyện với đúng nhà cung cấp bạn đã chọn. Skill và hook không gửi gì ra ngoài. Riêng CLI caveman, README cho biết nó gửi thống kê ẩn danh theo mặc định (lệnh nào được chạy, số token đi qua và số token cắt được), không bao gồm prompt, code hay đường dẫn file. Tắt bằng:

caveman telemetry off

Hoặc đặt biến môi trường DO_NOT_TRACK=1. Ranh giới chính xác được ghi trong file SECURITY.md của repo.

AI có kém thông minh đi không? Caveman chỉ thay đổi cách AI diễn đạt. Code, lệnh, đường dẫn và thông báo lỗi giữ nguyên. Thử nghiệm của JetBrains không tìm thấy khác biệt đo được về chất lượng.

Máy yếu có dùng được không? Skill chỉ là một file văn bản, không tốn tài nguyên máy. Proxy là một chương trình chạy nền trên máy; nếu thấy không cần, bạn bỏ qua Bước 5.