# gg-framework (GG Coder): agent viết code tiết kiệm gói AI — hướng dẫn cài đặt và dùng

> gg-framework là kho mã nguồn của GG Coder, một ứng dụng desktop agent viết code chạy trên Windows, macOS và Linux, đồng thời có các gói để bạn tự dựng agent riêng. Nó dùng gói AI bạn đã có (Claude, ChatGPT, Kimi Code, MiniMax, MiMo, API key hoặc mô hình local). Cài rất dễ: tải bản cài đặt về chạy, không cần gõ lệnh.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-11-11 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/gg-framework-gg-coder-agent-viet-code-tiet-kiem-goi-ai

GG Coder là một ứng dụng desktop đóng vai agent viết code, và gg-framework là kho mã nguồn của nó. Ý tưởng chính là giúp bạn làm được nhiều việc hơn với chính gói AI bạn đang trả tiền, thay vì phải mua thêm. Bạn mở ứng dụng, nối với nhà cung cấp AI, rồi giao việc cho agent như viết tính năng, sửa lỗi hay kiểm tra dự án.

Repo này hợp với ba nhóm người. Thứ nhất là lập trình viên mới muốn một công cụ làm giúp phần khó mà không phải học dòng lệnh. Thứ hai là người làm kinh doanh, văn phòng muốn tự dựng công cụ nhỏ bằng AI. Thứ ba là dev muốn lấy phần lõi (các gói TypeScript) để tự xây agent riêng.

Điểm đáng giá nhất theo tác giả là tốc độ và mức tiêu hao. Trong bài đo do chính tác giả thực hiện, GG Coder được xếp nhanh và nhẹ nhất trong 20 agent. Đây là số liệu tự đo, mình sẽ nói rõ ở phần cuối. Hiện repo có khoảng 294 sao và 50 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong 3 tháng gần đây.

```repo
- repo | KenKaiii/gg-framework
- kind | Ứng dụng
- desc | GG Coder là ứng dụng desktop agent viết code, dùng chính gói AI bạn đang trả (Claude, ChatGPT, Kimi...) và tác giả đo là nhanh, tiết kiệm hơn nhiều agent khác.
- stars | 294
- lang | TypeScript
- license | AGPL-3.0
```

## GG Coder làm được gì

Dưới đây là các điểm chính theo README, mình diễn giải lại theo lợi ích thực tế.

- **Làm nhiều việc hơn trên cùng một gói AI.** Tác giả cho chạy 20 agent trên cùng một mô hình (Claude Haiku 5.5) với 7 tác vụ, mỗi tác vụ 5 lần. Kết quả: trọn bộ bài test GG Coder mất 102 giây và tốn khoảng 0,014 USD. Claude Code mất 142 giây và khoảng 0,037 USD, tức tốn hơn khoảng 169%. Với bạn, nghĩa là cùng một hạn mức có thể làm được nhiều việc hơn.
- **Agent Steroids: tìm trong code thật.** Công cụ này tìm trong mã nguồn mở thật, hiện hành, ngay trên máy bạn. README nói không dùng máy chủ MCP bị giới hạn lượt gọi, nên không có giới hạn. Lợi ích là agent bớt đoán mò, viết code dựa trên ví dụ thật.
- **Ken Autopilot: làm đến khi kiểm tra xong.** Agent không dừng khi vừa viết xong, mà tiếp tục cho đến khi việc được kiểm chứng. Bạn đỡ phải ngồi hỏi lại: chạy được chưa?
- **Kiểm tra một cú nhấp.** Có các kiểm tra về bảo mật, tuân thủ, an toàn dữ liệu, khả năng truy cập, kiểm thử và nhiều thứ khác, cộng thêm điểm sức khoẻ dự án (Project health score). Người mới không cần biết phải hỏi gì, cứ bấm kiểm tra.
- **Dùng gói đăng ký của bạn.** Hỗ trợ gói Claude, ChatGPT, Kimi Code, MiniMax, MiMo, API key bất kỳ, hoặc mô hình chạy local.

Ngoài ra README còn nhắc ba tính năng đi kèm:

- **GG Goals:** giao cả một mục tiêu, một nhóm worker sẽ làm đến cùng.
- **Chat:** hội thoại có nhớ ngữ cảnh.
- **GG Motion:** biến ý tưởng của bạn thành video.

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

Theo README, nếu chỉ dùng ứng dụng thì bạn cần:

- Một trong ba hệ điều hành: macOS (chip Apple Silicon), Windows, hoặc Linux (x86_64).
- Một nguồn AI để kết nối: gói Claude, ChatGPT, Kimi Code, MiniMax hoặc MiMo, hoặc API key, hoặc mô hình local. README không nói cụ thể từng nhà cung cấp cần loại tài khoản nào, nên bạn dùng gói nào thì cứ chọn nhà cung cấp tương ứng trong ứng dụng.
- Nếu muốn chạy bản phát triển: cần cài sẵn Node.js, pnpm và các điều kiện của Tauri (README dẫn tới trang yêu cầu của Tauri). README không ghi số phiên bản Node cụ thể.

README không nói về yêu cầu GPU hay cấu hình RAM, nên mình không khẳng định gì về phần cứng.

```note
Khi nối ứng dụng với nhà cung cấp AI, bạn đang cho nó dùng gói đăng ký hoặc API key của mình. Nếu dùng API key tính theo lượt, chi phí chạy theo số lần agent làm việc. Hãy theo dõi mức dùng ở trang quản lý của nhà cung cấp và không gửi key cho người khác.
```

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

```steps
- Tải bản cài | Vào trang Releases của repo, tải file đúng hệ điều hành
- Cài ứng dụng | Mở .dmg (Mac), chạy .exe (Windows) hoặc cài .deb/.rpm (Linux)
- Mở và kết nối AI | Mở ứng dụng, nối với nhà cung cấp AI của bạn
- Chọn chế độ | Chọn Code, Chat hoặc Motion để bắt đầu
- (Tuỳ chọn) Chạy bản dev | Clone repo, cài và build nếu bạn là dev
```

### Tải bản cài đúng hệ điều hành

Vào trang Releases của repo trên GitHub, mở bản mới nhất. Bạn tải file theo máy của mình: file .dmg cho Mac chip Apple Silicon, file .exe cho Windows, file .deb hoặc .rpm cho Linux x86_64. Chỗ người mới hay vấp là tải nhầm file. Máy Mac đời cũ chip Intel không nằm trong danh sách README ghi, nên hãy kiểm tra máy trước.

### Cài trên Mac và Windows

Trên Mac, mở file .dmg vừa tải rồi làm theo màn hình. Trên Windows, chạy file .exe và đi hết trình cài đặt. Hai hệ điều hành này không cần gõ lệnh nào.

### Cài trên Linux

Mở terminal ở thư mục chứa file vừa tải (thường là thư mục Downloads). Với Ubuntu/Debian dùng lệnh sau:

```bash
sudo apt install ./GG*.deb
```

Với Fedora và các bản dùng rpm:

```bash
sudo dnf install ./GG*.rpm
```

Dấu `./` có nghĩa là file nằm ngay trong thư mục hiện tại. Nếu terminal báo không tìm thấy file, hãy kiểm tra bạn đang đứng đúng thư mục.

### Mở ứng dụng và kết nối AI

Mở GG Coder, kết nối với nhà cung cấp AI của bạn, rồi chọn Code, Chat hoặc Motion. README chỉ ghi ngắn gọn bước này. Hướng dẫn chi tiết từng màn hình (cho Mac và Windows) nằm trong cộng đồng RAID của tác giả, có trang chủ dự án ở skool.com/raid, miễn phí theo README.

### Dành cho dev: chạy bản phát triển

Nếu bạn đã cài Node.js, pnpm và các điều kiện của Tauri, bạn có thể chạy thẳng từ mã nguồn. Mở terminal ở thư mục bạn muốn chứa dự án, rồi chạy:

```bash
git clone https://github.com/KenKaiii/gg-framework.git
cd gg-framework
pnpm install
pnpm build
pnpm --filter gg-app tauri dev
```

Giải thích nhanh: lệnh đầu tải mã nguồn về, lệnh thứ hai đi vào thư mục dự án, `pnpm install` cài thư viện phụ thuộc, `pnpm build` biên dịch, và lệnh cuối mở ứng dụng ở chế độ phát triển. Lần chạy đầu thường lâu vì phải biên dịch. Nếu thiếu điều kiện của Tauri, bước cuối sẽ báo lỗi, nên hãy kiểm tra trang yêu cầu của Tauri trước.

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

README không đưa ra lệnh kiểm tra riêng. Cách đơn giản là xem kết quả thực tế:

- Ứng dụng mở được cửa sổ chính và cho bạn chọn Code, Chat hoặc Motion.
- Sau khi kết nối nhà cung cấp AI, bạn gửi thử một câu ở chế độ Chat và nhận được trả lời.
- Với bản dev, lệnh `pnpm --filter gg-app tauri dev` mở ra cửa sổ ứng dụng mà không báo lỗi đỏ ở terminal.

Nếu bước kết nối không thành công, bạn chưa dùng được các tính năng còn lại, nên hãy xử lý bước này trước.

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

README không đưa ví dụ prompt, nên các tình huống dưới đây là cách mình áp dụng các tính năng đã nêu. Câu lệnh mẫu chỉ là gợi ý, bạn tự chỉnh theo việc của mình.

### Chủ shop muốn một công cụ nhỏ để bàn việc

Bạn bán hàng online và muốn một trang đơn giản để ghi đơn. Mở chế độ Code, chọn một thư mục trống rồi gõ yêu cầu bằng tiếng Việt, ví dụ: Tạo cho mình một trang web nhập đơn hàng gồm tên khách, sản phẩm, số lượng, rồi hiện danh sách bên dưới. Vì có Ken Autopilot, agent tiếp tục làm cho đến khi kiểm tra xong, bạn đỡ phải nhắc đi nhắc lại. Kết quả là một dự án chạy được để bạn xem thử.

> Với người mới, phần khó không phải là viết code, mà là biết cần kiểm tra điều gì.
>
> — Ông T

### Lập trình viên mới muốn biết dự án của mình có ổn không

Bạn vừa làm xong một ứng dụng nhỏ và không biết nó đã đủ an toàn chưa. Dùng các kiểm tra một cú nhấp về bảo mật, an toàn dữ liệu, khả năng truy cập và kiểm thử, rồi xem điểm Project health score. Bạn nhận được danh sách điểm cần sửa mà không phải tự nghĩ ra câu hỏi. Mình khuyên đọc kỹ từng gợi ý trước khi cho agent sửa.

### Nhân viên văn phòng giao cả một mục tiêu

Bạn cần một công cụ nội bộ, như bảng tổng hợp báo cáo từ file có sẵn. Dùng GG Goals: mô tả mục tiêu thật rõ (đầu vào là gì, đầu ra mong muốn là gì), để một nhóm worker làm đến cùng. Kết quả là một sản phẩm hoàn chỉnh hơn so với việc hỏi từng câu lẻ. Hãy mô tả càng cụ thể càng tốt và tự mở kết quả ra thử trước khi dùng cho việc thật.

### Dev muốn tự dựng agent riêng

Bạn không cần ứng dụng desktop, chỉ cần phần lõi. Repo có sẵn các gói để dùng riêng. Chỉ cần cài gói kết nối nhà cung cấp AI và gói xây agent:

```bash
npm install @kenkaiiii/gg-ai @kenkaiiii/gg-agent
```

Theo README: `@kenkaiiii/gg-ai` kết nối nhà cung cấp AI và nhận phản hồi dạng luồng, còn `@kenkaiiii/gg-agent` giúp dựng agent dùng công cụ của bạn và làm việc qua các tác vụ. Ngoài ra có `@kenkaiiii/gg-core` (chọn mô hình, xác thực, tìm mô hình local) và `@kenkaiiii/ggcoder` (agent viết code, phiên làm việc và công cụ đứng sau ứng dụng và CLI). README chưa kèm đoạn code mẫu, nên bạn đọc phần hướng dẫn ở các liên kết gói trong README.

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

**Cài đặt trên Linux báo không tìm thấy file.** Lệnh `sudo apt install ./GG*.deb` chỉ chạy đúng khi terminal đang mở ở thư mục chứa file. Dùng `cd` vào thư mục tải về rồi chạy lại.

**Bản cài không mở được trên máy Mac cũ.** README ghi bản Mac dành cho Apple Silicon. Nếu máy bạn dùng chip Intel, README chưa nói gì về hỗ trợ, nên bạn thử bản dev hoặc xem phần Issues của repo.

**Chạy bản dev bị lỗi ở bước tauri dev.** Nguyên nhân hay gặp là thiếu điều kiện của Tauri trên máy. Đọc lại trang yêu cầu Tauri mà README dẫn tới và cài đủ, rồi chạy lại từ `pnpm install`.

**Kết nối nhà cung cấp AI không thành công.** Kiểm tra gói đăng ký hoặc API key còn hiệu lực và nhập đúng nhà cung cấp. Nếu vẫn lỗi, xem hướng dẫn từng bước trong cộng đồng RAID của tác giả hoặc mục Issues trên GitHub.

**Agent làm tốn hạn mức nhanh hơn dự kiến.** Việc lớn, mô tả mơ hồ thường khiến agent chạy lâu. Hãy chia nhỏ việc, mô tả rõ yêu cầu và theo dõi mức dùng ở nhà cung cấp.

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

**Điểm mạnh.** Cài đặt dễ vì có bản cài sẵn cho Windows, macOS và Linux. Dùng được nhiều loại gói AI, kể cả mô hình local. Có kiểm tra bảo mật, tuân thủ, kiểm thử và điểm sức khoẻ dự án, hợp với người mới. Phần lõi tách thành các gói riêng nên dev có thể tự xây agent. Dự án vẫn được cập nhật.

**Giới hạn cần biết.** Các số liệu tốc độ và chi phí là do tác giả tự đo, trên một mô hình (Claude Haiku 5.5), với các dự án thử nhỏ. Tác giả nói rõ mọi agent đều chạy ở trạng thái trần, không thêm skill, plugin hay MCP server. Kết quả trong công việc thật của bạn có thể khác. README cũng chưa ghi rõ yêu cầu phần cứng hay phiên bản Node cụ thể. Giấy phép AGPL-3.0: nếu bạn phát hành bản chỉnh sửa hoặc chạy nó như dịch vụ mạng thì phải chia sẻ mã nguồn theo cùng giấy phép, điều cần cân nhắc nếu bạn làm sản phẩm thương mại.

**Khi nào chọn cách khác.** Nếu bạn đã quen một agent dòng lệnh và hài lòng, chưa cần đổi chỉ vì bảng so sánh. Nếu bạn cần một công cụ có tài liệu tiếng Việt chi tiết, hãy biết rằng README có nhiều ngôn ngữ nhưng chưa thấy tiếng Việt. Với người mới, mình khuyên thử một dự án nhỏ trước, theo dõi chi phí, rồi mới giao việc lớn.

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

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

Mã nguồn công khai trên GitHub theo giấy phép AGPL-3.0 và README không nói phải trả phí để tải ứng dụng. Tuy nhiên bạn cần một nguồn AI như gói đăng ký hoặc API key, và chi phí đó do nhà cung cấp AI tính. README cũng nói cộng đồng RAID của tác giả là miễn phí.

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

Có. README có bản cài .exe cho Windows. Ngoài ra còn có bản .dmg cho macOS Apple Silicon và bản .deb hoặc .rpm cho Linux x86_64.

### Có cần GPU để dùng không?

README không nhắc đến yêu cầu GPU. Ứng dụng nối với gói AI hoặc API key của bạn, còn việc chạy mô hình local thì README chưa nêu cấu hình tối thiểu, nên mình chưa có thông tin chắc chắn.

### Nó dùng được với những nhà cung cấp AI nào?

README liệt kê gói Claude, ChatGPT, Kimi Code, MiniMax và MiMo, cùng với API key bất kỳ hoặc mô hình chạy local. Chi tiết cách kết nối từng loại nằm trong ứng dụng và hướng dẫn của tác giả.

### GG Coder khác gì Claude Code?

Theo bài đo của tác giả trên cùng mô hình và bộ tác vụ, GG Coder mất 102 giây và khoảng 0,014 USD, còn Claude Code mất 142 giây và khoảng 0,037 USD. Đây là số liệu tự đo trên các dự án thử nhỏ, nên kết quả thực tế của bạn có thể khác. Ngoài ra GG Coder là ứng dụng desktop có thêm Chat, GG Goals và GG Motion.

### Dữ liệu và mã nguồn của tôi có an toàn không?

README không có phần nói riêng về cách xử lý dữ liệu. Công cụ nối với nhà cung cấp AI bạn chọn, nên nội dung bạn giao cho agent sẽ đi qua nhà cung cấp đó. Repo có file SECURITY.md, bạn nên đọc để biết cách báo lỗi bảo mật.

### Tôi có thể dùng phần lõi để tự xây agent không?

Có. README giới thiệu các gói @kenkaiiii/gg-ai, @kenkaiiii/gg-agent, @kenkaiiii/gg-core và @kenkaiiii/ggcoder để dùng riêng. Để bắt đầu, README đưa lệnh npm install @kenkaiiii/gg-ai @kenkaiiii/gg-agent. Lưu ý giấy phép AGPL-3.0 khi bạn phát hành hoặc chạy dưới dạng dịch vụ mạng.
