Claude CodeをFreeBSDで動かす方法 — Linuxulatorの手順と制約

FreeBSDでClaude Codeを動かす現実的な経路は、Linux互換レイヤー(Linuxulator)の上でLinux版のバイナリを動かす方法だけです。標準のインストーラーもnpm経由の導入も、FreeBSDでは成立しません。ただし2.1.251以降は、jailの外のホストでもBashツールとWriteツールが失敗する報告があります。コミュニティ製のportは更新との競合が報告されている代替で、リモート環境を使う手もあります。

この記事では、ドキュメントが対応外としている範囲を示したうえで、GitHubのissueで共有されているLinuxulator運用の手順と、自動更新や2.1.251以降の不具合で踏みやすい制約を説明します。issueの手順は公式の保証ではなく、利用者の報告に基づく運用例です。

FreeBSDは対応環境に入っていない

システム要件に載っているOSは、macOS 13.0以上、Windows 10 1809以上またはWindows Server 2019以上、Ubuntu 20.04以上、Debian 10以上、Alpine Linux 3.19以上です。FreeBSDはありません。

導入経路ごとの状況は次のとおりです。

なぜnpmでも入らないのか

以前はnpmパッケージにNode.jsのフォールバックがあり、FreeBSDでも動きました。issueの記述では、v2.1.113でそのフォールバックが外れたとされています。

現在のnpmパッケージは、プラットフォームごとのオプション依存としてネイティブバイナリを取得し、postinstallでclaudeコマンドの位置に置く作りです。v2.1.289のメタパッケージで依存を見ると、8つのプラットフォームが並びます。

npm view @anthropic-ai/claude-code optionalDependencies

{
  '@anthropic-ai/claude-code-linux-x64': '2.1.289',
  '@anthropic-ai/claude-code-win32-x64': '2.1.289',
  '@anthropic-ai/claude-code-darwin-x64': '2.1.289',
  '@anthropic-ai/claude-code-linux-arm64': '2.1.289',
  '@anthropic-ai/claude-code-win32-arm64': '2.1.289',
  '@anthropic-ai/claude-code-darwin-arm64': '2.1.289',
  '@anthropic-ai/claude-code-linux-x64-musl': '2.1.289',
  '@anthropic-ai/claude-code-linux-arm64-musl': '2.1.289'
}

FreeBSDの行はありません。FreeBSD向けの名前のパッケージを直接引いても、レジストリは見つからないと返します。

npm view @anthropic-ai/claude-code-freebsd-x64 version

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/@anthropic-ai%2fclaude-code-freebsd-x64 - Not found
npm error 404 '@anthropic-ai/claude-code-freebsd-x64@*' is not in this registry.

トラブルシューティングには、FreeBSDではインストーラーがプラットフォーム非対応と報告する、という記載があります。

issueのコメントによれば、npmのラッパー側にはfreebsd向けのエントリが以前から入っています。ただしその先の@anthropic-ai/claude-code-freebsd-x64が未公開のため、npm i -gは「native binary not installed」で止まります。コメントの報告です。

FreeBSDまわりの変化を、バージョンの順に並べると次のとおりです。

Linuxulatorで動かす手順

issue #81704のコメントには、FreeBSD 15.0-RELEASEでLinuxulatorを使い、最新リリースに追従している利用者の手順が載っています。TUIの対話、-pによるヘッドレス実行、多段のサブエージェントまで動いたという報告です。以下はその手順の要約です。

Linux互換レイヤーを有効にする

最初に一度だけ実行します。

sysrc linux_enable=YES
service linux start
pkg install linux_base-rl9

service linux startでlinux64.koなどのカーネルモジュールが読み込まれ、linux_base-rl9がglibcと/lib64/ld-linux-x86-64.so.2を提供します。

linux-x64のバイナリを取得して検証する

npmのラッパーを経由せず、linux-x64のプラットフォームパッケージだけを直接取り出します。取り出したバイナリは、置き場所へ入れる前にその場で動作確認します。

VER=$(npm view @anthropic-ai/claude-code version)
npm pack @anthropic-ai/claude-code-linux-x64@$VER
tar xf anthropic-ai-claude-code-linux-x64-$VER.tgz
./package/claude --version

--versionがバージョン番号を返せば、Linuxulator上での起動は成立しています。ここで失敗するなら、linux_baseの導入かカーネルモジュールの読み込みを疑います。

バージョン付きパスに置いてシムで呼ぶ

バイナリはlibexec配下にバージョン名付きで置き、/usr/local/bin/claudeには自分で管理する1行のシェルスクリプトを置きます。

sudo install -m 755 package/claude \
  /usr/local/libexec/claude-code/claude-$VER

#!/bin/sh
exec /usr/local/libexec/claude-code/claude-2.1.219 "$@"

シェルスクリプトの2.1.219は、置いたバージョンに合わせて書き換えます。この構成なら、古いバージョンのバイナリがディスクに残ります。戻したいときはシムの向き先を古いパスに書き換えるだけです。

最新を入れてBashツールが動かないときは、claude-2.1.250を取得して同じ場所に置き、シムの向き先を2.1.250にします。不具合の詳細は後半の節にあります。

更新用の手順をスクリプトにまとめる

リリースごとに繰り返す部分は、次のようなシェルスクリプトにまとめられます。上の手順を並べただけの例で、issueに載っているものではありません。

#!/bin/sh
set -e
VER=$(npm view @anthropic-ai/claude-code version)
npm pack @anthropic-ai/claude-code-linux-x64@$VER
tar xf anthropic-ai-claude-code-linux-x64-$VER.tgz
./package/claude --version
sudo install -m 755 package/claude \
  /usr/local/libexec/claude-code/claude-$VER

set -eを付けておくと、--versionの確認で失敗した時点で止まり、動かないバイナリを置き場所へ入れずに済みます。シムの書き換えは最後に手で行う形にすると、確認前に向き先が変わることもありません。

古いバージョンに固定される代償と、JITフラグの扱い

npm経由でFreeBSDに入れた環境は、v2.1.112付近のバージョンで止まります。issueのコメントには、Linuxulatorを使わない場合は新しいモデルや自動モードの機能を使えず、旧世代のモデルに留まるという報告があります。バージョン固定の代償は、新機能に届かないことです。

もう1つ、以前の手順に出てくる環境変数BUN_JSC_useBBQJIT=0は、いまは不要という報告があります。Bunの実行環境でJITを切る設定で、Linuxulatorの初期の運用では必須でした。コメントの利用者は、2.1.204、2.1.219と更新を重ねても問題が出なかったと書いています。この報告は2.1.219までの範囲です。古いブログやissueの手順をそのまま写す前に、この設定を入れているかを確認する価値があります。

更新はすべて手作業になる

claude updateとインストーラーにFreeBSDの経路が無いため、新しいリリースへの追従は上の取得手順の繰り返しです。バージョン番号を変えてnpm packからinstallまで実行し、シムの向き先を差し替えます。

自動更新との衝突は、次のとおり構成で避けます。

• ドキュメントによると、ネイティブインストーラーの管理下にあるランチャーは~/.local/bin/claudeです。シムを/usr/local/binに置けば、更新機構と同じファイル名を共有しません
• 独自のランチャーを~/.local/bin/claudeに置いた場合、自動更新とclaude updateは上書きしません。新しいバージョンはversions/配下に入り、どれを動かすかはランチャーが決めます
• 更新を止めたいときは、settings.jsonのenvにDISABLE_AUTOUPDATERを"1"で設定します。手動のclaude updateは動きます。手動更新も含めて止めるならDISABLE_UPDATESです

claude doctor

claude doctorのAuto-updatesの行にdisabled (set by env: DISABLE_AUTOUPDATER)と出れば、設定は効いています。

FreeBSD portsを使う場合の落とし穴

コミュニティ製のport(misc/claude-code)は、cli.jsとベンダー済みバイナリをまとめて配る形です。issue #81704の記述では、実行中に自動更新がnpmのラッパーでport版を上書きし、そのラッパーがFreeBSDに対応しないため壊れる報告があります。

回避策として挙がっているのはDISABLE_AUTOUPDATER=1です。ただしissue本文はこの回避策を「undocumented」と書いています。現在のドキュメントには設定方法が載っているため、この記述は古い可能性があります。別の回避策として、Node.jsフォールバックが残る最後のバージョン(v2.1.112)に固定する案もありますが、新機能や新モデルは使えません。

2.1.251以降でBashとWriteが失敗する場合がある

issue #90984では、Linuxulator版が2.1.251で動かなくなった様子が報告されています。最初の報告はjailの内側でしたが、後のコメントでjailを使わない通常のホストでも同じ失敗が出ると示されました。二分探索の結果は、2.1.250までが正常、2.1.251から異常です。2.1.260でも直っていません。

報告者は、/dev/fdではなく/proc/self/fdをたどる処理への切り替えを原因に挙げています。/proc/self/fd/N/childの作成がENOTDIRで失敗し、BashツールもWriteツールも、スクラッチパッドの作成の段階で止まります。

報告者は、fdのシンボリックリンクが空に解決されると説明しました。別のコメントは、リンクは空ではなく、fd配下をたどる参照がENOTDIRになるのだと訂正しています。

修正はFreeBSD側(fdescfs)に入りました。修正コミットは2026年9月にFreeBSDのmainへ入り、安定ブランチへの取り込み待ちだと、issueのコメントが伝えています。Claude Code側の修正版の報告はありません。issueはopenのままです。

当面は2.1.250に固定する構成が手がかりになります。jailで運用する場合も、次の手順が使えます。

選び方の早見表

ネイティブ対応の見通し

issue #81704は、FreeBSD向けネイティブバイナリの追加を求める要望です。Bunの側でFreeBSDビルドが提供されたことを根拠に、bun build --compileでFreeBSD向けの単一実行ファイルを作れるはずだ、と主張しています。

要望はopenで、コメントには追従の声が続いています。システム要件にFreeBSDが入るまでは、公式バイナリをホスト上で最新まで動かす経路はLinuxulatorだけです。ネイティブ対応が入れば、インストーラーとnpmの両方が使えるようになり、シムや手動更新は不要になります。

隣接する環境との違い

同じLinux系でも、対応OSに入っているAlpineでは事情が違います。musl系ディストリビューションでは、インストール用にbashとcurl、実行時にlibgcc・libstdc++・ripgrepを入れ、USE_BUILTIN_RIPGREP=0を設定すれば、標準のインストーラーが使えます。詳しくはClaude Code Alpine Linuxセットアップにまとめています。

Linux全般のインストール手段はClaude Code install完全ガイド、apt・dnf・apkによる導入はClaude Code apt installでのLinuxパッケージ導入と更新が扱っています。glibcとmuslのバイナリ選択に絡む不具合はClaude Agent SDKのmusl版バイナリ優先バグの記事で確認できます。