# Paradev: chạy nhiều AI code song song trên một repo — hướng dẫn cài đặt và dùng

> Paradev (trước đây tên Superset) là ứng dụng desktop mã nguồn mở, giúp bạn chạy nhiều agent code trên dòng lệnh như Claude Code, Codex, OpenCode cùng lúc trên một repo. Mỗi tác vụ có worktree, nhánh và terminal riêng, kèm khu xem thay đổi và trình duyệt xem thử. Cài khá dễ: tải file .dmg trên macOS và chỉ cần có Git. Hiện chưa có bản Windows.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-13 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/paradev-chay-nhieu-ai-coding-agent-song-song-2

Paradev là ứng dụng desktop mã nguồn mở để chạy nhiều agent code dòng lệnh (Claude Code, Codex, OpenCode, Gemini CLI, Cursor Agent…) song song trên cùng một repository. Mỗi tác vụ được tách ra một Git worktree, một nhánh và các terminal riêng, nên các agent không giẵm lên file của nhau. Repo hiện có khoảng 16.268 sao và 1.457 fork, giấy phép MIT.

Vấn đề repo giải quyết rất đời thường. Nếu bạn đã quen dùng một agent trong terminal, bạn sẽ thấy nó chỉ làm được một việc trong một cửa sổ, trên một bản checkout. Muốn làm hai ba việc cùng lúc, bạn phải tự mở nhiều tab, tự tạo nhánh, tự nhớ con nào đang chạy con nào. Paradev gom hết phần "xung quanh" đó vào một nơi: danh sách workspace, trạng thái từng agent, khu xem diff, khu mở pull request và trình duyệt xem thử.

Điểm đáng giá nhất: Paradev **không phải** là một agent code. Bạn mang theo gói đăng ký và API key của chính mình, Paradev không đứng giữa chuyển tiếp các lệnh gọi mô hình. Tác giả cũng cam kết bản desktop miễn phí mãi mãi để chạy agent song song trên máy bạn. Một lưu ý để khỏi nhầm: Paradev không liên quan gì đến Apache Superset, công cụ báo cáo dữ liệu.

```repo
- repo | ParadevAI/Paradev
- kind | Ứng dụng
- desc | Paradev là ứng dụng desktop mã nguồn mở để chạy Claude Code, Codex và các agent CLI song song, mỗi việc một Git worktree riêng.
- stars | 16k
- lang | TypeScript
- license | MIT
```

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

Dưới đây là những tính năng chính, kèm lý do bạn nên quan tâm.

- **Mỗi việc một worktree.** Agent làm việc trên các bản sao riêng của repo, mỗi bản một nhánh. Bạn có thể giao cùng lúc "sửa lỗi đăng nhập" và "thêm trang báo cáo" mà hai việc không đè lên file của nhau. Lưu ý: README nói rõ worktree chỉ tách file làm việc, không cô lập tiến trình và không tự ngăn xung đột khi gộp nhánh.
- **Xem và sửa thay đổi ngay trong app.** Khu Changes cho bạn xem patch của agent, bình luận, sửa, commit, push và mở pull request. Khu pull request hiển thị kết quả kiểm tra, các luồng review và nút merge. Bạn không phải nhảy qua lại giữa nhiều công cụ.
- **Trình duyệt tích hợp.** Bạn xem thử máy chủ dev của từng workspace ngay trong app, cổng (port) được phát hiện riêng cho từng workspace nên không bị trùng. Chế độ Design cho phép chọn một phần tử trên giao diện rồi gửi yêu cầu chỉnh sửa kèm ngữ cảnh cho agent.
- **Theo dõi trạng thái agent.** Thanh bên cho biết agent nào đang làm, đã xong hay đang chờ bạn. Có chuông báo khi xong và huy hiệu trên dock khi cần bạn chú ý.
- **Terminal xịn.** Có tab, chia khung không giới hạn, preset lưu sẵn và phiên làm việc vẫn còn sau khi khởi động lại. Nhấn ⌘I để mở trình soạn prompt nhiều dòng, có thể gõ @ để nhắc đến file.
- **Dùng được nhiều agent.** Bảng agent được hỗ trợ đầy đủ gồm Claude Code, OpenAI Codex CLI, Cursor Agent, Gemini CLI, OpenCode, GitHub Copilot, Amp Code và nhiều agent khác. Agent CLI nào không có trong danh sách vẫn chạy được mà không cần cấu hình. Bạn cũng có thể thêm agent tuỳ chỉnh.
- **Ngoài một máy.** Có CLI `superset`, SDK TypeScript, MCP server, truy cập từ xa, ứng dụng iPhone/iPad và tự động hoá (chạy agent theo lịch hoặc khi có sự kiện). Theo README, các phần như ứng dụng di động và tự động hoá thuộc gói Pro.
- **Tuỳ biến.** Có script setup/teardown cho từng workspace, preset terminal, kết nối Slack và Linear, mở nhanh trong IDE, đổi giao diện, phím tắt và kết nối nhà cung cấp mô hình như OpenRouter, Bedrock, Vertex hay Vercel AI Gateway.

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

Phần này chỉ gồm những gì README nói.

- **Hệ điều hành:** macOS (cả Apple Silicon và Intel). Linux có bản AppImage x64 nhưng chỉ ở mức thử nghiệm. **Windows chưa có.**
- **Phần mềm bắt buộc:** chỉ cần cài Git. `gh` (GitHub CLI) là tuỳ chọn, dùng cho các luồng làm việc với pull request, và Paradev đề nghị cài giúp bạn.
- **Agent code:** Paradev không kèm agent. Bạn cần có ít nhất một agent CLI (ví dụ Claude Code hoặc Codex) cùng gói đăng ký hoặc API key của chính bạn.
- **Cho ứng dụng di động:** cần gói Paradev Pro và iOS 26 hoặc iPadOS 26 trở lên.
- **Nếu muốn build từ mã nguồn (dành cho người đóng góp):** Bun phiên bản 1.4.3 trở lên, `docker`, `jq` và `gh`. Người chỉ muốn dùng thì không cần phần này.

```note
Paradev không proxy các lệnh gọi mô hình. Mọi chi phí và giới hạn dùng đến từ gói đăng ký hoặc API key của agent bạn chọn, không phải từ Paradev. Chạy nhiều agent song song cũng có nghĩa là tiêu hao hạn mức nhanh hơn, nên hãy theo dõi mức dùng của bạn.
```

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

```steps
- Cài Git | Bảo đảm máy đã có Git, đây là thứ duy nhất bắt buộc
- Tải app | Tải file .dmg (macOS) hoặc AppImage (Linux) từ trang Releases
- Thêm repo | Mở Paradev, thêm một repository có sẵn hoặc clone mới
- Tạo workspace | Chọn agent CLI và mô tả việc cần làm
- Cài CLI (tuỳ chọn) | Dùng lệnh superset để điều khiển từ terminal
```

### Cài Git

Paradev cần Git để tạo worktree. Nếu máy bạn chưa có, hãy tải từ trang chủ Git. README không ghi lệnh cài Git cụ thể, nên bạn cứ dùng cách cài thông thường của hệ điều hành. Muốn kiểm tra đã có chưa, mở Terminal (trên macOS: ứng dụng Terminal) và gõ:

```bash
git --version
```

Nếu máy in ra số phiên bản là ổn.

### Tải ứng dụng

Vào trang Releases của repo trên GitHub (phần "latest") và chọn đúng bản:

- macOS chip Apple Silicon (M1/M2/M3…): file `Superset-arm64.dmg`
- macOS chip Intel: file `Superset-x64.dmg`
- Linux x64: file `Superset-x86_64.AppImage` (thử nghiệm)

Tên file vẫn còn chữ "Superset" vì app đổi tên từ Superset sang Paradev. Với file .dmg, bạn mở file và kéo ứng dụng vào thư mục Applications theo cách quen thuộc của macOS. Người mới hay vấp ở chỗ chọn nhầm bản: nếu không chắc chip máy mình là gì, bạn bấm biểu tượng quả táo, chọn "About This Mac" để xem.

### Thêm repository và tạo workspace

Bước này làm trong giao diện, README không có lệnh. Bạn làm theo thứ tự:

1. Mở Paradev, thêm một repository từ máy tính của bạn hoặc clone một repo mới.
2. Tạo workspace, chọn agent CLI bạn muốn dùng và mô tả một thay đổi nhỏ.
3. Xem patch trong khu **Changes**, chạy test liên quan và xem thử app trong khung trình duyệt trước khi commit.

Nên bắt đầu bằng một việc thật nhỏ. Hướng dẫn chi tiết hơn có ở bài "Your First Parallel Session" trong tài liệu chính thức của dự án.

### Cài CLI `superset` (tuỳ chọn)

CLI đã đi kèm trong app desktop. Nếu muốn cài riêng, README ghi hai cách. Cách thứ nhất dùng curl:

```bash
curl -fsSL https://paradev.com/cli/install.sh | sh
```

Cách thứ hai dùng Homebrew:

```bash
brew install paradevai/tap/superset
```

Lệnh vẫn tên là `superset` dù app đã đổi tên Paradev. Với lệnh curl, bạn đang chạy một script tải từ mạng, nên chỉ dùng khi bạn tin nguồn đó.

### Chạy từ mã nguồn (chỉ khi muốn đóng góp)

Bước này không cần thiết nếu bạn chỉ muốn dùng app. README hướng dẫn clone repo, thêm vào app Paradev đã cài rồi tạo workspace cho thay đổi của bạn:

```bash
git clone https://github.com/paradevai/paradev.git
```

Sau đó, trong terminal của workspace, chạy:

```bash
./.paradev/setup.local.sh
bun run dev
```

Phải chạy `setup.local.sh` một lần cho mỗi worktree mới. Script này dựng sẵn Postgres, neon-proxy và Redis cục bộ bằng Docker, nên bạn cần Docker đang chạy. Bạn không cần tài khoản Neon hay khoá bên thứ ba. Đăng nhập bằng nút "Sign in as dev". Hướng dẫn đầy đủ nằm trong file `DEVELOPMENT.md` của repo.

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

Với người dùng thường, dấu hiệu thành công khá rõ:

- Ứng dụng Paradev mở lên được và bạn thêm được repository.
- Bạn tạo được một workspace, agent bạn chọn khởi chạy trong terminal của workspace đó.
- Thanh bên hiện trạng thái agent (đang làm, xong hoặc chờ bạn) và khu **Changes** hiện patch sau khi agent sửa file.

Nếu bạn cài thêm CLI, README không nêu một lệnh kiểm tra riêng. Bạn có thể xem trang "CLI getting started" trong tài liệu chính thức để biết các lệnh con. Với bản chạy từ mã nguồn, mốc thành công là ứng dụng dev mở lên và bạn đăng nhập được bằng "Sign in as dev".

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

### Sửa hai lỗi cùng lúc

Bạn là lập trình viên và backlog đang có hai lỗi nhỏ ở hai chỗ khác nhau. Thay vì làm lần lượt, bạn tạo hai workspace trên cùng repo, mỗi workspace chọn một agent (hoặc cùng một agent) và giao một lỗi. Prompt mẫu cho workspace thứ nhất:

```text
Trang đăng nhập báo lỗi khi mật khẩu có ký tự đặc biệt. Hãy tìm nguyên nhân, sửa và thêm một test.
```

Bạn xem thanh bên để biết con nào xong. Khi một agent xong, bạn mở Changes, đọc patch, chạy test rồi commit. Kết quả: hai nhánh riêng, mỗi nhánh một lỗi, sẵn sàng mở pull request.

> Agent đâu có mệt, người chờ agent mới mệt. Cho chúng làm song song thì mình chỉ còn việc đọc và duyệt.
>
> — Ông T

### Thử hai cách cho cùng một vấn đề

Bạn chưa biết nên viết tính năng lọc đơn hàng theo cách A hay cách B. Tạo hai workspace, giao cùng yêu cầu nhưng gợi ý hướng khác nhau, rồi so sánh kết quả. README nói thẳng cách dùng này: thử hai hướng và giữ hướng bạn thích. Kết quả: bạn chọn bằng cách đọc code thật thay vì đoán, bỏ nhánh còn lại.

### Chỉnh giao diện bằng cách chỉ vào

Bạn làm website bán hàng và muốn nút "Mua ngay" to hơn, màu khác. Chạy máy chủ dev trong workspace, mở khung trình duyệt, bấm **Design** và chọn đúng nút đó. Sau đó nhập yêu cầu:

```text
Đổi nút này sang màu xanh lá, to hơn một chút và bo góc tròn hơn.
```

Paradev gửi yêu cầu cho agent kèm thông tin về phần tử bạn chọn. Bạn xem lại kết quả ngay trong trình duyệt tích hợp rồi mới commit.

### Nhờ agent sửa theo góp ý trên pull request

Đồng nghiệp để lại nhận xét trên một pull request. Bạn mở **Pull requests → Code**, chọn các dòng diff cần sửa và gửi góp ý thẳng cho một phiên agent đang chạy hoặc mở phiên mới. Việc đăng nhận xét lên GitHub là tuỳ chọn. Kết quả: agent cập nhật code theo đúng dòng bạn chỉ, bạn kiểm tra lại rồi push.

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

### Không thấy bản cho Windows

Đúng như README ghi, Windows chưa có bản chính thức. Hiện bạn dùng macOS, hoặc thử bản AppImage x64 trên Linux (chỉ ở mức thử nghiệm). Nếu bạn chỉ có Windows, hãy theo dõi trang Releases hoặc chọn công cụ khác cho đến khi có bản.

### Tạo workspace xong nhưng agent không chạy

Paradev không kèm agent, nên máy bạn phải có sẵn agent CLI đó và đã đăng nhập hoặc điền khoá của nó. Hãy thử chạy trực tiếp agent trong Terminal thường để xem nó có hoạt động không. Nếu agent chạy được ngoài Paradev, kiểm tra lại cài đặt launch command trong Settings → Agents.

### Hai nhánh sửa cùng một file và bị xung đột

Worktree chỉ tách file làm việc, chứ không ngăn xung đột khi gộp. Cách an toàn: giao các việc chạm vào những phần code khác nhau, và merge từng nhánh một, xem lại diff trước khi gộp. Gặp xung đột thì xử lý như Git bình thường.

### Chạy `setup.local.sh` báo lỗi (khi build từ mã nguồn)

Script cần Docker để dựng Postgres, neon-proxy và Redis. Kiểm tra Docker đã chạy chưa, và các công cụ `docker`, `jq`, `gh` đã cài chưa (README gợi ý `brew install jq gh`). Nhớ rằng script phải chạy một lần ở mỗi worktree mới. Nếu vẫn lỗi, mở mục troubleshooting trong `DEVELOPMENT.md`.

### Ứng dụng di động không kết nối được máy của bạn

Ứng dụng iPhone/iPad cần gói Pro và iOS 26 hoặc iPadOS 26 trở lên. Muốn vào workspace trên máy của chính bạn, phải bật Remote Access và giữ máy đó thức, có mạng. Máy ngủ thì phía điện thoại sẽ không với tới được.

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

**Điểm mạnh:** mã nguồn mở theo giấy phép MIT, bản desktop miễn phí. Bạn giữ nguyên gói đăng ký agent đang dùng. Hỗ trợ rất nhiều agent CLI. Gom được terminal, review, pull request và xem thử trình duyệt vào một chỗ. Dự án còn được cập nhật trong vài tháng gần đây.

**Giới hạn:** chưa có Windows, Linux mới ở mức thử nghiệm. Nó giả định bạn đã quen một agent trong terminal và biết Git cơ bản. Nó không thay thế việc đọc code và test của bạn. Worktree không cô lập tiến trình và không chống xung đột. Một số tính năng (di động, tự động hoá) thuộc gói Pro. README cũng tự nhận danh sách tính năng thay đổi nhanh, nên bạn nên xem changelog.

**Khi nên chọn cách khác:** nếu bạn dùng Windows, nếu chỉ làm một việc một lần trong một repo nhỏ (một agent trong terminal là đủ), hoặc nếu bạn chưa dùng agent code bao giờ. Khi đó hãy làm quen với một agent trước, rồi quay lại Paradev khi thấy mình cần chạy nhiều việc cùng lúc.

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

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

README nói bản desktop miễn phí mãi mãi: chạy agent song song trên máy của bạn sẽ không bao giờ yêu cầu trả tiền. Một số tính năng như ứng dụng iPhone/iPad và tự động hoá thuộc gói Pro. Bạn vẫn phải tự trả phí cho gói đăng ký hoặc API của agent bạn dùng.

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

Chưa. README ghi Windows chưa có bản. Hỗ trợ chính là macOS (Apple Silicon và Intel), còn Linux có bản AppImage x64 ở mức thử nghiệm.

### Paradev có tự cung cấp AI không, có cần GPU không?

Không. Paradev không phải là agent code và không proxy các lệnh gọi mô hình. Bạn mang agent và gói đăng ký của chính mình như Claude Code hay Codex. Tư liệu không đề cập yêu cầu GPU.

### Paradev khác gì Cursor, Codex app hay Conductor?

Mô tả của tác giả định vị Paradev là lựa chọn mã nguồn mở thay cho Codex App và Conductor, tập trung chạy nhiều agent CLI song song bằng gói đăng ký của bạn. Repo có các trang so sánh riêng với Cursor, Codex app và Conductor trên trang chủ dự án. Bài này chưa có thêm thông tin so sánh chi tiết.

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

README nêu nguyên tắc "Private by Default": bạn tự chọn agent, nhà cung cấp và tích hợp muốn kết nối. Paradev cũng không proxy các lệnh gọi mô hình. Tư liệu chưa có thêm chi tiết về cách lưu trữ dữ liệu, nên với code nhạy cảm bạn nên đọc kỹ tài liệu và SECURITY.md.

### Paradev có phải Apache Superset không?

Không. Paradev trước đây tên Superset nên lệnh CLI vẫn là superset, nhưng nó không liên quan gì đến Apache Superset, công cụ báo cáo và phân tích dữ liệu.

### Cần cài gì trước khi dùng?

Chỉ cần Git là bắt buộc. GitHub CLI (gh) là tuỳ chọn để dùng các luồng làm việc với pull request. Bạn cũng cần sẵn một agent CLI như Claude Code hoặc Codex cùng tài khoản của nó.
