◉CLAUDE LABEN
●CC 2.1.325 — 週末の新規リリースはなく、最新は 2.1.325(11/13)のままです●BILLING — 2.1.325 で、claude.ai ログインのバックグラウンド作業が API キーで課金されていた不具合が直りました●SONNET 4.5 — Claude API での提供終了は 11/30、残り14日。保存済みのモデル設定も確かめてください●403 — 会話の途中で Cloudflare の 403 画面が出てトークンだけ減る、という報告が出ています●MANAGED — 11/12 から Managed Agents を自社の環境で丸ごと動かす self-hosted 版の受付が始まっています●NEW — 「Browser extension is not connected」が消えないとき●CC 2.1.325 — 週末の新規リリースはなく、最新は 2.1.325(11/13)のままです●BILLING — 2.1.325 で、claude.ai ログインのバックグラウンド作業が API キーで課金されていた不具合が直りました●SONNET 4.5 — Claude API での提供終了は 11/30、残り14日。保存済みのモデル設定も確かめてください●403 — 会話の途中で Cloudflare の 403 画面が出てトークンだけ減る、という報告が出ています●MANAGED — 11/12 から Managed Agents を自社の環境で丸ごと動かす self-hosted 版の受付が始まっています●NEW — 「Browser extension is not connected」が消えないとき
記事一覧/Claude Code
⟐ Claude Code/2026-08-16中級

ビルドがメモリを食い尽くしたときの止まり方は、cgroup と ulimit で別物でした

Claude Code v2.1.233 で Bash ツールに memory cgroup 対応が入りました。上限を仮想アドレス空間に置く ulimit -v と、実メモリに置く cgroup では、止まり方も、そもそも止められるかどうかも変わります。Linux 上で実際に確かめた記録です。

Claude Code286Bash ツールメモリ9Linuxトラブルシューティング71

無人で回している定期タスクが、ビルドの途中で終わっていたことがあります。

真っ先に疑ったのはディスク不足でした。個人開発で App Store 向けのアプリと公開しているサイトを同じマシンでビルドしているため、ENOSPC は珍しい事故ではありません。けれどその時は空き容量が十分に残っていて、犯人はどうやら別にいました。

残る容疑者はメモリです。ビルドが一時的に数 GB を掴むと、同じマシンで動いている作業セッションごと巻き込まれます。ログを遡っても、最後の行が途中で切れているだけで、何も教えてくれませんでした。

Claude Code v2.1.233 の変更履歴に、Bash ツールのコマンドを Linux の memory cgroup に入れる CLAUDE_CODE_TOOL_MEMORY_LIMIT が加わったと書かれていました。「暴走したビルドがセッションを止められないようにする」という説明です。

では自分の環境では上限をどこに置けばよいのか。そして上限を置けば本当にセッションを守れるのか。Ubuntu 22.04(カーネル 6.8)のサンドボックスで手を動かして確かめたところ、上限を置く場所によって「止まり方」がまったく別物になることが分かりました。

上限を「仮想アドレス空間」に置くか「実メモリ」に置くか

Linux でプロセスのメモリを縛る方法は、大きく2つに分かれます。

手段縛る対象超えたときの挙動設定の単位
ulimit -v(RLIMIT_AS)仮想アドレス空間の確保量確保の呼び出しが失敗する(プロセスは生きたまま)シェルとその子プロセス
cgroup v2 の memory.max実際に使っている物理メモリ回収しきれなければ OOM killer が SIGKILL を送るcgroup に入れたプロセス群

言葉にすると近く見えますが、動かすと差がはっきり出ます。正直に言えば、私が最初に思い描いていたのも「ulimit で 512 MB に絞っておけば安心」という程度の理解でした。前者は「これ以上は確保させない」と申し出を断る仕組みで、後者は「使いすぎたら殺す」仕組みです。

断られたプログラムがどう振る舞うかは、そのプログラム次第です。ここが今回いちばん腑に落ちた点でした。

ulimit -v で止めた Python は、例外として捕まえられた

まず ulimit -v を使い、少しずつメモリを掴む Python を走らせました。

( ulimit -v 524288; python3 -c "
b = []
n = 0
try:
    while True:
        b.append(bytearray(4 * 1024 * 1024))
        n += 4
except MemoryError:
    print(n)
" )

ulimit -v の単位は KiB なので、524288 は 512 MiB です。結果は3回とも同じでした。

492
492
492

上限 512 MiB に対して、実際に確保できたのは 492 MiB。差の 20 MiB ほどはインタプリタ自身が先に使っている分です。上限を 256 MiB にすると 232 MiB まで、1024 MiB にすると 1000 MiB まで確保できたので、この目減り分はおおむね一定でした。

大事なのは数字よりも、MemoryError として捕まえられたことです。プロセスは殺されず、except に入って自分で後始末できました。終了コードも自分で決められます。

つまり、Python で書いた処理スクリプトなら、ulimit -v は「行儀のよい失敗」を作れる手段になります。

同じ制限で、Node は起動すらできませんでした

同じ 512 MiB を Node.js(v22.22.3)に掛けたところ、様子がまったく違いました。

( ulimit -v 524288; node -e "console.log('started')" )

started は表示されず、終了コードは 133。標準エラー出力の先頭にはこう書かれていました。

# Fatal process out of memory: Failed to reserve virtual memory for CodeRange

try / catch は一切通っていません。V8 が起動時にまとめて仮想アドレス空間を予約するため、ビルドが始まる前に Node 自体が落ちていたのです。

どこが境目なのか、刻んで探しました。

ulimit -vnode -e "0" の終了コード
512 MiB133(起動失敗)
640 MiB133(起動失敗)
704 MiB133(起動失敗)
768 MiB0(起動する)
896 MiB0(起動する)

この環境では 768 MiB が起動の下限でした。空の node -e "0" を動かすだけで、これだけの仮想アドレス空間が要ります。

なお上限を 2 GiB まで上げると、今度は確保の失敗をきちんと捕まえられました。

caught@1056MiB Array buffer allocation failed

起動さえ通れば、実行中の確保失敗は例外になります。落ちていたのは起動時の予約だけでした。

ここから引き出せる結論は、実務的にはかなり強いものです。Node のツールチェーン(npm・Vite・webpack・Metro など)に ulimit -v で低い上限を掛けると、暴走を止めるどころか、正常なビルドまで起動時に殺してしまいます。 「メモリを 512 MB に制限してビルドさせよう」という素朴な発想は、この時点で成立しません。

CLAUDE_CODE_TOOL_MEMORY_LIMIT が ulimit ではなく cgroup を選んでいるのは、この差を踏まえれば自然な設計だと感じました。

cgroup で止めると、失敗は「例外」ではなく SIGKILL になります

cgroup v2 の memory.max は物理メモリの使用量を見ます。仮想アドレス空間の予約は素通りするので、Node は普通に起動します。そのうえで、実際に使いすぎたときだけ OOM killer が働きます。

このとき送られるのは SIGKILL です。捕まえられません。シェルから見た終了コードは 137(128 + 9)になります。

bash -c 'sleep 20 & P=$!; kill -9 $P; wait $P'
echo $?
137

運用する側から見ると、この違いはログの読み方に直結します。

  • 終了コード 137 が出ていたら、まずメモリを疑います
  • 133 のような起動時の即死は、仮想アドレス空間の制限やコンテナ設定の可能性があります
  • MemoryError などの例外がログに残っているなら、プロセス自身は最後まで生きていたと読めます

再試行の設計も変わります。SIGKILL された処理は途中経過を残せないので、そのまま再実行すると同じ場所でもう一度殺されるだけです。上限を上げるか、並列数を下げるか、どちらかを選ぶ判断が先に要ります。

もうひとつ知っておくと気が楽になる点があります。cgroup は上限を1バイト超えた瞬間に殺すわけではありません。カーネルはまずページキャッシュなどの回収を試み、回収が追いつかなくなって初めて OOM killer に進みます。上限ぎりぎりで動いているビルドは、殺される前に遅くなることが多いのです。上限を掛けたあとでビルドが妙にもたつくときは、上限が少し窮屈だという合図かもしれません。

ひとつ正直に書いておきます。今回のサンドボックスは非特権ユーザーで動いており、/sys/fs/cgroup 配下にディレクトリを作ろうとすると Permission denied になりました。systemd-run --user もユーザーバスがなく使えません。そのため cgroup 側の停止は、終了コードの規約を確認するところまでに留めています。自分のマシンで試す場合は、systemd-run --user --scope -p MemoryMax=2G -- npm run build のように、まず捨ててよいビルドで一度殺されてみるのが確実です。

もうひとつ、2026年8月16日時点の状況として。CLAUDE_CODE_TOOL_MEMORY_LIMIT は変更履歴には記載がありますが、環境変数のリファレンスページにはまだ載っていません。値の書式は変わる可能性があるため、設定する前に一次情報を確認してください。この記事で断定しないのはそのためです。

「ulimit で絞ってあるから大丈夫」と思い込んでいた夜

この検証を始める前の私は、ビルド用のシェルに ulimit -v を入れてあるのだから、暴走しても止まるはずだと考えていました。止まる、というのは確かに間違いではありません。ただ、止まった先で何が起きているのかを、一度も見に行っていませんでした。

Node のビルドが起動直後に終了コード 133 で落ちているのを見つけたとき、最初の反応は「メモリが足りないのか」でした。実際には、実メモリは 41 MB ほどしか使っておらず、足りなかったのは仮想アドレス空間の予約枠のほうです。症状は同じ「メモリ不足」の顔をしていても、原因の置き場所がまるで違いました。胃のあたりが少し冷たくなったのを覚えています。

それ以来、メモリまわりの異常は、必ず次の3点を順に見るようにしています。

  • 終了コードは 133 か、137 か、それとも 0 か
  • 落ちたのは起動の直後か、処理の途中か
  • その時点の Maximum resident set size はいくつか

どれも1分で済みます。それでも、この3点を最初に見るかどうかで、半日の迷いが一時間に縮まるのだと感じています。

空の Node が使う実メモリは、起動に要る仮想アドレス空間の20分の1でした

ここまでの話を、数字で並べておきます。/usr/bin/time -v で Maximum resident set size(実際に載った物理メモリの最大値)を測りました。

/usr/bin/time -v node -e "0" 2>&1 | grep "Maximum resident"

3回とも約 41 MB(41,692〜41,720 KB)でした。次に、8 MiB のバッファを 50 個(合計 400 MiB)確保して中身を埋める Node のスクリプトを同じ方法で測ると、3回とも約 441 MiB(451,952〜452,080 KB)です。Python で同じ 400 MiB を確保した場合は約 425 MiB(435,072〜435,200 KB)でした。インタプリタ分の上乗せを含めて、確保した量に 10% 前後を足した値に収まっています。

注目したいのは、空の Node が実際に使うのは 41 MB なのに、ulimit -v では 768 MiB 未満だと起動できなかった点です。仮想アドレス空間の予約と、実際に載るメモリは、桁がひとつ違います。 cgroup の memory.max が見るのは後者なので、41 MB で動く Node に 512 MB の上限を置いても、起動は何も困りません。

測ってみるまで、私はこの差を頭の中で混ぜていました。「512 MB に絞る」と書けば、どちらの 512 MB なのかを決めていなかったことになります。

自分の環境で最初に決める2つのこと

上限を入れると決めたら、決めるべきことは2つだけでした。

1つめは、上限値そのものです。 単体のビルドが平常時にどれだけ使うかを一度測り、その 1.5〜2 倍を置くのが出発点になります。加えて、同時に走りうるビルドの本数を掛けた合計が、マシンの実メモリを超えないことを確かめます。無人タスクを複数並べている環境では、この「掛け算」を忘れると、上限を入れたのにマシン全体が苦しくなります。重いビルド同士は開始時刻をずらすほうが、全部の上限を下げるよりはるかに安上がりなこともあります。

2つめは、失敗の見え方です。 137 で終わったコマンドを、ログのどこに、どう残すか。無人で回している場合、ここを決めていないと「なぜか終わっていた」という朝を繰り返します。無音の失敗そのものを止める設計は「成功」と記録されたのに成果がゼロだったで扱っています。Bash ツール側のエラーを切り分けたい場合はClaude Code の Bash ツール実行エラーの原因と対処が近い話です。

今日からできる最初の一歩としては、いちばん重いビルドを一度だけ /usr/bin/time -v 付きで走らせ、Maximum resident set size を控えておくことをおすすめします。上限値の議論は、その1行がないと始まりません。

私自身、ディスクの方ばかり見ていてメモリを測っておりませんでした。疑う順番を決めていなかったのだと、いま思えば気づきます。

上限を決める前に、まず測ります。 数字のない上限は、安心した気分を買っているだけだと考えるようにしています。

同じ抜けをお持ちの方の朝が、少しでも穏やかになれば幸いです。

シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⟐ Claude Code2026-11-06
claude doctor に警告が 4 つ並んだ日、直す前に「原因は 1 つ」かどうかを仕分けました
claude doctor の末尾に「4 warnings found」と出たとき、4 つを順に直す必要はありませんでした。実際の出力をもとに、同じ原因の重複と、サインイン前の情報行を見分けて、直す順番を決める手順をまとめます。
⟐ Claude Code2026-10-29
大きな CLAUDE.md を丸ごと書き換えられたとき、消えた見出しを探して戻し、次から止める
Claude Code 2.1.312 で、先頭しか見ていない巨大な CLAUDE.md を Claude が上書きする不具合が直りました。それ以前の版で起きたときの見出しの差分の見つけ方、git での戻し方、Write を止めるフックの置き方を書き残します。
⟐ Claude Code2026-10-23
夜間の claude -p で MCP が「認証が必要」と出る朝に、Mac のスリープとキーチェーンを疑う順番
無人で回した claude -p の朝のログに「needs authentication」や MCP のタイムアウトが残っているとき、Mac のスリープとログインキーチェーンのロックを先に確かめる手順です。v2.1.307 で変わった挙動と、版を上げても残る部分の線引きをまとめました。