Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

  • Linuxサンドボックスがネイティブビルドで「ripgrep (rg) not found」エラーにより起動できない問題を修正しました

原文（英語） ​

  • Fixed Linux sandbox failing to start with "ripgrep (rg) not found" on native builds

概要 ​

Linux環境でClaude Codeのネイティブビルドを使用している場合、サンドボックス機能の起動時に「ripgrep (rg) not found」というエラーが発生して起動に失敗する問題がありました。サンドボックスはファイルシステムの隔離に ripgrep を使用していますが、ネイティブビルドではバンドルされた ripgrep のパスが正しく解決されていませんでした。バージョン2.1.73でこの問題が修正されました。

基本的な使い方 ​

bash
# Linuxでネイティブビルドのclaude codeを使用
# v2.1.73以降はサンドボックスが正常に起動する
claude

# サンドボックスの状態を確認
/config
# → sandbox: enabled と表示される

実践例 ​

ネイティブビルドのインストール ​

bash
# npmではなくネイティブインストーラーを使用する場合
# https://docs.anthropic.com/en/docs/claude-code/setup から取得

# インストール後、サンドボックスが正常に動作することを確認
claude --version
claude

サンドボックスの手動確認 ​

bash
# サンドボックスが有効かどうかの確認
claude

# セッション内で
/config
# sandbox設定を確認

# ripgrepが正しく検出されているか確認
which rg

bubblewrapとの組み合わせ ​

bash
# Linuxでサンドボックスを完全に活用するには bubblewrap が必要
# Debian/Ubuntu
sudo apt install bubblewrap

# Fedora/RHEL
sudo dnf install bubblewrap

# サンドボックスのネットワーク制限には socat も必要
sudo apt install socat  # Debian/Ubuntu

注意点 ​

  • この問題はLinuxのネイティブビルド（npm経由ではないインストール）でのみ発生していました
  • npm経由でインストールした場合は、システムにインストールされた ripgrep が使用されるため、この問題は発生しません
  • v2.1.73以降のネイティブビルドには ripgrep がバンドルされており（USE_BUILTIN_RIPGREP=0 で無効化可能）、別途インストールする必要はありません
  • Alpine Linuxなどmuslベースのディストリビューションでは、追加で libgcc と libstdc++ が必要な場合があります

関連情報 ​