Freebuff: trợ lý lập trình AI miễn phí ngay trong terminal — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
Freebuff là trợ lý lập trình AI dùng nhiều agent chuyên biệt, có bản CLI chạy trong terminal, bản Desktop, Web, Cloud và Chat. Bạn dùng miễn phí, không cần API key hay thuê bao, đổi lại có quảng cáo dạng chữ. Cài bản CLI chỉ cần một lệnh npm rồi gõ freebuff trong thư mục dự án.
Freebuff là một bộ năm sản phẩm AI miễn phí để viết code, dựng ứng dụng và nghiên cứu: bản Desktop, CLI (chạy trong terminal), Web, Cloud (chạy agent trên repo GitHub) và Chat. Tác giả mô tả ngắn gọn là “the free coding agent”. Bạn không cần đăng ký thuê bao, không cần mua credit, cũng không cần tự có API key để bắt đầu.
Bạn nên thử nếu mình là lập trình viên mới muốn có người “ngồi cạnh” đọc code và sửa giúp. Dân văn phòng hay chủ shop biết sơ về web cũng dùng được để dựng trang đơn giản hoặc hỏi đáp nghiên cứu. Cái hay nhất là bạn mở terminal trong thư mục dự án, gõ một lệnh, rồi mô tả bằng lời thứ mình muốn. Freebuff sẽ tự tìm file liên quan, sửa và chạy các bước kiểm tra.
Cái giá của sự miễn phí là có quảng cáo dạng chữ, và có giới hạn số giờ dùng mỗi ngày. Bài này mình đi qua cách cài bản CLI từng bước, cách dùng vào việc thật, và những điều cần biết về dữ liệu của bạn.
CodebuffAI/freebuff
Freebuff là bộ công cụ AI miễn phí để viết code, làm app và nghiên cứu, chạy trong terminal, desktop, web và GitHub; không cần API key hay thuê bao.
I.Freebuff làm được gì
Freebuff không đẩy mọi việc qua một mô hình và một câu lệnh duy nhất. Nó dùng nhiều agent chuyên biệt, mỗi agent lo một khâu. Nhờ vậy việc lớn được chia nhỏ và kiểm tra lại.
- Hiểu dự án trước khi sửa. Các agent chuyên tìm file sẽ lập bản đồ những phần liên quan trong dự án. Bạn đỡ phải tự chỉ từng file.
- Làm và rà soát. Agent có thể chia việc, sửa code, chạy lệnh rồi xem lại kết quả. Bạn nhận được thứ đã được thử, không chỉ là đoạn code gợi ý.
- Nghiên cứu và dùng trình duyệt. Agent có thể đọc tài liệu và thử ứng dụng trong một trình duyệt thật. Hữu ích khi bạn muốn biết trang mình làm có chạy đúng không.
- Chạy song song trên máy. Bản Desktop tách mỗi agent đang chạy cùng lúc vào một không gian làm việc riêng, nên chúng không đạp lên nhau.
- Môi trường trên đám mây. Bản Web và Cloud có sandbox, bản xem trước, terminal và quy trình triển khai. Bạn không cần cài gì trên máy.
- Nhiều mô hình để chọn. Có sẵn danh mục mô hình, ví dụ DeepSeek V4.1 Flash (mặc định ở nhiều mức truy cập), Solar Mini 4, Solar Pro 4 và vài mô hình thử nghiệm miễn phí không tốn giờ của bạn. Gói trả phí mở thêm mô hình như GPT-6 Luna hay Claude Haiku 5.5.
- Dùng cả agent bạn đã có. Bản Desktop chạy được Claude Code và Codex cài sẵn trên máy bằng tài khoản của bạn. Phần này tách riêng khỏi danh mục mô hình của Freebuff.
- Có app điện thoại. App iOS và Android cho bạn theo dõi và tiếp tục các cuộc trò chuyện, kể cả khi chúng đang chạy trên máy tính lúc Desktop đang mở.
II.Cần chuẩn bị gì
Với bản CLI, README chỉ nêu những thứ sau:
- Một máy có terminal và npm (lệnh cài đặt dùng
npm install -g). README không ghi phiên bản Node tối thiểu, nên mình không nói số cụ thể. - Một thư mục dự án để chạy Freebuff bên trong.
- Không cần thuê bao, credit hay API key theo README.
- Hệ điều hành: README nói bản Desktop có cho macOS, Windows và Linux. Repo có thêm file
WINDOWS.md, bạn dùng Windows thì nên mở đọc trước. - Phần cứng: README không nói gì về yêu cầu GPU hay cấu hình tối thiểu.
Nếu bạn chỉ muốn dùng, không cần Docker hay Bun. Hai thứ đó chỉ dành cho người muốn tham gia phát triển repo (xem phần cuối bài).
Freebuff dùng quảng cáo chữ để chi trả cho các mô hình. Trước khi bắt đầu, app sẽ hiện giới hạn của phiên và thông báo về việc dùng dữ liệu của từng mô hình. Bạn đọc kỹ phần này, đặc biệt nếu dự án chứa thông tin nhạy cảm của công ty.
III.Cài đặt từng bước
- Mở terminalDùng terminal có sẵn của máy hoặc của trình soạn code
- Cài FreebuffChạy lệnh npm để cài bản CLI cho toàn máy
- Vào thư mục dự ánDùng cd để đứng đúng thư mục bạn muốn làm việc
- Chạy freebuffGõ tên lệnh để mở trợ lý
- Mô tả việc cần làmGõ yêu cầu bằng lời, Freebuff tự xử lý
A.Mở terminal
Trên Windows, bạn có thể dùng PowerShell hoặc Terminal. Trên macOS và Linux, mở ứng dụng Terminal. Chỗ người mới hay vấp là gõ lệnh vào sai chỗ, ví dụ vào ô chat hay thanh địa chỉ trình duyệt. Lệnh phải gõ trong cửa sổ terminal, rồi nhấn Enter.
B.Cài Freebuff
Lệnh dưới đây cài Freebuff thành một lệnh dùng được ở mọi thư mục. Chữ -g nghĩa là cài toàn máy.
npm install -g freebuffNếu máy báo không tìm thấy npm, nghĩa là bạn chưa cài Node.js. README không hướng dẫn phần này, bạn tự cài Node.js từ trang chính thức rồi mở lại terminal.
C.Vào thư mục dự án
Lệnh cd đưa terminal vào thư mục dự án của bạn. Dòng dưới là ví dụ trong README, bạn thay ~/my-project bằng đường dẫn thật.
cd ~/my-projectFreebuff làm việc trong thư mục bạn đang đứng, nên bước này quan trọng. Đứng sai thư mục thì nó sẽ đọc nhầm dự án.
D.Chạy freebuff
freebuffLần đầu chạy, bạn làm theo màn hình hướng dẫn trong terminal. README không mô tả chi tiết các bước đó, nên mình không đoán trước nội dung.
E.Mô tả việc cần làm
Sau khi giao diện hiện lên, bạn gõ yêu cầu bằng tiếng thường. README nói Freebuff sẽ tìm file liên quan, thực hiện thay đổi và chạy các bước kiểm tra phù hợp với dự án của bạn.
F.Dùng bản Desktop, Web, Cloud hay Chat
Nếu không thích terminal, README chỉ đường vào trang freebuff.com. Bản Desktop tải trực tiếp cho macOS, Windows hoặc Linux. Các bản Web, Cloud, Chat dùng ngay trên trình duyệt qua các trang con /web, /cloud, /chat. Mình không có thêm hướng dẫn chi tiết cho các bản này ngoài những gì README nêu.
IV.Kiểm tra đã chạy được chưa
README không đưa ra một lệnh “kiểm tra phiên bản” riêng. Cách đơn giản để biết cài thành công là:
- Sau lệnh
npm install -g freebuff, terminal không báo lỗi đỏ. - Vào một thư mục dự án và gõ
freebuff. Nếu giao diện trợ lý mở ra, bạn đã cài xong. - Thử một yêu cầu nhẹ, chẳng hạn nhờ nó giải thích dự án làm gì. Nếu nó trả lời dựa trên file thật trong thư mục, mọi thứ đang chạy đúng.
Nếu gõ freebuff mà máy báo không nhận ra lệnh, xem phần lỗi thường gặp bên dưới.
V.Dùng vào việc thật
Những tình huống dưới đây bám theo khả năng README mô tả: tìm file, sửa code, chạy kiểm tra, nghiên cứu, thử ứng dụng. Câu lệnh mẫu chỉ là gợi ý cách bạn gõ yêu cầu, không phải cú pháp riêng của Freebuff.
A.Chủ shop muốn sửa trang bán hàng nhỏ
Chị Lan có một trang giới thiệu sản phẩm do người quen làm giúp. Giờ chị muốn đổi số điện thoại và thêm một mục giá. Chị mở terminal trong thư mục trang web, gõ freebuff, rồi viết:
Đổi số điện thoại ở đầu trang và chân trang thành 09xx xxx xxx, rồi thêm một mục bảng giá gồm 3 gói.Freebuff tìm các file có số điện thoại cũ, sửa và báo lại phần đã đổi. Chị không phải mở từng file để dò.
Bạn không cần biết file nào nằm ở đâu, chỉ cần nói rõ mình muốn trang trông và chạy thế nào.
Ông T
B.Lập trình viên mới đọc dự án lạ
Anh Minh vừa được giao một dự án có sẵn mà không ai hướng dẫn. Anh vào thư mục dự án, chạy freebuff và hỏi:
Dự án này làm gì? Liệt kê các thư mục chính và file nào là điểm bắt đầu.Các agent tìm file sẽ lập bản đồ phần liên quan rồi trả lời. Anh dùng kết quả để biết nên đọc file nào trước. Có thể hỏi tiếp từng chức năng nhỏ.
C.Dev sửa lỗi và chạy kiểm tra
Chị Hà thấy chức năng đăng nhập báo lỗi khi để trống mật khẩu. Chị mô tả lỗi và nhờ sửa:
Khi để trống mật khẩu, form đăng nhập báo lỗi khó hiểu. Hãy sửa để hiện thông báo rõ ràng, rồi chạy các kiểm tra của dự án.Freebuff sửa code, chạy lệnh kiểm tra phù hợp và cho chị xem kết quả. Chị vẫn nên đọc lại phần thay đổi trước khi dùng thật.
D.Nhân viên văn phòng cần tra cứu nhanh
Anh Tuấn không viết code, nhưng cần so sánh vài giải pháp trước khi báo cáo sếp. Anh dùng bản Chat tại freebuff.com/chat để nghiên cứu và đặt câu hỏi bằng tiếng thường. README mô tả Chat là nơi “research and think with AI”. Anh dùng nó như người trợ lý đọc tài liệu giúp, rồi tự kiểm tra lại các số liệu quan trọng trước khi dùng.
VI.Lỗi hay gặp và cách xử lý
A.Gõ freebuff báo không nhận ra lệnh
Thường do cài chưa xong, hoặc terminal đang mở từ trước khi cài. Đóng terminal, mở lại rồi thử lần nữa. Nếu vẫn lỗi, chạy lại npm install -g freebuff và đọc kỹ thông báo lỗi. Người dùng Windows nên xem file WINDOWS.md trong repo.
B.Lệnh npm báo lỗi quyền hoặc không tìm thấy npm
Không tìm thấy npm nghĩa là máy chưa có Node.js. Còn lỗi quyền khi cài toàn máy thì tùy hệ điều hành và cách bạn cài Node. Mình khuyên bạn đọc thông báo lỗi trước, không nên vội chạy mọi thứ với quyền quản trị cao nhất.
C.Gặp giới hạn giờ dùng
Freebuff tính hạn mức theo giờ. README nói phần miễn phí ở mức truy cập hạn chế là 5 giờ mỗi ngày, hoặc 4 giờ nếu dùng VPN hay proxy. Hết giờ thì bạn đợi hoặc đổi sang mô hình thử nghiệm miễn phí không tốn giờ. Bảng chọn mô hình trong app sẽ hiện mỗi giờ dùng tốn bao nhiêu giờ trong ví.
D.Không thấy mô hình mình muốn
Danh mục mô hình thay đổi theo vùng, mức truy cập và công suất hiện có. README cũng ghi vài mô hình đã bị gỡ. Mô hình nào chỉ dành cho gói trả phí thì bạn sẽ không dùng được ở mức miễn phí. Hãy xem bảng chọn trong app thay vì trông vào danh sách cũ.
E.Kết quả sửa code chưa đúng ý
Đây là chuyện thường với mọi trợ lý AI. Hãy yêu cầu rõ hơn, chia việc nhỏ ra, và luôn đọc lại phần thay đổi. Nếu dự án quan trọng, bạn nên dùng Git để lưu lại trước khi nhờ AI sửa, như vậy có thể quay lại dễ dàng.
VII.Có nên dùng không
Điểm mạnh. Cài nhanh bằng một lệnh, không cần API key, không thuê bao. Có nhiều cách dùng (terminal, desktop, web, cloud, chat, điện thoại) nên bạn chọn được kiểu hợp với mình. Mã nguồn mở theo giấy phép Apache-2.0, và repo hiện có khoảng 14.140 sao, 1.517 fork, vẫn được cập nhật trong vài tháng gần đây.
Giới hạn. Bạn dùng miễn phí thì có quảng cáo chữ và giới hạn số giờ mỗi ngày. Vùng được hỗ trợ có truy cập đầy đủ, còn vùng khác và người dùng VPN chỉ có truy cập hạn chế với một số mô hình. Mô hình mạnh nhất nằm ở gói trả phí.
Về dữ liệu, bạn cần đọc kỹ. Theo README, Freebuff dùng tin nhắn, dấu vết agent và file của bạn để chạy dịch vụ, và có thể phân tích chúng để cá nhân hóa quảng cáo. Họ nói không đưa file tải riêng, file dự án hay repo đã kết nối cho bên quảng cáo. Với một số mô hình hay tính năng, dữ liệu có thể được dùng để huấn luyện AI, và app sẽ báo trước. Vì vậy, nếu dự án chứa bí mật kinh doanh hay dữ liệu khách hàng, hãy đọc Chính sách quyền riêng tư trước, hoặc chọn cách khác phù hợp hơn.
Khi nào chọn cách khác. Nếu công ty yêu cầu dữ liệu tuyệt đối không rời máy, bạn nên dùng công cụ chạy hoàn toàn nội bộ. Nếu bạn đã có thuê bao của một trợ lý lập trình khác và hài lòng, chưa cần đổi. Còn nếu chỉ muốn thử AI viết code mà không tốn tiền, Freebuff là điểm bắt đầu dễ.
A.Muốn đóng góp hoặc chạy bản phát triển
Repo là một monorepo TypeScript xây trên Bun. README ghi chạy môi trường phát triển cần Docker và một file .env.local đã cấu hình, bạn xem Contributing Guide trong repo trước khi khởi động các dịch vụ. Các lệnh trong README:
git clone https://github.com/CodebuffAI/freebuff.git
cd freebuff
bun install
bun upChạy CLI riêng bằng:
bun start-cliPhần này dành cho người muốn sửa chính Freebuff. Nếu bạn chỉ muốn dùng, các bước cài ở trên là đủ. Freebuff xây trên Codebuff, một framework đa agent mã nguồn mở. Bạn muốn tạo agent riêng thì xem tài liệu của Codebuff.
Câu hỏi thường gặp
Freebuff có miễn phí thật không?
Theo README, bạn không cần thuê bao, credit hay API key để dùng. Quảng cáo dạng chữ chi trả cho các mô hình đi kèm. Có giới hạn số giờ dùng mỗi ngày, và gói trả phí mở thêm giờ và mô hình.
Cài Freebuff CLI bằng lệnh nào?
Chạy npm install -g freebuff, vào thư mục dự án bằng cd rồi gõ freebuff. README không nêu yêu cầu phiên bản Node cụ thể.
Freebuff có chạy được trên Windows không?
README nói bản Desktop có cho macOS, Windows và Linux. Repo cũng có file WINDOWS.md. Với bản CLI, README không nói riêng về Windows ngoài lệnh npm chung.
Tôi có cần GPU hay máy mạnh không?
README không nêu yêu cầu phần cứng. Các mô hình trong danh mục được phục vụ qua dịch vụ của Freebuff, không thấy yêu cầu chạy mô hình trên máy bạn.
Dữ liệu và code của tôi có an toàn không?
Freebuff dùng tin nhắn, dấu vết agent và file của bạn để chạy dịch vụ, và có thể phân tích để cá nhân hóa quảng cáo. Họ nói không đưa file dự án hay repo đã kết nối cho bên quảng cáo. Một số mô hình có thể dùng dữ liệu để huấn luyện AI và sẽ báo trước, nên bạn cần đọc Chính sách quyền riêng tư.
Giới hạn dùng miễn phí là bao nhiêu?
README ghi hạn mức miễn phí ở truy cập hạn chế là 5 giờ mỗi ngày, hoặc 4 giờ nếu dùng VPN hay proxy. Mô hình khác nhau tốn số giờ khác nhau, còn các mô hình thử nghiệm miễn phí thì không tốn giờ.
Freebuff có dùng được tiếng Việt không?
README không có thông tin về hỗ trợ tiếng Việt. Bạn nên tự thử với yêu cầu ngắn bằng tiếng Việt để biết kết quả với mô hình mình chọn.


