HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Clawk – コーディングエージェントにラップトップではなく、使い捨てのLinux VMを与える

Show HN: Clawk – Give coding agents a disposable Linux VM, not your laptop (github.com)

128 pointsby celrenheit119 コメント

要約

Clawkは、コーディングエージェントに開発者のラップトップではなく、使い捨てのLinux仮想マシンを提供するツールです。これにより、エージェントはパッケージのインストールやコードの実行などを安全に行えます。VMは分離されており、ホストマシンやファイルへのアクセスは制限されているため、セキュリティリスクを低減します。

全文翻訳

[画像: clawk](https://github.com/clawkwork/clawk/blob/main/assets/clawk-lockup-orange-transparent.png)

コーディングエージェントに、あなたのマシンではなく、それ自身の使い捨てLinuxマシンを与えましょう。

[画像: CI] [画像: License: Apache 2.0] [画像: Go 1.26+] [画像: Platform: macOS · Linux (experimental)]

インストール · クイックスタート · なぜVMなのか? · 仕組み · 比較 · FAQ · ドキュメント

コーディングエージェントは、実際に何かを実行させる(パッケージをインストールする、コードを実行する、サーバーを起動する、ネットワークを使用する)ときに初めて役立ちます。自分のマシンでこれを実行する場合、2つの悪い選択肢しかありません。すべてのコマンドを承認する(数秒ごとにプロンプトを監視する)、または--dangerously-skip-permissionsを実行して、何も重要なものがrm -rfやトークンの漏洩から遠いことを願うかです。

clawkは第3の選択肢です。リポジトリにcdしてclawkと入力すると、Claude Code(またはCodex、pi、シェル)が使い捨てのLinux VM内で動作します(コードはマウントされ、ゲスト内ではroot権限を持ち、権限プロンプトはありません)。一方、あなたのファイル、キーチェーン、およびマシンの残りの部分は手の届かないところに保たれます。エージェントはあなたのマシンではなく、それ自身のマシンを手に入れます。

[画像: clawkデモ: clawkはVMを起動し、claudeをアタッチします。未知のサーバーへのデータ送信の試行がclawkネットワーク拒否に表示されます。clawk attachは後でサンドボックスを再開します]
動作するエージェントへの1つのコマンド。未知のサーバーへのデータ送信の試行は、ネットワーク許可リストによってブロックされます。clawk attachは後でセッションを再開します。

境界線は、エージェントが説得されてしまうようなプロンプト内のルールではありません。それは別のマシンであり、開口部はあなたがマウントしたものだけです。サンドボックス内のシェルから:

$ curl https://tracker.evil.example   # 許可リストにない: ブロックされました
curl: (7) Failed to connect to tracker.evil.example port 443 after 2 ms: Connection refused

$ cat ~/.ssh/id_rsa                   # あなたのキーはVMに入りませんでした
cat: /home/agent/.ssh/id_rsa: No such file or directory

$ git push                            # ...しかし、これは機能します: ssh-agentが転送されています
Enumerating objects: 5, done.

限界について正直に言うと、許可リストは未知のサーバーへの接続をブロックしますが、あなたが許可したサーバーへの接続はブロックしません。github.comは事前に許可されており、転送されたssh-agentはプッシュできるため、エージェントが読み取れるものはすべて公開できるものと見なしてください。セキュリティモデルに詳細が記載されています。

そして、エージェントがVMを破壊した場合、clawk destroy && clawkを実行してください。新しいVM、同じリポジトリ、そして--resumeで会話が復元されます。

重要

1.0未満で急速に進化中。 リリース間での破壊的な変更や、時折の粗削りな部分を予想してください。物事は壊れる可能性があり、壊れます。問題を報告してください。そのフィードバックが1.0を形作っています。

ハイライト

  • エージェントにあらゆることを許可する。 制限されたネットワークを持つ使い捨てVMで実行されるため、rm -rf、パッケージインストール、信頼できないコードはホスト、ファイル、または明示的に共有したものに到達できません。
  • 1つのコマンドで作業開始。 リポジトリにcdしてclawkを実行します。Dockerfile、devcontainer、セットアップファイルは不要です。最初の起動時にイメージからrootfsがビルドされ、それ以降の起動は数秒で完了します。
  • 何も失わずに壊せる。 自由に破壊して再作成してください。あなたのコードとエージェントの会話はホストに残ります。使い捨てVMディスクのみが失われます。
  • 実際のLinuxボックス、あなたのツールチェーン。 OCIイメージなら何でもrootfsになります。完全なOSで、プロジェクトに必要なツールがすべて揃っています。Dockerデーモンは不要です。
  • 秘密情報はあなたのマシンに残る。 送信トラフィックは許可リストに登録され、ssh-agentは転送されるため、キーがVMに入ることなくgit pushが機能します。
  • プロジェクトまたはチケットごとのサンドボックス。 複数同時に実行できます。マルチリポジトリのチケットは、リポジトリごとにgit worktreeを備え、調整されたPRを作成します。アイドル状態のVMは自動的にメモリを解放し、ディスクにサスペンドするため、忘れられたサンドボックスのコストは(ほとんど)かかりません。

なぜVMなのか?

clawkは、自律型コーディングエージェントのための汎用ローカル環境です。VMが重要なのは、それがエージェントが所有できる完全なマシンであり、あなたが使用しているマシン上のポリシーでラップされたプロセスではないからです。

  • 独立したカーネル。 ゲストは独自のLinuxカーネルを実行するため、ホストファイルシステムは拒否ルールによって隠されることはありません。そもそもマウントされていません。
  • 従来のLinux環境。 標準カーネル、標準ユーザーランド、/dev/kvm形状の期待値。これにより、ツールはドキュメント通りに動作し、システムコールフィルターの驚きはありません。
  • ゲスト内でのroot権限。 システムパッケージのインストール、/etcの編集、モジュールのロード、特権ポートのバインド。エージェントが再構成できるのは、そのボックスです。
  • 使い捨てのライフサイクル。 破壊が容易で、再作成が迅速です。破壊されたVMは、clawk destroy && clawkで復元でき、リポジトリと会話はホスト上で変更されません。
  • ホストからのより強力な分離。 分離は、プロセスのサンドボックスポリシーを正確に設定することではなく、ハイパーバイザーの境界線に依存します。

この組み合わせにより、制限されたプロセスサンドボックスが通常は苦労するワークロードを実行できます。

  • パッケージやネイティブ依存関係のインストール。
  • バックグラウンドサービス(データベース、キュー、開発サーバー)の実行。
  • 信頼できないビルドやテストをフルスピードで実行。
  • 実際のマシンを期待するシステムレベルのLinuxツールを使用。
  • そして、サポートされているハードウェア上のKVM対応ゲストカーネルを使用すると、DockerやKindのようなコンテナおよびKubernetesの開発ワークフローがサンドボックス内で実行されます。これはオプトインであり、ハードウェアで制限されます。詳細はイメージを参照してください。

これらは製品ではありません。clawkは、一般的なローカルエージェント作業のためのものです。DockerとKubernetesは、「実際のマシンが必要で、サンドボックス化されたプロセスでは不十分」という例の中で最も顕著なものです。

インストール

macOS 14+のApple Siliconが必要です。(Linuxはfirecracker経由でサポートされており、現在は実験的です。docs/linux-quickstart.mdから始めてください。これにはセットアップ、ワークフロー、およびギャップが含まれます。このREADMEはmacOS優先です。)

brew install clawkwork/tap/clawk

ソースから(コントリビューター、またはHomebrewを使用しない場合)、Go 1.26+が必要です:

git clone https://github.com/clawkwork/clawk && cd clawk
make install

どちらの場合も、追加のホストツールは不要です。Docker、qemu、sudoはありません。ハイパーバイザーはAppleのVirtualization.frameworkで、バイナリにリンクされています。リリースバイナリには、インゲストエージェントがプリビルドされているため、ソースからビルドする場合にのみGoツールチェーンが必要になります。その場合、すでに持っています。最初の実行時に、不足しているものをプローブし、修正を提案します。

アンインストール:サンドボックスをclawk destroyし、rm -rf ~/.clawkしてから、バイナリをbrew uninstall clawk(またはソースインストールから$GOBINを削除)で削除します。他に何もインストールされていません。launchdジョブはなく、サンドボックスごとのデーモンはVMと一緒に終了する通常のプロセスです。

クイックスタート

日常的なケース、つまり現在いるディレクトリのサンドボックス:

cd ~/code/my-project
clawk                      # このディレクトリのサンドボックスを起動し、claudeをアタッチ
clawk run shell            # 同じサンドボックスでシェルにドロップイン
clawk run codex            # または他のエージェント: codex, pi, opencode, shell
clawk down                 # VMを停止(リポジトリ+エージェントの状態は永続化)
clawk attach               # 後で戻る — 停止していれば起動し、claudeを再アタッチ
clawk destroy              # VMを削除(会話履歴は保持)

一般的なオプション:

clawk run claude -- --resume            # エージェントに引数を渡す
clawk forward add my-project 3000       # ゲスト開発サーバーをlocalhost:3000で公開
clawk network allow my-project api.example.com

複数のリポジトリにまたがるチケットに取り組んでいますか?1つのコマンドで、リポジトリごとにworktreeを持つサンドボックスが作成され、clawk prで後でクロスリンクされたPRが開かれます:

cd ~/code/my-workspace     # clawk.mod(リポジトリ一覧)が含まれています
clawk work INFRA-123       # 1つのサンドボックス、リポジトリごとのworktree、claudeがアタッチされています
clawk pr INFRA-123         # ブランチをプッシュし、リポジトリごとに1つのPRを開く

チケットの完全なライフサイクル(ステータス、マージ後のフォローアップブランチ、リベース)は、docs/ticket-mode.mdにあります。

ヒント: Claude Codeを使用していますか?claude setup-tokenを実行してからclawk auth set-tokenを一度実行すると、すべてのサンドボックスがサインインした状態で起動し、/loginなしで、並列サンドボックス間のログイン競合もありません。docs/claude-auth.mdを参照してください。

何が何を生き残るか

永続性を支配する1つのルール:VMは使い捨てであり、失いたくないものはすべてホストに残ります。

clawk downclawk destroy
あなたのリポジトリ(マウントされたworktree;コミット、ブランチ)✅✅
エージェントの状態(Claude/Codex/pi/opencodeの会話、メモリ)✅✅
VMディスク(aptインストール、キャッシュ、$HOME)❌(起動ごとに新しくビルドされます*)❌(それが目的です)

*2つの例外:clawk snapshotの再開はディスクとメモリをサスペンド時とまったく同じように復元します。Linux/firecrackerプロバイダーは破棄されるまでディスクを保持します。起動ごとに必要なツールはイメージ(vm ( image … ))に含めるべきです。起動ごとのセットアップはon upフックに含めるべきです。

エージェントの状態はサンドボックスごとにホストにマウントされます。各ランナーのホームディレクトリ — claudeの~/.claude/、codexの~/.codex/、piの~/.pi/、opencodeの2つのXDGディレクトリ — はホストの~/.clawk/namespaces/default/state/<name>/の下にあり、再作成されたサンドボックスは--resumeで以前の会話を拾うことができます。そのマウントが約束を現実のものにします。VMディスク自体は、起動ごとにイメージからクローンされるため、ランナーがそのディレクトリの外に書き込んだものはすべて、次のclawk upで失われます。

デフォルトでの完全な自律性(および--safeオプトアウト)

ランナーは「外部でサンドボックス化された」モードで起動します。claudeは--dangerously-skip-permissions、codexは--dangerously-bypass-approvals-and-sandbox、piは--approve(バイパスする承認プロンプトはありませんが、プロジェクトローカルの.pi/設定と拡張機能を信頼プロンプトでゲートします)、opencodeは--autoを取得します。自分のマシンではこれらのフラグは無謀ですが、ここではそれが目的です。VMの境界とネットワーク許可リストが封じ込めを提供するため、エージェントはアクションごとのプロンプトなしでフルスピードで動作します。エージェントは、マウントして許可リストに登録したものにのみ影響を与えることができます(SECURITY.mdを参照)。

それでも確認プロンプトを優先しますか?任意のattach(clawk --safe、clawk run claude --safe)に--safeを追加すると、ランナーはそのセッションのバイパスフラグなしで開始されます。

ネットワーク

送信トラフィックはデフォルトで拒否されます。各サンドボックスには独自の許可リストがあります。DNSはすべてを解決します。リストにないホストへのTCP、UDP(QUICを含む)、およびICMPエコーは拒否されます。一般的なレジストリ(npm、PyPI、crates.io、GitHub、Anthropicなど)は事前に許可されており、フィルターはDNSを認識するため、example.comを許可するとIPがローテーションしても機能し続けます。

clawk network allow my-project api.stripe.com '*.internal.mycorp.com' 10.0.0.5
clawk network denials my-project     # エージェントが試みてブロックされたもの
clawk forward add my-project 3000    # localhost:3000 → ゲストの開発サーバー
clawk forward add-reverse my-project 63342   # その逆も:あなたのローカルホスト上のサービス、ゲスト内から到達可能

拒否は、ゲストが解決したホスト名によって記録されるため、clawk network denialsはエージェントが到達しようとしたことのログとして読み取れます。再利用可能な名前付きポリシー(oisdのような外部ブロックリストの購読を含む)と、それらをレイヤー化するuseチェーンは、docs/networking.mdにあります。

設定: clawk.mod

設定ファイルは不要です。デフォルトは適切です。プロジェクトでさらに多くの設定が必要な場合は、clawk.modファイルがそれを記述します。go.modスタイルの構文です:

sandbox my-project (
    vm (
        cpu    4
        memory 8GiB
        image  golang:1.25          # OCIイメージなら何でもrootfsになります
    )
    network ( allow api.example.com )
    forwards ( 3000 )
    env ( DATABASE_URL )            # ホスト変数を転送します。値はシェルから取得します
    # also: GH=${OTHER_NAME}, LOG=${LOG:-info} defaults, API=${API:?required}
    mcp (                           # MCPサーバー、最初の起動時に準備完了
        linear https://mcp.linear.app/mcp header "Authorization: Bearer ${LINEAR_TOKEN}"
    )
    on create ( "go mod download" )
    agent (
        instructions "Ask before running destructive commands."
    )
)

このブロックはテンプレートです。サンドボックス作成時にスナップショットされるため、実行中のサンドボックスが予期せず変更されることはありません。完全なリファレンス(共有、秘密ファイル、スキル、エージェントメモリのシード、マルチリポジトリワークスペースのルート)はdocs/configuration.mdにあります。MCPサーバーとその資格情報がディスクに残らない方法はdocs/mcp.mdにあります。マイクロコントローラー作業のためにMacからUSBシリアルボードをサンドボックスに入れる方法はdocs/serial.mdにあります。イメージとカスタムゲストカーネル(ネストされた仮想化に使用されるKVM対応カーネルを含む)はdocs/images.mdにあります。

ライフサイクル

clawk list                  # すべてのサンドボックス
clawk status [<name>]       # ステータス、フォワード、ブロックされたホスト;スクリプト用に--json
clawk up / down             # 起動 / 停止
clawk pause / resume        # 実行中のVMをメモリにサスペンド / 再開
clawk snapshot              # ディスクに保存:RAM解放、ゲストはそのまま;resumeで復元
clawk destroy               # VMを削除;ホスト側の状態は永続化

clawk snapshotはサンドボックスのハイバネーションです。ゲストのメモリはディスクの隣に保存され、次の起動時にゲストは中断した場所から正確に復元されます。バックグラウンドプロセスと開発サーバーは何も起こらなかったかのように継続し、clawk attachでエージェントの前に戻ります。完全なコマンドサーフェス、ランナースケジューリング、およびアイドル管理メカニズム(バルーニング、アドミッションコントロール、自動停止)はdocs/commands.mdにあります。

仕組み

you ──▶ clawk CLI ──▶ サンドボックスごとのデーモン(分離;VMを所有)
                        ├─ gvproxy: インプロセスユーザー空間TCP/IPスタック —
                        │  ゲストが再構成できないDNS認識型送信フィルター
                        ├─ インゲストpty-agentへのvsockブリッジ(sshdなし)
                        ├─ ssh-agentプロキシ、macOS(署名はホストに残る)
                        └─ VM: Virtualization.framework(macOS) / firecracker(Linux)
                             ├─ clawk-init、PID 1(systemdなし、cloud-initなし)
                             ├─ virtio-fs経由でライブマウントされたあなたのリポジトリ
                             └─ PTY上のclaude / codex / pi / shell

いくつかの意図的な選択、簡潔に:

  • rootfsは通常のOCIイメージです。 clawkはそれをプルし(Dockerデーモン不要)、レイヤーをフラット化し、rootもループデバイスもなしでext4ディスクを直接書き込みます。同じイメージからのすべてのサンドボックスはコピーオンライトクローン(APFS clonefile / FICLONE)であるため、サンドボックスごとのディスクコストはゲストが書き込んだものです。
  • ネットワークはゲストの下でフィルターされます。 VMの完全なL3(ゲートウェイ、DHCP、DNS、NAT)は、デーモンプロセス内のユーザー空間スタックです。すべての送信接続とDNS応答は、そこで許可リストを照会します。ゲスト内のrootでさえそれを変更できません。ホストiptablesなし、sudoなし。
  • 片道通行。 sshdなし、cloud-initなし:単一のvsockエージェントがゲストへの唯一の制御パスであり、各アタッチはコンテナ実行スタイルです。切断時に破棄される新しいプロセスです。

完全な図(ゲストスタック、両方のプロバイダー、フレームレベルのネットワーキング)はARCHITECTURE.mdにあり、各決定の根拠はDESIGN.mdにあります。

比較

  • コンテナとdevcontainers。 これらはあなたのカーネルを共有し、拒否ルールを除いたファイルシステムを見ます。単一のカーネルバグや誤ったマウントがホストを露出させる可能性があります。Devcontainerセットアップは、イメージをビルドするためにホストDockerソケットをバインドマウントすることが多く、コンテナにホストデーモンの制御を渡します。clawkはDockerをVM内に保持します。そして、書くべきDockerfile/devcontainer.jsonはありません。OCIイメージなら何でもrootfsになります。
  • OSレベルのエージェントサンドボックス。 Anthropicのsandbox-runtimeのようなツールは、あなたの実際のマシンにプロセスレベルのガードレールを適用します。軽量なルールには最適ですが、1つのポリシーミスがすべて(キーチェーンを含む)を露出させ、インストール、バックグラウンドサービス、またはネストされたハイパーバイザーの許可は困難です。clawkはワークロード全体を別のマシンに移動させます。
  • 汎用VMマネージャー(例:Lima)。 LimaはLinux VMを提供します。clawkは、そのVM上でのワークフローです。プロジェクトごとにVMがあり、リポジトリがマウントされ、エージェントがアタッチおよび認証され、デフォルトでEgressが許可リストに登録され、拒否が記録され、エージェントの会話が破棄をまたいで永続化され、チケットモードがworktreeとPRを管理します。(内部的には両方ともVirtualization.frameworkを使用しています。)
  • クラウドサンドボックス。 ローカルファースト:あなたのコードはマシンから離れることはなく、時間単位で請求されるものはありません。エージェントが編集するworktreeは、エディタ内のもので、macOS上でライブマウントされています(Linuxプロバイダーは現在作成時に焼き付けます。詳細はロードマップを参照)。クラウドサンドボックスはフリートに適していますが、clawkはあなたの机の上のマシン用です。

セキュリティモデル(およびその限界)

2つの境界線が機能します。VM(マウントしたもの以外はホストファイルシステムは見えません)と送信許可リスト(ゲストの下のユーザー空間で、送信可能なすべてのプロトコルに対して強制されます)。clawkが保護しないもの:

  • マウントまたは許可したものすべてが露出します。 Worktreeは書き込み可能であるため、エージェントは不正なコードをコミットしたり、転送されたssh-agentが到達できる任意のリポジトリにプッシュしたりできます。サンドボックスから出てくるものを、見知らぬ人のPRをレビューするようにレビューしてください。
  • プッシュした秘密情報は表示されます。 files ( … )およびshares ( … )の内容、転送された環境変数、Claudeトークンはエージェントが読み取れる(そして、宛先が許可リストに登録されていれば、そこに送信できる)ものです。最小限を共有してください。
  • ハイパーバイザーエスケープ。 clawkはVirtualization.framework/KVM分離に依存しており、それ以上の防御を追加しません。

境界を破る方法(ゲストからホストへのエスケープ、ネットワークフィルターバイパス、認証情報漏洩)を見つけた場合は、SECURITY.mdを通じてプライベートに報告してください。

FAQ

オーバーヘッドは? イメージからの最初の起動は、一度限りのrootfsビルド(プル→フラット化→ext4)を必要とします。その後、ディスクはコピーオンライトクローンになり、カーネルはファームウェアやインストーラーなしで直接起動します。アイドル状態のVMはメモリを約1 GiBまで解放し、30分のアイドル後に自動的に停止し、ディスクにスナップショットできるため、ストレージのみを消費します。

Intel MacやWindowsで動作しますか? いいえ。macOSはApple Silicon(macOS 14+)が必要です。Linuxでは、firecrackerプロバイダーは動作しますが、実験的です(docs/commands.mdを参照)。Windowsサポートはありません。

Dockerをインストールする必要がありますか? いいえ。clawkはOCIイメージをプルし、それ自体で起動可能なディスクをビルドします。Dockerイメージは入力形式であり、Dockerエンジンは関与しません。(サンドボックス内でDockerデーモンを実行することは、個別のオプトイン機能です。詳細はイメージを参照してください。ハードウェアおよびカーネル要件について。)

なぜ「clawk」なのですか? マークは爪(claw)です。clawkworkはA Clockwork Orangeのもじりです。巻き上げて、解き放ち、いつでもリセットできるVMです。

ロードマップ

次のステップ:RAMで保持できる以上のサンドボックスを実行できるようにする。

  • アイドル停止時にスナップショット。 手動サスペンドトゥディスクはclawk snapshot / clawk resumeとして出荷されました。次は、自動アイドル停止もこれを使用するため、開発サーバーは停止を生き残り、サスペンドされたサンドボックスはディスクのみを消費します。
  • 実行中VMのキャップ。 RAMがコミットされたときに新しいVMを拒否する代わりに、最も最近使用されていないサンドボックスをディスクにサスペンドし、新しいものを開始します。
  • Firecrackerの同等性。 Linuxでのライブworktree伝播とホストファイルプッシュ。

ステータス

1.0未満で、活発に開発中であり、急速に進化しています。リリース間での破壊的な変更を予想してください。CLIサーフェスは最も変更されず、内部が最も変更されますが、1.0まで何も凍結されていません。

貢献

問題とプルリクエストを歓迎します。ビルドとテストについてはCONTRIBUTING.mdを参照してください。構築方法についてはARCHITECTURE.mdを、目指す方向性についてはDESIGN.mdを参照してください。

ライセンス

アパッチライセンス2.0。clawkは、独自のライセンスの下で2つのサードパーティコンポーネントをバンドルしています(gvisor-tap-vsock、Apache-2.0;hcsshim ext4ライター、MIT)。NOTICEを参照してください。