Selparo · 実行環境の判断

Claude Codeの必要スペックは？ 公式要件と処理負荷を分けて考える

必要スペックは、Claude Code本体の最低要件と、同時に動かす開発作業を分けて決めます。4 GBという本体要件だけでPCやVPSを選ばず、代表作業のCPU・メモリ・保存容量を測ります。

公式情報確認日：

Claude Code本体の公式要件

2026年9月27日に確認したAnthropicの公式システム要件は次のとおりです。Local / VPSでCLIを実行するホストの対応条件であり、Web画面を開くだけの端末や、プロジェクト全体の推奨構成を示すものではありません。

RAM / CPUアーキテクチャ
4 GB以上のRAM、x64またはARM64プロセッサ。
OS
macOS 13.0以上、Windows 10 1809以上 / Windows Server 2019以上、Ubuntu 20.04以上、Debian 10以上、Alpine Linux 3.19以上。
通信・シェル・地域
インターネット接続、Bash / Zsh / PowerShell / CMD、Anthropicの対応地域。Linuxの依存ライブラリやWindowsの導入手順も公式ページで確認してください。
CPUコア数・ストレージ容量
この公式システム要件節では、一律の必要コア数やディスク容量の数値を確認できません。公式資料にない固定値を最低要件として補うことはしません。

ネイティブインストールにはNode.jsは不要です。npm経由では、v2.1.198以降のパッケージ要件はNode.js 22以上です。インストール方法の条件を全利用者の実行要件と混同しないでください。公式のnpm導入条件

4 GBという本体要件から、開発環境の容量は決まらない

Claude Codeは実行環境でファイルを読み書きし、コマンドやプロジェクトのツールを動かします。公式の実行の仕組みを踏まえると、容量の見積もりではClaudeプロセスだけでなく、OSと同時に動く作業全体を見る必要があります。

4 GBでどのリポジトリ・ビルド・Docker構成も快適に動くとは判断できません。「2 vCPU / 20 GB SSDなら十分」「16 GBが全員に必須」といった共通の数値も、このガイドでは設定しません。

GPUは上記の公式要件に列挙されていません。別途動かすローカルモデルやGPU処理の要件まで不要になるという意味ではありません。

実行する作業ごとに必要量を数える

同じClaude Codeでも、コードを読む作業と、DBを起動してブラウザテストを並列実行する作業では必要量が変わります。次の項目を、自分が実際に使うものだけ書き出してください。

リポジトリの容量・ファイル数

複製したソースだけでなく、依存パッケージ、複数の作業ツリー、生成物も保存容量に含めます。検索やインデックス作成時のCPU・RAM・ディスクI/Oを確認します。

ビルド・テスト

コンパイラやバンドラ、テストワーカーの同時実行がピークを作る場合があります。普段の編集時ではなく、実際のビルドとテストを動かした時点を測ります。

Docker

コンテナ内のプロセスに加え、イメージ・レイヤー・ボリューム・ビルドキャッシュを数えます。仮想マシンを使う構成では、ホスト全体とVM側のメモリ制限を両方確認します。

ブラウザ・Playwright

ブラウザの複数プロセス、開くページ数、テストワーカー数を含めます。スクリーンショット、動画、トレースの保存量も見積もります。

データベース

DBの常駐メモリ、データと索引、ログ、バックアップを含めます。開発用の小さなデータと、本番相当データでは負荷が異なります。

並列実行・複数エージェント

同時に走るClaudeセッションだけでなく、それぞれが起動するビルド・ブラウザ・DBも対象です。単体測定の足し算だけに頼らず、予定する並列数で全体を測ります。

長時間動かす処理

時間経過によるメモリ使用量やログ・キャッシュの増加を確認します。長時間動かすことと、高負荷で動かすことは別で、稼働時間だけからCPUやRAMは決まりません。

CPU・RAM・保存容量を見積もる手順

  1. 代表的な作業を決める。リポジトリ、依存環境、ビルド / テストコマンド、同時エージェント数、常駐サービスを書き出します。普段使う構成で比較します。
  2. CPUと待ち時間を見る。ビルド時間、CPUの使用状況、ディスクやネットワーク待ちを確認します。API待ちが主な原因なら、コア数を増やすだけで解決するとは限りません。
  3. RAMのピークを測る。予定する作業を同時に実行し、ホスト全体の使用量、swap、メモリ不足による終了を確認します。コンテナやVMの上限も調べます。
  4. ストレージは増加分も含める。OS・ツール・ソース・依存物・Docker・DB・ログ・成果物・バックアップに必要な容量と、作業中の一時領域を確認します。
  5. 余裕と変更条件を決める。測定したピークと増加傾向を基に、許容する待ち時間や余裕を決めます。一律の倍率ではなく、並列数や保存期間が変わったら再測定します。

測定にはOSのアクティビティモニタやタスクマネージャー等を使えます。VPSではゲストOS側の数値と契約上の資源制限を照合します。現時点で測っていない処理負荷の必要CPU / RAM / ストレージは未確認です。

作業別の見積もり例（実測ではありません）

単一リポジトリの文書修正なら、まず既存Localで通常作業の負荷を確認します。DockerのDBとPlaywrightを使うWeb開発なら、それらを同時起動した状態を測ります。複数エージェントがそれぞれビルドするなら、その並列条件を再現して評価します。エージェント数だけから必要RAMを断定しません。

Local / VPS / Cloudで確認する場所が違う

  • Local：IDE、ブラウザなど普段使うアプリも含めた余裕を確認。現在のPCで足りるなら、新しいサーバー契約は不要です。
  • VPS：同じ処理負荷を対象に、提供OS・アーキテクチャ・CPU / RAM / ディスク・バックアップ・プラン変更条件を確認。操作用PCの性能ではなく、VPS上で動く作業を見積もります。
  • 公式Cloud：Anthropicホスト環境にも環境の容量上限があります。これはCloud環境の容量であり、CLIの最低スペックではありません。必要ツール・通信先・時間制約への適合を確認します。
  • Remote Control：実行場所は元のホストなので、容量の負担もそこに残ります。Remote Controlの公式説明を参照してください。

必要容量と、PCを閉じても動かす方法は別の判断です。大きなRAMがあっても電源停止後の処理継続は保証されず、VPSでも利用上限や作業失敗は解消されません。

Claude Codeに使うなら、実行場所も決める

CPU・メモリ・保存容量の見積もりができたら、次はその作業を手元PCで続けるか、別の環境に置くかを決めます。

必要容量を測った後に実行場所を選ぶ

診断はClaude Codeの実行場所を選ぶためのものです。容量計算やn8n・Codexの設定は扱いません。VPS結果には広告 / PRがあり、不要なら契約しません。