Claude Codeのインストール方法｜Mac・Windows・Linux対応の手順とエラー対処【2026年9月】

Claude Codeのインストールは、macOS・Linux・WSLならターミナルで curl -fsSL https://claude.ai/install.sh | bash、WindowsのPowerShellなら irm https://claude.ai/install.ps1 | iex を実行するだけです。この公式推奨の方法はNode.js不要で、インストール後に claude と入力すれば起動できます。

「コマンドを打ったのに何も起きない」「EACCESエラーで詰まった」という状態で検索してここに来た人のために、原因別の直し方を最初に示す。

公式ドキュメント（code.claude.com/docs）では手順の列挙にとどまっており、エラーが出たときの根拠まで踏み込んだ解説は少ない。クリスタルメソッド株式会社はAIバーチャルヒューマン・AIロープレシステムをClaude APIを含む生成AIツールチェーンで本番運用しており、npmのグローバルインストールが本番環境でどう壊れるかを開発側として把握している。その経験から、手順の転記ではなく「なぜ起きるか・どう直すか」を原因ベースで書いた。

関連記事Claude Code（クロードコード）とは？できること・料金・使い方を初心者にもやさしく解説【2026年版】 ／ Claude Code 使用量を完全制御する実装ガイド【2026年版】 ／ Claude Code ログイン方法・できない時の対処法｜2026年版ガイド

Claude Codeのインストール手順は？（結論）

Claude Codeは、公式が推奨する「ネイティブインストーラー」をターミナルで1行実行するだけでインストールでき、Node.jsは不要です。インストール後に claude を実行し、ブラウザでAnthropicアカウントにログインすれば使い始められます（2026年9月時点・公式セットアップガイド準拠）。

環境	インストールコマンド（推奨順）	自動更新
macOS・Linux・WSL	curl -fsSL https://claude.ai/install.sh | bash	あり
Windows（PowerShell）	irm https://claude.ai/install.ps1 | iex	あり
macOS（Homebrew）	brew install --cask claude-code	なし（brew upgrade）
Windows（WinGet）	winget install Anthropic.ClaudeCode	なし（winget upgrade）
npm（上級者向けの代替手段）	npm install -g @anthropic-ai/claude-code（Node.js 22以上が必要）	—

• 動作環境：macOS 13.0以上／Windows 10 1809以上／Ubuntu 20.04以上、RAM 4GB以上。
• Windowsの注意：管理者として実行する必要はありません。Git for Windowsを入れておくと、Claude CodeがBashツールを使えます（無い場合はPowerShell経由で動作）。
• 確認：claude --version でバージョンが表示されればインストール完了。うまく動かないときは claude doctor でインストール状態を診断できます。
• npmで入れる場合：v2.1.198以降のnpmパッケージはNode.js 22以上が必要です。権限エラー（EACCES）が出ても sudo は使わず、nvm等でユーザー領域にNode.jsを入れ直します（詳しくは後述）。

実運用での環境・セットアップの勘所（一次情報）

クリスタルメソッドはClaude Codeを、SEO対策で十数端末、アプリケーション開発で二十端末規模で並列稼働させています。本格運用では「1台にどう入れるか」以上に、複数端末で並列に回す構成をどう組み、端末ごとに処理を振り分けるかが実務の要点になります。なお、確認漏れを防ぐために hook（フック）で検証を強制する仕組みをアプリ化して試したこともありますが、期待したほど有用にはならず、最終的には人が確認ポイントを明示的に指定する運用に落ち着きました。

権限まわりのエラー（EACCES等）については、システム全体のnpm設定を書き換えるのではなく、Node.jsのバージョン管理ツール（nvmやvolta）を使ってユーザーローカルの範囲に閉じる運用に統一しています。sudoを使わずにグローバルインストールできるため、端末ごとに権限設定がばらつくことを避けられます。複数端末を並列稼働させる構成では、この差が地味に効いてきます。

Windows環境ではネイティブ実行とWSL2の両方を検証していますが、ファイルI/Oが多い処理を行う場合は、Windows側のマウントパス（/mnt/c配下）で直接作業するより、WSL2のLinuxファイルシステム内（/home配下）にプロジェクトを置いたほうが体感の応答が安定する傾向があります。/mnt/c配下での直接作業はファイル監視やI/O待ちが発生しやすい点は、運用上の注意点として押さえておくとよいでしょう。

claude code npm install を始める前に確認すべき環境

公式ドキュメント（Advanced setup）が明示するシステム要件は以下の通りだ（出典：code.claude.com/docs/en/setup.md）。

• OS：macOS 13.0以上 / Windows 10 1809以上またはWindows Server 2019以上 / Ubuntu 20.04以上 / Debian 10以上 / Alpine Linux 3.19以上
• ハードウェア：RAM 4GB以上、x64またはARM64プロセッサ
• Node.js：ネイティブインストーラー・Homebrew・WinGetでは不要。npmでインストールする場合のみNode.js 22以上（v2.1.198以降のnpmパッケージの要件）
• ネットワーク：インターネット接続必須
• Anthropicアカウント：platform.claude.com から作成

npmでインストールする場合は、まず現在の環境を確認する（ネイティブインストーラーを使うならこの確認は不要）。

node --version   # v22.x.x 以上が返ればOK（npm経由の場合）
npm --version    # バージョンが表示されればOK

Node.jsが入っていない・v22未満の場合は後述するnvmまたはvoltaで入れ直してからインストールに進む。この順番を守るだけで権限エラーとバージョン不一致の大半を事前に潰せる。

インストールコマンドとグローバル／ローカル／npxの使い分け

公式が推奨するインストール方法は2系統ある。状況に応じて選ぶ。

ネイティブインストール（公式推奨・自動更新あり）

公式ドキュメントが最初に示すのはcurlスクリプト経由のネイティブインストールだ（出典：code.claude.com/docs/en/quickstart.md）。このルートはバックグラウンドで自動更新される。

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windowsで「&& is not valid」と出たらPowerShellに居る。「irm is not recognized」と出たらCMDに居る。プロンプトが PS C:\ で始まればPowerShell、C:\ のみならCMDと判別できる（出典：公式ドキュメント同上）。

npmグローバルインストール

パッケージマネージャで管理したい場合や、npmの依存解決に乗せたい場合に使う。

# グローバルインストール
npm install -g @anthropic-ai/claude-code

# Homebrew（macOS）
brew install --cask claude-code

グローバル・ローカル・npxの比較

方法	コマンド例	主な用途	注意点
グローバル（-g）	npm install -g @anthropic-ai/claude-code	常用・どのディレクトリからもclaudeで呼び出す	システム領域に書き込むため権限問題が起きやすい。nvmで管理すれば回避できる
ローカル	npm install @anthropic-ai/claude-code	特定プロジェクト内で固定バージョンを使いたい場合	claudeコマンドが直接使えないのでnpx経由になる。CLIツールとしての一般的な使い方には向かない
npx（都度実行）	npx @anthropic-ai/claude-code	インストールせずに試す	毎回ダウンロードが走るため遅い。日常利用には適さない

日常的に使うならグローバルインストール一択で良い。ただしnvmまたはvoltaでNode.jsを管理している環境に限る。その理由は次節で説明する。

【OS別】MacとWindowsのインストール要点

コマンドはOS共通に見えて、つまずく場所はOSごとに違う。要点だけ先に押さえておく。

Macにインストールする（macOS 13.0以上）

推奨は前述の公式スクリプト（自動更新あり）だ。

curl -fsSL https://claude.ai/install.sh | bash

Homebrew派は brew install --cask claude-code（安定版・通常約1週間遅れ）または claude-code@latest（最新版）を使える。ただしHomebrew経由は自動更新されないため、brew upgrade claude-code（@latest導入時は brew upgrade claude-code@latest）を定期実行する。旧バージョンがディスクに残るので brew cleanup も有効だ。配布バイナリは「Anthropic PBC」署名＋Apple公証済みで、codesign --verify --verbose ./claude で検証できる。導入後は claude --version で確認し、詳細診断は claude doctor を使う（出典：code.claude.com/docs/en/setup.md、2026-07-02確認）。

Windowsにインストールする（ネイティブ／WSL）

# PowerShell
irm https://claude.ai/install.ps1 | iex

# CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# WinGet
winget install Anthropic.ClaudeCode

ネイティブWindowsはサンドボックス機能に非対応で、WSL 2なら対応する。Git for Windowsは任意（導入するとBashツールが有効になる）。環境選択（ネイティブ/WSL2/WSL1）・PowerShellとCMDの取り違えエラー・更新の罠まで含めた詳細は Claude Code Windows 環境選択からエラー対処まで完全解説 にまとめている。

nvm / volta を先に入れておくべき理由

クリスタルメソッドでAIバーチャルヒューマン・AIロープレシステムの開発環境を整備してきた経験から言うと、npmのグローバルインストールが壊れる原因は「Node.jsをシステム領域に直接入れていること」がほぼ全てだ。

システムインストールのNode.js（macOSなら/usr/local/lib、Linuxなら/usr/libあたり）に対してnpm install -gを実行すると、書き込み先がroot所有ディレクトリになる。一般ユーザーには書き込み権限がないためEACCESエラーが出る。sudoで強行するとグローバルパッケージ群がroot所有になり、以後の更新・削除時に必ずsudoが必要になる連鎖が始まる。

nvmまたはvoltaで管理するNode.jsは、グローバルパッケージのディレクトリがホームディレクトリ配下（例：~/.nvm/versions/node/v22.x.x/lib/node_modules）に置かれる。ここは一般ユーザーが自由に読み書きできるため、sudoなしでnpm install -gが通る。

nvm（Node Version Manager）

# nvmインストール（macOS / Linux / WSL）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# シェルを再起動後
nvm install --lts      # 最新LTSをインストール
nvm use --lts          # 現在のシェルで使用するバージョンを切り替え
node --version         # 確認

# 複数バージョン管理の例
nvm install 20         # Node.js 20系もインストール
nvm use 20             # 一時的に20系を使う
nvm alias default lts  # デフォルトを常にLTSに

プロジェクトルートに.nvmrcファイルを置いてバージョンを固定できる。

# .nvmrc の内容例
lts/*

volta（クロスプラットフォーム・Windowsネイティブ対応）

# macOS / Linux / WSL
curl https://get.volta.sh | bash

# Windowsネイティブ（PowerShell）
# volta公式インストーラー（https://volta.sh）からmsiを取得してインストール

# Node.jsのインストール
volta install node@lts
node --version

# プロジェクトごとにバージョンをピン留め
volta pin node@22

voltaはnvmよりも起動が速く、WindowsネイティブでもWSL不要で動作する点が特徴だ。nvm useを手動で打つ必要がなく、プロジェクト移動時に自動でバージョンが切り替わる。

観点	nvm	volta
Windowsネイティブ対応	nvm-for-windows（別プロジェクト）が必要	公式対応
バージョン自動切替	.nvmrcがあればnvm useで切替（自動ではない）	プロジェクト移動時に自動切替
起動速度	普通	高速（Rustで実装）
シェル互換性	bash/zsh（rcファイルに設定が必要）	bash/zsh/fish/PowerShell
普及度・ドキュメント量	多い	少なめ

チームがMac/Linux統一ならnvm、Windowsネイティブをメインにするメンバーがいるならvoltaを選ぶのが実務での判断基準になる。

よくある失敗パターンと原因別の対処法

公式トラブルシュートページ（code.claude.com/docs/en/troubleshoot-install.md）をベースに、開発現場で実際に遭遇した原因の解像度を加えて整理した。

エラー・症状	根本原因	対処法
EACCES: permission denied	npmグローバルディレクトリがroot所有。システムインストールのNode.jsを使っている	nvmまたはvoltaでNode.jsを入れ直す。sudo npmは使わない
Unsupported engine またはインストール後に動かない	Node.jsがv22未満（npm版はv2.1.198以降Node.js 22以上が必要）。ディストリのaptで入れた古いバージョンが使われている	node --versionを確認。nvm install –ltsで入れ直してから再インストール
command not found: claude	npmグローバルbinがPATHに含まれていない。またはNode.jsバージョンを切り替えてインストールしたバージョンと実行バージョンがずれている	下記の詳細対処を参照
ETIMEDOUT / ECONNREFUSED	社内プロキシ・ファイアウォールによるブロック	npm config set proxy http://proxy.example.com:8080 でnpmプロキシを設定
インストールが途中で止まる・繰り返し失敗	npmキャッシュの破損	npm cache clean --force後に再試行
LinuxでKilledと表示されてインストールが中断	メモリ不足（OOMKiller発動）。公式ドキュメントが明示する低メモリLinuxサーバーの問題	スワップ領域を追加する（公式ドキュメント：troubleshoot-install.md 参照）
TLS connect error / SSL/TLS secure channel	CA証明書が古い	OSのCA証明書を更新（例：sudo update-ca-certificates）
Windows PowerShellで実行ポリシーエラー	スクリプト実行が組織ポリシーで制限されている	Set-ExecutionPolicy -Scope CurrentUser RemoteSignedを実行後に再試行

command not found の詳細対処

インストール自体は成功しているがclaudeコマンドが見つからないケースは、PATHの問題か、インストール時に使っていたNode.jsバージョンと現在のバージョンが違うかのどちらかだ。

# グローバルbinのパスを確認（npm bin -g は npm v9 で廃止。prefix に /bin を付与）
npm prefix -g
# 例：/home/username/.nvm/versions/node/v22.11.0 （実際のbinは末尾に /bin）

# PATHを確認
echo $PATH

# PATHに含まれていなければ ~/.bashrc または ~/.zshrc に追記
export PATH="$PATH:$(npm prefix -g)/bin"

# 設定を反映
source ~/.bashrc   # またはsource ~/.zshrc

# nvmで別バージョンに切り替えていた場合は、
# claude-codeをインストールしたバージョンで再実行
nvm use 22
claude --version

nvm環境でよくある落とし穴として、nvm use 20で別バージョンに切り替えた後にnpm install -gを実行すると、そのバージョンのbinディレクトリにしかclaudeが入らない。別バージョンに切り替えるとclaude: command not foundになる。どのNode.jsバージョンでも使いたい場合はそれぞれのバージョンでインストールするか、voltaのようにバージョンを自動管理するツールを使う。

EACCES権限エラーにsudoを使ってはいけない理由

sudo npm install -g @anthropic-ai/claude-codeはエラーを即座に解消するように見えるが、以下の問題を生む。

• グローバルパッケージがroot所有になり、次回npm update -gやnpm uninstall -gもsudoが必要になる
• sudoで実行されたスクリプトがシステムファイルに意図せず触れるリスクがある
• チーム共有環境では他ユーザーへの影響が出る場合がある

正しい対処はnvmまたはvoltaでNode.jsを管理する構成に切り替えることだ。これで権限エラーはほぼ再発しなくなる。

インストール後の動作確認と認証設定

インストールが完了したら、動作確認と認証設定を一気通貫で済ませる。ここで「正常に動く状態」を確立しておくと、後でトラブルが起きたときの切り分けが格段に楽になる。

ステップ1：バージョン確認

claude --version
# バージョン番号が表示されればインストールは成功

ここでcommand not foundが出た場合は前節のPATH対処に戻る。

ステップ2：初回認証（ブラウザ経由）

claude
# 初回起動時にブラウザが自動で開き、Anthropicアカウントの認証が求められる

認証が完了するとトークンがローカルに保存され、以降はclaudeコマンドで即座に対話セッションが始まる。リモートサーバーやSSH接続先でブラウザが開かない場合は、ターミナルに表示されたURLをコピーして手元のPCのブラウザに貼り付けて認証する。

ステップ3：APIキーによる認証（CI/CD・非インタラクティブ環境）

CI/CDパイプラインや自動化スクリプト内では、環境変数ANTHROPIC_API_KEYにAPIキーをセットすることでブラウザ認証をスキップできる。APIキーはAnthropic Console（platform.claude.com）で発行する。

# ローカル環境での一時的な設定
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
claude --version   # 認証確認

# 恒久設定の場合は ~/.bashrc または ~/.zshrc に追記
echo 'export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx' >> ~/.bashrc
source ~/.bashrc

GitHub ActionsやGitLab CIではリポジトリのSecrets機能でキーを管理し、ワークフロー内の環境変数として渡す。APIキーをコードにハードコードしないこと。

ステップ4：動作テスト

mkdir ~/claude-test && cd ~/claude-test
git init
echo "# Test" > README.md
claude

対話セッションが起動したら「このディレクトリのファイル一覧を教えて」など簡単な指示で応答を確認する。ファイルの読み書きが正常に動くところまで確認できれば、実用できる状態だ。

認証後の使い方全般については Claude Codeの使い方｜導入から活用まで で詳しく解説している。スラッシュコマンドの一覧は Claude Code スラッシュコマンド を参照してほしい。

利用できるモデルも現在は、最上位のFable 5.1、主力のOpus 5.5・Sonnet 5.5、軽量なHaiku 4.5まで揃っている。インストール後の初回起動時にどのモデルを使うか選べる。

アップデートとアンインストール

ネイティブインストール（curlスクリプト経由）は自動更新される。npmグローバルインストールの場合は手動でのアップデートが必要だ。

アップデート

# 更新確認
npm outdated -g @anthropic-ai/claude-code

# アップデート（公式は npm update -g を避け @latest 指定を推奨）
npm install -g @anthropic-ai/claude-code@latest

# アップデート後の確認
claude --version

チーム利用の場合は月1回程度、全員が同じバージョンに揃えるタイミングを設けると「自分の環境だけ動かない」問題を防ぎやすい。メジャーアップデート時はコマンドの挙動や設定ファイルの仕様が変わる場合があるため、公式リリースノートに目を通す習慣をつけておく。

アンインストール

# CLI本体の削除
npm uninstall -g @anthropic-ai/claude-code

# 設定・認証トークンの削除
rm -rf ~/.claude
rm -f ~/.claude.json

CLIを削除するだけでは認証トークンと設定ファイルがローカルに残る。セキュリティ要件がある環境では上記のディレクトリ削除も合わせて行う。

料金・プラン詳細は Claude Code 料金 および Claude Code API料金 を参照。他のAIコーディングツールとの比較は Claude Code vs Cursor や Claude Code vs Codex でまとめている。フックによる拡張については Claude Code hooks を参照してほしい。

よくある質問（Claude Codeのインストール）

Q. Claude Codeはnpmでインストールできますか？

A. できます。コマンドは npm install -g @anthropic-ai/claude-code で、npm版はNode.js 22以上が必要です。ただし公式が推奨するのはNode.jsを使わないネイティブインストーラーで、macOS・Linux・WSLは curl -fsSL https://claude.ai/install.sh | bash、Windows PowerShellは irm https://claude.ai/install.ps1 | iex の1行で入ります。npm版がダウンロードするのも同じネイティブのバイナリで、更新は npm install -g @anthropic-ai/claude-code@latest です（npm update -g では最新に上がらないことがあります）。

Q. Windowsにはどうやってインストールしますか？

A. PowerShellなら irm https://claude.ai/install.ps1 | iex、コマンドプロンプト（CMD）なら curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd を実行します。管理者として実行する必要はありません。winget install Anthropic.ClaudeCode でも入ります。WSL 2で使う場合は、PowerShellではなくWSLのターミナル内でLinux用のコマンドを実行します。Git for Windowsは任意ですが、入れておくとBashツールが使えます。

Q. インストールしたのに「claude: command not found」と出るのはなぜですか？

A. まず新しいターミナルを開き直して claude --version を実行してください。それでも見つからない場合は、インストール先がPATHに入っていません。ネイティブ版は ~/.local/bin、npm版は npm prefix -g の直下の bin がインストール先なので、~/.bashrc や ~/.zshrc に export PATH="$HOME/.local/bin:$PATH" のように追記して読み込み直します。原因の切り分けには claude doctor が使えます。

Q. インストールは無料ですか？どのアカウントが必要ですか？

A. インストール自体は無料ですが、利用にはPro・Max・Team・EnterpriseのいずれかのプランまたはConsole（API）アカウントが必要で、無料プランのclaude.aiアカウントではClaude Codeは使えません。インストール後に claude を起動するとブラウザでログインを求められます。ANTHROPIC_API_KEY を設定している場合はAPIキーでの利用も可能です（出典：Claude Code公式ドキュメント「Advanced setup」）。

DeepAIにおけるClaude API活用について

クリスタルメソッドが開発する「DeepAI」は、実在の人物の容姿・表情・声・振る舞いをデジタル空間で再現するバーチャルヒューマン／AIアバターソリューションだ。接客・研修・面接練習・広報などの用途で活用されており、対話AI部分にClaude APIを含む生成AIツールチェーンを本番環境で組み込んでいる。

AIロープレ・面接練習システムとしてのDeepAIは、受講者の表情・感情・緊張度を発話タイムラインに沿って解析・可視化する機能を持つ。Claude Code自体はコーディング支援CLIとして我々の開発ワークフローにも組み込んでおり、npmグローバルインストールが複数の開発環境で壊れるパターンをこれまでに複数回経験している。本記事の権限エラーやPATH問題に関する記述は、その実地経験に基づくものだ。

DeepAIの詳細についてはクリスタルメソッドのサービスページを参照してほしい。本記事はDeepAIの宣伝を目的とするものではなく、claude code npm installに関する技術情報の提供が主目的であることを明示する（利益相反の開示）。

---

関連記事

• Claude Code
• Claude Codeの始め方｜初心者が最初にやること
• Claude Codeの使い方｜導入から活用まで
• Claude Code スラッシュコマンド一覧
• Claude Code hooks の使い方
• claude code 動かない｜「完了しました」を信じるな——環境系と生成系の対処【2026】
• Claude Code 日本語対応の完全ガイド｜設定・文字化け・実務活用まで

参考文献

• Anthropic, “Advanced setup – System requirements, installation, version management, and uninstallation for Claude Code”, https://code.claude.com/docs/en/setup.md
• Anthropic, “Quickstart – Welcome to Claude Code”, https://code.claude.com/docs/en/quickstart.md
• Anthropic, “Troubleshoot installation and login”, https://code.claude.com/docs/en/troubleshoot-install.md
• Anthropic, “Agent SDK Quickstart”, https://code.claude.com/docs/en/agent-sdk/quickstart.md