Claude Codeインストール【Mac/Win対応・2026年版】

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

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

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：18以上（Agent SDK Quickstartにも「Node.js 18+」と明記）
• ネットワーク：インターネット接続必須
• Anthropicアカウント：platform.claude.com から作成

まず現在の環境を確認する。

node --version   # v18.x.x 以上が返ればOK
npm --version    # バージョンが表示されればOK

Node.jsが入っていない・v18未満の場合は後述する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がv18未満。ディストリの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 スラッシュコマンド を参照してほしい。

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

ネイティブインストール（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 を参照してほしい。

弊社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 の使い方

参考文献

• 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