Orca ADE

1. Orca là gì?

Orca là một ứng dụng máy tính dùng để chạy nhiều trợ lý lập trình AI cùng lúc, mỗi trợ lý làm một việc riêng mà không giẫm chân lên nhau. Nhóm phát triển (Stably AI) gọi nó là môi trường làm việc cho agent; agent ở đây là các trợ lý viết code chạy trong cửa sổ dòng lệnh như Claude Code, Codex hay Cursor CLI.

Cách Orca làm: mỗi việc bạn giao được đặt trong một "worktree" riêng, tức một bản sao làm việc độc lập của dự án do Git tạo ra. Nhờ đó ba trợ lý có thể cùng thử sửa một lỗi theo ba cách, bạn so sánh kết quả rồi chọn bản tốt nhất. Ngoài ra Orca có sẵn cửa sổ dòng lệnh, trình xem thay đổi code, trình duyệt gắn trong app và một app điện thoại để theo dõi từ xa.

Nói thẳng: Orca dành cho người viết code. Tài liệu chính thức ghi rõ nó hướng tới người làm phần mềm chuyên nghiệp, và nếu bạn tìm một công cụ không cần code thì Orca không phải thứ đó.

Orca miễn phí, mã nguồn mở theo giấy phép MIT, không có hệ thống tài khoản. Nhưng Orca không phải một mô hình AI. Bạn tự mang gói thuê bao Claude, Codex hoặc công cụ tương tự của mình vào dùng.

Hợp với bạn nếu:

• Bạn đã trả tiền cho Claude Code, Codex hoặc Cursor CLI và muốn điều phối chúng ở một chỗ.
• Bạn muốn cho vài trợ lý thử cùng một việc rồi chọn kết quả tốt nhất.
• Bạn chịu đọc và duyệt kỹ phần code AI viết trước khi dùng.

Chưa hợp nếu:

• Bạn chưa biết lập trình và chưa dùng Git.
• Bạn tìm một chatbot AI miễn phí. Orca không kèm AI nào.
• Bạn chỉ có điện thoại. App điện thoại của Orca chỉ là bộ điều khiển từ xa cho app máy tính.

2. Cần chuẩn bị gì?

• Máy tính chạy macOS (chip Apple Silicon hoặc Intel), Windows, hoặc Linux. Tài liệu chính thức không nêu phiên bản hệ điều hành tối thiểu.
• Git: công cụ quản lý các phiên bản mã nguồn. Orca dựa hoàn toàn vào Git để tạo worktree. Tải tại https://git-scm.com/downloads
• Một dự án đã nằm trong Git trên máy bạn. Orca làm việc với thư mục dự án có sẵn.
• Ít nhất một trợ lý lập trình chạy bằng dòng lệnh, đã cài và đã đăng nhập, ví dụ Claude Code hoặc Codex. Đây là phần tốn tiền: mỗi trợ lý có gói thuê bao riêng, giá xem trên trang của từng hãng. Orca không thu thêm gì.
• Bản máy tính không cần tài khoản Orca. Tài liệu về quyền riêng tư ghi Orca không có hệ thống tài khoản. (Ghép nối điện thoại qua "Orca Relay" thì có yêu cầu đăng nhập, xem Bước 4.)
• Điện thoại (tùy chọn) nếu bạn muốn theo dõi agent từ xa: iPhone hoặc Android.

Bản Orca mới nhất lúc viết bài là v1.4.217, phát hành ngày 29/9/2026. Nhóm phát triển ra bản mới gần như hằng ngày.

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

Bước 1: Tải bộ cài

Mở trang tải chính thức: https://onorca.dev/download

Chọn đúng hệ điều hành của bạn. Tên file tương ứng trên trang Releases (https://github.com/stablyai/orca/releases/latest):

Máy của bạn	File cần tải
Windows	orca-windows-setup.exe
Mac chip Apple Silicon (M1 trở lên)	orca-macos-arm64.dmg
Mac chip Intel	orca-macos-x64.dmg
Linux	orca-linux.AppImage, hoặc gói .deb / .rpm

Đúng là khi: trình duyệt tải về đúng file cho máy bạn.

Bước 2: Cài trên Windows

Bấm đúp vào orca-windows-setup.exe và làm theo các màn hình cài đặt. Bản cho Windows được ký số thông qua SignPath.

Đúng là khi: Orca xuất hiện trong menu Start.

Bước 2: Cài trên macOS

Mở file .dmg vừa tải và kéo biểu tượng Orca vào thư mục Applications. Bản cho macOS đã được Apple xác thực (signed và notarized); lần mở đầu macOS có thể vẫn hỏi xác nhận, đó là bình thường.

Nếu máy bạn có Homebrew (trình cài phần mềm bằng dòng lệnh cho Mac), có thể cài bằng một lệnh:

brew install --cask stablyai/orca/orca

Đúng là khi: Orca nằm trong Applications và mở được.

Bước 2: Cài trên Linux

Tài liệu khuyên chọn bản AppImage nếu bạn muốn Orca tự cập nhật. Cấp quyền chạy cho file rồi mở nó. Các gói .deb và .rpm cài bằng trình quản lý gói của bản phân phối bạn dùng.

Người dùng Arch Linux có gói trên AUR:

yay -S stably-orca-bin

Lưu ý: Trên Linux, lệnh dòng lệnh của Orca có tên orca-ide để không trùng với trình đọc màn hình Orca của GNOME.

Bước 3: Mở Orca lần đầu

Mở Orca. Theo tài liệu, lần đầu ứng dụng sẽ:

1. Xin quyền truy cập thư mục người dùng để thêm được dự án.
2. Đề nghị nhập sẵn cài đặt từ ~/.claude, ~/.codex và trình dòng lệnh Ghostty nếu máy bạn có.
3. Đưa bạn tới màn hình trống, nơi bạn thêm dự án đầu tiên.

Đúng là khi: bạn thấy màn hình chính với thanh bên trái và nút Add Repo.

Bước 4 (tùy chọn): Cài app điện thoại

App điện thoại đang ở giai đoạn beta.

• iPhone: cài từ App Store tại https://apps.apple.com/us/app/orca-ide/id6766130217
• Android: mở https://onorca.dev/download bằng Chrome, chọn Android để tải file app-release.apk (bản 0.0.50 lúc viết bài). Tải xong, mở mục Downloads và bấm vào file. Nếu Android hỏi, chỉ cấp quyền cài ứng dụng không rõ nguồn cho trình duyệt hoặc app Files, rồi tắt quyền đó sau khi cài xong.

Ghép nối với máy tính: trên máy tính, mở luồng ghép nối từ menu tài khoản / trạng thái để lấy mã dùng một lần. Trên điện thoại, mở app, chọn Pair và dán mã vào. Tài liệu nói cách ghép qua "Orca Relay" yêu cầu đăng nhập; mã hết hạn sau vài phút nên hãy tạo mã mới nếu không dùng được. Máy tính và điện thoại phải kết nối được với nhau qua mạng.

4. Dùng lần đầu

Tài liệu của Orca gọi đây là trang quan trọng nhất: từ app trống đến ba agent chạy song song.

1. Thêm dự án. Bấm Add Repo ở thanh bên và chỉ tới thư mục dự án trên máy. Orca đọc trạng thái Git và lấy nhánh mặc định làm gốc.
2. Tạo worktree. Bấm dấu + cạnh tên dự án và gõ tên việc cần làm, ví dụ fix-login-race. Để trống thì Orca tự đặt theo tên một loài sinh vật biển.
3. Chọn agent. Trong worktree mới, một cửa sổ dòng lệnh mở ra kèm ô chọn agent. Chọn Claude Code, Codex hoặc trợ lý bạn có. Orca khởi động trợ lý đó ở đúng thư mục.
4. Giao việc. Gõ yêu cầu cho agent như bạn vẫn làm.
5. Thử chạy song song. Lặp lại bước 2 và 3 thêm hai lần, dán cùng một yêu cầu vào cả ba. Kéo thẻ của một worktree sang cạnh phải hoặc cạnh dưới để chia màn hình và theo dõi cả ba.
6. Chọn bản tốt nhất. Khi các agent xong, mở phần xem thay đổi (diff) của từng worktree, chọn bản ưng ý, rồi commit và push ngay trong Orca. Hai worktree còn lại xóa bằng một cú bấm, nhánh của chúng cũng đi theo.

Kết quả trông thế nào: thanh bên trái liệt kê các worktree, phần chính là các ô dòng lệnh nơi từng agent đang làm việc.

Lưu ý: Mặc định Orca khởi động các trợ lý ở chế độ bỏ qua bước hỏi xin phép (ví dụ thêm cờ --dangerously-skip-permissions cho Claude), với lý do worktree là bản sao dùng rồi bỏ. Nếu bạn muốn trợ lý hỏi trước khi chạy lệnh, vào Settings, mục Agents, phần Agent Permissions và chuyển sang Manual.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Agent không khởi động	Trợ lý chưa cài, chưa đăng nhập, hoặc Orca không thấy nó	Chạy thử trợ lý trong cửa sổ dòng lệnh thường. Nếu ở đó cũng lỗi, cài lại hoặc đăng nhập lại. Nếu chỉ lỗi trong Orca, kiểm tra Settings, mục Agents, rồi bấm nút Restart trên thẻ
Tạo worktree thất bại	Nhánh gốc chưa được tải về, hoặc nhánh đó đã có worktree	Mở dòng lệnh trong thư mục dự án và chạy git fetch origin; hoặc xóa worktree cũ, hoặc đặt tên nhánh khác
Phần xem thay đổi hiển thị sai hoặc đứng yên	Có thao tác Git bên ngoài Orca chen vào giữa hai lần làm mới	Bấm biểu tượng làm mới trên thanh công cụ của phần diff
Gõ orca báo "command not found"	Lệnh dòng lệnh của Orca chưa được đăng ký	Vào Settings, mục General, phần Orca CLI để đăng ký. Trên macOS lệnh được đặt vào ~/.local/bin, hãy bảo đảm thư mục này nằm trong PATH
Máy chậm, ngốn RAM	Mở quá nhiều worktree và thẻ trình duyệt	Đóng các worktree không dùng và các thẻ trình duyệt trong app. Tài liệu ghi bố cục chia nhiều thẻ trình duyệt là thứ ngốn RAM nhất
Android tải file cài không xong	Link mở trong Discord, GitHub hoặc app khác	Chọn "Open in browser" rồi tải lại bằng Chrome
Samsung báo Auto Blocker chặn cài	Tính năng bảo vệ của Samsung	Vào Settings, Security and privacy, Auto Blocker, tắt tạm, cài Orca rồi bật lại. Không tắt Play Protect

Khi cần báo lỗi, vào menu Help và chọn Open Logs để lấy file nhật ký, rồi gửi tại https://github.com/stablyai/orca/issues

6. Gỡ cài đặt / cập nhật

Cập nhật:

• Orca tự cập nhật theo kênh ổn định (stable). Muốn kiểm tra ngay, vào Settings, mục General, phần Updates và bấm Check for Updates.
• Nếu cài qua Homebrew:

brew upgrade --cask orca

• Trên Linux, bản AppImage tự cập nhật. Gói .deb và .rpm chỉ báo có bản mới và đưa lệnh để bạn tự chạy; hãy thoát Orca trước khi chạy lệnh đó.
• Không thích bản mới? Các bản cũ vẫn có trên trang Releases. Tài liệu ghi Orca không ép hạ cấp dữ liệu worktree khi bạn quay về bản cũ.

Gỡ:

• Windows: vào Settings của Windows, mục Apps, Installed apps, tìm Orca và chọn Uninstall.
• macOS: kéo Orca từ Applications vào Thùng rác. Nếu cài bằng Homebrew:

brew uninstall --cask orca

• Linux: xóa file AppImage, hoặc gỡ gói bằng trình quản lý gói bạn đã dùng để cài.

Trước khi gỡ, hãy xóa các worktree không cần trong Orca. Xóa worktree sẽ xóa cả thư mục và nhánh của nó (có hỏi xác nhận). Thư mục dự án gốc của bạn không bị ảnh hưởng.

7. Câu hỏi hay gặp

Có mất tiền không? Orca miễn phí và mã nguồn mở (MIT). Phần mất tiền là gói thuê bao của các trợ lý lập trình bạn dùng bên trong.

Có cần mạng không? Có. Bản thân Orca chạy trên máy bạn, nhưng các trợ lý bên trong cần mạng để gọi tới dịch vụ AI của chúng.

Orca có thu thập dữ liệu của tôi không? Orca gửi dữ liệu sử dụng ẩn danh (loại sự kiện, phiên bản, hệ điều hành). Tài liệu ghi nó không gửi nội dung file, câu lệnh bạn gõ cho AI, kết quả của agent, tên dự án hay đường dẫn. Muốn tắt, vào Settings, mục Privacy và tắt "Share anonymous usage data". Lưu ý riêng: code của bạn vẫn được gửi tới hãng AI mà trợ lý bạn chọn sử dụng, đó là cách các trợ lý này hoạt động.

Không biết lập trình có dùng được không? Không nên. Tài liệu chính thức nói thẳng Orca không phải công cụ dành cho người không code. Bạn cần đọc được phần thay đổi và hiểu Git ở mức cơ bản.

Dùng trợ lý nào cũng được à? Orca chạy được bất kỳ trợ lý nào hoạt động trong cửa sổ dòng lệnh. Nhiều cái được cấu hình sẵn để bấm một lần là chạy, như Claude Code, Codex, Cursor CLI, GitHub Copilot CLI, OpenCode. Danh sách đầy đủ ở https://www.onorca.dev/docs/agents/supported