rdev đi kèm một hồ sơ AI agent có sẵn, để các agent của bạn biết môi trường hoạt động ra sao ngay từ ngày đầu.
Các agent được hỗ trợ
| Agent | Hỗ trợ |
|---|---|
| Claude Code | Đầy đủ |
| Codex | Đầy đủ |
| opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI | Đầy đủ |
| Cursor CLI, Antigravity CLI | Tiêu chuẩn |
Các agent khác đọc AGENTS.md và hỗ trợ MCP |
Tiêu chuẩn, do bạn cài đặt |
Hỗ trợ đầy đủ nghĩa là trình cài đặt, hồ sơ, cài đặt được quản lý, thông báo, trạng thái phiên và cập nhật đều bao phủ agent đó. Hỗ trợ tiêu chuẩn nghĩa là agent nhận các quy tắc dùng chung và quyền truy cập MCP, không có phần bổ sung riêng cho agent. Tab Agent của bảng điều khiển hiển thị mức hỗ trợ bên cạnh mỗi agent.
Cài đặt agent
Mở máy chủ từ Máy chủ trên thanh bên, rồi chọn Agent. Thẻ AI agent liệt kê mọi agent mà rdev biết, cho biết nó đã được cài đặt chưa và phiên bản nào, cùng lệnh khởi động nó (sao chép bằng nút bên cạnh). Cài đặt thêm một agent, và menu ⋯ cập nhật hoặc xóa một agent. Codex là một phần của image môi trường và không thể xóa. Các thay đổi chạy trên máy chủ và mất từ vài giây đến một phút; thẻ hiển thị kết quả khi xong.
Agent được quản lý theo từng môi trường: ở gói Team, mỗi thành viên chọn agent cho môi trường của riêng mình, và việc cài đặt một agent không thay đổi môi trường của ai khác. Điều này cần rdev 0.2.0-beta.36 trở lên; cho đến khi máy chủ chạy bản đó, thẻ sẽ yêu cầu bạn cập nhật.
Cập nhật agent
Agent không tự cập nhật trên máy chủ của bạn, và bạn sẽ không bao giờ thấy thông báo "đã cài bản cập nhật, hãy khởi động lại" trong agent. Hãy cập nhật từ menu ⋯ hoặc bằng rdev agents update (một agent: rdev agents update claude). Khi phiên bản thay đổi, rdev mở lại mọi phiên đang rảnh của agent đó bằng phiên bản mới: trong cùng cửa sổ terminal, cùng cuộc trò chuyện, giữ nguyên lịch sử. Phiên mà agent đang làm việc hoặc đang chờ bạn trả lời sẽ không bao giờ bị ngắt; phiên đó giữ phiên bản cũ cho đến khi bạn khởi động lại. Các phiên Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI và Gemini CLI được mở lại; các phiên Cursor CLI và Antigravity CLI tiếp tục chạy phiên bản cũ cho đến khi bạn khởi động lại. Cần rdev 1.1.5 trở lên.
Các mô hình khác: khóa nhà cung cấp và lối tắt
Agent cũng có thể chạy trên các mô hình của nhà cung cấp khác. Trong Khóa nhà cung cấp mô hình trên cùng tab, Thêm khóa lưu một API key cho Anthropic, OpenAI, Google Gemini, DeepSeek, Kimi (Moonshot), GLM (Z.ai), MiniMax, Qwen (Alibaba), OpenRouter, Groq, xAI hoặc Mistral. Với Ollama, bạn nhập địa chỉ máy chủ Ollama của mình (http://… hoặc https://…) thay cho khóa. Khóa được mã hóa trong trình duyệt của bạn cho máy chủ này: bảng điều khiển không bao giờ thấy nó, không thể hiển thị lại và chỉ biết nhà cung cấp nào đã có khóa. Thêm khóa cho nhà cung cấp đã có khóa sẽ thay thế khóa đó.
Khi đã đặt khóa, các lối tắt có sẵn sẽ khởi động một agent trên các mô hình của nhà cung cấp đó trong một dự án:
| Lối tắt | Nhà cung cấp |
|---|---|
claude-deepseek, claude-kimi, claude-glm, claude-minimax, claude-qwen |
Claude Code trên các mô hình DeepSeek, Kimi, GLM, MiniMax hoặc Qwen |
codex-deepseek, codex-openrouter, codex-groq, codex-xai, codex-ollama |
Codex trên các mô hình DeepSeek, OpenRouter, Groq, xAI hoặc Ollama |
qwen-<provider>, như qwen-openrouter |
Qwen Code trên các mô hình của nhà cung cấp khác |
Thẻ liệt kê các lối tắt mà khóa của bạn làm cho sẵn sàng. Claude Code với các mô hình khác ngoài Claude không được Anthropic chính thức hỗ trợ: nó hoạt động với hầu hết tác vụ, nhưng một số tính năng có thể hoạt động khác đi.
Quy tắc dùng chung
Các quy tắc mà mọi agent tuân theo nằm ở một nơi, AGENTS.md. Codex, Gemini CLI và opencode đọc trực tiếp tệp này, còn Claude Code đưa nó vào từ CLAUDE.md của chính nó. Các phần riêng của từng agent, như skill và hook của Claude Code, nằm bên trên các quy tắc dùng chung này.
Mức độ hồ sơ bạn nhận được phụ thuộc vào gói của bạn:
- Single: quy tắc cơ bản.
- Pro: hồ sơ đầy đủ với skill, agent và định tuyến mô hình.
- Team: hồ sơ đầy đủ cùng các quy tắc dùng chung của nhóm.
Hồ sơ đầy đủ bổ sung các skill của Claude Code cho Laravel, WordPress, gỡ lỗi và triển khai trong môi trường này; một subagent frontend làm công việc giao diện trên một mô hình nhanh hơn, rẻ hơn trong khi phiên chính giữ những phần khó (đó là định tuyến mô hình); và một subagent reviewer để đánh giá độc lập trước khi một thay đổi hoàn tất. Quy tắc nhóm được viết trên trang Nhóm. Nếu bạn chuyển sang Single, các tệp của hồ sơ đầy đủ bị xóa trừ khi bạn đã thay đổi chúng.
Hướng dẫn lệnh rdev
Mỗi gói đều cài một skill rdev cho từng agent lập trình bạn dùng. Đây là một hướng dẫn ngắn cho agent biết lệnh rdev hoặc công cụ MCP của rdev nào xử lý một việc: thêm và chạy dự án, cài phiên bản ngôn ngữ, PHP và Node, cơ sở dữ liệu và dịch vụ, giữ worker và tác vụ định kỳ luôn chạy, bản xem trước, checkpoint, truy cập Git, sao lưu, triển khai, theo dõi lỗi, thông báo và giấy phép. Agent tự tải hướng dẫn này khi một việc cần đến, nên bạn chỉ cần yêu cầu, ví dụ "thêm cơ sở dữ liệu Postgres vào shop" hoặc "chạy queue worker cho blog".
Skill được cài trong ~/.claude/skills/rdev (Claude Code) và ~/.agents/skills/rdev (Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI và Cursor), và trong ~/.gemini/config/skills/rdev khi đã cài Antigravity. rdev giữ các tệp này luôn mới; hãy đặt skill của riêng bạn ở các thư mục khác.
Truy cập MCP
Agent có quyền truy cập MCP vào các site và cơ sở dữ liệu của bạn. Nhờ đó agent có thể tự tạo một site, thêm Redis, cơ sở dữ liệu, tìm kiếm hoặc lưu trữ S3 vào một dự án, cài một phần mở rộng PHP như mongodb khi composer yêu cầu, tra cứu cơ sở dữ liệu hoặc đọc email đã bắt được, thay vì nhờ bạn làm.
Từ rdev 0.2.0-beta.34, agent cũng quản lý tiến trình và tác vụ định kỳ của từng dự án: sau khi viết một job xếp hàng, agent tự thiết lập queue worker hoặc scheduler của Laravel, khởi động lại worker sau khi thay đổi mã mà nó chạy và đọc kết quả của một tiến trình. Nó đọc phần cuối log Laravel hoặc lỗi gần nhất khi một yêu cầu thất bại, liệt kê, tạo và khôi phục các điểm khôi phục (bên dưới), chia sẻ một site dưới dạng bản xem trước khi bạn yêu cầu và cho bạn biết bản sao lưu hằng đêm đã chạy chưa. Claude Code hỏi bạn trước khi dùng một công cụ lần đầu tiên, như với mọi công cụ MCP khác.
Tài khoản của riêng bạn
Bạn kết nối tài khoản Anthropic hoặc OpenAI của riêng mình, hoặc các khóa nhà cung cấp ở trên. Chi phí sử dụng agent do các nhà cung cấp đó tính và không nằm trong gói đăng ký rdev của bạn. Chúng tôi không bao giờ thấy prompt hay mức sử dụng của bạn.
Chạy agent suốt ngày đêm
Giao prompt cho agent và để nó chạy trên máy chủ của bạn; bạn đóng laptop lại và tận hưởng ngày của mình. Agent chạy trên máy chủ của bạn, không phải trên laptop, nên một tác vụ kéo dài hàng giờ vẫn tiếp tục sau khi bạn rời đi.
Mỗi lần đăng nhập SSH vào máy chủ của bạn đều mở cùng một phiên liên tục tên là main: Terminal on the server của ứng dụng laptop, ssh rdev hoặc một ứng dụng SSH trên điện thoại hay máy tính bảng. Bạn không cần tự khởi động nó (rdev 1.0.1 trở lên).
Open in Terminal của một dự án trong ứng dụng laptop và rdev open <dự án> thay vào đó mở phiên lâu dài riêng của dự án đó, đặt theo tên dự án và bắt đầu trong thư mục của nó. Nhờ vậy mỗi dự án giữ cửa sổ và tác tử riêng, và hai thiết bị ở hai dự án khác nhau không bao giờ đổi màn hình của nhau (rdev 1.3.1 trở lên).
- Khởi động agent trong terminal đó và giao việc cho nó.
- Gập màn hình, đóng ứng dụng hoặc để kết nối bị ngắt. Agent vẫn tiếp tục làm việc trên máy chủ. Để chủ động rời đi, nhấn Ctrl-b rồi nhấn d.
- Quay lại từ bất kỳ thiết bị nào: đăng nhập lại và bạn ở trong cùng một phiên, ngay chỗ bạn đã dừng. Phiên agent trên bảng điều khiển và thông báo của bạn cho biết khi nào công việc xong hoặc đang chờ bạn.
Vài phím sẽ hữu ích: Ctrl-b c mở cửa sổ mới (cho agent thứ hai), Ctrl-b n và Ctrl-b p chuyển giữa các cửa sổ, và bạn có thể cuộn bằng chuột hoặc bàn di chuột. Để tắt phiên liên tục, chạy rdev session persist off trên máy chủ (on bật lại; cần rdev 1.0.5 trở lên); terminal từ xa của trình soạn thảo (VS Code, Cursor) và đồng bộ tệp không bao giờ dùng đến nó.
Khi một phiên đã kết thúc, hãy tiếp tục cùng cuộc trò chuyện bằng lệnh riêng của agent, chẳng hạn claude --continue (hoặc claude --resume để chọn một) và codex resume. Các cuộc trò chuyện nằm trên máy chủ của bạn, trong thư mục home, qua các lần cập nhật và khởi động lại.
rdev host update khởi động lại môi trường, việc này dừng mọi agent và mọi phiên liên tục. Lệnh sẽ đợi khi agent đang làm việc hoặc đang chờ bạn, và cho bạn biết; rdev host update --force vẫn cập nhật.
Phiên agent trên bảng điều khiển
Phiên agent trong bảng điều khiển liệt kê các phiên Claude Code và Codex trên máy chủ của bạn và việc mỗi phiên đang làm: Đang làm việc, Đang chờ bạn (một lời nhắc cấp quyền hoặc một câu hỏi), Đã hoàn thành hoặc Dừng do lỗi. Nó làm mới mỗi vài giây và dùng được trên điện thoại, nên bạn có thể kiểm tra một tác vụ dài từ bất cứ đâu. Các phiên đang chờ bạn được xếp lên đầu.
Chỉ agent, phiên, tên thư mục dự án và trạng thái được gửi đến bảng điều khiển; không bao giờ gửi prompt của bạn, câu trả lời của agent hay mã nguồn của bạn. Các phiên được giữ trong một tuần. Codex báo cáo Đang làm việc và Đã hoàn thành; các lời nhắc phê duyệt của nó chưa hiển thị.
Menu ⋯ trên một phiên sẽ dừng phiên đang chạy: máy chủ kết thúc tiến trình của agent trong vài giây (các tệp nó đã thay đổi vẫn còn, và điểm khôi phục từ đầu phiên có thể hoàn tác chúng; điều này cần rdev 0.2.0-beta.36 trở lên). Một phiên chạy trong terminal liên tục hiển thị huy hiệu Bền vững, và Đóng cửa sổ terminal trong menu của nó sẽ dừng agent nếu vẫn đang làm việc và đóng cửa sổ terminal của nó trên máy chủ, kể cả sau khi agent đã xong (rdev 1.0.1 trở lên). Xóa khỏi danh sách ẩn một phiên, và Xóa các phiên đã kết thúc xóa cùng lúc mọi phiên đã hoàn thành, thất bại hoặc không hoạt động; một phiên báo cáo lại sẽ quay trở lại. Mở trong terminal web mở cửa sổ terminal đó trong terminal web của máy chủ từ một thiết bị trong tailnet của bạn (chỉ trên máy chủ của riêng bạn, rdev 1.4.5 trở lên); nếu cửa sổ không còn, phiên lâu dài thường dùng của bạn sẽ mở.
Điểm khôi phục: hoàn tác những gì agent đã làm
Khi một lượt của agent bắt đầu trong một dự án git, rdev trước tiên lưu một điểm khôi phục của các tệp dự án: tệp được theo dõi và tệp mới, không gồm tệp bị bỏ qua. Đó là một commit nằm ngoài các nhánh của bạn, nên git status, lịch sử và stash của bạn trông vẫn như cũ. Mỗi dự án giữ 20 điểm khôi phục gần nhất; một lượt không thay đổi gì sẽ không thêm điểm nào.
Checkpoint tự động trước mỗi lượt đến từ hook của agent, nên Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI và Gemini CLI tự có. Cursor CLI và Antigravity CLI không có hook như vậy; chúng có checkpoint khi bạn khởi chạy qua rdev, khi đó phiên cũng hiện trên bảng điều khiển và bạn được thông báo khi nó kết thúc:
rdev agents run cursor
Với Antigravity CLI, dùng rdev agents run antigravity.
Để hoàn tác, hãy mở máy chủ của bạn trên bảng điều khiển và chọn một điểm khôi phục trong Hoàn tác và khôi phục, hoặc làm trên máy chủ. Liệt kê các điểm khôi phục của dự án:
rdev checkpoint list
Sau đó khôi phục một điểm theo id của nó:
rdev checkpoint restore 1793603600
Khôi phục đưa các tệp trở lại như cũ và xóa các tệp được thêm kể từ đó; trạng thái hiện tại được lưu thành một điểm khôi phục mới trước (trừ khi nó trùng với điểm mới nhất đã có), nên một lần khôi phục cũng có thể được hoàn tác. rdev checkpoint create lưu một điểm thủ công. Điểm khôi phục cần rdev 0.2.0-beta.16 trở lên.