Sẽ mở trong thẻ mới
PDL AIAI Worker — trợ lý AI trực 24/7: trả lời khách, xử lý yêu cầu, báo cáo tự động
PDL DigitalBuild. Automate. Grow.
Nhận tư vấn
Công cụ AI

Muse Code của Meta: cài đặt, đặt quyền an toàn và giao việc song song cho subagent

Đăng Vũ HảiĐăng 23.10.2026Cập nhật 11.10.2026≈ … phút đọc
Nhìn từ trên xuống hai bàn tay đang gõ phím trên laptop, màn hình hiển thị trình soạn thảo mã

Cập nhật tháng 10/2026. Muse Code đang ở giai đoạn beta, lệnh, gói và giá có thể thay đổi nhanh; hãy đối chiếu với tài liệu chính thức của Meta trước khi áp dụng cho dự án thật.

Bài này dành cho ai: lập trình viên, freelancer làm web và trưởng nhóm kỹ thuật ở đội nhỏ đã nghe về Muse Code của Meta và muốn thử một cách an toàn trên dự án của mình.

Bạn sẽ nắm được gì: Muse Code là gì và hợp với việc gì; cách cài, đăng nhập, chạy phiên đầu tiên; cách đặt quyền và sandbox; cách giao nhiều việc song song cho subagent; 3 prompt mẫu, lỗi thường gặp và bài tập 1 buổi.

Thời gian đọc: khoảng 11 phút, thực hành thêm 45–60 phút.

Chuyên mục Công cụ AI đã đi qua Claude Code, OpenAI Codex và Google Antigravity. Tháng 8/2026, Meta tham gia với Muse Code: agent lập trình chạy trong terminal, dùng mô hình Muse Spark, nhấn mạnh việc chạy nhiều agent cùng lúc và ghi lại mọi hành động. Bài này hướng dẫn thử nó trên một dự án web nhỏ, theo tài liệu chính thức.

Nhìn từ trên xuống hai bàn tay đang gõ phím trên laptop, màn hình hiển thị trình soạn thảo mã
Muse Code sống trong terminal: bạn mô tả việc cần làm, agent lập kế hoạch, sửa tệp và chạy lệnh trong vùng được phép.

1. Muse Code là gì và dùng khi nào

Theo Meta, Muse Code là agent lập trình để xây dựng, gỡ lỗi và phát hành phần mềm, được huấn luyện cùng mô hình Muse Spark. Bài blog ra mắt ngày 5/8/2026 giới thiệu nó cùng Muse Spark 1.2 (ngữ cảnh 1 triệu token). Agent chạy trong terminal và CI, lập kế hoạch, sửa tệp, chạy lệnh, với cơ chế duyệt và sandbox bật sẵn.

Nhiều agent mặc định

Agent chính có thể sinh agent con cho từng việc; mỗi agent con làm trong một git worktree riêng nên không giẫm chân nhau.

Kiểm tra lại được

Mọi phiên, mọi hành động được ghi thành tệp JSONL trên máy. Phiên bị tắt giữa chừng có thể chạy tiếp bằng muse resume.

Đọc quy ước dự án

Muse Code đọc AGENTS.md hoặc CLAUDE.md có sẵn trong dự án, nên bộ nhớ dự án bạn đã viết cho công cụ khác dùng lại được.

Muse Code hợp khi bạn có nhiều việc độc lập trên cùng một kho mã và muốn chúng chạy song song rồi duyệt từng nhánh. Dự án chưa có git thì hãy tạo kho git trước.

2. Gói và chi phí cần biết trước

Tại thời điểm viết, trang sản phẩm và bài blog của Meta nêu hai cách trả tiền:

  • Gói thuê bao Muse Code: ba mức Everyday Usage, High Usage và Power Usage, khác nhau ở hạn mức dùng trong cửa sổ 5 giờ. Giá có thể đổi trong giai đoạn beta, hãy xem trang chính thức trước khi mua.
  • Trả theo token qua Meta Model API: hợp khi chạy trong CI bằng khoá API; token suy nghĩ được tính như token đầu ra.
  • Bản contributor: mô hình có hậu tố -contributor rẻ hơn nhiều, giới hạn theo token trong cửa sổ 5 giờ, chỉ có ở một số quốc gia, và yêu cầu của bạn có thể được dùng để cải thiện sản phẩm của Meta.

Mã nguồn của khách hàng hoặc có dữ liệu nhạy cảm thì không chạy bằng bản contributor. Tuỳ chọn không lưu dữ liệu (zero data retention) phải liên hệ bộ phận kinh doanh của Meta. Đổi bản bằng lệnh /models trong phiên.

3. Cài đặt và chạy phiên đầu tiên

1

Cài bằng một lệnh

Trên macOS hoặc Linux, mở terminal và chạy curl -fsSL https://dev.meta.ai/install.sh | sh. Trên Windows dùng PowerShell: irm https://dev.meta.ai/install.ps1 | iex. Trình cài đặt đặt tệp chạy muse vào PATH. Kiểm tra bằng muse --version; nếu báo không tìm thấy lệnh, mở lại cửa sổ terminal.

2

Vào thư mục dự án và gõ muse

Lần đầu mở thư mục, Muse Code hỏi có tin cậy workspace không; chỉ khi đồng ý nó mới nạp skill, quy tắc và hook của dự án. Với kho mã lạ, đọc qua tệp hướng dẫn trước.

3

Đăng nhập

Chọn đăng nhập qua trình duyệt tại dev.meta.ai, hoặc dùng khoá API. Trong phiên, gõ /login để mở lại lựa chọn đăng nhập. Môi trường không tương tác như CI dùng biến môi trường META_API_KEY.

4

Tạo hoặc kiểm tra AGENTS.md

Nếu dự án chưa có tệp quy ước, chạy muse init để tạo AGENTS.md. Muse Code đọc lần lượt AGENTS.md, CLAUDE.md, .agents/AGENTS.md, .claude/CLAUDE.md và dùng tệp đầu tiên tìm thấy ở mỗi cấp thư mục. Ghi vào đó lệnh chạy thử, lệnh kiểm tra và những thư mục không được đụng.

5

Giao một việc nhỏ chỉ đọc

Gõ “Đọc dự án này, tóm tắt cấu trúc, cách chạy và 3 điểm rủi ro. Không sửa tệp nào.” Kết quả mong đợi: bản tóm tắt ngắn, git status không đổi.

4. Đặt quyền an toàn trước khi giao việc thật

Trang phân quyền của Muse Code mô tả ba chế độ duyệt, chọn bằng cờ --approval-mode:

on-request (mặc định)

Lệnh shell an toàn chạy luôn trong sandbox; mẫu nguy hiểm như xoá hàng loạt sẽ dừng lại chờ bạn duyệt.

untrusted

Mọi lệnh shell không khớp quy tắc cho phép đều dừng chờ duyệt. Đọc tệp và sửa tệp trong workspace vẫn chạy.

never

Không hỏi gì nữa, chỉ còn sandbox giới hạn. Chỉ dùng khi đã quen công cụ và dự án có git sạch.

Một vài điểm nên nhớ:

  • Lệnh ghép được tách thành từng bước. Ví dụ npm test && rm -rf dist được kiểm tra từng phần; bạn từ chối một bước thì cả lệnh không chạy.
  • Khi được hỏi: cho phép một lần, luôn cho phép trong workspace, hoặc từ chối. Quy tắc chặn luôn thắng.
  • Sandbox chỉ cho ghi trong workspace và thư mục tạm; .git, .muse, .agents chỉ đọc. Mạng mặc định duyệt theo từng địa chỉ.
  • Tránh --yolo trên máy làm việc. Cờ này tắt cả duyệt lẫn sandbox; Meta khuyên chỉ dùng trong môi trường đã cô lập sẵn.
Ảnh đen trắng chiếc laptop đang mở mã nguồn đặt trên bàn cạnh cốc và sổ ghi chép, phía sau là tường gạch
Giao cho agent một dự án có git sạch và tệp quy ước rõ ràng: rủi ro giảm, kết quả dễ duyệt hơn.

5. Ba prompt mẫu cho dự án web

Mẫu 1: Lập kế hoạch trước, chưa sửa mã

Muse Code có skill dựng sẵn /plan: đọc tệp, nêu các quyết định chính kèm đề xuất, lưu kế hoạch vào .agents/plans/ rồi dừng chờ duyệt.

/plan Thêm bộ lọc theo giá và theo danh mục cho trang danh sách sản phẩm.
Ràng buộc: giữ nguyên URL hiện có, không thêm thư viện mới, chạy được trên điện thoại.
Liệt kê tệp sẽ sửa, rủi ro, và cách tôi tự kiểm tra sau khi xong.

Mẫu 2: Chia việc song song cho subagent

Chạy muse --subagent-worktree-isolation trong kho git: mỗi agent con nhận worktree riêng dưới .muse/worktrees/ và commit vào nhánh riêng.

Có 3 việc độc lập, giao mỗi việc cho một subagent:
1. Sửa lỗi menu di động không đóng khi bấm ra ngoài.
2. Thêm thuộc tính alt còn thiếu cho ảnh trong thư mục templates/.
3. Viết test cho hàm tính phí vận chuyển trong src/shipping.js.
Mỗi subagent commit vào nhánh riêng, chạy npm test trước khi báo xong.
Khi xong cả ba, tóm tắt thay đổi từng nhánh để tôi duyệt và gộp lần lượt.

Mẫu 3: Đặt mục tiêu cho việc dài hơi

Lệnh /goal giữ agent làm đến khi xong và tự rà từng yêu cầu. Esc tạm dừng, /goal resume chạy tiếp.

/goal Đưa điểm Lighthouse Accessibility của trang chủ lên tối thiểu 90.
Chỉ sửa HTML và CSS trong thư mục theme/. Không đổi nội dung chữ.
Sau mỗi thay đổi, ghi lại lỗi đã sửa và cách kiểm tra.

6. Ví dụ: đội làm web 3 người nhận bảo trì nhiều website

Ví dụ minh hoạ: một nhóm freelancer ở TP.HCM bảo trì website cho vài cửa hàng, mỗi tuần nhận danh sách việc lặt vặt qua Zalo:

  • Thứ Hai: gom yêu cầu thành danh sách, chạy Mẫu 1 để có kế hoạch, trưởng nhóm duyệt trong 10 phút.
  • Thứ Ba: chạy Mẫu 2 cho các việc độc lập, review từng nhánh như pull request.
  • Cuối tuần: dùng /export transcript --redacted để xuất nhật ký đã che chuỗi giống mật khẩu, đính kèm báo cáo cho khách.

Nhóm giữ thói quen: agent không bao giờ được deploy, nhánh chỉ gộp sau khi người thật chạy thử trên máy.

7. Lỗi thường gặp

  • Chạy trong thư mục chưa có git: mất khả năng tách worktree và khó hoàn tác. Chạy git init và commit trước.
  • Giao các việc phụ thuộc nhau cho nhiều subagent: hai nhánh cùng sửa một tệp sẽ xung đột khi gộp. Chỉ tách những việc thật sự độc lập.
  • Tin tệp MEMORY.md của kho lạ: bộ nhớ dự án đã commit trong .agents/memory/ được nạp cả khi workspace chưa được tin cậy, nên hãy đọc nó với kho mã không do bạn quản lý.

8. Bài tập thực hành trong 1 buổi

  1. Tạo một bản sao dự án web nhỏ (landing page tĩnh là đủ), khởi tạo git và commit.
  2. Cài Muse Code, chạy muse, tin cậy workspace, chạy muse init và bổ sung lệnh chạy thử vào AGENTS.md.
  3. Giao việc chỉ đọc ở bước 5 phần 3, so sánh bản tóm tắt với hiểu biết của bạn.
  4. Chạy Mẫu 1, duyệt kế hoạch, rồi chạy Mẫu 2 với 2–3 việc nhỏ có thật trong dự án.
  5. Xem /subagents, duyệt từng nhánh bằng git diff, chỉ gộp nhánh đạt và ghi lại lỗi agent mắc phải.
Cận cảnh màn hình tối hiển thị nhiều dòng mã JavaScript nhiều màu, chụp nghiêng
Mỗi nhánh do subagent tạo ra vẫn là mã bạn phải đọc và chịu trách nhiệm trước khi gộp.

9. So sánh nhanh với Claude Code và Codex

Ba công cụ đều là agent lập trình đọc kho mã, sửa tệp và chạy lệnh. Khác biệt chính nằm ở cách làm việc:

Muse Code

Mới, đang beta. Mạnh ở chạy song song nhiều subagent trong worktree riêng và nhật ký JSONL; có gói thuê bao giá thấp để thử.

Claude Code

Hệ sinh thái trưởng thành, nhiều tài liệu và tích hợp. Xem quy trình sửa lỗi WordPress an toàn trong bài hướng dẫn Claude Code.

OpenAI Codex

Hợp với giao việc chạy nền và nhờ review code. Xem cách đội nhỏ dùng trong bài về Codex.

Vì Muse Code đọc cả AGENTS.md lẫn CLAUDE.md, bạn có thể dùng chung một tệp quy ước cho cả ba công cụ, như cách làm trong bài CLAUDE.md và AGENTS.md cho dự án web.

Thuật ngữ cần biết

  • Subagent: agent con do agent chính sinh ra để làm một phần việc rồi báo kết quả về (Meta cookbook).
  • Git worktree: tính năng của git cho phép mở nhiều thư mục làm việc từ cùng một kho, mỗi thư mục ở một nhánh khác nhau (git-scm.com).
  • Sandbox: vùng giới hạn do hệ điều hành áp đặt, chỉ cho lệnh của agent ghi tệp và truy cập mạng trong phạm vi được phép (tài liệu Muse Code).
  • JSONL: định dạng mỗi dòng là một bản ghi JSON, tiện để ghi nhật ký và lọc bằng công cụ dòng lệnh (jsonlines.org).
  • AGENTS.md: tệp hướng dẫn chung cho các agent lập trình, đặt ở gốc dự án (agents.md).

Tìm hiểu thêm

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

Muse Code có miễn phí không?

Tại thời điểm viết, trang sản phẩm chỉ niêm yết các gói thuê bao trả phí và cách trả theo token qua API. Bản contributor rẻ hơn nhưng chỉ có ở một số quốc gia và có thể dùng dữ liệu của bạn để cải thiện sản phẩm.

Muse Code chạy trên hệ điều hành nào?

Tài liệu ghi hỗ trợ macOS, Linux và Windows. Trên Windows, lệnh của agent chạy bằng PowerShell, sandbox có thể hỏi quyền UAC một lần, và chưa có nhập giọng nói.

Muốn đội của bạn dùng agent lập trình đúng quy trình, có quy ước dự án và cơ chế duyệt rõ ràng? Tham khảo chương trình đào tạo và triển khai AI của PDL.

Tác giả
Đăng Vũ Hải
Thuộc Ban AI Worker của PDL, chuyên thử và so sánh công cụ AI cho văn phòng: trợ lý AI, tự động hoá, bảng tính. Phụ trách chuỗi hướng dẫn dùng Claude.
Tư vấn 1:1

Bạn đang có bài toán số cần gỡ?

Website · AI · Quảng cáo · 360VR — chuyên gia PDL phản hồi trong giờ làm việc (T2–T7, 8h–18h).
Xem giải pháp
PDL · Tư vấn 1:1

Nhận tư vấn
miễn phí

Để lại thông tin, chuyên viên PDL sẽ liên hệ để hiểu nhu cầu và đề xuất giải pháp phù hợp ngân sách của bạn.

  • Phân tích nhanh hiện trạng website, quảng cáo, kênh bán hàng
  • Đề xuất lộ trình & báo giá minh bạch, rõ từng hạng mục
  • Không ràng buộc: nghe tư vấn xong mới quyết định
Giờ làm việc T2–T7 · 08:00–18:00

Chỉ mất khoảng 30 giây

Bạn cần tư vấn về

🔒 Thông tin được bảo mật, chỉ dùng để PDL liên hệ tư vấn.