Hướng dẫn
AI
Omarchy bao gồm các trình khởi chạy cho các coding agent dưới đây mà không chọn mặc định thay cho bạn. Chạy một lệnh để cài đặt CLI của nó trong lần sử dụng đầu tiên, sau đó xác thực khi được nhắc. Hermes là ngoại lệ: không có gì được cài đặt cho nó trong lần sử dụng đầu tiên, và việc chọn nó sẽ cài đặt Hermes Desktop, như phần Ứng dụng desktop dưới đây giải thích.
| Lệnh | Agent |
|---|---|
claude |
Claude Code |
codex |
OpenAI Codex |
opencode |
OpenCode |
agy |
Google Antigravity CLI |
amp |
Amp |
commandcode |
Command Code |
copilot |
GitHub Copilot CLI |
crush |
Crush |
cursor-agent |
Cursor CLI |
devin |
Devin CLI từ Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, coding agent miễn phí, có quảng cáo của Codebuff |
grok |
Grok Build từ xAI |
hermes |
Hermes, agent của Nous Research |
kilo |
Kilo, một coding agent dựa trên OpenCode |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, coding agent của MiniMax |
muse |
Muse Code, coding agent của Meta |
omp |
Oh My Pi |
ori |
Ori, harness của OpenRouter |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code, coding agent của Alibaba |
ori là trường hợp khác biệt: nó chạy các harness khác dựa trên toàn bộ danh mục mô hình của OpenRouter, vì vậy ori claude, ori codex hoặc ori opencode khởi động các agent đó trên bất kỳ mô hình nào bạn chỉ định, và ori code là agent riêng của Ori.
Cài đặt và cập nhật agent
Ngoại trừ Hermes, các agent này sử dụng cơ chế cài đặt lười của mise: lần khởi chạy đầu tiên sẽ cài đặt CLI, và các lần khởi chạy sau sẽ sử dụng lại nó. mise cũng kiểm tra bản phát hành mới cho một agent đã cài đặt tối đa bốn giờ một lần, ngay trước khi nó khởi động hoặc trong nền tại dấu nhắc shell. Nếu quá trình cập nhật đó thất bại hoặc bạn ngoại tuyến, phiên bản đã cài đặt sẽ chạy. omarchy update cập nhật các agent đã cài đặt cùng với phần còn lại của Omarchy, và mup chỉ cập nhật các công cụ do mise quản lý.
Trình cập nhật riêng của một agent, chẳng hạn như claude update, codex update hoặc nút cập nhật trong một ứng dụng, không cập nhật bản cài đặt do mise quản lý. codex update sẽ thất bại, và claude update có thể báo cáo thành công trong khi cài đặt một bản sao riêng mà mise không theo dõi. Nếu bạn muốn sử dụng trình cài đặt và trình cập nhật gốc của một agent thay vào đó, hãy thêm nó vào disable_tools; xem Các công cụ CLI được cài sẵn.
Để cài đặt tất cả các công cụ lười đã cấu hình trước khi bạn cần đến chúng, hãy chạy mise install --include-lazy. Việc này bao gồm các công cụ CLI mặc định khác của Omarchy cũng như các agent. Xem Các công cụ CLI được cài sẵn để cài đặt một công cụ riêng lẻ hoặc sử dụng bản cài đặt của riêng bạn.
grok được cài đặt thông qua gói grok chính thức của mise, theo cùng cách như claude và codex. Chạy grok, hoặc chọn nó trong Setup > Defaults > Agent. Bỏ qua trình cài đặt curl | bash trên x.ai. Đường dẫn đó đặt một bản sao thứ hai vào ~/.grok/bin, chèn nó vào đầu PATH và ghi đè trình bao bọc của Omarchy.
dsh mở giao diện trình duyệt của nó trên 127.0.0.1:3080, với thư mục khởi chạy làm không gian làm việc mặc định của nó. Giao diện trình duyệt của nó không nhận prompt khởi đầu, vì vậy omarchy agent prompt mở nó với prompt nằm trong clipboard của bạn để dán. Omarchy khởi động nó với preset quyền không cần phê duyệt của DeepSeek. DeepSeek Harness tải nhật ký phiên lên DeepSeek khi bạn sử dụng API mô hình chính thức của nó; tắt tính năng đó trong Settings > General > Upload Session Log trong giao diện trình duyệt của nó. Phản hồi bạn gửi cho nó cũng được tải lên cùng với phiên, trừ khi bạn khởi động nó với DSH_TELEMETRY_MODE=DISABLED.
Agent mặc định
Chọn agent mặc định của bạn bằng omarchy default agent <name> hoặc trong Setup > Defaults > Agent trong Omarchy Menu (Super + Space). Nếu agent chưa được cài đặt, việc chọn nó sẽ cài đặt nó trước. Một bản Omarchy mới sẽ mời bạn thực hiện lựa chọn này bằng một thông báo chỉ xuất hiện một lần.
Việc chọn Claude cũng cố gắng thiết lập tiện ích mở rộng trình duyệt của nó cho Chromium, Chrome, Brave, Brave Origin và Edge. Việc thiết lập tiện ích mở rộng áp dụng cho tất cả người dùng và có thể yêu cầu mật khẩu hệ thống của bạn; việc hủy bỏ hoặc cài đặt tiện ích mở rộng thất bại vẫn chọn và khởi chạy Claude. Khởi động lại trình duyệt của bạn, bật tiện ích mở rộng nếu được nhắc, và đăng nhập vào Claude để hoàn tất việc kết nối nó. Chạy /chrome trong Claude để kiểm tra kết nối. Firefox và Zen không hỗ trợ tiện ích mở rộng này. Nếu Claude đã là mặc định của bạn trước khi thiết lập này được thêm vào, hãy chọn lại nó để cài đặt tiện ích mở rộng.
Sau khi bạn đã chọn, Super + Shift + Ctrl + A khởi chạy agent mặc định trong một cửa sổ terminal chuyên dụng (hoặc mở trình chọn nếu bạn chưa chọn). Bạn cũng có thể khởi chạy nó thẳng vào một nhiệm vụ bằng omarchy agent prompt "Review this project". Freebuff và DeepSeek Harness không nhận prompt khởi đầu, vì vậy chúng mở ra với prompt nằm trong clipboard của bạn để dán thay vào đó. Các agent được khởi chạy theo cách này chạy không cần giám sát trong các chế độ đừng-dừng-lại-để-hỏi tương ứng của chúng, vì vậy hãy sẵn sàng để chúng thực sự làm việc! MiniMax Code không có chế độ như vậy cho các phiên tương tác của nó, vì vậy nó yêu cầu quyền như bình thường. Và vì các agent từ chối ghi nhớ sự tin cậy đối với thư mục home của bạn, các lần khởi chạy từ $HOME sẽ bắt đầu trong ~/Work thay vào đó.
Cũng có các phím tắt terminal: a chạy agent mặc định ngay trong terminal hiện tại, trong khi c, cx và cy khởi động trực tiếp OpenCode, Claude Code và Codex (lại trong các chế độ tự động phê duyệt của chúng). Thay đổi theme cũng đồng bộ tới các agent: Claude Code, Pi, OpenCode và Hermes (sau khi Omarchy đã cài đặt nó) đều đi theo khi bạn chuyển theme Omarchy.
Bảng agents
Thanh trên cùng có một biểu tượng agents. Trước khi bạn thiết lập một agent, bảng của nó hướng dẫn bạn đăng nhập vào Claude, Codex hoặc Grok, và agent đầu tiên trở thành agent mặc định của bạn. Sau đó, bảng đặt mọi gói đăng ký trên một trang: mỗi agent và tài khoản với gói của nó, một đồng hồ đo cho mỗi giới hạn phiên 5 giờ và giới hạn hàng tuần của nó kèm thời gian cho đến khi nó đặt lại (di chuột để xem phần trăm chính xác), hoặc số dư trả trước còn lại, dưới một dòng luân phiên qua những gì bạn đã sử dụng trên tất cả chúng, như số token tuần này và mô hình bạn dùng nhiều nhất. Trong Make something nó cung cấp các prompt khởi đầu cho một theme, plugin hoặc ứng dụng mới, giao nhiệm vụ cho agent mặc định của bạn. Các ứng dụng được xây dựng theo cách các ứng dụng Hype, Monologue và Omacut của chính Omarchy được xây dựng, bằng C++ và Qt Quick, tuân theo skill agent omarchy-app, và trình biên dịch cùng các thành phần Qt chúng cần đều được cài sẵn. Claude Code, Codex, Grok, Kimi, Cursor và hạn mức Grok Bot của nó, GitHub Copilot, Muse, Antigravity, Kimchi và Devin được hỗ trợ ngay từ đầu với các giới hạn của chúng, và Hermes, Mistral Vibe và Qwen Code hiển thị các phiên và token của chúng sau khi bạn đã sử dụng chúng. Các gói và khóa nhà cung cấp bạn sử dụng thông qua pi, omp hoặc opencode cũng xuất hiện: OpenCode Zen và Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan và Synthetic với các giới hạn của chúng; Fireworks, OpenRouter và DeepSeek với số dư trả trước của chúng; và các mô hình bạn chạy trên phần cứng của riêng mình trong Local models. Mỗi agent được tính một lần, dưới bên nào thanh toán cho nó, bất kể bạn điều khiển nó qua bao nhiêu harness.
Nhấp chuột trái vào biểu tượng trên thanh để mở bảng, nhấp chuột phải để khởi chạy agent mặc định của bạn. Các bản ghi sử dụng đằng sau nó được tạo lại mỗi 15 phút bởi omarchy agent usage-update, và bảng thậm chí có thể hợp nhất mức sử dụng từ các máy khác của bạn qua một thư mục đã đồng bộ. Xem README trong $OMARCHY_PATH/shell/plugins/agents/ để biết đầy đủ các cài đặt.
Nhiều gói đăng ký
Nếu bạn trả tiền cho nhiều hơn một gói Claude, Codex hoặc Grok - chẳng hạn một gói Max cá nhân và một gói công việc - Omarchy có thể giữ tất cả chúng luôn đăng nhập và di chuyển giữa chúng. Thêm một gói đăng ký bằng dấu + trong bảng agents, bảng này sẽ hướng dẫn bạn ngay tại đó, hoặc bằng omarchy agent account add claude Work (hoặc codex, hoặc grok). Nó sẽ cài đặt CLI nếu nó bị thiếu. Tài khoản đầu tiên cho một nhà cung cấp đăng nhập thông qua trình duyệt thông thường của bạn, ngay tại nơi CLI luôn tìm kiếm. Mọi tài khoản sau đó đăng nhập thông qua một cửa sổ riêng tư, vì vậy tài khoản mà trình duyệt của bạn đã đăng nhập sẽ không bị chọn nhầm; đăng nhập tại đó bằng tài khoản bạn đang thêm, và đóng bất kỳ cửa sổ riêng tư nào bạn đã mở trước đó. Đừng bao giờ đăng xuất khỏi CLI để làm điều này: việc đăng xuất sẽ thu hồi thông tin đăng nhập đã lưu, và tài khoản đó sẽ phải được thêm lại.
Để sao chép thông tin đăng nhập gói đăng ký của bạn sang một máy Omarchy khác qua SSH, hãy chạy omarchy agent account copy user@laptop. Bên gửi cung cấp một bên nhận tạm thời khi đích không có bên nhận nào được cài đặt, vì vậy các máy Omarchy cũ hơn có thể nhận tài khoản mà không cần cập nhật. Các bên nhận đã cài đặt được ưu tiên. Việc này sao chép tất cả các gói đăng ký Claude, Codex và Grok; thêm tên nhà cung cấp để chọn chúng, như trong omarchy agent account copy laptop claude. Tên tài khoản và ID lệnh khớp với nguồn, bao gồm các tài khoản đã có trên đích. Các tài khoản đích không liên quan sẽ nhận hậu tố số nếu tên của chúng xung đột, và cài đặt, skills, plugins và lịch sử cuộc trò chuyện vẫn ở cục bộ trên mỗi máy.
Thông tin xác thực đích hiện có được giữ lại. Một tài khoản nguồn đã đăng nhập tại đó sẽ được đồng bộ tên của nó mà không thay thế thông tin xác thực của nó; các tài khoản khác được thêm bên cạnh nó. Để thay thế thông tin xác thực đã lưu cho các tài khoản khớp, hãy sử dụng omarchy agent account copy --replace laptop claude sau khi thoát các phiên của tài khoản đó trên đích. Một đích mới cũng nhận được tài khoản đang hoạt động và tùy chọn chuyển đổi của nguồn; một đích đã thiết lập sẽ giữ lại của riêng nó.
Thông tin xác thực di chuyển qua SSH và được lưu trữ trong các tệp riêng tư trên đích, vì vậy chỉ sao chép tới các máy bạn tin tưởng. Đây là bản sao một lần, không phải đồng bộ hóa liên tục. Token làm mới của Codex có thể bị một máy khác luân chuyển, khiến một thông tin đăng nhập đã sao chép cần được gia hạn; các lần đăng nhập riêng biệt vẫn là lựa chọn đáng tin cậy nhất để sử dụng đồng thời trên nhiều máy. Xem hướng dẫn xác thực tài khoản của Codex.
Một tài khoản cho mỗi nhà cung cấp đang hoạt động, và mọi phiên mới đều bắt đầu bằng tài khoản đó: cx, cy, một claude, codex hoặc grok thông thường, bất cứ thứ gì được khởi chạy thông qua omarchy agent, và các script hoặc trình soạn thảo tìm thấy CLI trên PATH. Chuyển đổi bằng omarchy agent account use work (và quay lại bằng omarchy agent account use main), hoặc trong bảng bằng cách nhấn số của một tài khoản rồi nhấn Enter (hoặc nhấp vào nút Use của nó). Các phiên đang chạy sẽ ở lại tài khoản chúng đã bắt đầu. Lịch sử cuộc trò chuyện, cài đặt, skills và plugins được chia sẻ giữa các tài khoản, vì vậy claude --continue trong cùng một thư mục sẽ tiếp tục nơi bạn đã dừng trên tài khoản mới.
Với nhiều hơn một tài khoản, bảng hiển thị các giới hạn của từng tài khoản cạnh nhau, với tài khoản đang hoạt động được đánh dấu. Theo mặc định Omarchy thông báo cho bạn khi tài khoản đang hoạt động vượt qua 95% của một giới hạn, và việc nhấp vào thông báo sẽ chuyển sang tài khoản có nhiều khoảng trống nhất. Di chuột qua dòng của một tài khoản trong bảng và nhấp vào Autoswitch xuất hiện bên cạnh Use (hoặc nhấn m), hoặc chạy omarchy agent account mode auto, để nó tự chuyển đổi thay vào đó; trong khi nó đang bật, Autoswitch chiếm vị trí của Use, và việc nhấp lại vào nó sẽ quay lại chế độ thông báo. Thêm một số để thay đổi ngưỡng, như trong omarchy agent account mode auto 90. Nếu mọi tài khoản đều vượt quá ngưỡng, bạn sẽ được thông báo một lần, cùng với tài khoản nào sẽ được giải phóng đầu tiên. Trong khi một tài khoản đang hoạt động nằm trong vòng 15 điểm so với ngưỡng của nó (80% ở mức mặc định), các giới hạn của nó được kiểm tra mỗi ba phút thay vì mỗi 15 phút.
omarchy agent account list hiển thị mọi tài khoản và các giới hạn mới nhất của nó, omarchy agent account remove work quên một tài khoản, và omarchy agent account rename primary Hey đổi tên một tài khoản (hoặc nhấp vào tên của một tài khoản trong bảng). Các lệnh này hoạt động trên các tài khoản của agent mặc định của bạn; để đến nhà cung cấp còn lại, hãy đặt tên nó trước, như trong omarchy agent account use codex side. Thông tin đăng nhập bạn đã có trong ~/.claude hoặc ~/.codex là tài khoản Main và ở nguyên tại chỗ. Một tài khoản không được sử dụng trong hơn khoảng tám giờ có thể hiển thị Sign-in required; nhấp vào nó để đăng nhập lại tài khoản đó ngay trong bảng, hoặc bắt đầu một phiên trong đó, phiên này tự làm mới thông tin đăng nhập. Các máy chủ MCP bạn đã có khi một tài khoản được thêm sẽ đi cùng nó, nhưng những máy chủ bạn thêm sau bằng claude mcp add chỉ đến được tài khoản bạn đã thêm chúng trong đó. Claude Desktop và các công cụ được cấu hình với đường dẫn tuyệt đối tới một tệp nhị phân CLI không đi theo việc chuyển đổi. Một CLAUDE_CONFIG_DIR, CODEX_HOME hoặc GROK_HOME rõ ràng được ưu tiên hơn tài khoản đã chọn.
Chẩn đoán crash
Omarchy theo dõi systemd-coredump để phát hiện các crash của tiến trình. Khi một thứ gì đó bị segfault, bạn sẽ nhận được thông báo “Process crashed” - nhấp vào nó, và crash được giao cho agent mặc định của bạn cùng với skill diagnose-crash của Omarchy, skill này hướng dẫn agent thiết lập các sự kiện từ core dump và quyết định xem crash có đáng báo cáo lên upstream hay không. Bạn cũng có thể chạy nó thủ công đối với bất kỳ PID nào từ coredumpctl list bằng omarchy agent crash <pid>.
Việc theo dõi được bật theo mặc định. Tắt nó trong Trigger > Toggle > Crash Capture (hoặc bằng omarchy toggle crash-capture) và các thông báo sẽ dừng; omarchy agent crash <pid> vẫn hoạt động thủ công.
Các crash cũng có thể bị tắt tiếng từng chương trình một, đó là điều chẩn đoán đề xuất cho bạn ở cuối. omarchy crash mute hyprland dừng các thông báo chỉ cho chương trình đó, omarchy crash mute hyprland off mang chúng trở lại, và omarchy crash mute riêng lẻ liệt kê những gì bạn đã tắt tiếng. Nó chấp nhận đường dẫn của tệp nhị phân cũng vui vẻ như tên của nó, vì vậy omarchy crash mute /usr/bin/hyprland cũng làm điều tương tự. Đặt một tên có khoảng trắng trong dấu ngoặc đơn, như trong omarchy crash mute 'Some App'. Mọi thứ khác vẫn thông báo, và chương trình đã tắt tiếng vẫn crash - việc này ẩn lời nhắc, nó không sửa bất cứ thứ gì.
Ứng dụng desktop
Menu Install > AI cũng mang một vài ứng dụng AI đồ họa: ứng dụng desktop ChatGPT, ứng dụng desktop Claude (bản beta Linux của Anthropic, với các tab Chat, Cowork và Claude Code), Grok Bot để trò chuyện với các mô hình của xAI, Hermes Desktop, OpenClaw, ứng dụng desktop Perplexity và T3 Code. Grok Bot là ứng dụng trò chuyện desktop. Coding agent là lệnh grok.
Hermes Desktop là ứng dụng cần biết, bởi vì một máy có một Hermes, và nó thuộc về ứng dụng: Hermes chỉ được cài đặt thông qua ứng dụng, và lệnh hermes mà agent mặc định chạy là của ứng dụng. Việc chọn Hermes làm agent mặc định cài đặt cùng thứ mà mục Install > AI cài đặt: gói, và một runtime Hermes trong ~/.hermes được thiết lập bởi trình cài đặt riêng của Hermes, việc này mất vài phút trong lần đầu tiên. Runtime đó là Hermes duy nhất mà lệnh hermes trong terminal, agent mặc định và ứng dụng đều sử dụng, và nó tự cập nhật bằng hermes update thay vì chờ một bản phát hành Omarchy. Việc cài đặt nó cũng trao cho Hermes theme Omarchy làm một skin tên là omarchy, mà mọi bề mặt Hermes đều đi theo khi bạn chuyển theme; chọn một skin khác trong cài đặt Appearance của Hermes hoặc bằng /skin nếu bạn không muốn nó làm vậy, và Omarchy sẽ để yên lựa chọn đó. Việc gỡ bỏ ứng dụng trong Remove > AI đóng Hermes trước, bao gồm gateway, lấy runtime đó đi cùng, và giữ lại các cuộc trò chuyện, ký ức của bạn, và các skills Hermes đã tự viết cho chính nó trừ khi bạn bảo nó ngược lại: nó hỏi, mặc định là không, liệu dữ liệu đó và cài đặt kết nối của bạn có nên đi theo hay không.
Trải nghiệm desktop của OpenClaw là Control UI của nó, mở ra dưới dạng một web app được hỗ trợ bởi gateway cục bộ riêng của nó. OpenClaw nằm trong ~/.openclaw và tự cập nhật: sử dụng nút “Update Gateway” của Control UI hoặc chạy openclaw update, và gateway khởi động lại trên phiên bản mới. Omarchy chỉ chọn bản phát hành mà một bản cài đặt mới bắt đầu từ đó. Việc gỡ bỏ OpenClaw trong Remove > AI lấy dịch vụ gateway và ứng dụng đi cùng và sau đó hỏi liệu ~/.openclaw có nên đi theo hay không, vì nơi đó chứa các cuộc trò chuyện và thông tin xác thực của bạn cùng với chính OpenClaw và các runtime plugin nó tải xuống; mặc định giữ lại nó, và việc cài đặt lại OpenClaw sẽ nhặt lại nó.
T3 Code chạy từ bản phát hành AppImage chính thức của nó trong ~/.local/share/t3code thay vì từ một gói, vì vậy nó tự cập nhật. Việc cài đặt nó hỏi liệu có bắt đầu trên kênh Stable hay Nightly hay không; chuyển đổi sau trong cài đặt của T3 Code. Các thread và cài đặt của bạn nằm trong ~/.t3, và việc gỡ bỏ T3 Code trong Remove > AI lấy chúng đi cùng.
LLM cục bộ
Omarchy khuyến nghị hai cách chạy các mô hình LLM cục bộ: LM Studio và Ollama. LM Studio cung cấp giao diện GUI để tìm các mô hình open-weight, cài đặt chúng và chạy chúng. Đó là một cách tuyệt vời để bắt đầu dễ dàng. Ollama cung cấp một CLI để làm điều tương tự. Nhưng nếu bạn mới làm quen với các mô hình cục bộ, tôi sẽ bắt đầu với LM Studio. Bạn có thể cài đặt một trong hai trong Install > AI trong Omarchy Menu.
Skill Omarchy
Các skill agent giúp AI sử dụng các công cụ cụ thể theo một cách cụ thể, và Omarchy đi kèm với một skill mặc định để tùy chỉnh hệ thống. Như việc tinh chỉnh cấu hình Hyprland của bạn, điều chỉnh thanh, hoặc thậm chí tạo một theme mới từ đầu. Nó được symlink vào các thư mục skill cho Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills và mỗi ~/.hermes/profiles/*/skills), và vị trí chung ~/.agents/skills, vì vậy hầu hết các harness đều tự động nhặt nó.
Nhưng bạn nên coi skill này là thử nghiệm. Các mô hình khác nhau sẽ sử dụng nó với hiệu quả khác nhau. Tốt nhất là chạy ở chế độ plan trước, để bạn có ý tưởng về những gì agent muốn thay đổi. Và sau đó hãy sẵn sàng khôi phục các thay đổi hoặc thậm chí gọi omarchy reinstall configs, nếu agent làm mọi thứ rối tung lên.