Bỏ qua tới nội dung
Ông T.vn

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

11 phút đọcCập nhật

Bài này là một góc nhìn khác về ParadevAI/Paradev — 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: 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: chạy nhiều AI coding agent song song trên một máy — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Paradev (trước đây tên Superset) là ứng dụng desktop mã nguồn mở để chạy nhiều CLI coding agent như Claude Code, Codex, OpenCode cùng lúc. Mỗi tác vụ có Git worktree, nhánh và terminal riêng. Cài rất đơn giản vì chỉ cần tải bản cài, nhưng hiện chỉ có macOS và Linux (thử nghiệm), chưa có Windows.

Paradev là một ứng dụng desktop mã nguồn mở để chạy nhiều AI coding agent chạy trong terminal (Claude Code, Codex, OpenCode, Gemini CLI, Cursor Agent…) cùng lúc trên một repo. 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 này trước đây tên Superset, nên lệnh CLI của nó vẫn là superset.

Bạn nên đọc bài này nếu đã quen dùng một agent lập trình trong terminal và thấy mình đang loay hoay với hàng loạt tab terminal và nhánh Git. Nếu bạn chưa từng dùng agent nào thì nên làm quen một agent trước, vì Paradev không phải là agent. Nó chỉ là cái bàn làm việc xung quanh các agent.

Điểm đáng giá nhất: bạn dùng luôn gói đăng ký và API key sẵn có của mình, Paradev không đứng giữa gọi mô hình thay bạn. README cũng nói ứng dụng desktop miễn phí mãi mãi và toàn bộ mã nguồn dùng giấy phép MIT. Repo hiện có khoảng 16.268 sao và 1.457 fork.

Ứng dụng

ParadevAI/Paradev

Ứng dụng desktop mã nguồn mở giúp chạy song song nhiều agent lập trình như Claude Code, Codex trong các Git worktree riêng, kèm review diff và trình duyệt xem thử.

★ 16kTypeScriptMIT
Xem repo trên GitHub

I.Paradev làm được gì

Dưới đây là các tính năng chính, kèm lợi ích thực tế khi dùng.

  • Một worktree cho mỗi tác vụ. Bạn giao agent A sửa lỗi đăng nhập, agent B viết thêm trang báo cáo, cả hai chạy cùng lúc trên hai bản sao riêng của repo. Bạn không phải tự tạo nhánh và thư mục. README lưu ý worktree chỉ tách file làm việc, không phải sandbox và không ngăn được xung đột khi merge.
  • Xem lại thay đổi ngay trong app. Ngăn Changes cho bạn xem diff, commit, push và mở pull request. Ngăn pull request hiện kiểm tra (checks), các luồng review và nút merge. Bạn đỡ phải chuyển qua lại giữa nhiều cửa sổ.
  • Trình duyệt tích hợp. Bạn xem thử dev server của từng workspace ngay trong app. Cổng (port) được nhận diện theo từng workspace, nên hai nhánh cùng chạy web cũng không đè nhau.
  • 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ó âm báo khi xong và huy hiệu trên dock khi cần bạn chú ý.
  • Chế độ Design. Trong ngăn trình duyệt, bạn chọn một phần tử giao diện rồi gửi yêu cầu sửa kèm ngữ cảnh phần tử đó cho agent. Người không rành code cũng nói được kiểu «nút này to hơn, đổi màu xanh».
  • Terminal tiện tay. Có tab, chia ngăn không giới hạn, preset và phiên làm việc không mất khi khởi động lại. Nhấn ⌘I để mở trình soạn prompt nhiều dòng, có thể nhắc tên file bằng @.
  • Mở rộng ra ngoài một máy (gói Pro): máy từ xa, ứng dụng iPhone/iPad, và automation chạy agent theo lịch hoặc theo sự kiện.
  • Công cụ để script và để agent tự điều khiển. Có CLI superset, TypeScript SDK và MCP server, để agent hoặc script tạo và quản lý workspace.
  • Tuỳ biến. Có skill dựng sẵn dạng superset:*, script setup/teardown cho workspace, preset terminal, kết nối Slack và Linear, mở nhanh bằng IDE như Cursor hay VS Code, và nối thêm nhà cung cấp như OpenRouter, Bedrock, Vertex hay Vercel AI Gateway.

Cần nhớ: Paradev không phải coding agent. Bạn phải có sẵn agent và gói đăng ký hoặc API key của riêng bạn.

II.Cần chuẩn bị gì

Theo README, để dùng ứng dụng bạn cần:

  • Hệ điều hành: macOS (cả Apple Silicon lẫn Intel) là nền tảng chính. Linux có bản AppImage x64 ở mức thử nghiệm. Windows chưa có.
  • Git: đây là thứ duy nhất README yêu cầu phải cài sẵn.
  • gh (GitHub CLI): tuỳ chọn, bật các luồng làm việc với pull request. README nói Paradev sẽ đề nghị cài giúp bạn.
  • Một agent lập trình trong terminal cùng gói đăng ký hoặc API key của agent đó, ví dụ Claude Code hay Codex. Paradev không gọi mô hình hộ bạn.
  • Gói Pro chỉ cần nếu bạn muốn dùng app di động, automation và các tính năng từ xa. App di động cần iOS 26 hoặc iPadOS 26 trở lên.

Nếu bạn muốn tự build từ mã nguồn để đóng góp, cần thêm Bun từ 4.3 trở lên theo ghi chú trong README (phiên bản được ghim trong file .bun-version), cùng docker, jq và gh. README còn nhắc rõ: chỉ dùng thôi thì cài app là đủ.

Paradev không cung cấp mô hình AI. Chi phí gọi mô hình vẫn nằm ở gói đăng ký hoặc API key của agent bạn dùng. Chạy nhiều agent song song nghĩa là dùng hạn mức nhanh hơn, hãy để ý hạn mức của mình.

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

  1. Kiểm tra máyDùng macOS (hoặc Linux thử nghiệm) và cài sẵn Git
  2. Tải bản càiLấy file .dmg hoặc AppImage từ trang Releases của repo
  3. Thêm repositoryMở Paradev, thêm repo có sẵn trên máy hoặc clone mới
  4. Tạo workspaceChọn agent CLI và mô tả một thay đổi nhỏ
  5. Cài CLI (tuỳ chọn)Dùng lệnh curl hoặc brew nếu cần lệnh superset riêng

A.Kiểm tra máy và cài Git

Bước này chỉ cần nếu máy bạn chưa có Git. README chỉ yêu cầu duy nhất Git, tải ở trang chủ git-scm.com. Nếu bạn dùng Windows, hiện chưa có bản Paradev cho Windows, và README chưa ghi mốc phát hành nào. Bạn nên theo dõi trang Releases của repo.

B.Tải ứng dụng desktop

Vào trang Releases của repo ParadevAI/Paradev trên GitHub (bản mới nhất). README liệt kê các file như sau:

  • macOS Apple Silicon: Superset-arm64.dmg
  • macOS Intel: Superset-x64.dmg
  • Linux x64 (thử nghiệm): Superset-x86_64.AppImage

Tên file vẫn mang chữ Superset vì repo mới đổi tên. Đừng thấy lạ mà tưởng tải nhầm. Chưa biết máy Mac của bạn là chip nào thì bấm biểu tượng Apple ở góc trái màn hình, chọn «Giới thiệu về máy Mac» để xem. Mở file .dmg rồi làm theo cách cài app macOS quen thuộc.

C.Thêm repository và tạo workspace

Mở Paradev, thêm một repository từ máy bạn hoặc clone một repo mới. Sau đó tạo workspace, chọn agent CLI và mô tả một thay đổi nhỏ muốn làm. Đây là các bước README mô tả cho lần chạy đầu tiên. Nếu cần xem từng màn hình, README dẫn tới trang tài liệu «Your First Parallel Session» trên docs.paradev.com.

Chỗ người mới hay vấp: agent bạn chọn (ví dụ Claude Code) phải được cài và đăng nhập trên máy từ trước. Paradev chỉ chạy nó trong terminal của app.

D.Cài CLI superset (tuỳ chọn)

CLI đi kèm sẵn trong app desktop. Nếu muốn cài riêng, README đưa hai cách. Mở Terminal và chạy một trong hai:

Terminal
curl -fsSL https://paradev.com/cli/install.sh | sh
# hoặc
brew install paradevai/tap/superset

Lệnh đầu tải script cài đặt từ trang của dự án rồi chạy ngay, nên chỉ dùng khi bạn tin nguồn đó. Lệnh thứ hai dùng Homebrew, bạn cần có Homebrew trước. Cách dùng CLI chi tiết nằm ở docs.paradev.com/cli/getting-started, README không liệt kê các lệnh con.

E.Build từ mã nguồn (chỉ khi muốn đóng góp)

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

Terminal
git clone https://github.com/paradevai/paradev.git

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

Terminal
./.paradev/setup.local.sh
bun run dev

README dặn chạy setup.local.sh một lần trong mỗi worktree mới. Script này cấu hình danh tính app và cổng riêng cho workspace, để bản dev chạy cạnh được với bản Paradev đã cài. Bạn không cần tài khoản Neon hay thông tin bên thứ ba, vì script tự dựng Postgres, neon-proxy và Redis cục bộ bằng Docker. Vào app bằng nút «Sign in as dev». Hướng dẫn đầy đủ nằm trong file DEVELOPMENT.md của repo.

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

README không đưa ra một lệnh kiểm tra duy nhất. Dấu hiệu thành công theo luồng chuẩn của nó là:

  • App mở được, bạn thêm được repository vào.
  • Bạn tạo được workspace, agent đã chọn khởi động trong terminal của workspace đó.
  • Sau khi agent làm xong, ngăn Changes hiện ra bản vá (diff) để bạn xem.
  • Ngăn trình duyệt xem thử được ứng dụng đang chạy của bạn (nếu dự án của bạn có dev server).
  • Thanh bên hiện trạng thái agent: đang làm, xong hoặc chờ bạn.

Nếu cài CLI riêng, README chưa ghi lệnh kiểm tra phiên bản. Bạn có thể xem trang CLI getting-started trên docs.paradev.com.

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

A.Dev mới giao hai việc cho hai agent cùng lúc

Bối cảnh: bạn là lập trình viên mới, đang làm một web bán hàng. Có hai việc độc lập: sửa lỗi giỏ hàng và thêm trang liên hệ. Trước đây bạn làm lần lượt.

Cách làm: thêm repo vào Paradev, tạo hai workspace, mỗi cái chọn Claude Code hoặc Codex. Mô tả việc ở mỗi workspace bằng một câu rõ ràng, ví dụ «Sửa lỗi khi số lượng giỏ hàng bằng 0 vẫn cho thanh toán». Trong lúc agent chạy, thanh bên cho bạn biết cái nào xong trước.

Kết quả: mỗi việc nằm trên một nhánh riêng. Bạn xem diff từng cái trong Changes, chạy test, rồi commit và push. Hai bản sửa không lẫn vào nhau.

Bạn không cần agent giỏi hơn. Bạn cần agent không giẫm chân nhau.

Ông T

B.So hai hướng giải cho cùng một bài toán

Bối cảnh: bạn chưa chắc nên viết tính năng lọc sản phẩm theo cách nào. README gợi ý đúng tình huống này: thử hai cách tiếp cận cho cùng một vấn đề và giữ lại cách bạn thích.

Cách làm: tạo hai workspace từ cùng một repo, giao cùng một yêu cầu cho hai agent khác nhau (hoặc cùng agent nhưng hướng dẫn khác nhau). Đọc hai diff cạnh nhau.

Kết quả: bạn chọn bản gọn hơn để tạo pull request, bỏ bản còn lại. Chi phí là hạn mức dùng agent thêm một lượt.

C.Nhờ agent sửa pull request theo góp ý

Bối cảnh: đồng nghiệp review pull request và để lại vài chỗ cần sửa. Bạn không muốn tự gõ lại từng điểm.

Cách làm: mở Pull requests → Code, chọn các dòng diff cần sửa rồi gửi góp ý cho một phiên agent đang chạy hoặc một phiên mới. Việc đăng lên GitHub là tuỳ chọn.

Kết quả: agent nhận đúng đoạn code và nội dung góp ý, tạo bản sửa để bạn xem lại và đẩy lên.

D.Chủ shop nhờ chỉnh giao diện bằng Design mode

Bối cảnh: bạn có một trang web nhỏ do thuê dev làm, muốn đổi nút «Mua ngay» sang màu khác và to hơn, nhưng không biết file nào chứa nút đó.

Cách làm: mở ngăn trình duyệt của workspace, chuyển sang Design, bấm chọn nút cần sửa và gõ yêu cầu bằng tiếng thường. Paradev gửi yêu cầu kèm thông tin phần tử đó cho agent.

Kết quả: agent sửa đúng chỗ, bạn xem lại ngay trong trình duyệt tích hợp. Để an toàn, vẫn nên xem diff trong Changes trước khi commit. Lưu ý: việc này vẫn cần có repo chạy được trên máy và một agent đã đăng nhập.

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

A.Không tìm thấy bản cho Windows

README nói rõ Windows chưa có. Đừng cố tìm bản cài không chính thức. Nếu chỉ có máy Windows, bạn nên chọn công cụ khác hoặc theo dõi trang Releases. Linux có bản AppImage nhưng ở mức thử nghiệm.

B.Agent không khởi động hoặc báo chưa đăng nhập

Paradev không cung cấp agent hay mô hình. Hãy mở terminal trong workspace và kiểm tra agent đó có chạy được không, đã đăng nhập hay đã có key chưa. Cài và đăng nhập agent theo tài liệu của chính agent đó.

C.Các tính năng PR không hoạt động

Luồng pull request cần gh. README nói gh là tuỳ chọn và Paradev đề nghị cài giúp. Nếu không thấy các nút PR, hãy cài và đăng nhập gh rồi thử lại.

D.Hai agent sửa trùng file, merge bị xung đột

Worktree tách file làm việc nhưng không ngăn xung đột. Nếu hai tác vụ cùng đụng một phần code, hãy merge lần lượt, xem diff kỹ ở bước đầu rồi mới merge cái sau. Cách phòng tốt nhất là giao việc ít chồng chéo.

E.Build từ mã nguồn bị lỗi

Kiểm tra lại các yêu cầu: Bun đúng phiên bản (xem .bun-version), Docker đang chạy, đã cài jq và gh. Chạy ./.paradev/setup.local.sh một lần trong mỗi worktree mới. Nếu vẫn lỗi, xem mục xử lý sự cố trong DEVELOPMENT.md.

VII.Có nên dùng không

Điểm mạnh: giải đúng bài toán chạy nhiều agent song song mà không phải tự quản lý nhánh. Bạn dùng được nhiều loại agent khác nhau trong cùng một app. Có sẵn diff, PR, trình duyệt xem thử. Mã nguồn MIT, app desktop miễn phí, và README ghi rõ bạn tự chọn kết nối nào.

Giới hạn: chưa có Windows. Linux mới là thử nghiệm. Paradev không thay thế agent nên bạn vẫn phải trả tiền cho agent và mô hình. Worktree không phải sandbox, tức là agent vẫn có thể chạy lệnh trên máy bạn, nên hãy chỉ chạy trên repo bạn tin. Các tính năng như app di động, automation hay truy cập từ xa cần gói Pro.

Khi nào nên chọn cách khác: nếu bạn dùng Windows, nếu bạn chỉ chạy một agent một lúc và quản lý một nhánh là đủ, hoặc nếu bạn muốn một công cụ trọn gói có luôn mô hình thì một agent đơn lẻ trong terminal có thể đơn giản hơn. README có trang so sánh với Cursor, Codex app và Conductor trên trang chủ dự án nếu bạn đang cân nhắc.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

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

README ghi ứng dụng desktop miễn phí mãi mãi và chạy agent song song trên máy của bạn sẽ không bao giờ phải trả tiền. Mã nguồn dùng giấy phép MIT. Một số tính năng như app iPhone/iPad và automation thuộc gói Pro.

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

Hiện chưa. README ghi Windows chưa có bản cài. macOS (Apple Silicon và Intel) là nền tảng chính, còn Linux có bản AppImage x64 ở mức thử nghiệm.

Paradev có phải là một AI coding agent không?

Không. Paradev là ứng dụng bao quanh các agent như Claude Code, Codex, OpenCode, Gemini CLI, Cursor Agent. Bạn dùng gói đăng ký hoặc API key của riêng mình, và Paradev không chuyển tiếp các lệnh gọi mô hình.

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

README nói chỉ cần Git. gh là tuỳ chọn, giúp dùng các luồng pull request và Paradev có đề nghị cài giúp. Bạn cũng cần một agent CLI đã đăng nhập để có thứ chạy.

Paradev có liên quan đến Superset (Apache Superset) không?

Không. Paradev trước đây tên Superset nên lệnh CLI vẫn là superset, nhưng README nói rõ nó không liên quan đến Apache Superset, công cụ business intelligence.

Các agent chạy song song có bị xung đột file không?

Mỗi tác vụ có worktree và nhánh riêng nên file làm việc được tách ra. Tuy vậy README lưu ý worktree không phải sandbox và không ngăn được xung đột khi merge, nên bạn vẫn cần xem diff trước khi hợp nhất.

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

README ghi mục Private by Default với ý chính là bạn tự chọn kết nối agent, nhà cung cấp và tích hợp nào. Tư liệu chưa có thêm chi tiết về cách xử lý dữ liệu, nên bạn nên đọc thêm tài liệu và file SECURITY.md trong repo.

Chuyển nhanh tới mục

  1. I.Paradev làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra máy và cài Git
    2. B.Tải ứng dụng desktop
    3. C.Thêm repository và tạo workspace
    4. D.Cài CLI superset (tuỳ chọn)
    5. E.Build từ mã nguồn (chỉ khi muốn đóng góp)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới giao hai việc cho hai agent cùng lúc
    2. B.So hai hướng giải cho cùng một bài toán
    3. C.Nhờ agent sửa pull request theo góp ý
    4. D.Chủ shop nhờ chỉnh giao diện bằng Design mode
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Không tìm thấy bản cho Windows
    2. B.Agent không khởi động hoặc báo chưa đăng nhập
    3. C.Các tính năng PR không hoạt động
    4. D.Hai agent sửa trùng file, merge bị xung đột
    5. E.Build từ mã nguồn bị lỗi
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.