CodebuffAI/freebuff: coding agent AI miễn phí — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về CodebuffAI/freebuff — 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: 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à bộ năm sản phẩm 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 CLI ngay trong thư mục dự án, hoặc chọn Desktop, Web, Cloud và Chat; README không yêu cầu gói thuê bao, credit hay API key để bắt đầu.
Freebuff là một coding agent AI miễn phí, có thể làm việc trong terminal, desktop, trình duyệt và các repository GitHub. Công cụ dùng nhiều agent chuyên biệt để 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ả.
Repo này phù hợp với dev mới muốn có trợ lý lập trình, nhân viên văn phòng cần thử tự động hóa nhỏ, hoặc đội nhóm muốn khảo sát codebase nhanh hơn. Điểm đáng giá là bạn không cần đăng ký gói thuê bao, nạp credit hay tự chuẩn bị API key để bắt đầu với các model được tích hợp sẵn.
Repo có khoảng 14146 sao và 1518 fork, dùng TypeScript, giấy phép Apache-2.0. Freebuff không chỉ có một chương trình dòng lệnh. Nó gồm năm lựa chọn: Desktop để chạy agent song song trên máy, CLI để làm việc trong terminal, Web để xây dựng ứng dụng full-stack, Cloud để chạy agent trên repository GitHub và Chat để nghiên cứu, trao đổi với AI.
CodebuffAI/freebuff
Freebuff cung cấp các agent AI miễn phí để viết code, nghiên cứu và xây dựng ứng dụng từ terminal, desktop, trình duyệt hoặc GitHub.
I.Freebuff làm được gì
A.Làm việc trực tiếp trong codebase
Freebuff có thể đọc cấu trúc dự án, tìm những file liên quan đến yêu cầu rồi đề xuất hoặc thực hiện thay đổi. 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 kiểm tra một luồng xử lý.
Lợi ích thực tế là bạn không phải tự mở từng file để tìm điểm bắt đầu. Agent sẽ thu thập ngữ cảnh trước khi chỉnh sửa. Tuy vậy, bạn vẫn nên xem diff và chạy kiểm tra trước khi đưa thay đổi vào dự án thật.
B.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 loại việc, các agent có thể tìm ngữ cảnh, lập kế hoạch, chỉnh sửa, nghiên cứu, dùng công cụ và review kết quả.
Cách này hữu ích khi yêu cầu có nhiều phần. Ví dụ, một agent tìm các file giao diện, một agent xem logic phía máy chủ, sau đó kết quả được phối hợp để xử lý nhiệm vụ. README không cam kết rằng mọi tác vụ đều được chia thành cùng một số agent cố định.
C.Viết code từ terminal bằng CLI
CLI cho phép bạn mở một dự án rồi mô tả việc cần làm ngay trong terminal. Freebuff có thể tìm file, thay đổi code và chạy các kiểm tra phù hợp với dự án.
Đây là lựa chọn dễ thử nhất nếu bạn đã có một repository trên máy. Bạn không cần chuyển qua một ứng dụng khác để đưa yêu cầu. Hãy bắt đầu với một bản sao dự án hoặc một nhánh riêng để dễ xem và hoàn tác thay đổi.
D.Chạy agent song song trên Desktop
Freebuff Desktop có thể chạy các agent song song cục bộ. Mỗi tác vụ được cô lập trong workspace riêng.
Tính năng này phù hợp khi bạn muốn thử nhiều hướng sửa lỗi hoặc giao nhiều việc độc lập cho agent. README cho biết Desktop có bản tải cho macOS, Windows và Linux. README không nêu chi tiết cấu hình phần cứng tối thiểu cho từng hệ điều hành.
E.Xây dựng ứng dụng full-stack trên Web
Freebuff Web hướng tới việc xây dựng và đưa ứng dụng full-stack vào hoạt động. Môi trường Web cung cấp sandbox, preview, terminal và quy trình triển khai.
Bạn có thể dùng cách này khi chưa muốn thiết lập toàn bộ môi trường phát triển trên máy cá nhân. README không ghi cụ thể giới hạn của sandbox, các nền tảng triển khai được hỗ trợ hay chi tiết thao tác trong giao diện Web.
F.Làm việc với repository GitHub trên Cloud
Freebuff Cloud cho phép chạy agent trên bất kỳ repository GitHub nào sau khi kết nối repository. Đây là lựa chọn hợp với đội nhóm hoặc người muốn làm việc trên code từ xa.
README cho biết các repository kết nối với Freebuff Cloud có thể được đối tác hạn chế đánh giá. Các đối tác này không được dùng, chia sẻ rộng rãi hoặc huấn luyện trên repository theo mô tả trong README. Bạn vẫn nên đọc chính sách riêng trước khi kết nối code nhạy cảm.
G.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. Freebuff Chat cũng được thiết kế cho việc nghiên cứu và suy nghĩ cùng AI.
Khả năng này hữu ích khi bạn cần tìm hiểu một thư viện, kiểm tra hành vi của một trang hoặc lập kế hoạch trước khi viết code. README không nêu danh sách trình duyệt, cách cấu hình quyền truy cập hay bộ công cụ nghiên cứu chi tiết.
H.Chọn nhiều model có sẵn
Freebuff có catalog model được tuyển chọn. Các model có khả năng và giới hạn khác nhau, chẳng hạn model nhanh cho coding và tool use, model có context lớn, model text-only hoặc model thử nghiệm miễn phí.
Model picker hiển thị số giờ mà mỗi model sử dụng. Một model tính một giờ sẽ trừ một giờ trong số dư khi dùng một giờ; model tính ba giờ sẽ trừ ba giờ. Các model thử nghiệm miễn phí không dùng số giờ theo mô tả trong README.
Mức model và giới hạn phụ thuộc tier truy cập, sản phẩm và công suất hiện tại. Một số model chỉ dành cho quyền truy cập đầy đủ hoặc gói trả phí. Vì giá và danh mục có thể thay đổi, README khuyên xem thông tin ngay trong model picker.
II.Cần chuẩn bị gì
Nếu chỉ muốn dùng Freebuff như người dùng cuối, README cho biết bạn không cần gói thuê bao, credit hay API key. Bạn cần một máy có môi trường terminal để cài CLI, hoặc tải ứng dụng tương ứng nếu chọn Desktop. README xác nhận Desktop hỗ trợ macOS, Windows và Linux.
Để dùng CLI trong dự án, bạn cần có thư mục dự án trên máy. README minh họa một thư mục tên ~/my-project; đây là ví dụ, không phải đường dẫn bắt buộc. Bạn cũng cần cài được npm để chạy lệnh cài CLI được README cung cấp.
Để phát triển chính repo, cần Bun, Docker và một file .env.local đã cấu hình. Repo là monorepo TypeScript dùng Bun. README chỉ dẫn xem Contributing Guide trước khi khởi động các service; phần README được cung cấp không liệt kê nội dung cụ thể của file .env.local.
Bạn có thể dùng các model đi kèm mà không tự cung cấp tài khoản nhà cung cấp model. Freebuff Desktop cũng có thể chạy Claude Code và Codex đã cài cục bộ bằng tài khoản nhà cung cấp hiện có; các model kết nối này tách biệt với catalog đi kèm Freebuff.
Nếu dùng Freebuff Cloud, bạn cần kết nối một repository GitHub. Nếu dùng các ứng dụng Web, Cloud hoặc Chat, README không ghi thêm yêu cầu về trình duyệt, tài khoản riêng, GPU hay cấu hình máy chủ.
Không đưa secret, mã nguồn nhạy cảm hoặc dữ liệu khách hàng vào phiên làm việc nếu bạn chưa hiểu chính sách dữ liệu. README nói Freebuff dùng tin nhắn, agent trace và file để chạy dịch vụ; một số model hoặc tính năng có thể cho phép dùng dữ liệu để huấn luyện. Hãy xem thông báo sử dụng dữ liệu trước khi bắt đầu phiên.
III.Cài đặt từng bước
- Chọn cách dùngChọn CLI, Desktop, Web, Cloud hoặc Chat theo công việc
- Cài CLICài Freebuff toàn cục bằng npm nếu muốn làm việc trong terminal
- Mở dự ánĐi tới thư mục dự án cần agent hỗ trợ
- Khởi động agentChạy `freebuff` rồi mô tả yêu cầu
- Phát triển repoNếu muốn chạy mã nguồn repo, cài Bun và chuẩn bị Docker cùng `.env.local`
A.Chọn sản phẩm phù hợp
README cung cấp năm sản phẩm. CLI hợp với người muốn làm việc trong terminal. Desktop hợp với người cần chạy nhiều agent song song trên máy. Web dành cho xây dựng ứng dụng full-stack. Cloud dành cho repository GitHub. Chat dành cho nghiên cứu và trao đổi với AI.
Nếu bạn chỉ muốn thử nhanh trên một dự án đang có, hãy chọn CLI. Nếu muốn phát triển chính mã nguồn Freebuff, hãy làm theo phần dành cho contributor ở dưới.
B.Cài Freebuff CLI
Mở terminal. Lệnh dưới đây là lệnh Quick start trong README:
npm install -g freebuffLệnh này cài gói freebuff ở phạm vi toàn cục để bạn có thể gọi lệnh freebuff từ các thư mục khác nhau. Nếu terminal báo không tìm thấy npm, bạn cần cài môi trường có npm trước; README được cung cấp không ghi hướng dẫn cài npm.
Repo có metadata tên gói npm là codebuff-project, nhưng lệnh cài CLI trong README vẫn là npm install -g freebuff. Khi làm theo hướng dẫn người dùng, hãy ưu tiên đúng lệnh Quick start này và không tự đổi tên gói.
C.Mở thư mục dự án
Đi tới thư mục mà bạn muốn Freebuff đọc và chỉnh sửa. README dùng ví dụ sau:
cd ~/my-projectBạn thay ~/my-project bằng đường dẫn dự án của mình. Lệnh cd chỉ chuyển vị trí làm việc của terminal; nó không tạo dự án và không tải source code. Trên Windows, hãy mở terminal tại thư mục dự án hoặc dùng lệnh cd với đường dẫn thư mục phù hợp với shell đang dùng.
Nếu bạn cần lấy chính repo về máy, có thể dùng lệnh phổ thông sau rồi đi vào thư mục:
git clone https://github.com/CodebuffAI/freebuff.git
cd freebuffREADME có lệnh clone này trong phần đóng góp. Với dự án của bạn, hãy thay URL bằng repository mà bạn được phép làm việc trên đó.
D.Khởi động CLI và giao việc
Trong thư mục dự án, chạy:
freebuffSau đó mô tả điều bạn muốn Freebuff làm. README nói agent sẽ tìm file liên quan, tạo thay đổi và chạy các kiểm tra quan trọng cho dự án.
Bạn có thể bắt đầu bằng một yêu cầu nhỏ như “Tìm nơi xử lý đăng nhập và giải thích luồng này”. Khi đã hiểu cách agent làm việc, hãy yêu cầu cụ thể hơn như thêm một kiểm tra hoặc sửa một lỗi đã tái hiện được. Trước khi chấp nhận kết quả, hãy đọc thay đổi mà agent tạo ra và kiểm tra lại hành vi.
E.Chạy repo để phát triển
Nếu mục tiêu là đóng góp vào mã nguồn Freebuff, README yêu cầu Docker và file .env.local đã cấu hình. Trước tiên, clone repo và cài dependency bằng Bun:
git clone https://github.com/CodebuffAI/freebuff.git
cd freebuff
bun install
bun upbun install cài các dependency của monorepo. bun up là lệnh được README cung cấp để cập nhật dependency theo thiết lập của repo. README yêu cầu xem Contributing Guide trước khi khởi động service, vì phần hướng dẫn được cung cấp không giải thích nội dung .env.local hay các biến bắt buộc.
Để khởi động CLI riêng, chạy:
bun start-cliLệnh này dành cho môi trường phát triển của repo. Không nên nhầm nó với lệnh sử dụng CLI đã cài toàn cục là freebuff.
F.Chọn model và quyền truy cập
Sau khi chạy sản phẩm, mở model picker để xem model nào đang khả dụng và số giờ mỗi model sử dụng. Quyền truy cập có thể thay đổi theo khu vực, tier, sản phẩm và công suất hiện tại.
README nói quyền truy cập giới hạn có mức dùng miễn phí hằng ngày và số dư được tính theo giờ. Vì giới hạn và catalog có thể thay đổi, hãy đọc thông tin hiển thị trước khi chạy một tác vụ dài. Bạn không cần tự nhập API key cho catalog model đi kèm theo mô tả hiện có.
IV.Kiểm tra đã chạy được chưa
Với CLI, dấu hiệu cơ bản là sau khi chạy freebuff, chương trình mở phiên làm việc và chấp nhận mô tả yêu cầu. Hãy thử yêu cầu agent tìm một file hoặc giải thích một phần code. Kết quả mong đợi là agent tìm được ngữ cảnh liên quan và bắt đầu xử lý yêu cầu.
Với luồng phát triển repo, bun install và bun up phải chạy được trong thư mục đã clone. Sau đó chạy bun start-cli để kiểm tra CLI phát triển có khởi động hay không. Nếu service cần Docker hoặc .env.local, hãy hoàn tất đúng phần hướng dẫn trong Contributing Guide trước khi đánh giá kết quả.
Với Desktop, Web, Cloud và Chat, README mô tả mục tiêu của từng sản phẩm nhưng không đưa ra màn hình kiểm tra chi tiết. Có thể kiểm tra theo dấu hiệu tương ứng: Desktop tạo được workspace riêng cho agent; Web có sandbox, preview và terminal; Cloud nhận repository GitHub đã kết nối; Chat mở được phiên nghiên cứu.
Một phiên chạy thành công chưa có nghĩa code đã đúng. Hãy xem diff, chạy test hoặc các kiểm tra phù hợp với dự án, và tự kiểm tra luồng quan trọng trước khi triển khai.
V.Dùng vào việc thật
A.Chủ shop muốn sửa trang giới thiệu sản phẩm
Chủ shop có một dự án web trên máy và muốn đổi nội dung phần giới thiệu. Sau khi mở terminal trong thư mục dự án, chạy:
freebuffCó thể giao yêu cầu: “Tìm component hiển thị phần giới thiệu sản phẩm, đổi tiêu đề theo nội dung này, giữ nguyên giao diện trên điện thoại và cho tôi biết các file đã thay đổi.”
Agent sẽ tìm file liên quan và thực hiện thay đổi trong phạm vi dự án. Chủ shop nên xem phần thay đổi, mở trang để kiểm tra giao diện và yêu cầu agent sửa tiếp nếu kết quả chưa đúng. README không nói Freebuff tự hiểu nghiệp vụ của cửa hàng, nên yêu cầu càng cụ thể thì kết quả càng dễ kiểm tra.
B.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 nhận một repository nhưng chưa biết chức năng đăng nhập nằm ở đâu. Trong terminal, họ chạy Freebuff rồi yêu cầu: “Tìm toàn bộ luồng đăng nhập, liệt kê các file chính và giải thích dữ liệu đi từ màn hình đến nơi xác thực như thế nào.”
Đây là cách tận dụng khả năng file-finding và thu thập codebase context. Kết quả phù hợp là bản giải thích dựa trên các file agent đã đọc. Người dùng không nên yêu cầu agent suy đoán những phần không có trong repository; hãy hỏi lại bằng tên file hoặc luồng cụ thể nếu cần.
C.Dev mới muốn sửa một lỗi nhỏ
Dev thấy một nút không hoạt động sau khi người dùng bấm. Họ có thể mở dự án, chạy freebuff, rồi nhập: “Tìm xử lý sự kiện của nút này, giải thích nguyên nhân có thể xảy ra, sửa lỗi với thay đổi nhỏ nhất và chạy các kiểm tra phù hợp.”
Freebuff có thể tìm file, lập kế hoạch, chỉnh sửa và chạy kiểm tra. Dev nên yêu cầu agent giải thích trước nếu chưa chắc nguyên nhân. Sau đó, hãy xem diff và thử lại đúng thao tác gây lỗi. Agent hỗ trợ quá trình xử lý nhưng không thay thế việc xác nhận trên môi trường thật.
D.Đội phát triển muốn thử nhiều hướng xử lý
Một đội muốn giao các hướng điều tra độc lập cho nhiều agent. Freebuff Desktop hỗ trợ chạy agent song song cục bộ và cô lập các phiên trong workspace riêng.
Ví dụ, một phiên tìm nguyên nhân lỗi, phiên khác xem cách viết test, phiên thứ ba nghiên cứu tài liệu liên quan. Sau khi các phiên hoàn tất, đội có thể so sánh kết quả rồi chọn hướng phù hợp. README không nêu cách hợp nhất thay đổi giữa các workspace, vì vậy hãy kiểm tra quy trình cụ thể của Desktop trước khi đưa code vào nhánh chính.
Hãy để agent làm phần tìm kiếm và thao tác lặp lại, còn bạn giữ quyền quyết định với code và dữ liệu quan trọng.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Terminal không nhận lệnh freebuff
Nguyên nhân thường là CLI chưa được cài toàn cục, lệnh cài chưa chạy xong hoặc terminal chưa nhận PATH mới. Hãy chạy lại đúng lệnh npm install -g freebuff, mở terminal mới rồi thử freebuff. README không cung cấp lệnh chẩn đoán PATH cụ thể.
B.Chạy CLI trong sai thư mục
Nếu mở terminal ở thư mục cha hoặc một dự án khác, agent có thể đọc nhầm codebase. Hãy dùng cd để đi vào đúng thư mục trước khi chạy freebuff. Kiểm tra tên thư mục và trạng thái repository trước khi cho phép agent sửa file.
C.Agent tạo thay đổi ngoài mong muốn
Yêu cầu quá rộng có thể khiến agent chỉnh nhiều file hơn bạn dự định. Hãy bắt đầu bằng yêu cầu phân tích, giới hạn phạm vi file hoặc yêu cầu agent trình bày kế hoạch trước. Luôn xem diff và chạy kiểm tra trước khi commit hoặc triển khai.
D.Model hoặc thời lượng sử dụng khác dự kiến
Freebuff tính quyền truy cập theo model, tier, sản phẩm và công suất. Model picker hiển thị số giờ một model sử dụng; các model khác nhau có thể trừ số giờ khác nhau. Hãy kiểm tra picker trước khi bắt đầu tác vụ dài và chọn model phù hợp với quyền hiện có.
E.Không biết dữ liệu có được dùng để huấn luyện hay không
README nói dữ liệu chỉ được dùng để huấn luyện AI khi model hoặc tính năng thông báo điều đó. Freebuff hoặc nhà cung cấp có thể giữ submission để phát triển, huấn luyện, kiểm thử, đánh giá, fine-tune và cải thiện sản phẩm; trong một số trường hợp dữ liệu có thể được chia sẻ hoặc bán cho bên thứ ba.
Không đưa dữ liệu bí mật vào phiên nếu chưa đọc thông báo sử dụng dữ liệu và Privacy Policy. README cũng nói Freebuff không đưa riêng file tải lên, file dự án hoặc repository kết nối cho nhà cung cấp quảng cáo, nhưng dữ liệu vẫn có thể được xử lý cho vận hành, phân tích, quảng cáo hoặc mục đích được thông báo.
VII.Có nên dùng không
Freebuff đáng thử nếu bạn muốn một coding agent có nhiều cách sử dụng, từ terminal đến desktop và GitHub. CLI có quy trình bắt đầu ngắn. Catalog model có lựa chọn miễn phí và README không yêu cầu API key cho việc bắt đầu. Khả năng tìm ngữ cảnh, chỉnh sửa, chạy kiểm tra, nghiên cứu và review giúp giảm nhiều thao tác lặp lại.
Repo cũng có cộng đồng đáng chú ý với khoảng 14146 sao và 1518 fork, mã nguồn TypeScript và giấy phép Apache-2.0. Repo được tổ chức như một monorepo, có mã CLI, SDK, agent, package và tài liệu, nên phù hợp với người muốn tìm hiểu hoặc đóng góp sâu hơn.
Giới hạn lớn là quyền truy cập, model, số giờ và thông báo dữ liệu có thể phụ thuộc tier, khu vực, sản phẩm và công suất. Kết quả agent vẫn cần được kiểm tra. README không nêu đầy đủ yêu cầu phần cứng, cách cấu hình npm, chi tiết .env.local, quy trình hợp nhất workspace hay thông số từng dịch vụ.
Nếu bạn cần quyền kiểm soát tuyệt đối dữ liệu, môi trường offline hoặc một model tự quản lý bằng hạ tầng riêng, hãy cân nhắc cách khác. Nếu bạn cần tích hợp agent vào ứng dụng riêng, README hướng tới Codebuff và @codebuff/sdk, nhưng phần hướng dẫn này không đủ thông tin để mô tả quy trình tích hợp chi tiết.
Tóm lại, Freebuff phù hợp để thử coding agent miễn phí và làm các việc từ tìm hiểu code, sửa lỗi nhỏ đến nghiên cứu ứng dụng. Hãy bắt đầu bằng CLI trên một dự án không nhạy cảm, kiểm tra kỹ thay đổi và chỉ đưa code vào môi trường thật sau khi bạn xác nhận kết quả.
Câu hỏi thường gặp
Freebuff có miễn phí không?
README nói Freebuff không yêu cầu gói thuê bao, credit hoặc API key để bắt đầu. Quyền truy cập và giới hạn phụ thuộc khu vực, tier, sản phẩm và công suất; model picker hiển thị số giờ sử dụng của từng model.
Có cần API key để dùng Freebuff không?
Không cần API key theo mô tả trong README đối với các model được Freebuff tích hợp. Freebuff Desktop cũng có thể chạy Claude Code và Codex đã cài cục bộ bằng tài khoản nhà cung cấp hiện có; các model này tách biệt với catalog đi kèm.
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. README không nêu yêu cầu phần cứng tối thiểu hoặc hướng dẫn Windows chi tiết hơn.
Có cần GPU để chạy Freebuff không?
README không nói cần GPU và cũng không công bố cấu hình phần cứng tối thiểu. Vì vậy chưa có thông tin để kết luận về yêu cầu GPU cho từng sản phẩm.
Dữ liệu dự án có an toàn không?
README nói Freebuff dùng tin nhắn, agent trace và file để vận hành dịch vụ; một số model hoặc tính năng có thể dùng dữ liệu để huấn luyện nếu có thông báo. Không nên đưa dữ liệu nhạy cảm vào trước khi đọc thông báo sử dụng dữ liệu và Privacy Policy.
Freebuff khác gì một coding assistant thông thường?
Freebuff cung cấp nhiều sản phẩm và dùng các agent chuyên biệt để tìm ngữ cảnh, lập kế hoạch, chỉnh sửa, nghiên cứu, chạy công cụ và review. Ngoài CLI, repo còn có Desktop, Web, Cloud và Chat.
Tôi có thể phát triển chính repo Freebuff trên máy không?
Có, README nói repo là monorepo TypeScript dùng Bun. Môi trường phát triển cần Docker và `.env.local` đã cấu hình; sau đó README cung cấp các lệnh `bun install`, `bun up` và `bun start-cli`, đồng thời yêu cầu xem Contributing Guide.


