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

> Freebuff là một agent lập trình AI miễn phí, chạy trong terminal (CLI) và cả bản Desktop, Web, Cloud, Chat. Bạn mô tả việc cần làm, nó tìm file liên quan, sửa code và chạy kiểm tra. Cài CLI chỉ cần một lệnh npm, nhưng miễn phí có giới hạn theo giờ mỗi ngày và có quảng cáo dạng chữ.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-19 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/freebuff-tro-ly-lap-trinh-ai-mien-phi-huong-dan-cai-dat

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 dùng được ngay trong terminal, trên máy tính (Desktop), trên trình duyệt (Web), trên kho GitHub (Cloud) hoặc khung chat. Theo README, bạn không cần thuê bao, không cần mua credit và không cần API key.

Nếu bạn là lập trình viên mới, hoặc làm văn phòng và muốn nhờ AI sửa một dự án nhỏ, Freebuff rất đáng thử. Bạn không phải đi xin API key hay gắn thẻ thanh toán. Bạn gõ yêu cầu bằng tiếng thường, agent sẽ tìm file liên quan, sửa và chạy các bước kiểm tra phù hợp với dự án.

Điểm đáng giá nhất là chuyện miễn phí: phần chi phí được bù bằng quảng cáo dạng chữ. Đổi lại sẽ có giới hạn số giờ dùng mỗi ngày và có những lưu ý về dữ liệu mà bạn nên đọc trước khi dùng. Repo hiện có khoảng 14.140 sao và 1.517 fork, giấy phép Apache-2.0.

```repo
- repo | CodebuffAI/freebuff
- kind | CLI
- desc | Freebuff là bộ công cụ AI viết code miễn phí: chạy trong terminal, desktop, web hoặc GitHub, không cần đăng ký gói hay API key.
- stars | 14k
- lang | TypeScript
- license | Apache-2.0
```

## 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.

- **Hiểu dự án trước khi sửa.** Các agent tìm file sẽ khoanh vù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 thay đổi đã qua một lượt kiểm tra, thay vì một đoạn code chưa ai chạy thử.
- **Nghiên cứu và thử trên trình duyệt thật.** Agent có thể tra tài liệu và kiểm thử ứng dụng trong một trình duyệt thật.
- **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 lưu trữ sẵn.** Web và Cloud cung cấp sandbox, bản xem trước, terminal và quy trình triển khai.

Năm sản phẩm gồm:

- **Freebuff Desktop**: chạy nhiều agent song song trên máy (macOS, Windows, Linux).
- **Freebuff CLI**: viết code từ terminal. Đây là phần bài này hướng dẫn.
- **Freebuff Web**: dựng và đưa ứng dụng full-stack lên mạng.
- **Freebuff Cloud**: chạy agent trên bất kỳ kho GitHub nào.
- **Freebuff Chat**: nghiên cứu và suy nghĩ cùng AI.

Có thêm ứng dụng iOS và Android để theo dõi và nhắn tiếp các cuộc chat từ điện thoại, kể cả chat đang chạy trên máy tính khi Freebuff Desktop đang mở.

Về mô hình, Freebuff có sẵn một danh mục chọn lọc. Có DeepSeek V4.1 Flash (với các bản Slow và Fast), Solar Mini 4, Solar Pro 4 và ba mô hình thử nghiệm miễn phí là Beam 1.0, Glyph Cluster, Nemotron 3.5 Lightning. Các mô hình mạnh hơn như GPT-6 Luna, Muse Spark 1.3, Muse Ember, Claude Haiku 5.5 và GPT-6.1 Terra phụ thuộc vào gói và mức truy cập. README lưu ý danh mục thay đổi khá thường xuyên, nên bạn hãy xem bảng chọn mô hình trong ứng dụng để biết cái nào đang có.

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

Với bản CLI, README chỉ nói một việc: chạy lệnh `npm install -g freebuff`. Vì vậy máy bạn cần có sẵn `npm`. README chưa ghi phiên bản Node tối thiểu, hệ điều hành cụ thể cho CLI hay yêu cầu phần cứng.

- Một dự án (thư mục code) để Freebuff làm việc trong đó.
- Kết nối Internet.
- Không cần tài khoản trả phí, không cần API key để bắt đầu, theo README.

Bản Desktop có bản tải cho macOS, Windows và Linux ở trang freebuff.com. Repo cũng có file `WINDOWS.md`; nếu bạn dùng Windows và gặp vướng mắc, hãy mở file này trong repo.

Nếu bạn muốn chạy từ mã nguồn để phát triển (không bắt buộc với người dùng thường), README nói cần Docker, một file `.env.local` đã cấu hình, và dự án dùng Bun.

```note
Freebuff miễn phí nhưng có quảng cáo dạng chữ và giới hạn số giờ mỗi ngày. Trước khi bắt đầu, app sẽ hiển thị giới hạn phiên và thông báo về việc dùng dữ liệu của từng mô hình. Hãy đọc kỹ, đừng đưa vào các đoạn code hay dữ liệu bí mật của công ty nếu bạn chưa yên tâm về chính sách dữ liệu.
```

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

```steps
- Mở terminal | Mở terminal trên máy bạn, nơi gõ được lệnh npm
- Cài Freebuff | Chạy lệnh cài toàn cục bằng npm
- Vào thư mục dự án | Dùng lệnh cd đến dự án muốn làm việc
- Chạy freebuff | Gõ freebuff rồi mô tả việc cần làm
```

### Mở terminal và cài Freebuff

Terminal là cửa sổ để gõ lệnh: trên Windows bạn có thể dùng PowerShell, trên macOS và Linux là Terminal. Lệnh dưới đây cài Freebuff vào máy để dùng ở bất kỳ thư mục nào (cờ `-g` nghĩa là cài toàn cục).

```bash
npm install -g freebuff
```

Người mới hay vấp ở đây: nếu máy báo không tìm thấy `npm`, nghĩa là bạn chưa cài Node.js. Hãy cài Node.js trước rồi chạy lại lệnh trên.

### Vào thư mục dự án

Freebuff làm việc trên thư mục bạn đang đứng. Vì vậy bạn cần `cd` vào đúng dự án trước khi chạy. Dưới đây là ví dụ theo README; hãy thay `~/my-project` bằng đường dẫn dự án của bạn.

```bash
cd ~/my-project
```

### Chạy Freebuff

Gõ tên lệnh để mở giao diện. Sau đó bạn mô tả bằng lời thường việc muốn làm.

```bash
freebuff
```

Theo README, Freebuff sẽ tìm các file liên quan, thực hiện thay đổi và chạy những bước kiểm tra quan trọng cho dự án của bạn.

### Cách khác: dùng bản Desktop hoặc chạy từ mã nguồn

Nếu bạn không thích terminal, hãy tải bản Desktop ở trang freebuff.com. Còn nếu bạn muốn tham gia phát triển chính Freebuff, README đưa các lệnh sau. Cách này cần Docker và file `.env.local`, nên bạn hãy đọc `CONTRIBUTING.md` trong repo trước.

```bash
git clone https://github.com/CodebuffAI/freebuff.git
cd freebuff
bun install
bun up
```

Còn muốn mở CLI từ mã nguồn thì chạy riêng:

```bash
bun start-cli
```

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

README không mô tả chi tiết màn hình thành công, nên cách kiểm tra đơn giản nhất là:

1. Chạy `freebuff` trong một thư mục dự án. Nếu giao diện mở ra và cho bạn nhập yêu cầu, tức là cài đặt đã ổn.
2. Thử một yêu cầu nhỏ, ví dụ nhờ nó giải thích dự án làm gì. Khi nó đọc file và trả lời, bạn biết agent đã chạy được.
3. Xem bảng chọn mô hình trong ứng dụng. Ở đó hiển thị mô hình bạn đang dùng và mỗi giờ dùng tốn bao nhiêu giờ trong quỹ của bạn.

Trước khi bạn bắt đầu, app cũng hiển thị giới hạn phiên và thông báo dùng dữ liệu của từng mô hình, theo README.

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

Các tình huống dưới đây bám vào những gì README mô tả: tìm file liên quan, sửa, chạy kiểm tra, nghiên cứu. Câu lệnh mẫu chỉ là cách bạn diễn đạt yêu cầu, không phải cú pháp bắt buộc.

### Chủ shop nhờ hiểu một dự án web có sẵn

Bạn thuê người làm website bán hàng, giờ muốn biết trong đó có gì mà không biết code. Hãy `cd` vào thư mục dự án, chạy `freebuff` rồi nhập yêu cầu.

```text
Hãy giải thích dự án này gồm những phần nào và file nào lo việc hiển thị giỏ hàng.
```

Vì Freebuff có agent tìm file để khoanh vùng trước khi làm, bạn sẽ nhận được phần giải thích bám vào chính dự án của mình. Bạn nắm được cấu trúc trước khi trao đổi với người làm web.

### Dev mới nhờ sửa lỗi nhỏ

Bạn vừa nhận một dự án và gặp một lỗi hiển thị. Thay vì tự lần từng file, hãy mô tả lỗi.

```text
Nút Thanh toán không bấm được trên trang giỏ hàng. Hãy tìm nguyên nhân, sửa và chạy kiểm tra.
```

Theo README, agent sẽ tìm file liên quan, sửa và chạy các bước kiểm tra phù hợp. Bạn nhận về các thay đổi để xem lại. Hãy đọc kỹ thay đổi trước khi dùng vào sản phẩm thật.

> Công cụ miễn phí chỉ đáng giá khi bạn vẫn là người đọc lại những gì nó sửa.
>
> — Ông T

### Nhân viên văn phòng muốn tra cứu và thử ứng dụng

README nói agent có thể tra tài liệu và kiểm thử ứng dụng trong trình duyệt thật. Bạn có thể nhờ như sau.

```text
Tra tài liệu cách thêm trang liên hệ cho dự án này, rồi thử mở trang đó trên trình duyệt xem có lỗi không.
```

Kết quả bạn nhận được là câu trả lời có nghiên cứu kèm bước kiểm thử, đỡ phải tự mở từng trang tài liệu. Còn nếu chỉ muốn hỏi đáp, nghiên cứu mà không đụng đến code, hãy dùng Freebuff Chat.

### Đội nhóm chạy agent trên kho GitHub

Nếu bạn quản lý nhiều kho code, Freebuff Cloud cho phép chạy agent trên bất kỳ kho GitHub nào. Bạn kết nối kho ở trang freebuff.com/cloud. Theo README, một số đối tác bị hạn chế có thể đánh giá kho bạn kết nối vào Freebuff Cloud, nhưng không được dùng rộng rãi hay huấn luyện trên đó. Với kho riêng tư của công ty, bạn nên đọc Chính sách quyền riêng tư trước khi kết nối.

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

### Báo không tìm thấy lệnh npm

Nguyên nhân thường là máy chưa cài Node.js. Hãy cài Node.js (đã kèm npm), mở lại terminal rồi chạy lại `npm install -g freebuff`.

### Gõ freebuff nhưng máy báo không nhận ra lệnh

Sau khi cài toàn cục, hãy đóng terminal rồi mở lại, vì đôi khi terminal cũ chưa nạp lại đường dẫn. Nếu vẫn lỗi, bạn xem lại xem lệnh cài có báo lỗi quyền hay không. README chưa ghi cách xử lý riêng cho trường hợp này; với Windows, hãy xem `WINDOWS.md` trong repo.

### Hết giờ dùng hoặc bị giới hạn mô hình

Bản miễn phí tính theo giờ mỗi ngày. Theo README, mức miễn phí giới hạn là 5 giờ mỗi ngày, hoặc 4 giờ nếu dùng VPN/proxy. Nếu bạn dùng VPN hoặc ở vùng chưa được hỗ trợ đầy đủ, bạn chỉ có quyền truy cập giới hạn vào một số mô hình. Cách xử lý: chọn các mô hình thử nghiệm miễn phí (không tốn giờ nào), hoặc chờ sang ngày hôm sau.

### Mô hình bạn muốn không có trong bảng chọn

Một số mô hình chỉ có ở gói trả phí hoặc theo mức truy cập, và README cho biết một số mô hình đã bị gỡ khỏi danh mục. Hãy xem bảng chọn trong ứng dụng để biết mô hình nào đang dùng được với tài khoản của bạn.

### Chạy từ mã nguồn bị lỗi khi bun up

Cách chạy từ mã nguồn cần Docker và file `.env.local` được cấu hình đúng. Nếu thiếu một trong hai, các dịch vụ sẽ không lên. Hãy đọc `CONTRIBUTING.md` và các tài liệu trong thư mục `docs/` trước khi chạy. Nếu bạn chỉ muốn dùng, hãy quay lại cách cài bằng npm cho gọn.

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

**Điểm mạnh.** Cài chỉ một lệnh, không cần API key hay thẻ thanh toán, nhiều mô hình để chọn, và có đủ năm hình thức dùng (terminal, desktop, web, cloud, chat) cùng ứng dụng điện thoại. Mã nguồn dùng giấy phép Apache-2.0, và dự án vẫn được cập nhật trong vài tháng gần đây.

**Giới hạn.** Miễn phí có điều kiện: có quảng cáo dạng chữ, có hạn mức giờ mỗi ngày và phần quyền lợi phụ thuộc vùng, mức truy cập. Vấn đề dữ liệu cũng cần cân nhắc. README nói dữ liệu chỉ dùng để huấn luyện AI khi một mô hình hoặc tính năng ghi rõ điều đó. Khi ấy Freebuff hoặc nhà cung cấp có thể giữ lại nội dung bạn gửi và có thể chia sẻ hoặc bán cho bên thứ ba. Ngoài ra, dữ liệu sử dụng có thể được dùng để huấn luyện các mô hình chọn và đo quảng cáo.

**Khi nào nên chọn cách khác.** Nếu bạn làm việc với code nội bộ nhạy cảm, hãy đọc kỹ Chính sách quyền riêng tư và thông báo của từng mô hình trước khi dùng, hoặc cân nhắc giải pháp khác mà bạn kiểm soát dữ liệu chặt hơn. Còn nếu bạn muốn tự tạo agent riêng hoặc nhúng agent vào ứng dụng của mình, README chỉ sang Codebuff, framework mà Freebuff được xây dựng trên đó, cùng gói `@codebuff/sdk`.

Nói gọn: nếu bạn muốn thử một trợ lý lập trình miễn phí mà không phải cấu hình nhiều, Freebuff là lựa chọn dễ bắt đầu. Hãy bắt đầu với một dự án nhỏ, không chứa thông tin nhạy cảm.

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

### Freebuff có thật sự miễn phí không?

README nói bạn không cần thuê bao, credit hay API key. Chi phí được bù bằng quảng cáo dạng chữ. Có hạn mức giờ dùng mỗi ngày, và gói trả phí mở thêm một số mô hình.

### Cài Freebuff CLI bằng lệnh nào?

Chạy `npm install -g freebuff`, sau đó `cd` vào thư mục dự án và gõ `freebuff`. README chưa ghi rõ phiên bản Node tối thiểu.

### Freebuff có chạy được trên Windows không?

Bản Desktop có bản tải cho macOS, Windows và Linux. Repo còn có file WINDOWS.md. README chưa nói rõ chi tiết hệ điều hành cho riêng bản CLI.

### Có cần GPU hay máy mạnh không?

Tư liệu không nêu yêu cầu phần cứng cho người dùng thông thường. Các mô hình do dịch vụ cung cấp. Riêng bản Desktop có thể chạy thêm agent Claude Code và Codex đã cài trên máy bằng tài khoản của 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 để vận hành dịch vụ và phân tích để cá nhân hóa quảng cáo. Dữ liệu chỉ dùng để huấn luyện AI khi một mô hình hoặc tính năng ghi rõ, và khi đó có thể bị chia sẻ với bên thứ ba. Bạn nên đọc Chính sách quyền riêng tư trước khi đưa code nhạy cảm vào.

### Giới hạn dùng miễn phí là bao nhiêu?

Mức miễn phí giới hạn là 5 giờ mỗi ngày, hoặc 4 giờ nếu dùng VPN hoặc proxy. Mỗi mô hình tốn số giờ khác nhau, còn các mô hình thử nghiệm miễn phí (Beam 1.0, Glyph Cluster, Nemotron 3.5 Lightning) không tốn giờ nào.

### Freebuff có liên quan gì đến Codebuff?

Freebuff được xây dựng trên Codebuff, một framework nhiều agent mã nguồn mở lo phần điều phối, công cụ và SDK. Nếu muốn tạo agent riêng hoặc nhúng vào ứng dụng, README chỉ sang tài liệu Codebuff và gói @codebuff/sdk.
