kosa8

官方

為 AI 代理打造的安全基礎架構：可建立檢查點、回溯及分叉的密封式 microVM 沙箱。

GitHub

你可以用 kosa8 MCP 做什麼？

在密封的 microVM 中執行程式碼 — 請 Claude 在隔離的 microVM 中執行不受信任或產生的程式碼，且只能存取工作區資料夾。
建立沙箱檢查點並回復 — 儲存包含記憶體與執行中程序的還原點，然後回復至該還原點並恢復程序。
分叉執行中的沙箱 — 將執行中的沙箱分叉成多個獨立副本，以平行嘗試不同方法，並保留可行的方法。
限制網路對外連線 — 建立網路僅能連線至允許清單中主機的沙箱，並拒絕其他所有連線。
檢查 daemon 狀態 — 請 Claude 檢查 kosa8 daemon 是否正在執行，並回報其版本。

文件

Claude Code 的 kosa8 外掛程式

kosa8：為 AI 代理提供安全的基礎架構。

為 Claude 提供一台密封的工作機器。此外掛程式會將 Claude Code 連接到 kosa8，這是為 AI 代理提供的安全基礎架構：每個代理都有自己的密封機器，也就是一台擁有自身核心的真正 microVM，而不是與主機共用核心的容器。

啟用此外掛程式後，Claude 可以：

在密封的 microVM 中執行不受信任或由代理撰寫的程式碼；該 microVM 只能看到一個資料夾（工作區），看不到主機上的其他任何內容；
在封閉網路環境中工作，只有你撰寫的允許清單中的主機可以連線，其他連線都會遭到拒絕；
使用 API 金鑰而不持有金鑰：主機上的輸出流量代理會在連線送出時注入金鑰，沙箱中只會保留佔位符；
在執行風險步驟前，於約 0.7 秒內建立整台執行中機器的檢查點，包括記憶體和程序，出錯時則可在約一秒內將仍在執行的機器還原；
將執行中的機器分叉成多個即時副本，以平行嘗試不同方法，並保留可行的方法；
在風險操作前等待一或兩位指定的人類核准者（雙人規則），並將每項操作寫入雜湊鏈結、防竄改的稽核記錄。

此外掛程式包含四個部分：

MCP 伺服器（.mcp.json），會透過 scripts/kosa8-mcp 將 kosa8 mcp serve 作為本機 stdio 程序啟動。
技能（skills/kosa8-sandbox），告訴 Claude 何時使用沙箱，以及如何安全地使用檢查點、還原、分叉、輸出流量允許清單和核准功能。
命令： /kosa8:status、/kosa8:sandbox <task>、/kosa8:checkpoint、 /kosa8:rewind（還原前會先詢問）和 /kosa8:explore（在多個平行分叉中嘗試多個命令）。
代理： sandbox-runner 會在密封的 microVM 中執行不受信任或產生的程式碼，並回報執行內容；fork-explorer 會在同一個執行中沙箱的平行分叉中比較不同方法。

先決條件

Claude Code。
在同一台機器上安裝 kosa8，並將 kosa8 放在你的 PATH 上。kosa8 可在 Apple 晶片 Mac 和 x86-64 Linux 上執行，也可透過 WSL2 在 Windows 上執行（預覽版）。請從 kosa8.com/download 安裝。發行版本均經過簽署和公證。使用 kosa8 version 檢查安裝狀態。
kosa8 daemon 正在執行。此插件是精簡的啟動器：沙箱是由你機器上的 kosa8d 執行的 microVM，因此 daemon 未啟動時，任何功能都無法運作。

開始之前：安裝 kosa8 並啟動 daemon

此外掛程式不會安裝 kosa8，沒有 kosa8 也無法執行。在新機器上：

# 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

如果 kosa8 version 回報 kosa8 daemon: not running，請再次執行 kosa8 daemon start。MCP 伺服器可以在 daemon 未啟動時啟動，但此時每個沙箱工具都會回覆 cannot reach kosa8d。

為使用者安裝此伺服器的代理可以參閱 llms-install.md。

安裝

在 Claude Code 中，將此儲存庫新增為市集並安裝此外掛程式：

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

或從 shell 執行：

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

重新啟動 Claude Code（或執行 /reload-plugins）。執行 /mcp，確認 kosa8 伺服器已連線，然後請 Claude「檢查 kosa8 狀態」。

共用主機資料夾

依預設，代理無法將任何主機目錄共用到沙箱中。若要讓代理共用專案資料夾，請使用 --allow-mount DIR（唯讀）或 --allow-mount DIR:rw 啟動伺服器。你可以新增自己的 MCP 伺服器項目來設定，例如在專案的 .mcp.json 中：

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

網路和金鑰

沙箱的網路存取權限會在建立時設定。若要讓沙箱只能存取一個 API，請從終端機建立：

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

工具

kosa8 mcp serve 提供以下工具（由 kosa8 0.5.0 中的 kosa8 mcp tools 回報）：

工具	功能
`kosa8_status`	檢查 kosa8 daemon 是否正在執行，並回報其版本
`sandbox_create`	啟動隔離的 microVM 沙箱，配備自己的核心和容器引擎
`sandbox_list`	列出沙箱，包括每個分叉的來源父項
`sandbox_run`	在沙箱的私有引擎中執行容器，與主機隔離
`sandbox_pull`	將映像檔拉取至沙箱的私有引擎
`sandbox_checkpoint`	儲存還原點，包括記憶體和執行中的程序
`sandbox_checkpoint_list`	列出沙箱的還原點
`sandbox_rewind`	將沙箱還原至檢查點，並恢復程序執行
`sandbox_fork`	將執行中的沙箱分叉成 N 個獨立副本
`sandbox_explore`	Best-of-N：為每個候選命令建立一個分叉、並行執行，並保留勝出者
`sandbox_snapshot`	擷取沙箱的完整狀態作為快照
`sandbox_stop`	停止沙箱但不刪除它
`sandbox_start`	從沙箱自己的磁碟啟動已停止的沙箱
`sandbox_delete`	停止並刪除沙箱及其 VM
`snapshot_list`	列出已儲存的沙箱快照
`snapshot_restore`	從快照啟動沙箱，並恢復程序執行
`snapshot_rm`	刪除快照
`container_run`	執行容器直到完成並傳回其輸出
`container_exec`	在執行中的容器內執行命令
`container_list`	列出容器
`container_logs`	擷取容器的輸出
`container_stats`	回報容器的 CPU、記憶體和 pid 使用量
`container_stop`	停止執行中的容器
`image_build`	從主機目錄中的 Dockerfile 建置映像檔
`image_list`	列出映像檔
`image_pull`	從登錄檔拉取映像檔
`network_create`	建立隔離的橋接網路
`network_list`	列出容器網路
`volume_create`	建立具名磁碟區
`volume_list`	列出具名磁碟區

執行 kosa8 mcp tools，查看你所安裝版本的工具清單。

此外掛程式執行的內容

此外掛程式唯一的可執行檔是 scripts/kosa8-mcp，這是一個簡短的 shell 指令碼，會尋找你機器上已安裝的 kosa8，並執行 kosa8 mcp serve。它不會下載或安裝任何內容。此外掛程式本身不會將資料傳送到任何地方、不會連線至任何伺服器，也不會讀取任何憑證。

其他 MCP 用戶端

同一個伺服器也已發布至官方 MCP Registry，名稱為 io.github.kosa8ai/kosa8（請參閱 server.json）。它以 MCP 套件 kosa8-mcp.mcpb 發行，附加於每個 GitHub 發行版本：套件包含資訊清單，以及與 scripts/kosa8-mcp 相同的簡短啟動器。它不會下載或安裝任何內容，因此請先安裝 kosa8。

任何能啟動 stdio 伺服器的 MCP 用戶端，也可以直接執行 kosa8 mcp serve。

隱私權

kosa8 MCP 伺服器在本機執行，並與同一台機器上的 kosa8 daemon 通訊。根據 kosa8 隱私權政策，代理發出的工具呼叫、其引數和結果都會留在你的機器上，絕不會傳送至 kosa8。該政策列出 kosa8 軟體傳送的所有資料及傳送時機，包括付費授權的授權檢查，也說明如何使用 KOSA8_OFFLINE=1 關閉所有對外連線。

完整政策：https://kosa8.com/privacy/

定價

kosa8 是商業軟體。此儲存庫中的外掛程式檔案免費，並採用 MIT 授權，但 kosa8 本身需要授權：每個授權都附有 14 天免費試用期，可使用所有功能，無須帳戶或信用卡。方案月費自 $29 起。請參閱 https://kosa8.com/pricing/.

支援與聯絡方式

電子郵件：contact@kosa8.com
問題回報：https://github.com/kosa8ai/kosa8-claude-plugin/issues
網站：https://kosa8.com

授權

此儲存庫中的檔案依據 MIT License 發行。此授權僅涵蓋此儲存庫中的檔案（Claude Code 外掛程式：其資訊清單、市集檔案、MCP 設定、技能、命令、代理、啟動器、README 和標誌）。此授權不涵蓋 kosa8 軟體本身；該軟體是商業軟體，依其自身條款另行發行。