Claude Codeのインストール手順 Mac・Windows別の方法とエラー対処【2026年最新】

ターミナルに指示を出すだけでコードが書かれ、テストが走る。Claude Codeを試したい担当者は増えていますが、最初のインストールで止まってしまうという声も多く聞きます。総務省の令和7年版情報通信白書によれば、国内企業の55.2%が何らかの業務で生成AIを利用しており、開発領域での導入検討も進んでいます。

つまずきの原因の多くは、情報が古いことにあります。以前はnpm経由が基本でしたが、現在の公式手順ではコマンド1行で完了するネイティブインストーラーが推奨されています。この記事では、公式ドキュメントにもとづいてOS別の手順、初回ログイン、よくあるエラーの対処までを順に解説します。

出典：総務省「令和7年版 情報通信白書」企業におけるAI利用の現状

確認したいポイント	結論	詳細
インストール前に何が必要？	有料プランと対応OS環境	無料プランではClaude Codeを使えません。macOS 13以上などの要件を先に確認します。
どの方法でインストールする？	公式推奨はネイティブインストーラー	コマンド1行で完了し、バックグラウンドで自動更新されます。npmは必須ではありません。
Macでの手順は？	curlコマンド1行で完了	ターミナルに1行貼り付けるだけです。LinuxとWSLも同じコマンドが使えます。
Windowsでの手順は？	PowerShellかCMDで実行	画面の表示でどちらにいるか判別できます。WSLを使う選択肢もあります。
他の入れ方もある？	Homebrew・WinGet・npmなど	パッケージ管理に載せたい場合の選択肢です。自動更新の扱いが異なります。
インストール後は何をする？	claudeで起動してログイン	ブラウザで認証すれば完了です。以降は認証情報が保存されます。
エラーが出たときは？	claude doctorで状態を確認	コマンドが見つからない場合はPATH、権限エラーの場合はsudoを使わない対処が基本です。

この記事でわかること

• npmが必須ではなくなり、コマンド1行で導入できるようになった現在の手順
• macOS・Windows・Linux・WSLそれぞれの具体的なインストール方法
• インストール方法ごとに異なる自動更新の扱い
• コマンドが見つからない、権限エラーが出るといった典型的な失敗への対処
• 組織でまとめて導入するときにバージョンをそろえる仕組み

【ご相談】AIコーディングの社内導入をご支援しますネクストスケールは、法人向けAI研修とシステム開発の両輪で、生成AIを実務に組み込む支援を行っています。インストールは入口にすぎず、どの工程に組み込むかの設計が成果を分けます。愛媛・東京を拠点に、開発体制に合わせた導入計画をご提案します。 ▶ 無料相談・お問い合わせはこちら（株式会社ネクストスケール）

インストール前に確認すること

作業を始める前に、3点だけ確認しておくと後戻りを防げます。特にアカウントの条件は、コマンドを実行してから気づくと手戻りになります。

システム要件

・OS：macOS 13.0以上、Windows 10 1809以上またはWindows Server 2019以上、Ubuntu 20.04以上、Debian 10以上、Alpine Linux 3.19以上

・ハードウェア：RAM 4GB以上、x64またはARM64のプロセッサ

・シェル：Bash、Zsh、PowerShell、CMDのいずれか

・ネットワーク：インターネット接続が必要

・地域：Anthropicのサポート対象国であること

古いmacOSやWindowsでは動きません。手元の環境が該当するかを先に確かめてください。要件を満たさない場合、インストール自体は通ってもその後の動作で問題が出ます。

有料プランまたはConsoleアカウントが必要

Claude Codeは無料のClaude.aiプランには含まれていません。利用するには、Pro、Max、Team、Enterpriseのいずれかの契約か、開発者向けのConsoleアカウントが必要です。Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryといったクラウド経由でも使えます。

プランごとの費用と、最も安く始める方法については

▶ Claude Codeは無料で使える？料金プランと最安で始める方法で整理しています。

ターミナル版とデスクトップ版

Claude Codeはターミナルだけのものではありません。デスクトップアプリ、VS CodeやJetBrainsの拡張、Web版、Slack、CI/CDと、複数の入口が用意されています。ターミナルに慣れていないのであれば、デスクトップアプリから始めるという選択肢もあります。

この記事では、最も広く使われているターミナル版の手順を中心に解説します。デスクトップ版はインストーラーをダウンロードして実行するだけで、特別な準備は要りません。

インストール方法は複数ある

選択肢が複数あるため、どれを選ぶかで迷いやすい部分です。自動更新の扱いが方法ごとに違うという点だけ押さえておけば、判断できます。

方法	対応環境	自動更新	選ぶ場面
ネイティブインストーラー	macOS・Linux・WSL・Windows	される	特に理由がなければこれ
Homebrew	macOS・Linux	されない	Homebrewで統一管理したい
WinGet	Windows	されない	Windowsの標準的な管理に載せたい
npm	各プラットフォーム	条件つき	npmの依存解決に載せたい
apt・dnf・apk	Debian・Fedora・Alpineなど	されない	Linuxの通常の更新に組み込みたい

公式が推奨するのはネイティブインストーラー

公式ドキュメントで最初に示されるのがこの方法です。コマンド1行で完了し、インストール後はバックグラウンドで自動的に最新版に更新されます。更新を意識しなくてよいという点が、実務では大きな利点になります。

手順の全体像は、Claude Code Docs「クイックスタート」で公開されています。

npmは必須ではなくなった

以前の記事を参照すると、npmでのグローバルインストールが基本手順として紹介されていることがあります。現在も選択肢として残っていますが、必須ではありません。この誤解が、Node.jsの準備でつまずく原因になっています。

補足すると、npmパッケージはv2.1.198以降、Node.js 22以上を必要とします。「Node.js 18以上」と書かれた情報は古いものです。加えて、npmが配置するのはスタンドアロン版と同じネイティブバイナリで、インストールされたclaudeコマンド自体はNodeを呼び出しません。Node.jsは配布経路として使われているだけです。

macOS・Linux・WSLでの手順

この3つの環境は同じコマンドで導入できます。ターミナルを開いて、次の1行を貼り付けて実行してください。

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

処理が終わったら、シェルを開き直すか再読み込みします。続けて、正しく入ったかを確認します。

claude –version

claude doctor

バージョン番号が表示されれば成功です。claude doctorは、インストールと設定の状態をまとめて点検してくれるコマンドなので、最初に一度実行しておくと安心できます。

コマンドが見つからないとき

インストール直後にcommand not foundと出る場合、原因のほとんどはPATHが通っていないことです。macOSとLinuxでは、実行ファイルはユーザーのホーム配下に配置されます。シェルの設定ファイルを読み直すか、パスを追加してください。

source ~/.zshrc    # bashの場合は ~/.bashrc

~/.local/bin/claude –version    # 絶対パスで確認

絶対パスで動くのであれば、インストール自体は成功しています。設定ファイルにパスを追加して読み直せば解決します。

Ubuntu・WSLでの下準備

新しいUbuntuやDebianの環境では、curlが入っていないことがあります。インストールコマンドが動かない場合は、先にcurlと証明書を入れてください。

sudo apt update

sudo apt install -y curl ca-certificates

WSLで使う場合は、PowerShellやCMDからではなく、WSLのターミナルの中でインストールと起動を行います。Windows側とWSL側の両方に入れてしまうと、どちらが動いているのか分からなくなります。

【ご相談】環境構築でつまずいている方へOSやシェルの違い、既存のNode環境との衝突、社内ネットワークの制限。導入の初期段階でつまずく原因は環境ごとに異なります。ここで時間を溶かすのはもったいない部分です。セットアップの支援から、社内標準の環境づくりまでご相談いただけます。 ▶ 環境構築について相談する（株式会社ネクストスケール）

Windowsでの手順

Windowsでは、使っているのがPowerShellかCMDかによってコマンドが変わります。ここが最初のつまずきどころです。

PowerShellとCMDの見分け方

判別は画面の表示で行えます。プロンプトがPSで始まっていればPowerShell、PSが付かずドライブ名から始まっていればCMDです。それぞれのコマンドは次のとおりです。

# PowerShell の場合

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

# CMD の場合

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

エラーメッセージからも判別できます。「&&は有効なステートメント区切り記号ではありません」と出たらPowerShellにいます。「irmは内部コマンドまたは外部コマンドとして認識されていません」と出たらCMDにいます。管理者として実行する必要はありません。

ネイティブWindowsかWSLか

Windowsでは、そのまま動かす方法とWSLの中で動かす方法があります。扱うプロジェクトがWindows向けであればネイティブ、Linuxのツールチェーンを使うならWSLという判断になります。

方式	必要なもの	サンドボックス	向いている場面
ネイティブWindows	特になし（Git for Windowsは任意）	非対応	Windows向けのプロジェクト
WSL 2	WSL 2の有効化	対応	Linuxのツールを使う場合
WSL 1	WSL 1の有効化	非対応	WSL 2が使えない環境

Git for Windowsの役割

ネイティブWindowsで使う場合、Git for Windowsの導入は任意です。入れておくとGit Bashが利用でき、Bashを使ったコマンド実行が有効になります。入っていない場合は、PowerShellを経由してコマンドが実行されます。

普段Gitを使う開発であれば、あわせて入れておくほうが扱いやすくなります。WSLで使う構成であれば、Git for Windowsは不要です。

その他のインストール方法

既存のパッケージ管理の仕組みに載せたい場合は、次の方法も選べます。いずれも自動更新の扱いが異なる点に注意してください。

HomebrewとWinGet

# macOS / Linux（Homebrew）

brew install –cask claude-code

# Windows（WinGet）

winget install Anthropic.ClaudeCode

Homebrewには2つのcaskがあります。claude-codeは安定版のチャネルを追い、通常1週間ほど遅れて大きな不具合を含むリリースを飛ばします。claude-code@latestは最新版をそのまま受け取ります。どちらも自動更新はされないため、定期的にアップグレードのコマンドを実行してください。

WinGetも同様に手動更新が前提です。更新はwinget upgrade Anthropic.ClaudeCodeで行います。

npmでのインストール

npm install -g @anthropic-ai/claude-code

npmの依存解決に載せたい場合の選択肢です。前述のとおりNode.js 22以上が必要になります。更新するときはnpm update -gではなく、パッケージ名に@latestを付けて入れ直してください。前者は元のバージョン範囲を尊重するため、最新版に移らないことがあります。

sudoを付けてグローバルインストールする操作は避けてください。権限の問題とセキュリティ上のリスクにつながります。権限エラーが出る場合は、ユーザーが書き込めるディレクトリを使うようnpmを設定するのが正しい対処です。

Linuxのパッケージマネージャー

Debian系ではapt、Fedora系ではdnf、Alpineではapkのリポジトリが公開されています。いずれも署名付きで、安定版と最新版の2つのチャネルを選べます。システムの通常の更新作業に組み込みたい場合に適しています。

この方法もClaude Code側からの自動更新は行われません。更新は各パッケージマネージャーのアップグレード操作で行います。

初回ログインと最初のセッション

インストールが終われば、あとは起動して認証するだけです。作業したいプロジェクトのフォルダで実行してください。

cd /path/to/your/project

claude

初回はログインを求められます。ブラウザが開くので、案内に沿って認証を完了させてください。一度ログインすれば認証情報が保存され、次回以降は求められません。後からアカウントを切り替える場合は、セッション内で/loginと入力します。

対応するアカウントの種類

• Claude Pro、Max、Team、Enterpriseの各プラン（推奨）
• Claude Console（プリペイドクレジットによるAPIアクセス）
• Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundry
• 組織が運用する自己ホスト型のゲートウェイ経由での企業SSO

Consoleで初めてログインすると、費用の追跡をまとめるためのワークスペースが自動的に作成されます。組織で使う場合、どのアカウント種別で統一するかは先に決めておいてください。

最初に試すコマンド

起動すると、バージョン、使用中のモデル、作業ディレクトリが表示されます。まずは手を動かさず、プロジェクトについて質問してみるのが取り組みやすい入口です。「このプロジェクトは何をするもの？」と日本語で聞けば、ファイルを読んで概要を返します。

Claude Codeはファイルを変更する前に必ず許可を求めます。いきなり書き換えられる心配はありません。慣れてきたら、簡単な関数の追加やテストの作成といった実作業を任せてみてください。使いこなしの考え方は

▶ AIエージェントとは？従来の生成AIとの違いと業務での使いどころも参考になります。

覚えておくと便利なのが、/helpでコマンド一覧を表示する、/clearで会話履歴を消す、/exitで終了するという3つです。ターミナルからはclaude -cで直前の会話を続けられます。

【ご相談】使いこなせる状態まで伴走します導入しても、指示の出し方や任せるタスクの選び方が掴めなければ稼働率は上がりません。プロンプトの型づくりから確認手順の整備まで、社内で回せる状態になるまでご支援します。研修と実務での伴走を組み合わせた進め方もご提案できます。 ▶ 社内展開について相談する（株式会社ネクストスケール）

よくあるエラーと対処

つまずきの典型はいくつかに絞られます。原因と対処を対応づけておけば、大半は自力で解決できます。

症状	考えられる原因	対処
command not found	PATHが通っていない	シェル設定を読み直すかパスを追加する
権限エラー（EACCES）	npmのグローバル領域に書けない	sudoを使わず書き込み可能な場所を設定する
&&が使えない	PowerShellでCMD用のコマンドを実行	PowerShell用のコマンドに切り替える
irmが認識されない	CMDでPowerShell用のコマンドを実行	CMD用のコマンドに切り替える
curlでエラーや403	ネットワークやプロキシの制限	社内ネットワークの設定を確認する
検索が動かない	ripgrepが見つからない	配布物に含まれるが、環境により個別対応

まずclaude doctorを実行する

原因が特定できないときは、このコマンドが役立ちます。インストールの状態、設定、最新の更新結果をまとめて確認できます。エラーの相談をする前に、この出力を取っておくと解決が早くなります。

claude doctor

インストールが重複しているケース

以前に別の方法で入れた形跡が残っていると、意図しないバージョンが起動することがあります。アンインストールしたはずなのにclaudeが動く場合は、2つ目のインストールか、古いシェルのエイリアスが残っている可能性を疑ってください。

社内ネットワークでの制限

企業の環境では、プロキシやファイアウォールがインストールを妨げることがあります。curlの実行段階で失敗する場合は、ネットワーク側の設定を情報システム部門と確認する必要があります。この確認を含めた社内での扱い方は

▶ 社内の生成AI利用ルールを整備する手順で整理しています。

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

導入して終わりではなく、更新の扱いを理解しておくと運用が安定します。方法ごとに挙動が違う点が要注意です。

自動更新の仕組み

ネイティブインストーラーで入れた場合、起動時と実行中に定期的に更新が確認され、バックグラウンドでダウンロードとインストールが行われます。次に起動したときから新しいバージョンが有効になります。すぐに反映したい場合は手動で更新できます。

claude update

Homebrew、WinGet、Linuxのパッケージマネージャーで入れた場合は、この自動更新は働きません。それぞれのアップグレード操作を定期的に行ってください。

リリースチャネルの選択

更新の受け取り方は2つから選べます。latestは新機能をリリース直後に受け取る設定、stableは通常1週間ほど前のバージョンを使い、大きな不具合を含むリリースを飛ばす設定です。設定ファイルまたは/configから切り替えられます。

業務で安定性を優先するならstableが無難です。組織全体で統一したい場合は、管理者向けの設定で一律に適用することもできます。

アンインストールの手順

削除はインストール方法ごとに分かれます。ネイティブ版であれば、実行ファイルとバージョン管理用のディレクトリを消します。Homebrewやnpmで入れた場合は、それぞれのアンインストール操作を行います。

# ネイティブ版（macOS / Linux / WSL）

rm -f ~/.local/bin/claude

rm -rf ~/.local/share/claude

設定やセッション履歴まで消す場合は、ホーム配下の設定ディレクトリも削除します。ただし、VS Code拡張やデスクトップアプリが残っていると同じ場所が再作成されます。完全に消したい場合は、それらを先にアンインストールしてください。

詳細な手順は、Claude Code Docs「高度なセットアップ」に記載があります。

【ご相談】開発体制ごとAIで再設計しませんか研修による底上げ、内製化の支援、受託開発との併走まで一貫して対応しています。社内にエンジニアがいない場合でも、外部と組み合わせながら進める形をご提案できます。現状の課題整理からご一緒しますので、検討段階でもお気軽にどうぞ。 ▶ 開発体制の相談をする（株式会社ネクストスケール）

組織でまとめて導入するときの論点

個人が1台に入れるのと、社内の複数人に展開するのとでは、考えるべきことが変わります。事前に決めておく項目を挙げます。

バージョンをそろえる仕組み

自動更新は便利ですが、メンバーごとにバージョンが違うと、動作の違いが問い合わせの原因になります。管理者向けの設定を使えば、リリースチャネルや最低バージョンを組織全体で統一できます。

配布経路も統一しておくと管理が楽になります。macOSはHomebrew、WindowsはWinGetというように標準の入れ方を決め、手順書として共有してください。

権限と教育をセットで整える

インストール手順を配るだけでは定着しません。どのリポジトリで使ってよいか、入力してはいけない情報は何か、生成された変更を誰が承認するか。この3点を決めて初めて、業務での運用が成立します。

並行して必要になるのが、使いこなすための教育です。導入したものの稼働していないという状態を避けるには、最初の数週間の伴走が効きます。研修の設計例は

▶ 法人向けAI研修の内容とカリキュラム例で紹介しています。

社内の人員だけで立ち上げが難しい場合は、外部の開発リソースと組み合わせる進め方もあります。最初の構築を委ね、運用と改善を内製に移す形であれば、立ち上がりの速度と将来の自走を両立できます。判断の材料は

▶ AI受託開発とは？依頼できることと費用相場が参考になります。

効果の測り方についても先に決めておいてください。使った時間ではなく、完了した作業の量で見るほうが判断しやすくなります。測定の考え方は

▶ 生成AIによる業務効率化の進め方と改善事例で整理しています。

まとめ

Claude Codeのインストールは、現在の公式手順ではコマンド1行で完了します。macOS、Linux、WSLは共通のcurlコマンド、WindowsはPowerShellかCMDかで使うコマンドが分かれます。npmは必須ではなく、Node.jsの準備でつまずく必要はありません。

導入前に確認すべきは、対応OSのバージョンと、Pro以上の有料プランまたはConsoleアカウントを持っているかという2点です。無料プランにはClaude Codeが含まれていないため、ここを見落とすと手戻りになります。

つまずいたときは、まずclaude doctorで状態を確認してください。コマンドが見つからないならPATH、権限エラーならsudoを使わない対処が基本になります。インストールが済んだら、プロジェクトのフォルダでclaudeと打ち、「このプロジェクトは何をするもの？」と聞くところから始めてみてください。

【ご相談】AI活用の第一歩を、専門チームと一緒に「何から着手すべきか分からない」という段階で問題ありません。現状をうかがったうえで、優先度の高いところから具体的な進め方をご提示します。AI研修、システム開発、Webマーケティングまでワンストップで対応しています。 ▶ まずは無料でご相談ください（株式会社ネクストスケール）