その日、Macは突然反応しなくなりました。

カーソルは動く。でもクリックしても何も起きない。虹色の円が回りはじめ、数十秒待つと、見慣れた灰色のダイアログがゆっくり現れます。

「アプリケーションメモリが不足しています」。一覧の先頭にはClaudeが並び、その右に信じがたい数字が出ている。

強制終了を押せば、Macは正気に戻ります。ただし押した瞬間に、それまでの会話も、AIが積み上げていた文脈も、まとめて消えます。書きかけのコードは残っても、そこに至った経緯は残りません。

そして一週間ほど経つと、また同じことが起きる。

対策は入れているはずでした。上限も設定した。設定ファイルも書いた。それでも、週に一度この画面が出る。

私はその理由を突き止めました。

入れていた対策は、一度も動いていませんでした。

この記事を読み終えたあなたが手にするもの

あなたのMacで、いま何がメモリを食っているのかを、5分で特定できるようになります。

「たぶんChromeでしょう」で終わらせず、プロセス名と数字で名指しできる状態のことです。

お渡しするものは4つあります。

1. 正しい測り方

macOSには、普通の見方では絶対に見えないメモリがあります。比喩ではありません。私の環境で実際に見つかった一例を挙げます。

よく使われる方法で見た値 :   10 MB
実際に食っていた量       : 4944 MB

494倍ずれています。桁が2つ違う。

ネット上で見つかるメモリ監視スクリプトの大半は、この左側の数字を見ています。どれだけ真面目に監視しても、暴走そのものが視界に入ってきません。

右側を見る方法を、手順ごとお渡しします。

2. 効かない対策の実測データ

「対策は入れている」── その対策、このOSでは動いていない可能性があります。

よく紹介される方法を片端から試して、動作を記録しました。結果を先に言うと、主要な対策のうち、まともに機能したものはひとつもありませんでした。 なぜ効かないのかを、実行結果の出力ごと載せています。

3. 常駐監視ツール一式

エージェントが暴走したときに、原因のプロセスだけを止める監視ツールです。設置は同梱のインストーラを一度走らせるだけ。sudoも追加インストールも要りません（macOS標準のPython 3だけで動きます）。

この道具の設計で一番考えたのは「何を止めないか」でした。 ブラウザも動画編集ソフトも、何があっても触りません。エージェント本体も最後まで残します。

強制終了ダイアログのボタンを押すのとは、失うものがまるで違います。

4. 落ちた後に原因を特定する手順

「週に一度落ちる」を「毎回この操作のときに落ちる」に変えるための、記録の取り方です。ここが本命だと思っています。

配布物の中身

数えられる形で並べます。

✅ 常駐監視ツール一式（1,460行） ── インストーラ・アンインストーラ込み。sudo不要、依存パッケージ0

✅ 確認コマンド6種 ── 現状把握 / 有効化前の点検 / 停止の記録 / ピークの推移 / 置き忘れの一覧 / 動作の実証

✅ Claude Code の予防フック4種 ── コマンド実行の直前に割り込んで、機械を殺しにいくものだけを止める

✅ 本編全9章＋付録 ── 症状からの逆引き表、設定の全リファレンス、効かない場面の一覧つき

✅ 実測データ ── 対策5種の検証結果、494倍の乖離、検知遅延、この機械の最大確保速度まで、全部数字で

✅ 設定の目安 ── 16GB / 32GB / 64GB それぞれの出発点と、誤爆したときの戻し方

追加の月額はありません。 使う道具はmacOSに最初から入っているものだけです。

あなたが入れている対策は、たぶん動いていません

私も同じことをしていました。プロセスにメモリの上限をかければいい。誰でもそう考えます。

打ってみた結果がこれです。

$ ulimit -v 8000000
setrlimit failed: invalid argument

上限に達したのではありません。上限を設定するコマンド自体が、その場で失敗しています。

zshでもbashでも同じでした。別の指定方法も試しましたが、結果は変わりません。値が入るように見えるものもありました。ただ調べてみると、カーネルは受け取った値を無視していました。制限をかけた状態で、その制限を超える量が普通に確保できてしまう。

つまり ──

macOSには、プロセス単位のメモリ上限が存在しません。

これが「対策は入れているのに、それでも週に一度こうなる」の正体です。対策が甘かったのではなく、設定した対策が最初から一度も効いていなかった。

AIエージェント界隈でよく共有されている、もうひとつの設定があります。それも試しましたが、現在のバージョンでは効く余地がないと分かりました。理由は本編で説明します。ツールの中身が、多くの人が思っているものと違っていました。

内側から縛る方法が存在しない以上、やることは一つに決まります。外から見張る。 ほかに道がありません。

犯人は、たいてい「置き忘れ」です

ここが一番の発見でした。

先ほどの「494倍」の正体をお話しします。私のMacに、16日間動き続けていたプロセスが2つありました。

調べてみると、一度も仕事をしていませんでした。

起動して待機しただけ。その状態で、2つ合わせて9.9GBを抱えていました。物理メモリ16GBの、実に60%です。

プロジェクトのフォルダはとっくに削除されていました。存在しない場所を作業ディレクトリとして掴んだまま、データだけをメモリに載せて、16日間ただ待っていた。

さらに厄介なことに、そのアプリ自身に状態を尋ねると「空きメモリ17.1GB」と答えてきました。スワップが13.8GB埋まっている機械の上で、です。自分が何をしているのか、アプリ自身も把握していませんでした。

止めた瞬間、スワップに空きが戻りました。

これは特殊な例だとは思っていません。エージェントが起動して、そのまま忘れられた開発サーバ。終わったはずの処理。閉じたつもりのセッション。そういうものが静かに積もっていって、ある日ダイアログを呼ぶ。見えていないだけで、たぶんあなたのMacにも何かいます。

本編を掃除の手順から始めるのは、そのためです。

「メモリを増やせ」で終わらせられない理由

この話をすると、必ず返ってくる言葉があります。16GBで足りないなら買い替えろ、と。

その通りです。メモリは多いほうがいい。 そこは否定しません。

ただ、64GBに載せ替えたところで、16日間居座って9.9GBを抱えるプロセスは、やはり9.9GBを抱えます。暴走したプロセスは、増えたぶんも同じように埋めていきます。発生を遅らせるだけで、性質は何ひとつ変わりません。

それに、ダイアログが出るたびに失っているのはメモリではなく作業です。増設で買えるのは猶予であって、「何が起きているか分かる状態」は金額に関係なく手に入りません。

収録内容

本編は全9章と付録で構成しています。

第0章｜週に一度、Macが固まる ── 扱う問題と、扱わない問題の線引き
第1章｜あなたが入れている対策が効かない理由 ── 実行結果つきで、何が動いていないのかを確認する
第2章｜見えていないメモリを見る ── 494倍の乖離はどこから来るのか。正しい測り方
第3章｜犯人はエージェント本体ではない ── 置き忘れを見つけて掃除する手順
第4章｜番人を置く ── 監視ツールの導入。効いていることを自分の目で確かめる
第5章｜閾値の決め方 ── 16GB / 32GB / 64GB それぞれの目安と、誤爆したときの戻し方
第6章｜太らせない設定 ── メモリを吹き飛ばす操作を、実行前に止める
第7章｜落ちた後に原因を特定する ── 記録の読み方と、二度目を防ぐ直し方
第8章｜Codex / Antigravity / Cursorへの適用 ── 対象を増やす
付録 ── 症状からの逆引き表、設定の全リファレンス、効かない場面の一覧

買わないでいただきたい方

先に書いておきます。次に当てはまる方には、この記事は役に立ちません。

• Windows / Linuxをお使いの方。 macOS専用です。他のOSでは扱う問題そのものが違います
• AIエージェントを日常的には使っていない方。 月に数回なら、落ちたときに再起動するほうが早いです
• 一行もコマンドを打ちたくない方。 コピペで完結するようには書きますが、ターミナルは開いていただきます
• 「これを入れれば二度と落ちない」を求めている方。 そうは書きません。理由はFAQに書きます

よくある質問

Q. sudoやパスワードは必要ですか

不要です。システム領域には一切触れません。設置先はホームディレクトリの中だけで、取り外しもアンインストーラ一度で完全に元に戻ります。

Q. 大事なプロセスを勝手に殺されませんか

そこを一番慎重に作りました。監視対象はエージェントとその配下だけです。 ブラウザも動画編集ソフトも、設計上そもそも対象に入りません。

加えて、短時間に一定数を超えて止めようとした場合、ツールは自分で手を止めて通知だけに切り替わります。 「守るはずのものが一番の加害者になる」経路を塞ぐためです。何があっても触ってほしくないものを、名指しで除外する設定もあります。

そして導入直後は「観測のみ」の状態で入ります。 しばらく眺めて、自分の使い方でどこまでメモリが伸びるかを確かめてから有効にする流れです。

Q. 入れれば落ちなくなりますか

そうは言えません。

ここは正直に書きます。

数十秒から数分かけて膨らんでいく暴走なら、実測で捕まえられています。

一方で、一瞬で数十GBに達するような確保には間に合いません。OSにハードリミットが存在しない以上、これは原理的にどうにもなりません。

本編には、どこまでの速さなら止められるのかを実測値で載せています。 できることとできないことの線を数字で引いた上で、使ってください。

Q. 監視ツール自体が重くなりませんか

平常時のコストを実測しています。数字は本編に載せました。見張るために遅くなったのでは本末転倒なので、ここは測った上で設計しています。

Q. 設定を書き換えて壊しませんか

想定しています。しきい値に無茶な値を書いた場合、起動時にツールがそれを検出して安全側に補正し、何を補正したかを記録に残します。 黙って動くことはありません。

Q. 個別サポートはついていますか

この記事に個別サポートは付いていません。手順どおりに進めば完結するように書いています。

価格について

3,980円 です。

安いとは言いません。ただ、ダイアログが一度出るたびに失っているものと比べてみてください。書きかけの作業、AIが積み上げていた文脈、そこから復帰するまでの時間。週に一度なら、年に50回です。

私はこの問題を解決するたびに明らかにこの金額以上のトークンを消費してやっとここまで辿り着きました。

レビューが貯まった段階で、価格は改定する予定です。いまが一番安いタイミングになります。

最後に

この記事でお渡しするのは、たった一つのことです。

自分のMacで何が起きているのかを、推測せずに数字で言えるようになること。

たった一つと書きましたが、週に一度固まる機械と付き合っている方なら、それがどれほど遠いかをご存じだと思います。私も、あの10MBという数字を信じている間は、何ひとつ分かりませんでした。

原因が見えれば、対処は驚くほど単純になります。

AI関連の情報コミュニティのご案内

この記事は単体で完結します。以下は興味のある方だけお読みください。

noteで「AI関連の情報コミュニティ」を運営しています（プレミアムプラン月1,000円）。掲示板で質問でき、過去に有料で公開したAI関連の記事も、一部を除いてほぼすべて読めます。

この記事のサポートの代わりではありません。AIエージェントまわりを継続的に追いかけたい方にとって、少し近道になる場所です。

https://note.com/bn_akanuma/membership

ここから先が本編です。

第0章から順に読むことを勧めますが、急ぐ場合は付録の「症状からの逆引き」から入っても成立します。

配布物の guard_kit（zip）は第4章で使います。先にダウンロードしておいてください。