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

> Freebuff là bộ năm sản phẩm AI dành cho lập trình, xây dựng ứng dụng và nghiên cứu, gồm Desktop, CLI, Web, Cloud và Chat. Bản CLI cài từ terminal khá đơn giản; README không yêu cầu API key hay gói thuê bao, nhưng giới hạn truy cập và số giờ phụ thuộc sản phẩm, khu vực và model.

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

Freebuff là một bộ trợ lý AI miễn phí cho lập trình, xây dựng ứng dụng và nghiên cứu. Bạn có thể dùng nó trong terminal, trên máy tính, trình duyệt hoặc với repository GitHub. Repo được viết chủ yếu bằng TypeScript và là một monorepo dùng Bun.

Điểm đáng giá nhất là bạn không cần tự mua API key để bắt đầu. Freebuff cung cấp nhiều agent chuyên biệt và một danh mục model có sẵn. Agent có thể tìm file liên quan, lập kế hoạch, sửa code, chạy kiểm tra và xem lại kết quả. Người mới có thể bắt đầu bằng CLI; đội nhóm hoặc người cần chạy nhiều tác vụ song song có thể xem thêm Desktop, Web và Cloud.

Repo hiện có khoảng 14.146 sao và 1.518 fork. Dự án dùng giấy phép Apache-2.0 và vẫn còn được cập nhật. Tuy nhiên, “miễn phí” ở đây đi kèm hạn mức giờ, quyền truy cập theo khu vực, model và công suất hiện tại. Bạn nên kiểm tra thông tin hiển thị trong ứng dụng trước khi chạy tác vụ dài.

```repo
- repo | CodebuffAI/freebuff
- kind | Agent
- desc | Freebuff là bộ công cụ AI miễn phí giúp lập trình, nghiên cứu và xây dựng ứng dụng trên terminal, máy tính, web và GitHub.
- stars | 14k
- lang | TypeScript
- license | Apache-2.0
```

## Freebuff làm được gì

### Làm việc với code ngay trong terminal

Freebuff CLI chạy trong thư mục dự án. Bạn mô tả việc cần làm bằng ngôn ngữ tự nhiên, chẳng hạn sửa lỗi, thêm tính năng hoặc giải thích một luồng xử lý. Agent sẽ tìm các file liên quan, tạo thay đổi và chạy những bước kiểm tra phù hợp với dự án.

Điều này hữu ích khi bạn không muốn tự mở từng file để lần theo code. Bạn vẫn nên đọc phần thay đổi trước khi đưa vào sản phẩm thật.

### Chia nhiệm vụ cho nhiều agent chuyên biệt

Freebuff không gửi mọi yêu cầu qua một model và một prompt duy nhất. Tùy tác vụ, các agent có thể thu thập ngữ cảnh, lập kế hoạch, chỉnh sửa, nghiên cứu, gọi công cụ và xem lại kết quả.

Cách này phù hợp với công việc có nhiều phần, ví dụ tìm nơi xử lý một tính năng, sửa code rồi chạy kiểm tra. Với Freebuff Desktop, các agent chạy song song được cô lập trong những workspace riêng, giúp giảm nguy cơ các tác vụ cùng sửa một thư mục.

### Hỗ trợ nghiên cứu và dùng trình duyệt

Các agent có thể điều tra tài liệu và kiểm thử ứng dụng trong một trình duyệt thật. Tính năng này phù hợp khi bạn cần tìm hiểu tài liệu kỹ thuật, kiểm tra hành vi của giao diện hoặc xác minh một quy trình trên web.

README không mô tả chi tiết từng lệnh cho phần nghiên cứu và trình duyệt. Vì vậy, khi cần dùng hai khả năng này, bạn nên xem hướng dẫn trong sản phẩm tương ứng thay vì tự đoán tham số.

### Chọn model theo tốc độ và mục đích

Danh mục model gồm các lựa chọn nhanh, lựa chọn có ngữ cảnh lớn, model văn bản và các model thử nghiệm miễn phí. Một số model phù hợp cho coding nhanh, một số model mạnh hơn cho tác vụ tổng quát hoặc agentic coding.

Model picker hiển thị số giờ mà một model tiêu tốn. Model thử nghiệm miễn phí không dùng giờ, còn model tính theo mức được hiển thị. Quyền truy cập model có thể thay đổi theo gói, khu vực, sản phẩm và công suất hiện tại.

### Dùng nhiều cách truy cập

Freebuff có năm sản phẩm chính:

- Desktop để chạy agent song song cục bộ.
- CLI để làm việc từ terminal.
- Web để xây dựng và phát hành ứng dụng full-stack.
- Cloud để chạy agent trên repository GitHub.
- Chat để nghiên cứu và trao đổi với AI.

Ứng dụng trên iOS và Android cho phép theo dõi hoặc tiếp tục cuộc trò chuyện, kể cả cuộc trò chuyện đang chạy trên máy tính khi Freebuff Desktop mở.

### Hỗ trợ phát triển và mở rộng

Repo là một monorepo TypeScript xây dựng bằng Bun. Người đóng góp có thể làm việc với sản phẩm, agent, công cụ, tài liệu và runtime. Freebuff được xây dựng trên Codebuff, một framework multi-agent mở có orchestration, tools và SDK.

Nếu bạn muốn tạo agent riêng hoặc nhúng agent vào ứng dụng khác, README hướng tới tài liệu Codebuff và gói `@codebuff/sdk`. Phần này phù hợp hơn với lập trình viên đã quen TypeScript và cấu trúc monorepo.

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

Nếu chỉ muốn dùng Freebuff CLI trong một dự án, README cung cấp lệnh cài qua npm và không yêu cầu API key. README cũng không nêu một phiên bản Node.js cụ thể, nên không nên tự suy đoán phiên bản tối thiểu.

Bạn cần có:

- Một máy tính có terminal.
- Một thư mục dự án để Freebuff làm việc.
- npm để chạy lệnh cài CLI theo README.
- Kết nối mạng để cài gói và sử dụng dịch vụ AI.

Freebuff hỗ trợ Desktop trên macOS, Windows và Linux. README cũng có hướng dẫn bắt đầu cho CLI, nhưng không mô tả chi tiết khác biệt giữa các hệ điều hành. Nếu dùng Windows, bạn có thể mở PowerShell hoặc terminal tương đương và chạy lệnh CLI sau khi cài.

Nếu muốn phát triển chính repo này, bạn cần thêm Bun, Docker và một file `.env.local` đã cấu hình. README nói rõ phần phát triển cục bộ cần Docker và `.env.local`, đồng thời yêu cầu xem Contributing Guide trước khi khởi động các service.

Bạn không cần tự cung cấp API key để dùng danh mục model đi kèm. Tuy vậy, Desktop có thể chạy Claude Code và Codex đã cài cục bộ bằng tài khoản provider hiện có của bạn. Các model kết nối này tách biệt với danh mục model đi kèm của Freebuff.

```note
Không gửi mã nguồn bí mật, khóa truy cập, thông tin khách hàng hoặc dữ liệu chưa được phép chia sẻ vào một agent. README cho biết dữ liệu có thể được dùng khác nhau tùy model hoặc tính năng; hãy đọc thông báo về giới hạn và việc sử dụng dữ liệu trước khi bắt đầu.
```

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

```steps
- Chọn cách dùng | Dùng CLI trong dự án hoặc tải Freebuff Desktop
- Cài CLI | Cài gói Freebuff toàn cục bằng npm
- Mở dự án | Chuyển terminal vào thư mục cần làm việc
- Chạy agent | Gọi lệnh freebuff và mô tả việc cần làm
- Phát triển repo | Nếu sửa chính mã nguồn, cài Bun và chuẩn bị Docker cùng .env.local
```

### Chọn sản phẩm phù hợp

Nếu bạn muốn sửa code trong một thư mục hiện có, CLI là đường đi ngắn nhất. Nếu muốn chạy nhiều agent cục bộ song song, chọn Desktop. Nếu muốn làm việc với repository GitHub trên môi trường lưu trữ, xem Cloud. Web phù hợp với việc xây dựng và phát hành ứng dụng full-stack; Chat phù hợp với nghiên cứu và suy nghĩ cùng AI.

README cung cấp trang bắt đầu riêng cho từng sản phẩm, nhưng hướng dẫn lệnh cụ thể trong nội dung được cung cấp chỉ có cho CLI và phát triển repo.

### Cài Freebuff CLI

Mở terminal. Bạn có thể mở terminal ở bất kỳ thư mục nào để cài gói toàn cục. Lệnh dưới đây là lệnh Quick start trong README:

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

Tùy chọn `-g` cài CLI ở phạm vi toàn cục để lệnh `freebuff` có thể được gọi từ các thư mục dự án khác nhau. README không ghi phiên bản npm hoặc Node.js tối thiểu. Nếu lệnh báo không tìm thấy npm, hãy cài môi trường Node.js có npm trước; repo không cung cấp thêm chỉ dẫn chi tiết trong phần tư liệu này.

Thông tin repo được cung cấp có tên gói npm là `codebuff-project`, nhưng lệnh người dùng trong README là `npm install -g freebuff`. Khi cài theo hướng dẫn sử dụng, hãy ưu tiên đúng lệnh README và không tự đổi sang tên gói khác.

### Mở thư mục dự án

Chuyển terminal vào thư mục chứa code bạn muốn giao cho agent:

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

Đường dẫn `~/my-project` chỉ là ví dụ có trong README. Bạn cần thay bằng đường dẫn thật trên máy. Nếu dùng Windows, hãy mở terminal tại thư mục dự án hoặc thay đường dẫn bằng đường dẫn Windows tương ứng. README không đưa ra một đường dẫn Windows cụ thể.

Trước khi chạy, hãy kiểm tra bạn đang đứng đúng dự án. Agent có thể đọc file trong phạm vi dự án và tạo thay đổi ở đó. Với code quan trọng, nên có commit hoặc bản sao để dễ xem lại thay đổi.

### Khởi động Freebuff

Chạy CLI bằng lệnh sau:

```bash
freebuff
```

Sau khi khởi động, hãy mô tả điều bạn muốn làm. README cho biết Freebuff sẽ tìm các file liên quan, tạo thay đổi và chạy những kiểm tra phù hợp với dự án. Bạn nên viết yêu cầu có phạm vi rõ, ví dụ nêu file, chức năng, điều kiện không được thay đổi và cách kiểm tra mong muốn.

Nếu agent đề xuất thay đổi lớn, hãy đọc diff và kết quả kiểm tra trước khi chấp nhận. README không nói rằng mọi thay đổi đều tự động được commit, vì vậy đừng giả định lịch sử Git đã được cập nhật.

### Chạy bản CLI từ mã nguồn

Nếu mục tiêu là phát triển chính repo Freebuff, clone repo rồi cài dependency bằng Bun:

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

Lệnh `git clone` tải mã nguồn về máy. `cd freebuff` chuyển vào thư mục repo. `bun install` cài dependency của monorepo. `bun up` là lệnh có trong README để cập nhật dependency theo quy trình của repo.

README nói local development cần Docker và `.env.local` đã cấu hình. Bạn cần xem Contributing Guide trước khi khởi động service; tư liệu được cung cấp không chép nội dung file `.env.local`, nên không nên tự tạo biến môi trường theo phỏng đoán.

### Khởi động CLI trong môi trường phát triển

Sau khi chuẩn bị môi trường phát triển theo hướng dẫn đóng góp, chạy CLI riêng bằng:

```bash
bun start-cli
```

Lệnh này dành cho việc phát triển repo, không phải cách cài CLI toàn cục cho người dùng thông thường. Nếu bạn chỉ muốn dùng Freebuff trong dự án của mình, hãy quay lại lệnh `npm install -g freebuff` và `freebuff` ở trên.

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

Cách kiểm tra đơn giản nhất là chạy:

```bash
freebuff
```

Nếu CLI khởi động và cho phép bạn mô tả công việc, phần cài đặt cơ bản đã hoạt động. Hãy thử yêu cầu agent giải thích một file nhỏ hoặc kiểm tra một lỗi đơn giản. Kết quả mong đợi theo README là agent tìm được các file liên quan, thực hiện thay đổi nếu được yêu cầu và chạy các kiểm tra phù hợp.

Với bản phát triển từ mã nguồn, việc `bun install`, `bun up` hoàn tất không lỗi và `bun start-cli` khởi động được là dấu hiệu tốt. README không đưa ra một màn hình đầu ra cố định, tên cổng cụ thể hoặc bộ test cụ thể. Muốn kiểm tra sâu hơn, bạn cần xem Contributing Guide, development guide và testing guide trong repo.

Nếu bạn dùng Desktop, dấu hiệu thành công là ứng dụng chạy được trên macOS, Windows hoặc Linux và cho phép khởi chạy agent. README không cung cấp ảnh chụp màn hình hoặc quy trình kiểm tra chi tiết hơn.

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

### Chủ shop cần sửa nhanh trang bán hàng

Một chủ shop có website nhỏ có thể mở terminal trong thư mục dự án rồi chạy `freebuff`. Prompt nên nêu rõ mục tiêu và giới hạn:

```text
Hãy tìm phần hiển thị nút thêm sản phẩm vào giỏ hàng. Sửa lỗi để nút không bị tràn trên màn hình nhỏ. Chỉ thay đổi các file cần thiết và chạy những kiểm tra phù hợp với dự án.
```

Agent sẽ tìm phần code liên quan, lập kế hoạch, sửa file và kiểm tra kết quả theo khả năng của dự án. Chủ shop nên yêu cầu agent giải thích file đã đổi và tự xem lại giao diện trước khi đưa lên máy chủ.

### Nhân viên văn phòng muốn hiểu một công cụ nội bộ

Một nhân viên không quen đọc code có thể dùng Freebuff để hỏi về cấu trúc dự án:

```text
Hãy giải thích luồng xử lý khi người dùng gửi biểu mẫu này. Tìm các file liên quan, mô tả dữ liệu đi qua những bước nào và không thay đổi file nào.
```

Kết quả hữu ích là bản giải thích dựa trên các file liên quan thay vì phải mở toàn bộ repository. Nếu cần nghiên cứu thêm tài liệu hoặc kiểm thử trên trình duyệt, có thể xem Freebuff Chat, Web hoặc khả năng browser của agent, nhưng README không cung cấp prompt chuyên biệt cho từng sản phẩm.

### Lập trình viên mới muốn thêm một tính năng nhỏ

Một dev mới có thể yêu cầu agent chia công việc thành kế hoạch rồi thực hiện:

```text
Hãy lập kế hoạch thêm chức năng tìm kiếm cho danh sách khách hàng. Trước tiên hãy tìm các file liên quan và nêu các thay đổi cần thiết. Sau đó thực hiện thay đổi, chạy kiểm tra phù hợp và tóm tắt các file đã sửa.
```

Cách viết này giúp người dùng nhìn thấy phạm vi trước khi sửa. Freebuff có thể tìm ngữ cảnh, triển khai và xem lại kết quả; bạn vẫn cần xác nhận yêu cầu nghiệp vụ, kiểm tra dữ liệu đầu vào và đọc thay đổi trước khi hợp nhất.

### Nhóm phát triển cần xử lý nhiều việc độc lập

Một nhóm có thể dùng Freebuff Desktop để chạy các agent song song trong những workspace riêng. Chẳng hạn, một agent nghiên cứu cấu trúc module, một agent đề xuất kiểm tra, còn một agent xử lý tài liệu.

Prompt mẫu cho từng agent:

```text
Hãy kiểm tra module thanh toán, tìm các điểm cần bổ sung kiểm tra lỗi và chỉ đề xuất thay đổi. Không sửa code cho đến khi nêu rõ các file liên quan.
```

Việc cô lập workspace giúp các tác vụ song song ít va chạm hơn. Dù vậy, kết quả vẫn cần được người phụ trách xem lại và hợp nhất có chủ đích.

> Công cụ hữu ích nhất khi bạn giao cho agent một mục tiêu rõ, phạm vi rõ và cách kiểm tra rõ.
>
> — Ông T

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

### Terminal báo không tìm thấy lệnh `freebuff`

Có thể gói chưa được cài thành công hoặc thư mục chứa npm executable chưa nằm trong PATH. Hãy chạy lại đúng lệnh `npm install -g freebuff`, kiểm tra thông báo lỗi của npm và mở terminal mới. README không cung cấp cách sửa PATH theo từng hệ điều hành, nên không nên tự thêm đường dẫn nếu chưa biết npm cài vào đâu.

### Chạy nhầm thư mục dự án

Nếu Freebuff không tìm thấy file mong muốn hoặc đề xuất thay đổi không liên quan, hãy kiểm tra lệnh `cd` và chắc chắn terminal đang ở thư mục dự án. Đường dẫn `~/my-project` trong README chỉ là ví dụ. Với dự án quan trọng, hãy dừng agent, chuyển đúng thư mục rồi chạy lại.

### Tác vụ dùng hết hạn mức giờ

Freebuff tính thời lượng theo model và hiển thị mức tiêu tốn trong model picker. Hạn mức miễn phí hằng ngày có thể khác theo khu vực hoặc việc dùng VPN, còn model và quyền truy cập cũng phụ thuộc công suất hiện tại. Hãy xem số giờ và giới hạn trước khi bắt đầu tác vụ dài; có thể chọn model thử nghiệm miễn phí nếu model đó đang khả dụng.

### Không biết dữ liệu được dùng thế nào

README cho biết chỉ những model hoặc tính năng có thông báo cho phép dùng dữ liệu để huấn luyện mới áp dụng việc đó. Freebuff dùng tin nhắn, trace của agent và file để vận hành dịch vụ; dữ liệu có thể được phân tích cho quảng cáo hoặc model quảng cáo. Hãy đọc thông báo sử dụng dữ liệu trước khi gửi mã nguồn riêng tư, và xem Privacy Policy khi cần quyết định cho dữ liệu doanh nghiệp.

### Bản phát triển không khởi động được

Repo yêu cầu Docker và `.env.local` đã cấu hình cho local development. Nếu chỉ chạy `bun install` và `bun up` nhưng service chưa hoạt động, hãy xem Contributing Guide trước khi tự thêm biến môi trường hoặc đổi lệnh. README không cung cấp nội dung `.env.local` hay quy trình khởi động đầy đủ.

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

Freebuff đáng thử nếu bạn muốn một agent coding có thể dùng ngay từ terminal mà không phải tự cấu hình API key. Bộ sản phẩm rộng, có CLI, Desktop, Web, Cloud và Chat. Khả năng tìm ngữ cảnh, chia nhiệm vụ, sửa code, chạy kiểm tra và nghiên cứu giúp nó phù hợp với cả người mới lẫn dev muốn tăng tốc công việc thường ngày.

Giới hạn lớn nhất là quyền truy cập và hạn mức không cố định cho mọi người. Model picker mới cho biết model nào đang khả dụng và tiêu tốn bao nhiêu giờ. Một số model chỉ dành cho gói trả phí hoặc quyền truy cập đầy đủ. Dữ liệu cũng cần được cân nhắc kỹ vì cách sử dụng phụ thuộc model và tính năng.

Nếu bạn cần kiểm soát tuyệt đối dữ liệu, môi trường chạy offline hoặc quy trình enterprise riêng, hãy cân nhắc công cụ chạy model cục bộ hoặc giải pháp có chính sách dữ liệu phù hợp hơn. Nếu bạn chỉ cần một thư viện để nhúng agent vào ứng dụng, hãy xem Codebuff và `@codebuff/sdk` thay vì chỉ cài CLI.

Tóm lại, Freebuff phù hợp để bắt đầu nhanh, thử nhiều agent và xử lý các việc coding thực tế. Hãy bắt đầu bằng một dự án nhỏ, yêu cầu rõ ràng, đọc diff và kiểm tra kết quả trước khi dùng trong code sản xuất.

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

### Freebuff có miễn phí không?

README mô tả Freebuff là bộ sản phẩm không cần thuê bao, credit hoặc API key để bắt đầu. Tuy nhiên, quyền truy cập và số giờ phụ thuộc sản phẩm, khu vực, model và công suất; model picker hiển thị mức tiêu tốn cụ thể.

### Có cần API key để dùng Freebuff CLI không?

README nói không cần API key để sử dụng Freebuff. Desktop có thể kết nối Claude Code hoặc Codex cài cục bộ bằng tài khoản provider hiện có, nhưng các model đó tách biệt với danh mục model đi kèm của Freebuff.

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

Có. README cho biết Freebuff Desktop có bản cho Windows, macOS và Linux. Phần CLI cung cấp lệnh npm và không nêu giới hạn hệ điều hành cụ thể.

### Có cần GPU để chạy Freebuff không?

README không nói rằng người dùng cần GPU. Tài liệu chỉ nêu Desktop có thể chạy agent cục bộ và danh mục model đi kèm; chưa có thông tin phần cứng tối thiểu chi tiết.

### Dữ liệu dự án có an toàn không?

README cho biết Freebuff dùng tin nhắn, trace của agent và file để vận hành dịch vụ; việc dùng dữ liệu để huấn luyện phụ thuộc thông báo của model hoặc tính năng. Bạn nên đọc Privacy Policy và thông báo dữ liệu trước khi gửi repository hoặc file riêng tư.

### Freebuff khác gì một công cụ coding AI thông thường?

Freebuff cung cấp nhiều sản phẩm và agent chuyên biệt thay vì chỉ một giao diện chat. Nó có thể tìm file, lập kế hoạch, sửa code, chạy công cụ, nghiên cứu và xem lại kết quả; mức phù hợp cụ thể còn tùy sản phẩm và model.

### Muốn phát triển chính repo Freebuff cần gì?

Repo là monorepo TypeScript dùng Bun. README yêu cầu Docker và `.env.local` đã cấu hình cho local development, sau đó dùng `bun install`, `bun up` và `bun start-cli`; chi tiết cần xem các guide đóng góp, phát triển và kiểm thử.
