Claude CodeをUbuntuにインストールする手順とbubblewrapの導入
Claude CodeをUbuntuに入れるcurlとaptのコマンド、サンドボックスに要るbubblewrap・socatの導入、Ubuntu 24.04のAppArmor制限の直し方を症状別に示します。
Ubuntu・Debian・Fedoraなど主要なLinuxでは、ターミナルで1行実行するだけでClaude Codeが入ります。つまずくのはその先で、claude は動くのにサンドボックスだけ有効にならない、という状態です。
Ubuntuで必要なコマンドは、次の3つに絞れます。
| やりたいこと | コマンド |
|---|---|
| Claude Codeを入れる(自動更新あり) | コマンドcurl -fsSL https://claude.ai/install.sh | bash |
| サンドボックス用のbubblewrap・socatを入れる | コマンドsudo apt-get install bubblewrap socat |
| Ubuntu 24.04以降でbwrapが止まるか確かめる | コマンドsysctl kernel.apparmor_restrict_unprivileged_userns |
3つ目が 1 を返したときだけ、AppArmorプロファイルの追加が要ります。aptリポジトリから入れる方法もあり、curlとの違いは後半の節で扱います。
本記事は、インストールが途中で止まる症状、サンドボックスに必要なbubblewrapとsocat、Ubuntu 24.04以降のAppArmor制限を、症状から引ける順に並べます。全OSの導入手順はClaude Codeインストール完全ガイドにあります。
要件と、Linuxだけ違う点
| 項目 | 要件 |
|---|---|
| OS | 要件Ubuntu 20.04以上・Debian 10以上・Alpine 3.19以上 |
| ハードウェア | 要件RAM 4GB以上、x64またはARM64 |
| サンドボックスの依存 | 要件bubblewrap・socat(WSL2でも同じ) |
| サンドボックスが動かない環境 | 要件ネイティブWindows、WSL1 |
サンドボックスはmacOSなら標準のSeatbeltを使うので、追加のインストールが要りません。LinuxとWSL2だけが、別に2パッケージを必要とします。設計の考え方はClaude Codeのサンドボックス設計で扱っています。
インストールが途中で止まるときの症状別対処
導入コマンドは1行です。
curl -fsSL https://claude.ai/install.sh | bash小さなVPSやコンテナでは、このコマンドが成功せずに止まることがあります。症状と原因は次の3つです。
インストール時に出る3つの症状
Killed(終了コード137)
メモリー不足でOOM killerがインストール手順を止めています。インストールには約512MBの空きメモリーが要り、実行にはそれ以上が要ります。
libstdc++.so.6 が見つからない
glibcのシステムにmuslの導入物が入っていると、muslと誤判定されてmusl向けバイナリが落ちることがあります。
ldd --version 2>&1 | head -1の出力がGNU libcかmuslかで見分けます。Illegal instruction
CPUがバイナリの必要とする命令を持っていません。アーキテクチャーの取り違えのほか、AVXを持たない古いCPUや、AVXをゲストに渡さない仮想マシンが原因です。
Killedの場合は、スワップを足して再実行します。
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfileDockerのビルド中に固まるなら、/ でインストーラーを走らせていないかを疑います。ルートからだとファイルシステム全体を走査してメモリーを使うので、Dockerfileに WORKDIR /tmp を置いてから実行します。
Illegal instructionは、VPSやVMなら grep -m1 -ow avx /proc/cpuinfo で切り分けられます。出力が空ならAVXがゲストに見えていません。ネイティブバイナリ側に回避策はなく、報告先のissue #50384は、2026年5月27日に長期間動きがないとして not plannedで自動クローズされています。
curlとaptのどちらで入れるか
curlのネイティブインストールは自動更新に対応します。aptは自動更新されず、通常のシステム更新に乗せる運用です。
署名付きaptリポジトリには2つのチャンネルがあります。stable は通常1週間ほど前のバージョンを配信し、重大なリグレッションのあった版を飛ばします。latest はリリース直後から配信されます。次は stable の設定です。
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-codeまっさらなDebian・Ubuntuには curl や gpg が入っていないことがあります。command not found が出たら、先に sudo apt install curl gnupg を実行します。鍵の取得に失敗したまま進むと、apt update が NO_PUBKEY BAA929FF1A7ECACE で失敗します。更新は sudo apt update && sudo apt upgrade claude-code です。
導入後は claude --version で確認します。v2.1.287では次のように出ます。
$ claude --version
2.1.287 (Claude Code)バージョンを指定して入れ直すときは、claude install に stable・latest・具体的なバージョンのどれかを渡します。v2.1.287の claude install --help は次のとおりです。
Usage: claude install [options] [target]
Install Claude Code native build. Use [target] to specify version (stable,
latest, or specific version)
Options:
--force Force installation even if already installed
-h, --help Display help for commandサンドボックスを動かすまでの手順
Claude Codeのサンドボックス化されたBashツールは、シェルコマンドをファイルシステムとネットワークの両面で隔離します。自動許可(auto-allow)モードでは、境界内に収まるコマンドが許可プロンプトなしで動きます。LinuxとWSL2では、次の2パッケージが前提です。
- bubblewrap: ファイルシステムの分離を担う非特権のサンドボックスツール
- socat: サンドボックスのプロキシ経由でネットワーク通信を中継するリレー
Ubuntuでサンドボックスを有効にする流れ
- 1
2パッケージを入れる
sudo apt-get install bubblewrap socatを実行します。Fedoraはsudo dnf install bubblewrap socatです。 - 2
Ubuntu 24.04以降はAppArmorを確認する
次の節の
sysctlが1を返したときだけ、bwrap用のプロファイルを追加します。 - 3
Claude Codeを再起動する
依存関係の確認は起動時に走るので、パッケージを入れただけでは反映されません。
- 4
/sandbox を開く
Dependenciesタブが出ていないことを確かめます。
ripgrepはネイティブバイナリに同梱されています。任意のseccompフィルタ(Unixドメインソケットの遮断を追加)が欲しいときは、npm install -g @anthropic-ai/sandbox-runtime で入れます。
Dependenciesタブには、ripgrep・bubblewrap・socat・seccompフィルタのうち足りないものが並びます。必須パッケージが揃ってseccompだけ欠けているときは、Dependenciesタブが残ったまま、Mode・Overrides・Configの3タブも並びます。タブが完全に消えるのは、seccompを含めて揃ったときです。
本当にサンドボックスの中で動いているかを確かめる
パネルが開いても、コマンドが隔離されているとは限りません。確認は、Claudeに次の2行を実行させて行います。自分で ! プロンプトに打つと、サンドボックスの外で動くことが多く、検証になりません。
| 実行させるコマンド | サンドボックス内での結果 |
|---|---|
touch ~/sandbox-probe | サンドボックス内での結果Linux・WSL2では Read-only file system で失敗 |
curl --noproxy '*' https://example.com | サンドボックス内での結果Could not resolve host で失敗 |
Claudeが「サンドボックス外で再実行しますか」と聞いてきたら、この検証では断ります。ホームディレクトリが書き込み許可先でない環境で touch が成功した場合は、~/sandbox-probe を削除し、/sandbox で有効化と依存関係を見直します。
Ubuntu 24.04以降でAppArmorがbubblewrapを止める
Ubuntu 24.04以降の既定のAppArmorポリシーは、bubblewrapが隔離に使うユーザー名前空間の作成を止めます。パッケージを入れても、サンドボックスが起動しない原因になります。
まず環境が対象かを確認します。WSL2でも同じです。
sysctl kernel.apparmor_restrict_unprivileged_userns0 なら制限は無効で、以降の手順は要りません。No such file or directory が出た場合も、キー自体が無いので対応不要です。1 のときだけ、bwrapにユーザー名前空間の作成を許可するプロファイルを追加します。
sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>
profile bwrap /usr/bin/bwrap flags=(unconfined) {
userns,
include if exists <local/bwrap>
}
EOFこのプロファイルが効くのはbwrap自体だけで、サンドボックス内のコマンドには及びません。反映はAppArmorのリロードです。
sudo systemctl reload apparmorそれでもエラーが残るなら、近い症状の記事が2本あります。unshare(CLONE_NEWUSER)の失敗原因と、setgroups書き込みの失敗です。
WSL2とコンテナで変わること
WSL2とコンテナのつまずき
WSL2
WSL1ではサンドボックスが動かず、Sandboxing requires WSL2 と表示されます。PowerShellで wsl -l -v を実行してバージョンを確かめ、WSL1なら wsl --set-version <ディストリビューション名> 2 で上げます。
cmd.exe や /mnt/c/ 配下のWindowsバイナリの起動は、Unixソケット経由でWindowsホストに渡されます。サンドボックス内から許可するかは allowAllUnixSockets の設定次第で、遮断するにはseccompフィルタが前提です。
非特権コンテナ
bubblewrapが新しい /proc をマウントできず、Can't mount proc on /newroot/proc: Operation not permitted で失敗します。enableWeakerNestedSandbox を true にすると、コンテナの既存の /proc をbind mountして動きます。
外側のコンテナが十分な隔離境界を持つ場合に限った設定です。プロセス情報がサンドボックス内から見えるようになり、隔離は弱まります。
DevContainerやDocker上で安全に動かす構成は、DevContainerでの安全な実行構成にあります。
動き始めたあとに出るつまずき
NixOSでnix-direnvを使っている場合は、別の症状が出ます。切り分けはNixOSでbwrapエラーになる原因と対処法にあります。
設定の保存が失敗する(強制終了のあと)
セッションがSIGKILLなどで強制終了されると、サンドボックスが作った0バイトの読み取り専用プレースホルダーが残ることがあります。次のセッションはそれを毎回読み取り専用で結び直すため、「Yes, and don't ask again」のような設定の書き込みが、そのパスで失敗します。
claude doctor を実行すると、Stale sandbox mask files left by a killed session として残ったファイルが最大3件まで表示されます。ほかのClaude Codeセッションを閉じてから、挙がったファイルを rm で削除し、警告が消えるまで claude doctor を繰り返します。v2.1.257より前は、この警告が出ません。診断の範囲はClaude Codeの/doctorチェックアップで扱っています。
v2.1.287の claude doctor --help は次のとおりです。
Usage: claude doctor [options]
Check the health of your Claude Code installation. Reads settings files in the
current directory without a trust prompt. For a full checkup that can also fix
issues, run /doctor in a session.企業のmanaged settingsで起動しなくなった
failIfUnavailable: true をmanaged settingsに入れると、bubblewrapのような依存が見つからないときにClaude Codeの起動自体が止まります。既定は、依存が欠けていたりプラットフォームが非対応だったりしても、サンドボックスなしで実行を続ける動作です。
サンドボックスはネイティブWindowsで動かないため、フリートにWindowsが混じるなら、その端末はこの設定で起動時に終了します。
ヘッドレスなUbuntuサーバーでログインできない
ブラウザーが開けない環境では、ログインURLを手元のブラウザーで開き、表示された認可コードをターミナルの Paste code here if prompted に貼り付けます。WSL2・SSH・コンテナでは、ブラウザーがClaude Codeのローカルのコールバックサーバーに届かず、コード表示になるのが一般的です。
CIのように対話ログインができない場合は、claude setup-token で1年有効なOAuthトークンを発行し、CLAUDE_CODE_OAUTH_TOKEN に設定します。--bare を付けるとこの変数は読まれないので、その場合は ANTHROPIC_API_KEY かapiKeyHelperを使います。自社サーバーで継続稼働させる構成はClaude Code self-hosted-runnerにあります。
docker コマンドがサンドボックスで失敗する
docker はサンドボックスと相性が悪いので、excludedCommands で外に出します。パターンは docker * のように末尾に * を付けます。docker だけだと、引数なしの docker にしか一致しません。
外に出したコマンドは全権限で動きます。docker compose * のように狭いパターンのほうが、サンドボックスの外で動くものが少なく済みます。
よくある質問
サンドボックスを使わずにClaude Codeを使えますか
使えます。サンドボックスは既定で有効ではなく、従来どおり各コマンドで許可を求める運用のまま動きます。
Alpine Linuxでもこの手順で動きますか
インストールの時点で手順が変わります。Alpineには bash と curl が入っておらず、1行のコマンドが not found で失敗します。ランタイムには libgcc・libstdc++・ripgrep も要るので、次のように先に入れ、環境変数 USE_BUILTIN_RIPGREP=0 を設定します。
apk add bash curl libgcc libstdc++ ripgrepサンドボックス用の導入コマンドはapt-getとdnfの2系統で、Alpine用のコマンドは用意されていません。
まとめ
サンドボックスが動かないときは、パッケージ、再起動、AppArmor、強制終了の残骸の順に疑うと切り分けられます。権限モデルの全体はClaude Codeセキュリティ・権限ガイドにあります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。