Claude Media
Claude CodeをUbuntuにインストールする手順とbubblewrapの導入

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 /swapfile

Dockerのビルド中に固まるなら、/ でインストーラーを走らせていないかを疑います。ルートからだとファイルシステム全体を走査してメモリーを使うので、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. 1

    2パッケージを入れる

    sudo apt-get install bubblewrap socat を実行します。Fedoraは sudo dnf install bubblewrap socat です。

  2. 2

    Ubuntu 24.04以降はAppArmorを確認する

    次の節の sysctl が 1 を返したときだけ、bwrap用のプロファイルを追加します。

  3. 3

    Claude Codeを再起動する

    依存関係の確認は起動時に走るので、パッケージを入れただけでは反映されません。

  4. 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_userns

0 なら制限は無効で、以降の手順は要りません。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フィルタが前提です。

/proc のマウント

非特権コンテナ

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セキュリティ・権限ガイドにあります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/setup
  2. code.claude.com/docs/ja/sandboxing
  3. code.claude.com/docs/ja/troubleshoot-install
  4. code.claude.com/docs/ja/errors
  5. code.claude.com/docs/ja/authentication
この記事を共有:XはてブLinkedIn