# Orca: chạy nhiều AI lập trình song song, mỗi việc một worktree — hướng dẫn cài đặt và dùng

> Orca là ứng dụng mã nguồn mở (MIT) để chạy nhiều agent lập trình như Claude Code, Codex cùng lúc, mỗi agent làm trong một worktree riêng, kèm xem diff, trình duyệt và CLI trong một cửa sổ. Bạn dùng chính gói đăng ký agent của mình. Cài trên Windows, macOS, Linux khá dễ: tải bộ cài hoặc dùng Homebrew/AUR.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-11-01 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/orca-chay-nhieu-ai-lap-trinh-song-song-huong-dan-cai-dat

Orca là một ứng dụng (desktop, có thêm bản điện thoại) giúp bạn chạy nhiều agent lập trình AI cùng lúc, như Claude Code hay Codex, mỗi agent làm việc trong một "worktree" riêng để không đạp lên nhau. Trong cùng một cửa sổ bạn có khung chat hoặc terminal, xem diff, trình duyệt và dòng lệnh. Tác giả dùng từ "orchestrator" (người điều phối) để mô tả nó.

Vấn đề nó giải quyết rất đời thường: khi dùng AI viết code, bạn hay phải ngồi chờ một agent xong rồi mới giao việc tiếp. Với Orca, bạn chia việc ra, mỗi việc một workspace tách biệt, nhiều agent chạy song song, còn bạn chỉ việc duyệt kết quả. Repo hiện có khoảng 123.468 sao và 7.803 fork, giấy phép MIT, viết chủ yếu bằng TypeScript.

Nếu bạn là lập trình viên mới, người làm sản phẩm hoặc dân văn phòng đã bắt đầu dùng Claude Code/Codex và thấy một cửa sổ terminal là không đủ, Orca đáng thử. Điểm đáng giá nhất: nó dùng gói đăng ký agent của chính bạn, và agent nào chạy được trong terminal thì chạy được trong Orca.

```repo
- repo | stablyai/orca
- kind | Ứng dụng
- desc | Orca là ứng dụng máy tính và điện thoại để chạy song song nhiều agent lập trình (Claude Code, Codex…), mỗi agent một worktree riêng, có xem diff và CLI.
- stars | 123k
- lang | TypeScript
- license | MIT
```

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

Dưới đây là các tính năng chính, mình diễn giải theo lợi ích khi dùng.

- **Chat hoặc Terminal**: bạn chạy agent bằng giao diện chat hoặc bằng CLI thuần, và chuyển qua lại giữa hai kiểu mà không mất ngữ cảnh cuộc trò chuyện. Người mới thích chat, người quen dòng lệnh thích terminal, Orca cho cả hai.
- **Worktree song song**: mỗi nhiệm vụ nằm trong một môi trường cô lập, nên nhiều agent sửa cùng một dự án mà không giẫm chân nhau.
- **Điều phối agent**: bạn giao một việc lớn cho một agent, nó tự chia nhỏ, khởi động các agent "thợ" trong workspace riêng rồi gom kết quả về cho bạn.
- **Chạy ở bất kỳ đâu**: ghép với một Orca Server từ xa, làm việc trên máy chủ qua SSH, hoặc cho một worktree một máy ảo đám mây riêng. Agent vẫn chạy khi laptop của bạn ngủ.
- **App điện thoại**: ghép với bản desktop để nhận thông báo khi agent cần bạn, trả lời trong chat và giữ công việc chạy khi bạn rời bàn.
- **Duyệt kết quả của AI**: xem diff, ghi chú đúng vào dòng bị thay đổi và gửi phản hồi có trọng tâm lại cho agent.
- **Tích hợp Git**: tạo nháp commit message và pull request từ diff, gửi check bị lỗi hoặc comment review PR cho agent tự sửa.
- **Design Mode**: bấm vào một phần tử bất kỳ trong trình duyệt của Orca để sao chép HTML, style và selector, rồi dán vào chat với agent.
- **GitHub và Linear**: xem task của cả hai ở một chỗ, và mở workspace cho từng task khi sẵn sàng làm.
- **Orca CLI**: những gì bạn làm được trong Orca thì agent cũng làm được qua dòng lệnh: tạo worktree, khởi động worker, điều khiển trình duyệt và ứng dụng desktop, lên lịch tự động hoá.
- **Plugin và chia pane**: theme, trình soạn thảo, ngôn ngữ, panel từ cộng đồng; đặt agent, terminal, trình duyệt và diff cạnh nhau.

Ngoài ra còn một số tiện ích đáng chú ý: kéo thả file hoặc ảnh vào prompt của agent, xem trước ảnh/PDF/Markdown ngay trong workspace, giả lập iOS/Android cho agent tự bấm và kiểm tra, đọc giọng nói để gõ vào prompt, theo dõi mức dùng hạn mức của agent và đổi tài khoản không cần đăng xuất, cùng tính năng Automations để hẹn giờ chạy prompt (ví dụ nâng cấp thư viện hằng đêm, phân loại issue hằng tuần). Tác giả cũng nói danh sách này luôn chậm hơn thực tế vì họ cập nhật mỗi ngày.

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

Theo README, bạn cần:

- **Hệ điều hành**: macOS (cả Apple Silicon và Intel), Windows hoặc Linux cho bản desktop. Bản điện thoại có cho iOS và Android.
- **Một agent lập trình đã có sẵn**: Orca không thay thế Claude Code hay Codex, nó chạy chúng "bằng gói đăng ký của chính bạn". Danh sách agent hỗ trợ rất dài (Claude Code, Codex, Grok, Cursor, GitHub Copilot, OpenCode, Hermes Agent, Goose, Cline, Qwen Code và nhiều agent khác). Bạn cần tự cài và đăng nhập agent bạn chọn theo hướng dẫn của agent đó.
- **Một dự án Git** để thử: tính năng worktree, diff, commit đều xoay quanh Git. README không nói chi tiết yêu cầu này, nhưng đó là logic của worktree.
- **Node 24**: chỉ cần nếu bạn muốn tự chạy từ mã nguồn (package.json yêu cầu Node 24). Người chỉ muốn dùng thì tải bộ cài, không cần Node.

README không nói gì về yêu cầu GPU hay RAM tối thiểu.

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

```steps
- Chọn bản cài | Tải từ trang chủ hoặc dùng trình quản lý gói
- Cài ứng dụng | Chạy bộ cài hoặc lệnh brew/yay
- Cài sẵn agent | Có Claude Code, Codex… đã đăng nhập
- Mở dự án | Thêm một repo Git vào Orca
- Ghép điện thoại | (Tuỳ chọn) cài app iOS/Android để ghép
```

### Chọn bản cài phù hợp

Vào trang tải của dự án (orca.dev/download) hoặc lấy bản dựng trực tiếp từ trang Releases của repo. README liệt kê các bản: macOS Apple Silicon (.dmg), macOS Intel (.dmg), Windows (.exe) và Linux (AppImage). Nếu bạn dùng Windows, chọn file .exe; chạy file như cài phần mềm bình thường.

Chỗ người mới hay vấp trên Mac: Apple Silicon (chip M1, M2…) và Intel là hai bản khác nhau. Bấm vào menu Apple, chọn "Giới thiệu về máy Mac này" để biết máy bạn thuộc loại nào.

### Cài bằng trình quản lý gói (tuỳ chọn)

Nếu bạn quen dòng lệnh, README có sẵn các lệnh sau. Hãy mở Terminal (macOS/Linux) rồi dán vào:

```bash
# macOS (Homebrew)
# Always use the full name; bare `orca` is an unrelated Plotly cask.
brew install --cask stablyai/orca/orca
# Upgrade an existing install
brew upgrade --cask stablyai/orca/orca
# Release candidates (conflicts with the stable cask; uninstall it first)
brew install --cask stablyai/orca/orca@rc

# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin
```

Lệnh đầu cài bản ổn định bằng Homebrew, lệnh thứ hai để nâng cấp. Lưu ý quan trọng: phải gõ tên đầy đủ `stablyai/orca/orca`, vì chữ `orca` đứng một mình là một gói khác không liên quan (của Plotly). Dòng `orca@rc` là bản thử nghiệm, xung đột với bản ổn định nên chỉ dùng khi bạn đã gỡ bản kia. Người dùng Arch Linux dùng `yay -S stably-orca-bin`.

### Cài sẵn và đăng nhập agent

Orca là nơi điều khiển agent, còn agent là phần bạn tự có. Hãy cài Claude Code, Codex hoặc agent khác theo trang hướng dẫn riêng của chúng, đăng nhập bằng gói của bạn, rồi mới quay lại Orca. README chưa ghi từng bước cài agent, nên bạn xem tài liệu của chính agent đó.

### Mở dự án đầu tiên

Mở Orca và thêm một thư mục dự án Git của bạn. README không mô tả từng cú nhấp chuột, vì vậy hãy xem phần tài liệu về mô hình worktree (orca.dev/docs/model/worktrees) để biết cách tạo workspace. Nên thử trên một dự án nhỏ hoặc bản sao, đừng thử đầu tiên trên dự án quan trọng nhất.

### Ghép với điện thoại (tuỳ chọn)

iOS có trên App Store (tên "Orca IDE"). Android tải file APK từ trang orca.dev/download/android; README có kèm hướng dẫn cài APK ở orca.dev/docs/android-apk. Sau khi cài, bạn ghép với bản desktop để theo dõi và điều khiển agent từ điện thoại.

```note
Mỗi agent chạy bằng gói đăng ký của bạn, nên chạy nhiều agent song song có thể ngốn hạn mức nhanh hơn bạn nghĩ. Orca có mục theo dõi mức dùng và thời điểm reset, hãy xem nó trước khi giao việc lớn. Đừng dán API key hay mật khẩu vào prompt gửi cho agent.
```

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

README không đưa một lệnh kiểm tra chính thức, nên mình gợi ý cách thử đơn giản dựa trên chức năng của app:

- Mở Orca, thêm một dự án Git, tạo một workspace mới và khởi động agent bạn đã cài. Nếu khung chat hoặc terminal hiện ra và agent trả lời, bạn đã cài xong.
- Thử gõ một yêu cầu nhỏ như "giải thích cấu trúc thư mục dự án này". Agent trả lời được là kết nối ổn.
- Nếu dùng Homebrew, gõ `brew upgrade --cask stablyai/orca/orca` để chắc chắn bản cài hợp lệ: nếu đã mới nhất, Homebrew sẽ không có gì để nâng cấp.
- Với điện thoại: nếu bạn nhận được thông báo khi agent cần bạn, tức là đã ghép thành công.

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

Dưới đây là vài tình huống bám đúng tính năng README nêu. Các câu lệnh mẫu là prompt bạn gõ cho agent, không phải lệnh của Orca.

### Dev mới sửa ba lỗi nhỏ cùng lúc

Bạn đang làm website và có ba lỗi nhỏ: sai chính tả menu, nút không bấm được trên điện thoại, trang liên hệ thiếu ô số điện thoại. Thay vì sửa lần lượt, bạn tạo ba worktree, mỗi worktree một agent. Prompt mẫu cho agent đầu: "Sửa lỗi chính tả trong menu chính, chỉ đổi đúng chỗ cần thiết". Ba agent chạy cùng lúc, mỗi bên có nhánh riêng nên không ghi đè lên nhau. Kết quả: bạn có ba diff sẵn để xem, thay vì ngồi chờ từng việc.

> Để agent chạy việc, còn bạn chỉ làm một việc: đọc diff và quyết định.
>
> — Ông T

### Duyệt diff và gửi phản hồi chính xác

Agent làm xong, bạn mở diff trong Orca, thấy một dòng code bạn không hiểu. Bạn ghi chú ngay trên dòng đó, ví dụ "đoạn này vì sao đổi? giữ logic cũ", rồi gửi lại cho agent. Phản hồi gắn đúng chỗ nên agent ít hiểu nhầm hơn so với một câu chat chung chung. Khi đã ưng, bạn nhờ Orca soạn nháp commit message và pull request từ diff, rồi tự đọc lại trước khi gửi.

### Người làm giao diện chỉ cho agent đúng phần tử cần sửa

Bạn là chủ shop tự quản trị trang bán hàng và muốn đổi màu một nút. Mở trang trong trình duyệt của Orca, bật Design Mode, bấm vào nút đó. Orca sao chép HTML, style và selector của nút. Bạn dán vào chat và viết: "Đổi nút này thành màu xanh lá, giữ nguyên kích thước". Agent biết chính xác phần tử nào, khỏi đoán. Kết quả là thay đổi nhỏ, gọn, dễ kiểm tra bằng diff.

### Hẹn giờ việc lặp lại và theo dõi từ xa

Với Automations, bạn có thể lên lịch một prompt chạy định kỳ trên một repo, README nêu ví dụ như nâng cấp thư viện hằng đêm, phân loại issue hằng tuần hoặc rà test chập chờn. Sáng ra bạn mở app (hoặc điện thoại) xem kết quả. Khi agent cần quyết định, điện thoại sẽ báo để bạn trả lời ngay trong chat. Vì chức năng này cho agent tự chạy, hãy bắt đầu bằng việc ít rủi ro và luôn xem diff trước khi gộp.

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

README không có mục xử lý sự cố, nên các lỗi sau là những vấp phổ biến với loại công cụ này; nếu gặp vấn đề lạ, hãy xem tài liệu trên trang chủ hoặc mục Issues của repo.

- **Cài nhầm gói `orca` bằng Homebrew**: nếu gõ `brew install --cask orca` bạn sẽ cài một gói khác của Plotly. Gỡ nó đi và dùng đúng tên đầy đủ `stablyai/orca/orca`.
- **Mở Orca nhưng agent không chạy**: thường do agent chưa được cài hoặc chưa đăng nhập. Mở một terminal thường, chạy thử agent đó trước; nếu terminal cũng không chạy được thì sửa ở phía agent.
- **Mac chặn mở ứng dụng tải về**: macOS đôi khi hỏi xác nhận với phần mềm tải ngoài App Store. Hãy chắc là bạn tải từ trang chính thức hoặc trang Releases của repo rồi mới cho phép mở.
- **Hết hạn mức giữa chừng**: chạy nhiều agent cùng lúc dùng hạn mức nhanh. Xem mục theo dõi mức dùng trong Orca, giảm số agent song song hoặc đổi sang tài khoản khác khi cần.
- **Bản RC xung đột với bản ổn định**: README cảnh báo rõ. Gỡ bản đang cài trước khi cài bản kia.

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

**Điểm mạnh**: mã nguồn mở MIT, miễn phí theo README, dùng gói agent bạn đã có nên không phải trả thêm cho một lớp trung gian về mặt giấy tờ. Hỗ trợ rất nhiều agent, không khoá bạn vào một hãng. Worktree song song, xem diff và ghi chú theo dòng giúp việc duyệt code của AI bớt rối. Có bản điện thoại và chế độ chạy từ xa, hợp với việc để agent làm lâu.

**Giới hạn**: Orca là công cụ cho người làm việc với code và Git, nên nếu bạn chỉ cần hỏi đáp với AI hoặc viết văn bản thì không cần đến nó. Nó không thay agent: bạn vẫn phải có và trả tiền cho gói agent riêng. Chạy nhiều agent cùng lúc dễ tốn hạn mức và dễ sinh nhiều thay đổi cần đọc, vì vậy bạn vẫn phải kiểm tra kỹ. README cũng nhắc đến việc thu thập dữ liệu sử dụng ẩn danh, có trang riêng giải thích cách tắt, hãy đọc nếu bạn quan tâm quyền riêng tư. Dự án cập nhật rất nhanh (tác giả nói ship hằng ngày), nên giao diện và tính năng có thể thay đổi giữa các lần dùng.

**Khi nào chọn cách khác**: nếu bạn mới chỉ dùng một agent cho một việc nhỏ, cứ dùng terminal trực tiếp là đủ. Khi bắt đầu thấy mình mở nhiều cửa sổ, chờ đợi và lẫn lộn nhánh, đó là lúc Orca có ích.

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

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

README ghi Orca là phần mềm miễn phí và mã nguồn mở theo giấy phép MIT. Tuy nhiên các agent chạy bên trong (như Claude Code, Codex) dùng gói đăng ký của chính bạn, nên chi phí của các agent đó vẫn tính riêng.

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

Có. README cung cấp bộ cài Windows (.exe), cùng bản cho macOS (Apple Silicon và Intel) và Linux (AppImage). Ngoài ra còn có lệnh Homebrew cho macOS và AUR cho Arch Linux.

### Orca có cần GPU không?

README không nói gì về yêu cầu GPU hay cấu hình phần cứng. Orca chủ yếu điều khiển các agent, còn phần xử lý AI thường diễn ra ở dịch vụ của agent bạn dùng. Chưa có thông tin chi tiết hơn trong tư liệu.

### Orca khác gì việc tự mở nhiều terminal chạy Claude Code?

Orca gom nhiều agent vào một ứng dụng, mỗi agent có một worktree riêng, kèm xem diff, ghi chú theo dòng, trình duyệt, tích hợp Git và app điện thoại. Bạn vẫn dùng chính các agent đó, chỉ khác là việc quản lý và duyệt kết quả tập trung hơn.

### Agent nào dùng được với Orca?

README nói Orca chạy với bất kỳ agent CLI nào, nghĩa là nếu chạy được trong terminal thì chạy được trong Orca. Danh sách có Claude Code, Codex, Grok, Cursor, GitHub Copilot, OpenCode, Hermes Agent, Goose, Cline, Qwen Code và nhiều agent khác.

### Có dùng được trên điện thoại không?

Có. Có app iOS trên App Store và file APK cho Android. Bạn ghép app với bản desktop để nhận thông báo khi agent cần bạn, trả lời trong chat và theo dõi công việc khi rời bàn.

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

README nói Orca có thu thập dữ liệu sử dụng ẩn danh và có trang tài liệu riêng giải thích đó là gì cũng như cách từ chối. Tư liệu không nêu thêm chi tiết về cách xử lý mã nguồn, nên bạn hãy đọc trang đó trước khi dùng cho dự án nhạy cảm.
