コンテンツへスキップ

media AI活用の最前線

ツール比較・実践ガイド

Claude Code インストール完全ガイド【2026】|全OS・npm非推奨対策

Claude Code インストール完全ガイド【2026】|全OS・npm非推奨対策

結論: Claude Codeは2026年現在、ネイティブインストーラー(curlコマンド1行)で5分以内にMac・Windows・Linux全てにインストールできます。

この記事の要点:

  • 要点1: 推奨インストール方法は curl -fsSL https://claude.ai/install.sh | bash の1行(npm方式は非推奨化)
  • 要点2: 前提条件はAnthropicアカウント(Pro/Max/Team/Enterprise)のみ。Node.jsは不要
  • 要点3: インストール後の初期設定はCLAUDE.md作成と認証の2ステップで完了

対象読者: Claude Codeを初めてインストールしたい開発者・エンジニア・IT担当者

読了後にできること: Claude Codeを自分のPCに正しくインストールし、今日から使い始められる

「Claude Codeを入れたいんだけど、npmとHomebrewとネイティブインストーラー、どれを使えばいいの?」

企業向けAI研修でこの質問をされることが増えました。特に2025年後半からnpmインストールが非推奨になったことで、「昔の記事どおりにやったらエラーになった」という声も聞こえてきます。

先日、研修先のエンジニアチームでセットアップ会を開いたのですが、5人中2人が古いnpmインストール手順でつまずいていました。最新の公式ドキュメントを確認したら、インストール方法が大幅に変わっていたんです。これは早く情報をアップデートしなければ、と感じました。

この記事では、2026年3月時点の最新インストール方法をOS別に全公開します。MacでもWindowsでもLinuxでも、5分以内にセットアップできる手順です。初期設定やよくあるエラーの解決策まで、コピペで動くコマンドつきで解説しますね。

まず試したい「5分インストール」手順

細かい説明の前に、まず動かしてみましょう。MacまたはLinuxを使っている方は、以下のコマンド1行でインストールできます。

【Mac/Linux共通】ネイティブインストーラー(最推奨)

# ネイティブインストーラーで1発インストール
curl -fsSL https://claude.ai/install.sh | bash

# インストール確認
claude --version

# 起動
claude

これだけです。Node.jsも何も事前インストール不要。コマンドを実行するとインストーラーが自動でダウンロード・設定まで行ってくれます。筆者の環境(Mac M4)では約30秒で完了しました。

インストール後に claude と打つと認証画面が表示されるので、ブラウザでAnthropicアカウントにログインすればすぐに使い始められます。

【Windows】PowerShellでのインストール

# 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の場合はGit for Windowsが必須です。事前に公式サイトからインストールしておいてください。WSL(Windows Subsystem for Linux)経由でも利用できます。

Claude Codeとは?インストール前に知っておくこと

Claude Codeは、Anthropicが提供するAIコーディングアシスタントです。ターミナルやVS Codeから使える開発専用AIで、コード生成・リファクタリング・バグ修正・テスト作成をAIに任せられます。

AIエージェントの基本概念や導入ステップについては、AIエージェント導入完全ガイドで体系的にまとめています。

Claude Codeを使うための前提条件

インストール前に以下を確認してください。

条件詳細備考
AnthropicアカウントPro、Max、Team、またはEnterpriseプラン無料プランでは使えません
OSmacOS 13.0+、Windows 10 1809+、Ubuntu 20.04+Alpine Linux 3.19+も対応
RAM4GB以上8GB推奨
ネットワークインターネット接続必須オフライン使用不可
Node.js【ネイティブインストーラー利用時は不要】npm方式利用時はNode.js 18+が必要

一番よく聞かれるのが「無料プランで使えますか?」という質問です。残念ながらClaude.aiの無料プランにはClaude Codeが含まれません。Pro(月20ドル)以上のプランが必要です。研修先でも「無料で試せると思った」という声をよく聞くので、先に確認しておきましょう。

OS別インストール方法(全3パターン)

パターン1:ネイティブインストーラー(全OS推奨)

2025年後半から採用された最新インストール方式です。npmより速く、依存ライブラリ不要で、バックグラウンド自動更新まで対応しています。

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

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

# stableチャンネル(より安定したバージョン)を使いたい場合
curl -fsSL https://claude.ai/install.sh | bash -s stable

メリット: Node.js不要、自動更新、署名済みバイナリ(macOSは”Anthropic PBC”名義でApple公証済み)
デメリット: 特になし

パターン2:Homebrew(Macユーザー向け)

# インストール
brew install --cask claude-code

# 更新(定期的に実行)
brew upgrade claude-code

# 古いバージョンの削除(ディスク節約)
brew cleanup claude-code

メリット: Homebrewで一元管理できる
デメリット: 自動更新されない。手動で brew upgrade claude-code が必要

研修先で「いつの間にかバージョンが古くなっていた」というケースをよく見ます。Homebrew使用者は定期的なアップデートを忘れずに。

パターン3:npm(非推奨・互換性目的のみ)

# 【非推奨】npmインストール(Node.js 18+が必要)
npm install -g @anthropic-ai/claude-code

# ⚠️ 以下は絶対にやらないこと(権限問題が発生)
sudo npm install -g @anthropic-ai/claude-code  # NG!

npmインストールは公式に非推奨化されました。既存のnpmインストール済み環境は、以下でネイティブ方式に移行できます。

# ネイティブへの移行手順
curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

Windows専用セットアップ手順

WindowsはMacやLinuxと少し手順が異なります。Windowsユーザーは以下のどちらかで進めてください。

方法A:Git for Windows + ネイティブインストーラー(推奨)

# ステップ1: Git for Windowsをインストール(まだの場合)
# https://git-scm.com/downloads/win からダウンロード

# ステップ2: PowerShellでClaude Codeをインストール
irm https://claude.ai/install.ps1 | iex

# ステップ3: 確認
claude --version

Git Bashのパスが見つからないエラーが出る場合は、settings.jsonに以下を追加します。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:Program FilesGitbinbash.exe"
  }
}

方法B:WinGet(Windowsパッケージマネージャー)

# WinGetでインストール
winget install Anthropic.ClaudeCode

# 更新
winget upgrade Anthropic.ClaudeCode

方法C:WSL(Windows Subsystem for Linux)

# WSLターミナルで
curl -fsSL https://claude.ai/install.sh | bash

WSL 2はサンドボックス機能にも対応しているため、セキュリティを重視する場合はWSL 2がおすすめです。

インストール後の初期設定(認証とCLAUDE.md作成)

インストールが完了したら、次は初期設定です。2ステップで完了します。

ステップ1:認証(ブラウザログイン)

# claudeコマンドを起動
claude

# ブラウザが開くので、Anthropicアカウントでログイン
# 初回のみ認証が必要。次回からは自動認証

研修でよく聞かれますが、APIキーの入力は不要です。ブラウザでログインするだけでOK。ただしAWSのBedrock経由やGoogle Vertex AI経由で使う場合は別途設定が必要です(企業導入の場合は後述の関連記事を参照)。

ステップ2:インストール確認

# バージョン確認
claude --version

# セットアップ状態の詳細チェック
claude doctor

# 正常なら "All checks passed" と表示される

ステップ3:CLAUDE.mdを作成(プロジェクト設定)

# プロジェクトフォルダに移動
cd ~/your-project

# CLAUDE.mdを作成(プロジェクトのルール・コンテキストを書く)
claude
# 起動後に「/init」コマンドでCLAUDE.mdの雛形を自動生成

CLAUDE.mdはClaude Codeへの「指示書」です。プロジェクトの概要、使用技術、コーディング規約などを書いておくと、毎回説明する手間が省けます。個人的には「CLAUDE.mdを作るだけで生産性が30%上がる」と感じています。

# CLAUDE.mdの最小テンプレート
# プロジェクト名: ○○
# 技術スタック: Node.js 20, React 18, TypeScript
# コーディング規約: ESLint + Prettier準拠
# 禁止事項: console.logを本番コードに残さない
# 不足している情報があれば、最初に質問してから作業を開始してください。

AI活用、何から始めればいい?

100社以上の研修実績をもとに、30分の無料相談で貴社の課題を整理します。

無料相談はこちら

VS Code・JetBrains拡張のインストール

CLIだけでなく、IDEからも使えます。

VS Code拡張(推奨)

# VS Codeの拡張機能から検索してインストール
# 検索キーワード: "Claude Code"(公式: anthropic.claude-code)

# またはターミナルから
code --install-extension anthropic.claude-code

VS Code拡張についての詳細な設定方法は、Claude Code VS Code拡張 完全ガイドで解説しています。インラインチャット・ファイル編集・ターミナル統合など、CLI版との違いも含めて詳しく紹介していますので、ぜひあわせてご覧ください。

JetBrains拡張(IntelliJ IDEA・PyCharm等)

# JetBrains Marketplace から検索
# キーワード: "Claude Code"
# または: Settings → Plugins → Marketplace で検索

【要注意】よくあるインストールエラーと解決策

エラー1:「command not found: claude」

# ❌ インストール直後にclaudeコマンドが見つからない
$ claude
zsh: command not found: claude

# ✅ 解決策1: PATHを再読み込み
source ~/.zshrc   # または source ~/.bashrc

# ✅ 解決策2: 絶対パスで確認
~/.local/bin/claude --version

# ✅ 解決策3: PATHに追加
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

エラー2:npmのpermission denied(古いnpm方式でよく発生)

# ❌ よくあるミス
sudo npm install -g @anthropic-ai/claude-code  # 絶対NG!

# ✅ 解決策: ネイティブインストーラーに切り替える
curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code  # 旧npmバージョンを削除

「なぜsudoがNGなの?」と聞かれますが、sudoで入れると後でアップデートや設定変更のたびに権限問題が発生します。ネイティブインストーラーならこの問題は起きません。

エラー3:Alpine Linuxでのインストールエラー

# Alpine Linuxでは追加ライブラリが必要
apk add libgcc libstdc++ ripgrep

# その後settings.jsonに追加
{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

エラー4:Windowsで「Git Bash not found」

# settings.jsonにGit Bashのパスを明示
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:Program FilesGitbinbash.exe"
  }
}

# settings.jsonの場所: %USERPROFILE%.claudesettings.json

エラー5:認証後も「API rate limit」エラー

# ✅ 対応策
# 1. プランを確認(Proプランは使用量制限あり)
# 2. 一定時間(数時間)待つ
# 3. 大量使用が必要な場合はMaxプラン(月100ドル)を検討

# プラン確認
claude /usage

研修先でよく聞かれるのが「Proプランで使い切れる?」という質問です。個人利用なら十分ですが、一日中コード生成をし続けると月後半に制限に引っかかることがあります。業務で本格利用するならMaxプランが安心です。

インストール後の更新・アンインストール方法

更新方法

# ネイティブインストーラー方式(自動更新 + 手動即時更新)
claude update  # 手動で今すぐ更新したい時

# 更新チャンネルの設定(settings.jsonに追加)
{
  "autoUpdatesChannel": "stable"  # 安定重視の場合
  # "latest"(デフォルト): 最新機能をすぐ使いたい場合
}

# Homebrew方式
brew upgrade claude-code

# WinGet方式
winget upgrade Anthropic.ClaudeCode

アンインストール方法

# ネイティブインストーラー方式
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

# 設定ファイルも削除する場合(注意:全設定・履歴が消えます)
rm -rf ~/.claude
rm ~/.claude.json

# Homebrew方式
brew uninstall --cask claude-code

# npm方式
npm uninstall -g @anthropic-ai/claude-code

インストール後すぐ使える5つのプロンプト

インストールと初期設定が完了したら、以下のプロンプトをそのままコピペして試してみてください。

プロンプト1:現在のプロジェクト構成を把握する

このプロジェクトの全体構成を説明してください。主要なファイル・フォルダの役割と、
アーキテクチャの概要をMarkdown形式でまとめてください。
不足している情報があれば、最初に質問してから作業を開始してください。

プロンプト2:バグを修正してもらう

(エラーメッセージをコピペ)
このエラーの原因を特定して修正してください。
修正の理由と、今後同じエラーを防ぐ方法も教えてください。

プロンプト3:コードレビューをしてもらう

このコードをレビューしてください。以下の観点でチェックしてください:
1. バグ・潜在的な問題
2. パフォーマンスの改善点
3. 可読性・保守性
4. セキュリティリスク
問題があれば優先度をつけて指摘してください。

プロンプト4:テストを自動生成してもらう

このファイルのユニットテストをJestで書いてください。
エッジケース・正常系・異常系を網羅してください。
仮定した点は必ず「仮定」と明記してください。

プロンプト5:新機能を実装してもらう

以下の機能を実装してください:
(機能の説明)

実装前に、仕様の確認や不明点があれば質問してください。
実装方針を先に提示してから、コードを書いてください。
数字と固有名詞には根拠を添えてください。

研修先でも「最初どんなプロンプトを使えばいいかわからない」という声が多いので、まずはこの5つから始めてみてください。どれも業務でそのまま使える実践的な内容です。

Claude Codeのプランと料金

プラン月額Claude Code用途
無料無料❌ 使えないClaude.ai チャットのみ
Pro$20(約3,000円)✅ 使える個人開発・副業
Max$100〜$200(約15,000〜30,000円)✅ 使える(上限大)本格業務利用
Team$25/人/月〜✅ 使えるチーム導入
Enterprise要問合せ✅ 使える(SSO・監査ログ等)大規模企業導入

企業でのTeam/Enterprise導入については、Claude Code企業導入ガイドで詳しく解説しています。なお、Claude Codeは公式にはClaude.aiサービスの一部として提供されており、AnthropicのAI規約・利用ポリシーが適用されます。APIキーベースのアクセスを希望する場合は、Anthropic Console経由のAPIプランも選択肢になります。

Native Install vs npm vs Homebrew|インストール方式の選び方

Claude Codeには複数のインストール方法があります。GSCデータを見ると「claude code npm install」や「claude install」のクエリが多数ある一方でクリック率が低い傾向があります。これは各インストール方式の違いや使い分けが記事内で十分に説明されていないことが一因です。以下で方式ごとの特徴と選び方を整理します。

インストール方式コマンド自動更新推奨シーン
Native Install(推奨)curl / PowerShell スクリプトあり(バックグラウンド)ほぼすべてのユーザー
Homebrewbrew install --cask claude-codeなし(手動 brew upgradeHomebrewで一括管理したい Mac ユーザー
WinGetwinget install Anthropic.ClaudeCodeなし(手動 winget upgradeWinGetで一括管理したい Windows ユーザー
npmnpm install -g @anthropic-ai/claude-codeなし(手動 npm install -g @anthropic-ai/claude-code@latestnpm 管理を一元化している開発者
apt / dnf / apk各パッケージマネージャーの手順なし(システム upgrade に委ねる)Debian / Fedora / Alpine の CI 環境

Native Install を選ぶ理由

公式ドキュメント(code.claude.com/docs/en/setup)では Native Install が「Recommended」と明示されています。バックグラウンド自動更新が有効なため、常に最新機能とセキュリティ修正を受け取れます。

  • 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

npm インストールの注意点

npm でインストールする場合、内部では同じ Native バイナリをダウンロードします(npm 自体では動きません)。以下の点に注意してください。

  • sudo npm install -g は使用しない:パーミッションエラーやセキュリティリスクの原因になります(公式明記)
  • 更新時は npm update -g ではなく npm install -g @anthropic-ai/claude-code@latest を使う(npm update は semver 範囲を参照するため最新版に上がらないケースがあります)
  • Node.js 18以上が必要です

Homebrew のチャンネル選択

Homebrew には2種類のカスクがあります。

  • brew install --cask claude-code:stable チャンネル(約1週間遅れ、重大な不具合を含むリリースをスキップ)
  • brew install --cask claude-code@latest:latest チャンネル(即時)

アップグレードは自動で行われないため、定期的に brew upgrade claude-code または brew upgrade claude-code@latest を実行してください。古いバージョンがディスクに残る場合は brew cleanup で回収できます。

「zsh: command not found: claude」などインストール後エラーの完全診断

GSCのデータでは、インストール後に「zsh: command not found: claude」と検索しているユーザーが一定数います。インストール自体は成功していても、シェルに claude コマンドが認識されないケースです。以下の手順で診断・解決できます。

手順1:インストールの確認

まずバイナリが存在するか確認します。

claude --version

コマンドが見つからない場合は、次のコマンドで診断レポートを出力できます(公式ドキュメント記載)。

claude doctor

手順2:パスが通っているか確認

Native Install の場合、バイナリは ~/.local/bin/claude(macOS / Linux)に配置されます。このディレクトリがシェルの PATH に含まれていない場合にエラーが発生します。

# PATHに含まれているか確認
echo $PATH | grep -o '[^:]*local/bin[^:]*'

# 含まれていなければ .zshrc または .bashrc に追記
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

手順3:競合するインストールが残っていないか確認

過去に npm でインストールしたバイナリが残っている場合、バージョン不整合が起きることがあります。

# claude バイナリの場所を全部調べる
which -a claude 2>/dev/null || type -a claude 2>/dev/null

複数のパスが表示された場合は、不要な方をアンインストールしてください。

手順4:Windows で PowerShell / CMD を間違えていないか確認

Windows Native Install では、使用するシェルによってインストールコマンドが異なります。

  • プロンプトが PS C:\ で始まる → PowerShell:irm https://claude.ai/install.ps1 | iex
  • プロンプトが C:\ のみ → CMD:curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

The token '&&' is not a valid statement separator」と表示された場合は、CMD 用コマンドを PowerShell で実行しています。逆に「'irm' is not recognized」は PowerShell 用コマンドを CMD で実行したサインです。

手順5:WSL 内での実行を確認

WSL を使用している場合、claude コマンドは WSL の内部ターミナルから実行します。PowerShell や CMD から直接 WSL の claude を呼び出す構成はサポートされていません。WSL 内でインストールし、WSL ターミナル内で claude を起動してください。

インストール方式を検討したうえで、Claude Code を使いこなすための学習ロードマップについてはClaude Code 独学ロードマップ|挫折しない5ステップもあわせて参照してください。料金・プラン選びはClaude Code 料金完全ガイドで詳しく解説しています。

まとめ:今日から始める3つのアクション

  1. 今日やること: curl -fsSL https://claude.ai/install.sh | bash を実行してClaude Codeをインストール
  2. 今週中: CLAUDE.mdをプロジェクトに作成し、コーディング規約を登録
  3. 今月中: VS Code拡張もインストールして、IDE連携ワークフローを確立

次回予告: 次の記事では「Claude Code VS Code拡張の使いこなし術」をテーマに、インラインチャット・ファイル編集・ショートカットキーを詳しく紹介します。


参考・出典


著者

: 佐藤傑(さとう・すぐる)
株式会社Uravation代表取締役。早稲田大学法学部在学中に生成AIの可能性に魅了され、X(@SuguruKun_ai)フォロワー約10万人。100社以上の企業向けAI研修・導入支援を展開。著書『AIエージェント仕事術』(SBクリエイティブ)。SoftBank IT連載7回執筆(NewsPicks最大1,125ピックス)。

Claude Code導入サポートをご希望の方は、Claude Coachingからお気軽にご相談ください。ご質問はお問い合わせフォームからもどうぞ。

Claude Code インストール 完全ガイド【2026】|全OS対応・npm非推奨対策のよくある質問

この記事の内容を実務で使う前に確認しやすいよう、導入判断で迷いやすい点を整理します。

Claude Code インストール 完全ガイド【2026】|全OS対応・npm非推奨対策は誰向けの記事ですか?

Claude Code インストール 完全ガイド【2026】|全OS対応・npm非推奨対策は、生成AIやAI活用を業務に取り入れたい担当者、管理職、経営層が導入判断をするための整理として読めます。

導入前に最初に確認することは何ですか?

目的、対象業務、利用データ、社内ルール、費用対効果、担当者の運用負荷を確認します。ツール選定より先に、どの業務をどう変えるかを決めることが重要です。

小さく試す場合の進め方は?

社内情報を使わない検証から始め、出力品質、作業時間、レビュー負荷を確認します。成果が見えたら、権限とログを整えて実業務に近づけます。

失敗しやすいポイントは?

目的が曖昧なままツール導入を急ぐこと、評価基準を決めないこと、現場の確認フローを省くことです。AIの出力は最初から完全自動化せず、人間の確認を残す設計が安全です。

社内展開では何を残すべきですか?

プロンプト、判断基準、利用データ、承認フロー、失敗例、改善履歴を残します。属人化を避けることで、研修や横展開もしやすくなります。

最終確認日: 2026年5月28日

無料・初回相談

100社以上の支援実績|30分の無料相談で導入設計を一緒に組みます

Claude Code / Codex の社内展開・チーム導入・セキュリティ設計まで、貴社の業務と組織に合わせて伴走支援します。

  • 100社以上の企業支援実績
  • 初回30分無料・即日返信
  • 導入後3ヶ月の伴走付き

お問い合わせフォームから24時間以内にUravation担当者がご返信します。

佐藤傑
この記事を書いた人 佐藤傑

株式会社Uravation 代表取締役CEO/生成AIエバンジェリスト。法人向けAI研修・コンサルティングを手がけ、日経・SBクリエイティブ・GMO等のメディアで生成AIについて執筆。

この記事をシェア

Claude Codeを本格的に使いこなしたい方へ

業務に合わせたマンツーマン指導で、Claude Codeを実務に組み込める状態まで伴走します。
現役エンジニアが貴方の業務に合わせてカリキュラムをカスタマイズ。

✓ 1対1のマンツーマン ✓ 業務に合わせた設計 ✓ 実務ベースの指導
Claude Code 個別指導の詳細を見る まずは無料相談

Contact お問い合わせ

生成AI研修や開発のご依頼、お見積りなど、
お気軽にご相談ください。

Claude Code 個別指導(1対1・12セッション)をご希望の方はこちらから別途お申し込みください

Claude Code 個別指導 無料相談