kosa8

plugin kosa8 cho Claude Code

kosa8: Hạ tầng bảo mật cho các tác nhân AI.

Cung cấp cho Claude một máy được niêm phong để làm việc. Plugin này kết nối Claude Code với kosa8, hạ tầng bảo mật cho các tác nhân AI: mỗi tác nhân được cấp một máy được niêm phong riêng, một microVM thực sự có kernel riêng, chứ không phải container dùng chung kernel của máy chủ.

Khi bật plugin, Claude có thể:

• chạy mã không đáng tin cậy hoặc do tác nhân viết trong một microVM được niêm phong, chỉ nhìn thấy một thư mục (workspace) và không thấy bất kỳ thứ gì khác trên máy chủ;
• làm việc trong mạng đóng, nơi chỉ các máy chủ trong danh sách cho phép do bạn viết mới có thể truy cập, còn mọi thứ khác đều bị từ chối kết nối;
• sử dụng khóa API mà không cần giữ chúng: một bộ trung gian chuyển tiếp lưu lượng ra ngoài trên máy chủ sẽ chèn khóa khi gửi đi, còn sandbox chỉ giữ một giá trị giữ chỗ;
• tạo điểm kiểm tra cho toàn bộ máy đang chạy, gồm bộ nhớ và các tiến trình, trong khoảng 0.7 giây trước một bước rủi ro, rồi tua lại máy vẫn đang chạy trong khoảng một giây khi có sự cố;
• phân nhánh một máy đang chạy thành các bản sao trực tiếp để thử nhiều cách tiếp cận song song và giữ lại cách hoạt động hiệu quả;
• chờ một hoặc hai người phê duyệt được chỉ định xác nhận các hành động rủi ro (quy tắc hai người), đồng thời ghi mọi hành động vào nhật ký kiểm tra có chuỗi băm, chống giả mạo.

Plugin gồm bốn phần:

• Máy chủ MCP (.mcp.json) khởi chạy kosa8 mcp serve thông qua scripts/kosa8-mcp dưới dạng tiến trình stdio cục bộ.
• Kỹ năng (skills/kosa8-sandbox) hướng dẫn Claude khi nào nên dùng sandbox và cách sử dụng an toàn các điểm kiểm tra, tua lại, phân nhánh, danh sách cho phép lưu lượng ra ngoài và phê duyệt.
• Lệnh: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (hỏi trước khi tua lại) và /kosa8:explore (thử nhiều lệnh trong các nhánh song song).
• Tác nhân: sandbox-runner chạy mã không đáng tin cậy hoặc mã được tạo trong một microVM được niêm phong rồi báo cáo những gì đã thực hiện; fork-explorer so sánh các cách tiếp cận trong những nhánh song song của cùng một sandbox đang chạy.

Điều kiện tiên quyết

• Claude Code.
• kosa8 được cài đặt trên cùng máy, với kosa8 trên PATH. kosa8 chạy trên máy Mac dùng chip Apple và Linux x86-64, cũng như trên Windows thông qua WSL2 (bản xem trước). Tải xuống tại kosa8.com/download. Các bản phát hành được ký và công chứng. Kiểm tra cài đặt bằng kosa8 version.
• Daemon kosa8 đang chạy. Plugin chỉ là một trình khởi chạy mỏng: các sandbox là microVM do kosa8d chạy trên máy của bạn, vì vậy sẽ không có gì hoạt động cho đến khi daemon khởi chạy.

Trước khi bắt đầu: cài đặt kosa8 và khởi chạy daemon

Plugin không cài đặt kosa8 và không thể chạy nếu thiếu phần mềm này. Trên máy mới:

# 1. Install kosa8 (macOS on Apple silicon, x86-64 Linux, or WSL2)
#    from https://kosa8.com/download/, then check it:
kosa8 version

# 2. Start the daemon that runs the microVMs:
kosa8 daemon start

# 3. Confirm both halves are up:
kosa8 version          # prints "kosa8 daemon <version> (up Ns)"
kosa8 mcp tools        # lists the tools this plugin exposes

Nếu kosa8 version báo kosa8 daemon: not running, hãy chạy lại kosa8 daemon start. Máy chủ MCP khởi chạy được mà không cần daemon, nhưng khi đó mọi công cụ sandbox đều trả lời cannot reach kosa8d.

Các tác nhân cài đặt máy chủ này cho người dùng có thể làm theo llms-install.md.

Cài đặt

Trong Claude Code, thêm kho lưu trữ này làm marketplace rồi cài đặt plugin:

/plugin marketplace add kosa8ai/kosa8-claude-plugin
/plugin install kosa8@kosa8

Hoặc chạy từ shell:

claude plugin marketplace add kosa8ai/kosa8-claude-plugin
claude plugin install kosa8@kosa8

Khởi động lại Claude Code (hoặc chạy /reload-plugins). Chạy /mcp để xác nhận máy chủ kosa8 đã kết nối, rồi yêu cầu Claude “kiểm tra trạng thái kosa8”.

Chia sẻ thư mục trên máy chủ

Theo mặc định, tác nhân không thể chia sẻ bất kỳ thư mục nào trên máy chủ vào sandbox. Để cho phép chúng chia sẻ một thư mục dự án, hãy khởi chạy máy chủ với --allow-mount DIR (chỉ đọc) hoặc --allow-mount DIR:rw. Bạn có thể thực hiện việc này bằng cách thêm mục máy chủ MCP của riêng mình, ví dụ trong .mcp.json của một dự án:

{
  "mcpServers": {
    "kosa8-workspace": {
      "command": "kosa8",
      "args": ["mcp", "serve", "--allow-mount", "/Users/you/code/api:rw"]
    }
  }
}

Mạng và khóa

Quyền truy cập mạng của sandbox được thiết lập khi tạo sandbox. Để cấp cho sandbox quyền truy cập vào một API duy nhất và không gì khác, hãy tạo sandbox từ terminal:

kosa8 sandbox create sealed --egress-allow api.anthropic.com

Công cụ

kosa8 mcp serve cung cấp các công cụ sau (theo báo cáo của kosa8 mcp tools trong kosa8 0.5.0):

Công cụ	Chức năng
kosa8_status	Kiểm tra daemon kosa8 có đang chạy hay không và báo cáo phiên bản
sandbox_create	Khởi động sandbox microVM biệt lập với kernel và bộ máy container riêng
sandbox_list	Liệt kê sandbox, bao gồm nhánh nào được tạo từ sandbox cha nào
sandbox_run	Chạy container bên trong bộ máy riêng của sandbox, biệt lập với máy chủ
sandbox_pull	Tải image vào bộ máy riêng của sandbox
sandbox_checkpoint	Lưu điểm khôi phục, bao gồm bộ nhớ và các tiến trình đang chạy
sandbox_checkpoint_list	Liệt kê các điểm khôi phục của sandbox
sandbox_rewind	Khôi phục sandbox về một điểm kiểm tra, tiếp tục chạy các tiến trình
sandbox_fork	Phân nhánh sandbox đang chạy thành N bản sao độc lập
sandbox_explore	Chọn phương án tốt nhất trong N phương án: tạo một nhánh cho mỗi lệnh ứng viên, chạy đồng thời và giữ lại phương án thắng cuộc
sandbox_snapshot	Chụp toàn bộ trạng thái của sandbox thành ảnh chụp
sandbox_stop	Dừng sandbox mà không xóa
sandbox_start	Khởi động sandbox đã dừng từ đĩa riêng của nó
sandbox_delete	Dừng và xóa sandbox cùng máy ảo của nó
snapshot_list	Liệt kê ảnh chụp sandbox đã lưu
snapshot_restore	Khởi động sandbox từ ảnh chụp, tiếp tục chạy các tiến trình
snapshot_rm	Xóa ảnh chụp
container_run	Chạy container đến khi hoàn tất và trả về đầu ra
container_exec	Chạy lệnh bên trong container đang chạy
container_list	Liệt kê container
container_logs	Lấy đầu ra của container
container_stats	Báo cáo mức sử dụng CPU, bộ nhớ và pid của container
container_stop	Dừng container đang chạy
image_build	Tạo image từ Dockerfile trong thư mục trên máy chủ
image_list	Liệt kê image
image_pull	Tải image từ registry
network_create	Tạo mạng cầu nối biệt lập
network_list	Liệt kê mạng container
volume_create	Tạo volume có tên
volume_list	Liệt kê volume có tên

Chạy kosa8 mcp tools để xem danh sách dành cho phiên bản bạn đã cài đặt.

Plugin này chạy những gì

Tệp thực thi duy nhất của plugin là scripts/kosa8-mcp, một shell script ngắn tìm bản kosa8 đã được cài đặt trên máy của bạn rồi chạy kosa8 mcp serve. Tệp này không tải xuống hay cài đặt gì. Bản thân plugin không gửi dữ liệu đi đâu, không liên hệ máy chủ nào và không đọc thông tin xác thực.

Các ứng dụng MCP khác

Máy chủ này cũng được phát hành trên Official MCP Registry với tên io.github.kosa8ai/kosa8 (xem server.json). Máy chủ được phân phối dưới dạng gói MCP, kosa8-mcp.mcpb, đính kèm trong mỗi bản phát hành GitHub: một tệp kê khai và cùng trình khởi chạy ngắn dưới dạng scripts/kosa8-mcp. Tệp này không tải xuống hay cài đặt gì, vì vậy hãy cài đặt kosa8 trước.

Mọi ứng dụng MCP có thể khởi chạy máy chủ stdio cũng có thể chạy trực tiếp kosa8 mcp serve.

Quyền riêng tư

Máy chủ MCP kosa8 chạy cục bộ và giao tiếp với daemon kosa8 trên cùng máy. Theo chính sách quyền riêng tư của kosa8, các lệnh gọi công cụ mà tác nhân của bạn thực hiện, đối số và kết quả của chúng đều nằm trên máy của bạn và không bao giờ được gửi đến kosa8. Chính sách liệt kê mọi dữ liệu mà phần mềm kosa8 gửi đi và thời điểm gửi, bao gồm cả việc kiểm tra giấy phép trả phí, cũng như cách tắt toàn bộ các lệnh gọi ra ngoài bằng KOSA8_OFFLINE=1.

Toàn văn chính sách: https://kosa8.com/privacy/

Giá

kosa8 là phần mềm thương mại. Các tệp plugin trong kho lưu trữ này miễn phí và được cấp phép theo MIT, nhưng bản thân kosa8 cần có giấy phép: phần mềm đi kèm bản dùng thử miễn phí 14 ngày với đầy đủ tính năng, không cần tài khoản và thẻ thanh toán. Các gói bắt đầu từ $29 mỗi tháng. Xem https://kosa8.com/pricing/.

Hỗ trợ và liên hệ

• Email: contact@kosa8.com
• Vấn đề: https://github.com/kosa8ai/kosa8-claude-plugin/issues
• Trang web: https://kosa8.com

Giấy phép

Các tệp trong kho lưu trữ này được phát hành theo Giấy phép MIT. Giấy phép chỉ áp dụng cho các tệp trong kho lưu trữ này (plugin Claude Code: tệp kê khai, tệp marketplace, cấu hình MCP, kỹ năng, lệnh, tác nhân, trình khởi chạy, README và logo). Giấy phép không áp dụng cho chính phần mềm kosa8, vốn là phần mềm thương mại được phân phối riêng theo các điều khoản riêng.