Claude Code は「モデルはクラウドだからスペック不要」——半分だけ正しい。推論はローカル GPU を使わないが、Agent が tool call を実行するたびに npm test、xcodebuild、docker compose、言語サーバー……をローカルで起動する。同一チップの M4 Mac 3台(16 / 24 / 64GB)で8つの同一タスクを実行し、ピークメモリ・swap 回数・エンドツーエンド所要時間を計測した。結論:ターミナル中心の軽量利用なら 16GB で十分。IDE + Agent の日常開発は 24GB がスイートスポット。Xcode + 複数シミュレータ + 並列 subagent は 64GB を検討。
1. 誤解:Claude Code はローカル算力を食わない?
Claude Code の大規模モデル推論は Anthropic クラウド上で行われ、Mac に NVIDIA GPU は不要で、「モデルが大きすぎて OOM」になることもない。しかし「8GB の古いマシンでも快適」という意味ではない——Agent モードの本質はAI にローカル環境を操作させることだ:
- ファイル読み取り → ripgrep、git、ファイルシステムキャッシュを起動
- テスト実行 → Node、Jest、pytest、cargo test などのプロセスツリーを起動
- CI 修正 →
xcodebuild、Gradle、Docker コンテナを実行する可能性 - 並列 subagent → 複数ターミナルセッションが同時にディスク読み取り・コンパイル
30日間の Claude Code 請求監査でも書いた通り、最もコストがかかるのは長時間セッション + リポジトリ全体の読み取りだ。メモリ面も同様——swap は Agent が起動するローカルコマンドを2〜5倍遅くする。待つのはモデル応答だけでなく、ローカルのコンパイルとテストでもある。
2. 実測環境と方法論
| 項目 | 仕様 |
|---|---|
| 機種 | Mac mini M4(3台、メモリ 16 / 24 / 64GB、いずれも 512GB SSD) |
| OS | macOS 15.5、iCloud デスクトップ同期オフ、「低電力モード」統一オフ |
| Claude Code | 2026.7 版、デフォルト Sonnet。複雑なリファクタでは Opus も追加計測 |
| テストリポジトリ | ① TypeScript monorepo(pnpm、約180パッケージ)② Swift iOS プロジェクト(SPM + CocoaPods)③ 中規模 Go バックエンド(Docker Compose 含む) |
| サンプリング | 各シナリオ3回実行の中央値。memory_pressure + Activity Monitor でピークと swap 回数を記録 |
| 計測 | プロンプト送信から Agent が「タスク完了」を報告するまでの実時間(ローカルコマンド実行含む) |
注:以下は同一チップ・メモリのみ異なる比較で、CPU 世代差の影響を排除。数値はリポジトリ規模・依存バージョンで多少変動するが、3段階間の相対差は複数回の再現で安定していた。
3. Claude Code 本体のメモリ使用量
「ターミナルのみ・空リポジトリ・単発の短い Q&A」という極限の軽量シナリオでは:
| 状態 | 常駐メモリ | ピークメモリ |
|---|---|---|
| Claude Code アイドル(ログイン済み) | ~180 MB | ~220 MB |
| 単発 Q&A(tool call なし) | ~200 MB | ~350 MB |
| 5ラウンド tool call(20ファイル読み取り) | ~280 MB | ~520 MB |
| 40ラウンド Agent セッション(コンテキスト未クリア) | ~400 MB | ~780 MB |
つまり:Claude Code を「強化版 ChatGPT ターミナル」として使うだけなら、16GB は十分。差がつくのは Agent が実行するローカル副作用だ。
4. 8シナリオ横断比較表
下表はピークメモリ使用量(Claude Code + 並行ローカルプロセス)、明確な swap の有無(>500MB/min のページング)、タスク実時間の中央値。
| シナリオ | 16GB ピーク | 16GB 所要時間 | 24GB ピーク | 24GB 所要時間 | 64GB ピーク | 64GB 所要時間 |
|---|---|---|---|---|---|---|
| S1 ターミナルのみ + TS 軽微修正(3ファイル変更 + lint) | 6.8 GB OK | 42s | 6.8 GB | 41s | 6.8 GB | 40s |
| S2 Claude Code + Cursor + TS LSP | 14.6 GB 時々 swap | — | 14.6 GB OK | — | 14.6 GB | — |
S3 Agent が pnpm test(全量単体テスト) |
15.9 GB 深刻な swap | 8m 12s | 16.4 GB 軽い swap | 3m 05s | 16.4 GB | 2m 58s |
| S4 12ファイル跨ぎ API リファクタ + テスト | 16.1 GB 深刻な swap | 14m 30s | 17.8 GB OK | 6m 20s | 17.8 GB | 6m 08s |
| S5 Claude Code + Xcode + iPhone 16 シミュレータ | — 使用不可 | 25m+ | 22.3 GB ギリギリ | 11m 40s | 22.3 GB OK | 10m 55s |
| S6 デュアル subagent 並列(各々テスト実行) | — OOM リスク | 失敗 | 21.7 GB swap | 9m 50s | 21.7 GB OK | 4m 22s |
| S7 Docker Compose 4サービス起動 + Agent API 呼び出し | — 使用不可 | — | 23.1 GB swap | 7m 15s | 23.1 GB OK | 5m 40s |
| S8 monorepo 夜間 CI シミュレーション(build + test + lint チェーン) | — 継続 swap | 45m+ | 24.6 GB 高負荷 | 18m 20s | 24.6 GB OK | 16m 05s |
表の読み方:16GB は S3 以降で全面崩壊——Claude Code が遅いのではなく、ローカルテストが swap に引きずられる。24GB は S1〜S4 と軽度の S5 をカバーするが、並列 Agent と Docker は依然きつい。64GB は全シナリオで「使用不可」ゼロ。S6 デュアル subagent は 24GB より2倍以上速い。
5. 16GB:何ができて、いつ我慢が必要か
向いている人
- 主に Claude Code ターミナルを使い、IDE はたまに開くか Vim/Neovim 派
- リポジトリが小さい(<50k 行)、テストは30秒以内で完了
- iOS シミュレータや Docker マトリックスは使わない
- すでに MacBook Air / エントリー MacBook Pro を持ち、メモリ増設の予算がない
16GB サバイバルルール
- 「重い」アプリは一度に1つだけ:Agent がテスト中は Cursor の TS 言語サーバーウィンドウを閉じる
.claudeignoreを設定し、無意味なインデックスを減らす(請求記事のコスト制御ルールと同様にメモリも節約)- サブタスク終了後すぐ
/clearし、コンテキストの雪だるま化による追加バッファ消費を防ぐ xcodebuild、Docker、長時間 CI はクラウド Macに任せ、ローカルは編集と軽量検証のみ
# リアルタイム概要 memory_pressure # swap 使用量を確認 sysctl vm.swapusage # 最もメモリを食うプロセスを特定 top -l 1 -s 0 -o mem | head -20
実測の体感:16GB は S1〜S2 で完全に快適。Agent が全量テストを起動(S3)すると、ファンが回り、カーソルがカクつき、Agent が「テストタイムアウト」と判断して再試行——遅いうえにtoken も余計に消費する。
6. 24GB:多くの人にとっての最適解
「Claude Code + モダン IDE」の開発者に1段階だけ選ばせるなら、24GB が 2026 年のスイートスポット——Apple は M4 MacBook Pro 14インチで 24GB を一般的なアップグレード段階にしており、24GB から 48GB への価格差は通常かなり小さい。
24GB で快適にカバーできること
- Claude Code + Cursor(または VS Code)+ TypeScript / Python LSP を同時稼働
- 中規模 monorepo の単発全量テスト
- 12ファイル以内のモジュール横断リファクタ + 自動テスト閉ループ
- 単一 Docker サービス(DB / Redis)+ ローカル API 開発
24GB でもきついシナリオ
- Xcode + iOS シミュレータ + Claude Code の3点セット同時起動(S5 ピーク 22.3GB、余裕ほぼなし)
- デュアル subagent 並列(S6)または Docker 4サービス(S7)
- Chrome 50+ タブ + 上記開発スタック(笑えない、実際こういう人が多い)
7. 64GB:本当に必要な人
64GB は「生産性オーバー」に聞こえるが、Claude Code ヘビーユーザーにとって解決するのは並列性の問題——Agent 時代のワークフローは「1つのコンパイルタスクを順番待ち」ではなく、「複数 subagent が同時にディスク読み取り・テスト・コンテナ起動」だ。
64GB に上げるべきサイン
| サイン | なぜ 64GB か |
|---|---|
| UI テストで iOS シミュレータを2台以上常時起動 | シミュレータ1台 ~3〜5GB、Xcode 本体 ~4〜6GB |
| Claude Code に並列 subagent を起動する習慣がある | 各サブセッションが独立したテストプロセスツリーを実行する可能性 |
| ローカル Docker マトリックス(db + cache + queue + mock) | コンテナメモリの積み上がりが極めて速い |
| 大規模 monorepo の保守(turbo / nx キャッシュ常駐) | ビルドキャッシュ + 言語サーバー + インデックスで 24GB を使い切る |
| チーム Tech Lead で、ローカルに3プロジェクトウィンドウを同時起動 | 贅沢ではなく日常 |
S6 デュアル subagent:64GB は 4m 22s vs 24GB の 9m 50s——差はモデルではなく、2台並列の npm test が swap を奪い合わなくなったこと。毎日2回の並列タスクで1回5分節約すると、年間約60時間の待ち時間を削減。
予算が 36GB(一部 M4 Pro で選択可能)に収まる場合:iOS 開発者には良い折衷案。S5 シミュレータシナリオは 24GB より安定するが、デュアル subagent は1つ閉じるかクラウドにオフロードを推奨。
8. メモリ以外に見るべき点
| コンポーネント | Claude Code への影響 | 推奨 |
|---|---|---|
| SSD | Agent は大量にファイル読み取り。swap 発生時はディスク速度がカクつきを決定 | 512GB 以上、1TB なら余裕。リポジトリを遅い外付けドライブに置かない |
| チップ | ローカルコンパイルに影響。モデル推論には影響しない | M4 で十分。M4 Pro はマルチコアコンパイルが速い。MacBook Pro 選定記事を参照 |
| ネットワーク | ストリーミング応答、大コンテキストアップロード。切断で Agent 中断 | 安定した有線または 5GHz Wi‑Fi。長時間タスクはテザリングを避ける |
| 冷却 | 長時間コンパイル + 夏季室温が持続性能に影響 | ノートはスタンド推奨。7×24 タスクは Mac mini / クラウド |
| ディスプレイ | メモリに直接影響しないが、デュアルスクリーンは IDE ウィンドウ常駐を増やす | 外付けディスプレイユーザーほどメモリ余裕を多めに |
9. ハイブリッド:ローカル + クラウド Mac
ノートを 64GB にしなくてもよい。2026 年のより一般的なやり方:
- ローカル 16〜24GB:Claude Code で編集、レビュー、軽量テスト
- クラウド M4 Mac mini(24〜64GB):
xcodebuild、夜間 CI、並列 subagent の重い作業 - SSH でクラウドに入り Agent セッションを実行、ローカルは結果を受け取るだけ——メモリのボトルネックをデータセンターに移す
これは 請求記事とも呼応する:フタを閉じてスリープすると Agent が再実行され、token も時間も無駄になる。常時オンラインのクラウド Macは「長時間タスクを投げっぱなし」スタイルに向いている。
メモリ不足?重い作業は常時オンラインのクラウド Mac へ
Nuvcloud は専用 M4 Mac mini(複数メモリ構成)を SSH/VNC でリモート接続、日/週/月単位の課金。ローカル 16GB でコードを書き、クラウド 64GB で Claude Code 並列 Agent + Xcode 全量コンパイル——料金を見る。
10. 用途別購入クイックガイド
| あなたのプロフィール | 推奨メモリ | 代表的な機種 | 備考 |
|---|---|---|---|
| 学生 / スクリプト / 運用自動化 | 16GB | MacBook Air M4、Mac mini M4 | .claudeignore とクラウド重作業を併用 |
| フルスタック / バックエンド / データ | 24GB | MacBook Pro 14 M4、Mac mini M4 | コスパ最高段階 |
| iOS / macOS 個人開発者 | 24〜36GB | MacBook Pro 14 M4 Pro | シミュレータ常時起動なら 36GB+ 推奨 |
| Tech Lead / monorepo 保守者 | 48〜64GB | MacBook Pro 16 M4 Pro/Max、Mac mini カスタム | 並列 subagent 必須 |
| Windows マシンを主力にしている | クラウド 24GB+ | Nuvcloud Mac mini | 2台目のローカル PC は不要 |
11. よくある質問
| 質問 | 回答 |
|---|---|
| Claude Code は Cursor よりメモリを食う? | ターミナル本体は軽い。ただし Claude Code Agent はデフォルトで shell コマンドを「大胆に」実行するため、ローカル副作用が大きくなる可能性がある。IDE レイヤー記事を参照。 |
| メモリは token 請求に影響する? | 間接的に影響:swap でコマンドタイムアウト → Agent 再試行 → ラウンド数増加。マシンが遅い = 請求が高い。 |
| Apple Silicon ユニファイドメモリは GPU と「共有」できる? | できるが、Claude Code はローカル GPU をほぼ使わない。ユニファイドメモリの意味はCPU と I/O 集約タスクが同じプールを奪い合うこと——余裕を多めに確保すべき。 |
| 後からメモリを増設できる? | できない。Apple Silicon Mac のメモリは実装済み。購入時に正しく選ぶ。 |
| Linux デスクトップ + Claude Code は使える? | Claude Code は Linux 対応。メモリも同様に 24GB 以上推奨。macOS 専用ツールチェーンが不要な開発者にはコスパが高い。 |
| アップグレードが必要かどうか判断するには? | Agent タスク中に memory_pressure を実行。「warn」表示または swap が継続増加なら、メモリ増設か重作業のオフロードが必要。 |
12. 結論
Claude Code は「コードを書く」を「ローカル環境を指揮する」に変えた——メモリ選定の核心は、Agent が同時に何個のプロセスを起動するかを見積もること。実測結果は明快:
- 16GB:軽量ターミナルユーザーには十分。IDE + 全量テスト + Agent が同時だと swap で体験が断崖的に悪化
- 24GB:2026 年の大多数の開発者のスイートスポット。日常 Claude Code ワークフローの80%をカバー
- 64GB:並列 Agent、Xcode マトリックス、Docker ヘビーユーザーの「手間削減税」——節約するのは見栄ではなく待ち時間
購入時にメモリは増設不可。CPU 段階を1つ下げても、まず目標メモリに到達させる。予算が限られるなら、ローカル 24GB + クラウド大メモリ Mac は「16GB で無理やり耐える」より経済的——マシンが1回遅ければ Agent が1ラウンド再実行し、浪費した時間と token は数日分のクラウド利用料に相当する。