Claude Codeのインストール方法｜OS別手順とエラー別トラブル対処の完全版

Claude Codeのインストールは、うまくいけば1行のコマンドで30秒で終わる。この記事はその1行と、うまくいかなかったときの原因別対処、インストール後に最初にやるべき設定までをまとめた「詰まらないための網羅版」だ。

僕はClaude CodeでSaaSを1人開発していて、Mac・Windows(WSL)・クラウド環境それぞれでセットアップしてきた。手順は2026年8月時点の公式仕様で裏取りしている。古い解説記事(npm時代)との違いにも触れるので、過去に一度失敗した人も読み直してほしい。

インストール前に知っておくこと(3分)

先に前提を3つだけ。

1. インストールは無料。ただし利用にはPro以上が必要。公式ドキュメントに「Claude CodeにはPro、Max、Team、Enterprise、またはConsole(API)アカウントが必要で、無料のClaude.aiプランには含まれない」と明記されている。無料アカウントのままだと、インストールは通るが起動後のログインで弾かれる
2. 必要なのはターミナルとClaudeアカウントだけ。Node.jsやPythonの事前インストールは不要になった(ここが古い記事と違う)
3. 対応OS: macOS / Linux / Windows(ネイティブ・WSL両対応)。加えてWeb版(claude.ai/code)やVS Code / JetBrains拡張もあるので、実は「インストールせずに試す」選択肢もある

あわせて読みたい【2026年版】AI活用1人SaaS開発の完全ロードマップ｜5ステップで始める個人開発 →

OS別インストール手順(2026年8月版)

公式推奨はネイティブインストーラ。自分のOSの1行をターミナルに貼るだけだ。

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ではPowerShellとCMDでコマンドが違う。プロンプトの表示が `PS C:\` ならPowerShell、`C:\` だけならCMDだ。取り違えると後述のエラーになる。

またネイティブWindowsで使うならGit for Windowsを入れておくことを勧める。無いとClaude CodeがBashツールの代わりにPowerShellを使う動作になり、一部の作業で不便になる(WSL利用なら不要)。

パッケージマネージャ派向け

重要な違い: 既定で自動アップデートされるのはネイティブインストーラ版だけ。HomebrewやWinGetは手動更新(`brew upgrade claude-code` / `winget upgrade Anthropic.ClaudeCode`)が前提だ。ただし環境変数 `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1` を設定すれば、HomebrewとWinGetでもClaude Codeが自動でアップグレードを実行してくれる。Claude Codeは更新頻度が高いので、こだわりがなければネイティブインストーラを選ぶのが結局楽だ。

なおHomebrewの2つのcaskの違いは更新の速さだ。`claude-code` は安定チャンネルで約1週間遅れ、重大な不具合を含むリリースをスキップする。`claude-code@latest` は出た瞬間に最新が来る。

しんたろー：
僕は最初Homebrewで入れて、数週間後に「他の人が使えている新機能が自分には無い」状態になって気づいた。手動アップデート運用は絶対に忘れる。開発道具の中でもClaude Codeは進化が特に速く、1ヶ月古いだけで体験がだいぶ違う。素直にネイティブインストーラの自動更新に乗るのが正解だった。

インストールの確認と初回起動

入ったかどうかの確認:

claude --version

バージョン番号に続いて `(Claude Code)` と表示されれば成功だ(例: `2.1.211 (Claude Code)`)。

うまくいかないときのために、公式には診断コマンドが用意されている。

claude doctor

インストールの健全性、設定ファイルの検証エラー、警告と推奨される対処を、セッションを開始せずに読み取り専用で出力してくれる。トラブル時はまずこれを打つのが最短ルートだ。

そのまま初回起動まで進めよう。プロジェクトのフォルダに移動して:

cd あなたのプロジェクト
claude

初回はログインを求められる。画面の指示に従ってブラウザで認証すればいい(Claudeのサブスクアカウントのほか、Console=API課金アカウントでもログインできる)。認証情報は保存されるので、ログインは初回だけだ。アカウントを切り替えたくなったらセッション内で `/login` と打つ。

つまずき対処:エラー別の原因と解決

実際に人がハマるポイントを、エラーの見た目から逆引きできるようにした。

`The token '&&' is not a valid statement separator` と出る(Windows)

→ PowerShellにCMD用のコマンドを貼っている。PowerShell用(`irm ... | iex`)を使う。

`'irm' is not recognized as an internal or external command` と出る(Windows)

→ 逆パターン。CMDにPowerShell用コマンドを貼っている。CMD用を使うか、PowerShellを開き直す。

`syntax error near unexpected token '<'` や 403 エラーが出る

→ ネットワーク側の問題(プロキシ、社内ネットワークの制限など)であることが多い。公式のインストールのトラブルシューティングページにエラー別の対処と代替インストール方法がまとまっているので、エラーメッセージで照合する。

`claude: command not found` になる(インストールは成功したのに)

→ パスが通っていない。まずターミナルを開き直す。それでもダメなら、インストーラの出力に表示されたパスの案内を確認する。

昔npmで入れたものが残っていて挙動がおかしい

→ 複数インストールの共存が原因のことがある。`which claude`(Windowsは `where claude`)でどちらが呼ばれているか確認し、不要な方を削除する。ネイティブ版のアンインストールは `rm -f ~/.local/bin/claude` と `rm -rf ~/.local/share/claude`、npm版は `npm uninstall -g @anthropic-ai/claude-code` だ。

なおnpm版は今も公式サポートされている(Node.js 22以降が必要)。「npmは古い」わけではなく、自動更新が効く点でネイティブが推奨、という関係だ。

ログインできない・プランがないと言われる

→ 無料のClaude.aiプランでは使えない。Pro以上のサブスク、またはAPI従量課金のConsoleアカウントが必要。これが最も多い「インストールできたのに動かない」の正体だ。プラン選びは料金プラン完全ガイドへ。

社用PCで入れられない/動かない

→ 技術的な問題より先に、組織のAI利用ポリシーの確認を。企業利用ではAmazon BedrockやGoogle Cloud経由の構成もあり、その場合は管理者側のセットアップが前提になる。

Dev Container / Docker で使う場合

コンテナ内で開発している人向けの補足。Claude Codeはコンテナ内にも同じ手順でインストールできる。ただし2点だけ注意がいる。

• 認証情報の永続化: コンテナを作り直すたびにログインし直しになるので、認証情報を置く `~/.claude` をボリュームでマウントしておくと楽になる
• ネットワーク: Claude Codeはクラウドと通信するため、コンテナからインターネットに出られる必要がある。社内プロキシ環境では追加設定が要る場合がある

WSL上のDockerで使う場合は、WSL側にインストールするのが素直だ。

インストール後、最初の10分でやるべき設定

道具は入れて終わりではない。最初のセッションでやるべきことが3つある。

1. プロジェクトを理解させる — 「このプロジェクトは何をしている？」とまず聞く。ファイルの手動貼り付けは不要で、Claude Codeが自分で読む
2. 権限モードを把握する — 最初のセッションでは編集のたびに確認を求められる。2回目以降、Pro/Max/TeamプランではAutoモード(大半の操作は確認なし)が標準になる。`Shift+Tab` でいつでも切り替え可能。「どこまで自動で任せるか」の考え方は使い方完全ガイドで詳しく書いた
3. CLAUDE.mdを作る(慣れてきたら) — プロジェクト直下に置くと毎回読んでくれる指示書。書き方のコツは「事故りやすいポイントだけを書く」こと

この先の実践的な使い方・運用のコツ・失敗談はClaude Codeの使い方完全ガイドに、料金プランの選び方は料金プラン完全ガイドにまとめてある。

しんたろー：
インストールで一番伝えたいのは「ここで詰まって離脱するのが一番もったいない」ということ。Claude Codeの価値はインストールの先にしかないのに、PowerShellとCMDの取り違えみたいな些細な理由で「なんか動かなかった」で終わる人が実際に多い。エラーが出たら、エラーメッセージをそのままClaude(Web版)に貼って聞くのも手だ。道具の入口で、その道具の中身に助けてもらえばいい。

あわせて読みたい【2026年版】VRAM 8GBで動かすローカルLLM構築術10選｜1人SaaS開発者の実践記録 →

よくある質問

Node.jsやnpmは必要ですか？

ネイティブインストーラを使うなら不要です。依存の事前準備なしに1行で入ります。一方でnpm版も公式に現行サポートされており(Node.js 22以降が必要)、既にnpmで管理している環境ならそのままでも問題ありません。ネイティブを推奨する理由は「新しいから」ではなく、バックグラウンドで自動更新されるからです。

インストールは無料ですか？その後の料金は？

インストール作業自体は無料ですが、使うにはPro($17/月・年払い)以上のプラン、またはAPI従量課金のConsoleアカウントが必要です。無料のClaude.aiプランにClaude Codeは含まれません。プランの選び方と実際の運用コスト、無料で判断材料を得る方法は料金プラン完全ガイドに実測付きでまとめました。

WindowsはWSLとネイティブ、どちらで入れるべきですか？

すでにWSLで開発しているならWSL、そうでなければネイティブで問題ありません。ネイティブWindowsの場合はGit for Windowsを併せて入れるとBashツールが使えて快適です。迷ったら「普段コードを置いている場所」に合わせるのが正解です。プロジェクトファイルと同じ環境にClaude Codeが居るのが一番自然に動きます。

複数のPCで使えますか？

使えます。各マシンにインストールして同じアカウントでログインすれば、プラン(利用上限)はアカウント単位で共有されます。さらにWeb版(claude.ai/code)やデスクトップアプリもあるので、メインマシン以外では「インストールせずWeb版」という使い分けも現実的です。僕も外出先ではWeb版から同じプロジェクトを触っています。

アップデートはどうやりますか？

ネイティブインストーラ版なら何もしなくていい。バックグラウンドで自動更新されます。Homebrew版は `brew upgrade claude-code`、WinGet版は `winget upgrade Anthropic.ClaudeCode` を手動で実行する必要があります。更新の手間を考えると、特別な理由がない限りネイティブ版を推奨します。

オフラインでも使えますか？

使えません。Claude CodeのAI処理はクラウド側で動くため、インターネット接続が必須です。ネットワークが不安定な環境や、コードを外部に出せない要件がある場合は、ローカルで動くLLMという別の選択肢があります。用途は異なりますが、ローカルLLM環境の構築も選択肢として知っておくといいでしょう。

まとめ:1行実行して、最初の質問まで

手順を最短でまとめる。

1. 自分のOSのインストールコマンドを1行実行(推奨はネイティブインストーラ)
2. `claude --version` で確認
3. プロジェクトフォルダで `claude` → ブラウザでログイン
4. 最初の質問「このプロジェクトは何をしている？」を投げる

ここまで来たら、インストールの記事の役目は終わりだ。次は使い方完全ガイドで、最初の1時間の型と2年運用のコツを持っていってほしい。