kosa8

Claude Code 向け kosa8 プラグイン

kosa8：AI エージェント向けの安全なインフラストラクチャです。

Claude が作業するための隔離されたマシンを用意します。このプラグインは Claude Code を kosa8 に接続します。kosa8 は AI エージェント向けの安全なインフラストラクチャです。各エージェントには、それぞれ専用のカーネルを持つ実際のマイクロVMが割り当てられます。ホストのカーネルを共有するコンテナではありません。

このプラグインを有効にすると、Claude は次のことができます。

• 信頼できないコードやエージェントが作成したコードを、ホスト上ではワークスペースという1つのフォルダーだけが見える隔離されたマイクロVMで実行する。
• 閉じたネットワーク内で作業する。接続できるのは、自分で作成した許可リストにあるホストだけで、それ以外への接続は拒否される。
• API キーを保持せずに使用する。ホスト上の送信ブローカーが送信時にキーを挿入するため、サンドボックスが保持するのはプレースホルダーだけです。
• リスクのある手順の前に、メモリやプロセスも含めて実行中のマシン全体を約0.7秒でチェックポイントに保存し、問題が起きたときには、実行状態のまま約1秒で巻き戻す。
• 実行中のマシンを稼働中のコピーにフォークして、複数の方法を並行して試し、うまくいったものを残す。
• リスクのある操作について、指定した1人または2人の承認者を待機する（2人承認ルール）。すべての操作は、ハッシュチェーンで連結された改ざん検知可能な監査ログに記録される。

このプラグインは4つの部分で構成されています。

• MCP サーバー（.mcp.json）。scripts/kosa8-mcp を介して kosa8 mcp serve をローカルの標準入出力プロセスとして起動します。
• スキル（skills/kosa8-sandbox）。Claude に、サンドボックスを使うタイミングと、チェックポイント、巻き戻し、フォーク、送信許可リスト、承認を安全に使用する方法を伝えます。
• コマンド： /kosa8:status、/kosa8:sandbox <task>、/kosa8:checkpoint、/kosa8:rewind（巻き戻す前に確認します）、/kosa8:explore（複数のコマンドを並行するフォークで試します）。
• エージェント： sandbox-runner は信頼できないコードや生成されたコードを隔離されたマイクロVMで実行し、実行内容を報告します。fork-explorer は、1つの実行中のサンドボックスから作成した並行フォークで複数の方法を比較します。

前提条件

• Claude Code。
• 同じマシンに kosa8 がインストールされており、kosa8 が PATH にあること。kosa8 は Apple チップ搭載の Mac と x86-64 Linux で動作し、Windows では WSL2 を通じて動作します（プレビュー）。kosa8.com/download からインストールしてください。 リリースには署名と公証が付与されています。kosa8 version でインストールを確認してください。
• kosa8 デーモンが実行中であること。このプラグインは薄いランチャーにすぎません。サンドボックスはマシン上で kosa8d が実行するマイクロVMなので、デーモンが起動するまでは何も動作しません。

はじめる前に：kosa8 をインストールしてデーモンを起動する

このプラグインは 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 サーバーはデーモンがなくても起動しますが、その場合、すべてのサンドボックスツールが cannot reach kosa8d と応答します。

このサーバーをユーザー向けにインストールするエージェントは、 llms-install.md を参照してください。

インストール

Claude Code で、このリポジトリをマーケットプレイスとして追加し、プラグインをインストールします。

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

または、シェルから実行します。

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.json に独自の MCP サーバーエントリーを追加できます。

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

ネットワークとキー

サンドボックスのネットワークアクセスは、作成時に設定します。サンドボックスに1つの API だけへのアクセスを許可し、それ以外にはアクセスさせないようにするには、ターミナルから次のコマンドを実行して作成します。

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

ツール

kosa8 mcp serve は以下のツールを公開します（kosa8 0.5.0 で kosa8 mcp tools を実行した際の報告内容です）。

ツール	機能
kosa8_status	kosa8 デーモンが実行中かどうかを確認し、バージョンを報告します
sandbox_create	独自のカーネルとコンテナーエンジンを備えた、分離されたマイクロ VM サンドボックスを起動します
sandbox_list	サンドボックスを一覧表示します。各フォークの元となった親も表示します
sandbox_run	サンドボックスのプライベートエンジン内で、ホストから分離されたコンテナーを実行します
sandbox_pull	イメージをサンドボックスのプライベートエンジンにプルします
sandbox_checkpoint	メモリーと実行中のプロセスを含む復元ポイントを保存します
sandbox_checkpoint_list	サンドボックスの復元ポイントを一覧表示します
sandbox_rewind	サンドボックスをチェックポイントに戻し、プロセスを再開します
sandbox_fork	実行中のサンドボックスを N 個の独立したコピーにフォークします
sandbox_explore	ベスト・オブ・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 のみです。これは、マシンにすでにインストールされている 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 デーモンと通信します。kosa8 のプライバシーポリシーに従い、エージェントが行うツール呼び出し、その引数、結果はマシン上にとどまり、kosa8 に送信されることはありません。このポリシーには、有料ライセンスのライセンス確認を含め、kosa8 ソフトウェアが送信するすべての情報とその送信時期、および KOSA8_OFFLINE=1 ですべての外向きの通信を無効にする方法が記載されています。

ポリシー全文：https://kosa8.com/privacy/

料金

kosa8 は商用ソフトウェアです。このリポジトリのプラグインファイルは無料で、MIT ライセンスの下で提供されていますが、kosa8 自体にはライセンスが必要です。すべての機能を利用できる 14 日間の無料トライアルが付属し、アカウントもカードも不要です。プランは月額 $29 からです。https://kosa8.com/pricing/ をご覧ください。

サポートとお問い合わせ

• メール：[email protected]
• 課題：https://github.com/kosa8ai/kosa8-claude-plugin/issues
• ウェブサイト：https://kosa8.com

ライセンス

このリポジトリ内のファイルは、MIT License のもとで公開されています。 ライセンスの対象は、このリポジトリ内のファイル（Claude Code プラグインのマニフェスト、マーケットプレイスファイル、MCP 設定、スキル、コマンド、エージェント、ランチャー、README、ロゴ）のみです。別途、独自の条件で配布される商用ソフトウェアである kosa8 自体は対象外です。