Tổng hợp lệnh Muse Code CLI: lệnh, flag và phím tắt

Muse Code là chương trình chạy trong terminal, và lệnh muse lo gần như mọi thứ. Trang này gom các lệnh, flag, slash command và phím tắt từ tài liệu của Meta tính đến CLI 1.4.13. Gõ /help trong phiên làm việc để xem danh sách đầy đủ mà phiên bản của bạn hỗ trợ, và /keymap để xem phím tắt.

Cài đặt, đăng nhập và kiểm tra phiên bản

Lệnh	Tác dụng
curl -fsSL https://dev.meta.ai/install.sh | sh	Cài đặt trên macOS hoặc Linux
irm https://dev.meta.ai/install.ps1 | iex	Cài đặt trên Windows (PowerShell)
muse --version	Xem phiên bản đã cài
muse	Mở phiên làm việc trong thư mục hiện tại; lần chạy đầu sẽ yêu cầu đăng nhập
muse auth set	Lưu API key thay vì đăng nhập qua trình duyệt
/login	Mở lại các tùy chọn đăng nhập ngay trong phiên
muse logout	Xóa phiên trình duyệt và key đã lưu
muse usage	Xem hạn mức của gói còn lại bao nhiêu
/upgrade	Mở Accounts Center để đổi gói

Muse Code tự cập nhật. Hướng dẫn cài đặt của chúng tôi có phần cập nhật, xử lý lỗi và gỡ cài đặt.

Slash command trong phiên

Lệnh	Tác dụng
/help	Liệt kê mọi lệnh có trong workspace này
/new	Mở phiên mới, giữ nguyên lịch sử cuộn của terminal
/clear	Mở phiên mới và xóa sạch lịch sử cuộn
/resume	Chọn một phiên cũ trong workspace này để làm tiếp
/resume --last	Làm tiếp phiên gần nhất
/name [name]	Xem hoặc đặt tên phiên
/fork	Rẽ nhánh phiên mới từ điểm ổn định gần nhất
/rewind	Rẽ nhánh từ một tin nhắn trước đó của bạn
/side [prompt] hoặc /btw <prompt>	Mở cuộc trò chuyện phụ mà không làm lệch mạch chính
/compact	Tóm tắt ngữ cảnh cũ để giải phóng chỗ
/recap	Tóm tắt hoạt động gần đây
/copy	Copy câu trả lời cuối cùng
/export transcript	Lưu cuộc hội thoại thành file .txt
/export trajectory	Lưu toàn bộ log phiên dưới dạng JSON

Lập kế hoạch, mục tiêu và agent

Lệnh	Tác dụng
/plan	Lên kế hoạch và chờ bạn duyệt rồi mới bắt tay làm
/grill	Vặn vẹo kế hoạch đến khi nó đứng vững
/goal <objective>	Đặt mục tiêu cho agent theo đuổi; quản lý bằng /goal pause, /goal resume, /goal edit, /goal clear
/loop <cadence> <prompt>	Lặp một prompt theo chu kỳ (10m) hoặc biểu thức cron
/workflows	Mở phòng điều khiển cho các lượt chạy workflow multi-agent
/subagents	Xem các subagent đang chạy và đã xong
/tasks	Mở ngăn background task
/stop	Hủy background task và terminal

Bài skill có sẵn giải thích /plan, /grill và /goal phối hợp với nhau thế nào.

Model và reasoning

Lệnh hoặc flag	Tác dụng
/model <model-id>	Đổi model trực tiếp, ví dụ /model muse-wonder-1.0
/models	Mở bộ chọn model
/effort	Đặt mức reasoning cho phiên
--model <id>	Chọn model khi khởi động
--reasoning-effort <level>	none, minimal, low, medium, high (mặc định), xhigh, max hoặc ultra
/settings	Cài đặt, bao gồm Model → Contributor mode trên các gói
--contributor-mode on|off	Ghi đè Contributor mode cho một lần chạy

Token reasoning được tính như output, nên chỉ để dành max và ultra cho bài toán khó. Đặt mức ultra còn có thể tự khởi động một workflow multi-agent.

Phím tắt

Phím	Tác dụng
Enter khi agent đang chạy	Lái hướng: chèn nội dung của bạn vào lượt đang chạy
Alt+Enter	Xếp hàng nội dung cho lượt kế tiếp
Esc	Ngắt lượt hiện tại
Esc khi ô prompt trống	Rút lại chỉ dẫn vừa xếp hàng
Esc Esc khi đang rảnh	Rewind
Ctrl+C	Ngắt (khi prompt trống) hoặc xóa nội dung đang nhập
Alt+V (Option+V trên Mac)	Bật hoặc tắt nhập bằng giọng nói (không có trên Windows)

Khi agent hỏi lại để làm rõ, phím số dùng để chọn đáp án, Space bật/tắt chọn nhiều, Tab thêm ghi chú, còn Enter để gửi.

Chạy headless: muse exec

Flag	Tác dụng
muse exec "<prompt>"	Chạy một task đến khi xong rồi thoát
--json	In event JSONL ra stdout
--prompt-file <path>	Đọc prompt từ file
--max-model-steps <n>	Giới hạn khối lượng việc của lượt chạy
--session-id <uuid>	Làm tiếp một phiên cũ ở chế độ không tương tác
--no-session-log	Không lưu log phiên
muse export --session <uuid> --out run.json	Xuất một phiên

Exit code: 0 là lượt chạy hoàn tất, 1 là thất bại hoặc bị hủy (kể cả khi chạm giới hạn step), 2 là dùng sai lệnh, 130/143 là bị ngắt. 0 không có nghĩa code đúng — hãy chạy test. Trong CI, xác thực bằng META_API_KEY; hướng dẫn API key của chúng tôi có ví dụ.

Quyền và sandbox

Flag	Tác dụng
--approval-mode on-request	Mặc định: lệnh shell rủi ro sẽ dừng lại chờ duyệt
--approval-mode untrusted	Mọi thứ không có allow rule đều dừng lại chờ duyệt
--approval-mode never	Không hỏi duyệt; sandbox vẫn áp dụng
--approval-judge off	Chuyển mọi quyết định duyệt cho bạn thay vì judge có sẵn
--disable-approval	Bỏ qua bước duyệt, giữ sandbox
--disable-sandbox	Giữ bước duyệt, bỏ sandbox
--yolo	Không duyệt, không sandbox, tin tưởng workspace — chỉ dùng trong container dùng xong bỏ
--sandbox-network <mode>	proxy-only (mặc định), restricted hoặc unrestricted
--trust-workspace	Tin tưởng thư mục mà không cần hỏi ở lần chạy đầu

Phiên làm việc khởi đầu ở profile Auto-review; các profile còn lại là Ask me, Read-only và Unrestricted. Tài liệu giải thích mỗi profile cho phép những gì.

Skill, MCP và thiết lập dự án

Lệnh	Tác dụng
muse init	Tạo file AGENTS.md cho dự án (--dry-run để xem trước)
muse skills list	Liệt kê skill đã cài
muse skills install ./my-skill --scope user	Cài một skill
muse skills import --from claude	Import skill của Claude Code (--from codex cho Codex)
/migrate	Import memory và cấu hình MCP của Claude Code hoặc Codex
/mcp	Xem các MCP server và tool đang kết nối
muse mcp login <server>	Đăng nhập vào một MCP server từ xa
muse config status	Xem cài đặt nào đang có hiệu lực
/theme	Đổi theme của terminal

File nằm ở đâu

• Cài đặt: ~/.config/muse/settings.json — profile quyền mặc định, MCP server, hook, thời gian giữ phiên.
• Chỉ dẫn dự án: AGENTS.md; Muse Code cũng đọc CLAUDE.md, .agents/AGENTS.md và .claude/CLAUDE.md.
• Skill và memory của dự án: .agents/skills/ và .agents/memory/ trong repository.
• Hook của dự án: .muse/hooks.json, chỉ được nạp sau khi bạn tin tưởng thư mục.

Mới dùng Muse Code? Hãy bắt đầu với bài làm quen, rồi để trang này mở sẵn trong một tab.