# Claude Codeのインストール方法【2026年版】Mac・Windows・Linux完全ガイド

> Claude Codeは、ネイティブCLIインストーラーを使用して、macOS、Linux、Windowsに依存関係ゼロで2分以内にインストールできます。本ガイドでは、ネイティブ、Homebrew、WinGet、npm、Windows CMD、WSLの6つのインストール方法を網羅。Claudeプランの選び方、認証設定、CLAUDE.mdの構成、よくあるエラーの解決方法、ターミナルでのAIコーディング開始までを詳しく解説します。

- URL: https://blog.laozhang.ai/ja/posts/how-to-install-claude-code
- Published: 2026-03-16
- Updated: 2026-10-16
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ja/about)
- Topic: Claude Code
- Tags: Claude Code, インストールガイド, AIコーディングツール, 開発者ツール

---
Claude Codeは、Anthropic社が提供するターミナルベースのAIコーディングエージェントです。コードベースの読み取り、ファイルの編集、コマンドの実行、gitの管理をすべてコマンドラインから行えます。2026年10月時点で推奨されるインストール方法はネイティブCLIインストーラーで、外部依存関係がゼロ、バックグラウンドで自動更新が行われ、macOS、Linux、Windowsで動作します。初めてClaude Codeをセットアップする場合でも、以前のnpmベースのインストールから移行する場合でも、本ガイドでは2026年に利用可能なすべての方法を解説します。数時間ではなく数分でAIアシスタントとのコーディングを始められます。

## まとめ

Claude Codeは、すべての主要プラットフォームで1つのコマンドでインストールできます。完全なガイドを読む前に、以下の要点を確認してください。

- **macOS / Linux**: `curl -fsSL https://claude.ai/install.sh | bash`
- **Windows PowerShell**: `irm https://claude.ai/install.ps1 | iex`
- **要件**: macOS 13以上、Windows 10 1809以上、またはUbuntu 20.04以上。Claude Proサブスクリプション（月額20ドル）以上が必須で、無料プランにはClaude Codeへのアクセスが含まれません。
- **6つの方法**: ネイティブインストーラー（推奨）、Homebrew、WinGet、npm（公式ドキュメントでは高度なインストールオプション）、Windows CMD、WSL。ネイティブインストーラーはバックグラウンドで自動更新され、npmのグローバルインストールもグローバルフォルダーに書き込める限り自動更新されます。HomebrewとWinGetは既定では手動更新です。
- **初回起動**: ターミナルで`claude`を実行し、ブラウザで認証すれば準備完了です。

コマンドだけが必要な場合は、お使いのプラットフォーム用のコマンドをコピーして、[認証と初回起動](#認証と初回起動)セクションに進んでください。各方法の違いを理解したい方、Windowsの特殊なケースに対応したい方、適切なClaudeプランを選びたい方は、このまま読み進めてください。

## Claude Codeインストール前の準備


インストールコマンドを実行する前に、2つのことを確認する必要があります。お使いのオペレーティングシステムが最小要件を満たしていること、そして適切な種類のAnthropicアカウントを持っていることです。この手順を省略することが、インストールに失敗して時間を無駄にする最大の原因です。

### システム要件

Claude Codeは3つの主要プラットフォームをサポートしていますが、バージョン要件はほとんどのCLIツールよりも厳しくなっています。古いOSバージョンで実行すると、インストールや認証中にサイレントエラーが発生するため、まずバージョンを確認してください。

macOSでは、バージョン13.0（Ventura）以降が必要です。Apple SiliconとIntelマシンの両方がネイティブインストーラーでサポートされています。バージョンが不明な場合は、Appleメニューをクリックして「このMacについて」を選択してください。Xcode互換のセットアップを使用しているほとんどの開発者はこの要件をすでに満たしていますが、macOS Monterey以前を実行している古いMacBookハードウェアを使用している方は注意が必要です。macOSに付属するターミナルアプリで問題なく動作します。iTerm2やサードパーティのターミナルは不要ですが、それらでも問題なく動作します。

Windowsでは、バージョン10ビルド1809以降が必要で、これにはWindows 10 October 2018 Update以降のすべてのバージョン（Windows 11を含む）が該当します。2026年10月時点の公式ドキュメントでは、ネイティブWindowsでのGit for Windowsは任意です。入っていなければClaude CodeはPowerShellツールでシェルコマンドを実行し、入れるとBashツール用にGit Bashを使います。インストールに管理者権限は不要です。Bashベースのスクリプトやツールを扱う場合は、[git-scm.com](https://git-scm.com/downloads/win)からGit for Windowsをダウンロードし、セットアップで「Add to PATH」を選び、インストール後にターミナルを再起動してください。Windows Server 2019以降もCI/CDユースケースでサポートされています。

Linuxでは、公式の要件としてUbuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降が挙げられています（2026年10月時点）。それ以外のディストリビューションは公式の一覧に載っていません。ただしFedoraとRHEL向けには公式のdnfリポジトリが用意されています。Alpineなどmusl系では、`bash`、`curl`、`libgcc`、`libstdc++`、`ripgrep`を入れ、`USE_BUILTIN_RIPGREP=0`を設定する必要があります。インストーラーはアーキテクチャ（x86_64またはARM64）を自動的に検出するため、追加の設定は不要です。WindowsマシンのWSL内でLinuxを実行している場合、Linuxのインストール方法がそのまま使えます。詳しくは以下のWindowsセクションで説明します。

すべてのプラットフォームで、少なくとも4GBのRAMと、初回ダウンロードおよび認証のための安定したインターネット接続が必要です。インストールされるバイナリは1バージョンあたり約250MBです（2.1.301のnpm配布パッケージの展開サイズで、macOS Apple Silicon版が約251MB、Linux x64版が約268MB）。

### 適切なアカウントの選択

ここで多くの開発者が予想外の壁にぶつかります。Claude Codeは無料のClaude.aiプランでは利用できません。Claude Codeを認証して使用するには、以下のいずれかのアカウントタイプが必要です。

| アカウントタイプ | 月額料金 | 最適な用途 | Claude Codeアクセス |
|-------------|-------------|----------|-------------------|
| Claude Pro | 月額20ドル（年払い17ドル） | 個人開発者 | あり — Sonnet 4.6 |
| Claude Max 5x | 月額100ドル | 毎日ヘビーに使用 | あり — Opus 4.6 + 5倍の制限 |
| Claude Max 20x | 月額200ドル | パワーユーザー、チーム | あり — Opus 4.6 + 20倍の制限 |
| Teams Standard | 月額25ドル/シート | 小規模チーム | あり — シートごとにPro相当 |
| Anthropic Console | 従量課金 | API優先 / CI/CD | あり — APIキー経由 |

初めてClaude Codeを試す場合、月額20ドルのProプランが最も合理的な出発点です。ターミナルでのClaude CodeとWebインターフェースの両方にアクセスでき、集中的なコーディングセッション中にレート制限に達した場合は、後からMaxにアップグレードできます。複数の開発者間でClaude Codeを評価しているチームには、Teamsプランが一元化された請求と管理コントロールを提供します。Anthropic Consoleオプションは、CI/CDパイプラインでのみClaude Codeを使用する予定がある場合や、月額サブスクリプションよりもトークン単位の課金を好む場合に最適です。Consoleアカウントで初めてログインすると、コスト追跡用の「Claude Code」ワークスペースが自動的に作成されます。

## macOSとLinuxへのClaude Codeインストール

macOSとLinuxでのインストールは、両プラットフォームが同じインストーラースクリプトを共有しているため、簡単です。ネイティブインストーラーは、お使いのプラットフォームとアーキテクチャに固有の静的コンパイルバイナリをダウンロードします。Node.jsは不要で、Node.jsやnvmとのバージョン競合もなく、更新はバックグラウンドで自動的に行われます。2.1.112以前のnpm版はNode.js上でJavaScript版を動かしていましたが、2.1.113（2026年4月17日）以降はnpmでインストールしても同じネイティブバイナリが入り、`claude`は実行時にNode.jsを使いません。

### ネイティブインストーラー（推奨）

ターミナルを開き、1つのコマンドを実行します。

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

このスクリプトはClaude Codeバイナリをダウンロードし、`~/.local/bin/claude`（実体は`~/.local/share/claude/versions/`内）に配置して、`claude`コマンドとして使えるようにします。`~/.local/bin`がPATHに入っていない場合、インストーラーは出力の`Setup notes:`でその旨と修正コマンドを表示しますが、PATH自体は変更しません。適切なインターネット接続があれば、プロセス全体が約30秒で完了します。インストール後、新しいターミナルウィンドウを開くか（またはmacOSでは`source ~/.zshrc`、Linuxでは`source ~/.bashrc`を実行して）、シェルが新しいPATHエントリを認識するようにしてください。

ネイティブインストーラーの最大の利点は自動更新です。Claude Codeは起動時と実行中に定期的に新しいバージョンをチェックし、バックグラウンドでダウンロードとインストールを済ませ、次回の起動から新しいバージョンに切り替わります。インストーラーを再実行したり、更新を確認することを覚えておく必要はありません。新しく公開されたモデルを使うには新しいClaude Codeが必要になることがあるため、これは特に重要です。既定の`latest`チャネルでは新しいリリースをすぐに受け取り、`/config`の自動更新チャネルで`stable`に切り替えると、通常1週間ほど前の版で大きな不具合のあったリリースを飛ばした更新になります。すぐに更新したいときは`claude update`を実行します。

スクリプトをbashに直接パイプすることにセキュリティ上の懸念がある場合は、スクリプトを先にダウンロードして確認してから手動で実行できます。これは完全に有効なアプローチです。

```bash
curl -fsSL https://claude.ai/install.sh -o install-claude.sh
less install-claude.sh  # スクリプトを確認
bash install-claude.sh
```

### Homebrewでの代替方法

Homebrewでツールを管理することを好む開発者向けに、Claude Codeはcaskとして利用可能です。

```bash
brew install --cask claude-code
```

この方法はmacOSとLinux（Linuxbrew経由）の両方で動作します。トレードオフとして、Homebrewインストールは既定では自動更新されません。新機能やセキュリティ修正を取得するには、定期的に`brew upgrade claude-code`を実行する必要があります。環境変数`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`を`1`にすると、新しいバージョンが出たときにClaude Codeがこの更新コマンドをバックグラウンドで実行します。なお`claude-code` caskはstableチャネル（通常1週間ほど前の版）を追います。最新版を追いたい場合は`claude-code@latest` caskを入れ、更新も`brew upgrade claude-code@latest`で行います。すでにHomebrewですべてを管理しているほとんどの開発者にとっては、使い慣れたパッケージマネージャーを使い続ける便利さが、手動更新の手間を上回ります。

インストール済みのバージョンを確認するには：

```bash
claude --version
```

後で更新するには：

```bash
brew upgrade claude-code
```

HomebrewインストールはClaude Codeを、Apple Silicon Macでは`/opt/homebrew/bin/`に、Intel Macでは`/usr/local/bin/`に配置します。後で自動更新のためにネイティブインストーラーに切り替える場合は、まずHomebrew版を`brew uninstall --cask claude-code`でアンインストールして、異なる場所に2つのバイナリが存在してどちらが実行されているか混乱するのを避けてください。

### インストールの確認

どの方法を選んだかに関わらず、以下を実行してClaude Codeにアクセスできることを確認してください。

```bash
which claude
claude --version
```

`which claude`がパスを返し、`claude --version`が`2.1.301 (Claude Code)`のようなバージョン番号を表示すれば、インストールは完了です。ネイティブインストーラーの場合、macOSとLinuxでは`~/.local/bin/claude`が返ります。「command not found」が表示される場合は、以下のトラブルシューティングセクションを確認してください。

## WindowsへのClaude Codeインストール

![Windowsインストールの判断フロー：Claude CodeセットアップのネイティブPowerShell、WinGet、WSLパス](https://blog.laozhang.ai/posts/ja/how-to-install-claude-code/img/windows-decision.webp)

Windowsでのインストールは、macOSやLinuxよりも1つ多い判断が必要です。Claude CodeをWindows上でネイティブに実行するか、WSL（Windows Subsystem for Linux）内で実行するかを選択する必要があります。正しい選択は開発ワークフローによって異なり、間違った選択はフラストレーションにつながります。判断基準を説明してから、各パスを詳しく見ていきましょう。

主にWindowsをターゲットとするコードを書いている場合（.NETアプリケーション、PowerShellスクリプト、Windows固有のツールチェーン）は、ネイティブPowerShellインストーラーを使用してください。Windows上で直接実行され、既存のPATHと統合され、必須の前提条件はありません（Git for Windowsは任意）。主にLinuxデプロイ向けのコードを書いている場合（Node.jsサーバー、Pythonバックエンド、Dockerコンテナ）は、WSLを使用すると、Claude CodeがmacOSやLinuxの環境と同じように動作する本格的なLinux環境が得られます。迷った場合は、ネイティブインストーラーから始めてください。WSLは後からいつでも追加できます。

### ネイティブPowerShellインストーラー（ほとんどのユーザーに推奨）

Git for Windowsは任意です。入っていなければClaude CodeはシェルコマンドをPowerShellツールで実行し、入っていればBashツールにGit Bashを使います。Bashベースのスクリプトを扱う予定があるなら、PowerShellで`git --version`を実行し、バージョン番号が表示されなければ[git-scm.com](https://git-scm.com/downloads/win)からGitをダウンロードしてインストールし（セットアップで「Add to PATH」を選択）、PowerShellを再起動してください。インストーラーを管理者として実行する必要はありません。

準備ができたら、PowerShell（CMDではなく）でインストーラーを実行します。

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

これにより、ネイティブバイナリがダウンロードされてインストールされ、`claude`コマンドがグローバルに利用可能になります。インストール後、PATHが更新されるように新しいPowerShellウィンドウを開いてください。macOS/Linuxのネイティブインストーラーと同様に、このバージョンはバックグラウンドで自動更新されます。

### WinGetでの代替方法

WinGet（Windows 11および新しいWindows 10ビルドに付属するWindowsパッケージマネージャー）を使用している場合、Claude Codeは公式リポジトリから利用可能です。

```powershell
winget install Anthropic.ClaudeCode
```

これはPowerShellインストーラーと機能的に同等ですが、Windowsパッケージ管理システムを使用します。WinGetインストールは既定では自動更新されないため、定期的に`winget upgrade Anthropic.ClaudeCode`を実行する必要があります（Homebrewと同じく`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1`で自動実行にできますが、Claude Codeの実行中はWindowsが実行ファイルをロックするため失敗することがあり、その場合は手動コマンドが表示されます）。組織がWindowsパッケージマネージャーポリシーでソフトウェアを管理している場合、WinGetは良い選択です。

### Windows CMDインストーラー

PowerShellが制限されている環境では、CMD互換のインストーラーも用意されています。

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

これはあまり一般的ではありませんが、PowerShellの実行ポリシーが厳しい企業環境で便利です。

**WSLパス**（Linux優先の開発者向け）

Windows上で完全なLinux開発環境を使用したい場合は、まずWSLをインストールしてから、その中で標準のLinuxインストール方法を使用してください。

```powershell
# ステップ1: WSLをインストール（管理者としてPowerShellで実行）
wsl --install

# ステップ2: プロンプトが表示されたらコンピュータを再起動

# ステップ3: WSLターミナルを開く（デフォルトはUbuntu）
# ステップ4: Linuxの方法でClaude Codeをインストール
curl -fsSL https://claude.ai/install.sh | bash
```

WSLを使用する際のよくある間違いは、Windows側にNode.jsがインストールされていてもWSL環境内にはインストールされていないことです。WSL経由でnpmインストール方法を使用する場合、WSL内にNode.js 22以上がインストールされている必要があります。WSLは既定でWindowsのPATHも取り込むため、WSL内にNode.jsがないとWindows側のnpmやNode.jsが使われ、プラットフォームの不一致や`exec: node: not found`の原因になります。`which npm`と`which node`の結果が`/mnt/c/`で始まっていればWindows側のものなので、LinuxのパッケージマネージャーかnvmでWSL内にNode.jsを入れてください。ネイティブインストーラーはNode.jsへの依存関係がないため、この問題を完全に回避できます。

WSLのパフォーマンスを最適化するには、プロジェクトファイルをWindowsファイルシステム（例：`/mnt/c/Users/...`）ではなく、WSLファイルシステム（例：`~/projects/`）内に配置してください。WSL/Windows境界を越えたファイル操作は大幅に遅くなり、Claude Codeでタイムアウトが発生する可能性があります。

## npmからネイティブインストーラーへの移行

以前`npm install -g @anthropic-ai/claude-code`でClaude Codeをインストールした場合、ネイティブインストーラーへの移行は必須ではなく任意です。2026年10月時点の公式セットアップドキュメントは、npmを「高度なインストールオプション」として引き続き掲載しており、非推奨とは書いていません。推奨はネイティブインストーラーのままです。2026年1月21日の2.1.15ではnpmインストール向けの非推奨通知が追加されましたが、2.1.301のバイナリ（macOS Apple Silicon版）にはその通知文は含まれていません。移行すると、インストールを1つに揃えられ、Node.jsが不要になり、更新もnpmのグローバルフォルダーの書き込み権限に左右されずに自動で行われます。

npmを使い続ける場合は、インストールに使うNode.jsを22以上にしてください。nvmやasdfで切り替えている場合も、npmを実行するときのバージョンが基準です。古いNode.jsではnpmが`EBADENGINE`警告を出しますが、インストールは完了し、`claude`も動きます。更新は`npm install -g @anthropic-ai/claude-code@latest`で行い、`npm update -g`は使わないでください。最初のインストール時のバージョン範囲に従うため、最新版に上がらないことがあります。

移行プロセスは約2分で完了し、既存の設定は保持されます。

```bash
# ステップ1: PATH上にあるclaudeをすべて表示
which -a claude
# node_modulesまたは.npm-global内のパスが返された場合、npmを使用しています
npm -g ls @anthropic-ai/claude-code

# ステップ2: npm版をアンインストール
npm uninstall -g @anthropic-ai/claude-code
# 古いバージョンが作ったローカルnpmインストールが残っていれば削除
rm -rf ~/.claude/local

# ステップ3: 削除を確認
which -a claude  # 何も表示されないか、"not found"が返されるはずです

# ステップ4: ネイティブ版をインストール
curl -fsSL https://claude.ai/install.sh | bash  # macOS/Linux
# または
irm https://claude.ai/install.ps1 | iex  # Windows PowerShell

# ステップ5: 新しいターミナルを開いて確認
claude --version
```

認証トークンと設定ファイル（`~/.claude/`に保存）はこの移行時に保持されます。再認証や再設定は不要です。ネイティブバイナリがnpmバージョンの続きをそのまま引き継ぎます。

`which -a claude`で2つ以上のパスが表示される場合は、使う1つだけを残し、残りを削除してください（Homebrewなら`brew uninstall --cask claude-code`、WinGetなら`winget uninstall Anthropic.ClaudeCode`、Windowsでの確認は`where.exe claude`）。古いnpmのコピーがPATHに残っていると、`Error: Cannot find module './yoga.wasm'`が出ることがあります。原因と消し方は[Claude Code「Cannot find module yoga.wasm」の対処法](https://blog.laozhang.ai/ja/posts/claude-code-cannot-find-module-yoga-wasm)を参照してください。

nvmやasdfでNode.jsのバージョンを管理していた場合、ネイティブインストーラーに移ればClaude CodeとNode.jsの関係はなくなります。npm方式でも、2.1.113以降はNode.jsが関わるのはインストールのときだけです。2.1.112以前のnpm版はNode.js上で動くJavaScript版だったため、Node.jsのバージョンがClaude Code自体の動作に関わっていました。

起動の速さも、npm版がNode.jsランタイムを毎回初期化していた2.1.112以前の話です。2.1.113以降はnpmでもネイティブインストーラーと同じバイナリが入るため、起動の仕組みはどちらの方法でも同じです。

チーム全体でClaude Codeを管理している場合も、現在はローカルのNode.jsのバージョン差でClaude Codeの動作が変わることはありません。違いが出るのはインストールと更新の経路で、npmではNode.js 22以上と書き込み可能なグローバルフォルダーが必要です。チームでインストール方法を1つに揃え、各自が`which -a claude`でコピーが1つだけであることを確かめると、バージョンの食い違いを防げます。組織全体のリリースチャネルは、管理者向けのmanaged settingsで固定できます。

## 認証と初回起動

Claude Codeをインストールしたら、次のステップは認証です。任意のプロジェクトディレクトリに移動して実行します。

```bash
cd /path/to/your/project
claude
```

初回起動時に、Claude CodeはデフォルトのウェブブラウザでAnthropicのOAuthページを開きます。Claude Pro、Max、またはTeamsアカウントでログインし、CLIを承認すると、ブラウザが成功を確認するためにリダイレクトします。セッショントークンは`~/.claude/`にローカルに保存されるため、この操作は1回だけで済みます。

### 認証方法

Claude Codeは3つの認証経路をサポートしており、それぞれ異なるユースケースに適しています。

**ブラウザOAuth**がデフォルトで、ほとんどの開発者に適しています。初めて`claude`を実行すると、自動的にブラウザが開きます。Claude ProまたはMaxを使用している場合、これが最もシンプルな方法です。サブスクリプションがすべての課金を処理し、プランティアに関連付けられた使用量制限が適用されます。

**APIキー認証**は、ヘッドレス環境（CI/CDパイプライン、Dockerコンテナ、ブラウザのないリモートサーバー）向けに設計されています。Claude Codeを起動する前に`ANTHROPIC_API_KEY`環境変数を設定してください。

```bash
export ANTHROPIC_API_KEY=sk-ant-...
claude
```

APIキーを使用すると、課金はAnthropic Consoleアカウントを通じてトークン単位で行われます。

**サードパーティクラウドプロバイダー**（Amazon Bedrock、Google Vertex AI、Microsoft Foundry）は、環境変数を通じてサポートされています。

```bash
# Amazon Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id
```

これらのオプションは、既存のクラウドプロバイダー契約を持ち、AIトラフィックを既存のインフラストラクチャ経由でルーティングすることを好む企業が主に使用します。

### CLAUDE.mdでプロジェクトを初期化

認証後、最も効果的な単一のアクションは、プロジェクトルートに`CLAUDE.md`ファイルを作成することです。このMarkdownファイルは、Claudeにコードベースに関する永続的なコンテキストを提供します。ビルドコマンド、コード規約、アーキテクチャの決定、テスト手順など、Claudeがコードだけでは推測できないあらゆる情報を含めます。これがないと、Claudeはプロジェクト固有のパターンを理解せずに毎回セッションを開始します。

スターター`CLAUDE.md`を自動生成します。

```bash
# Claude Codeセッション内で実行:
/init
```

このコマンドはコードベースを分析し、検出されたビルドシステム、テストフレームワーク、コードパターンを含む`CLAUDE.md`を作成します。良い`CLAUDE.md`は簡潔で、50〜100行を目安にしてください。各行について「これを削除するとClaudeが間違いを犯すか？」と自問してください。そうでなければ削除しましょう。モノレポの場合は、サブディレクトリに追加の`CLAUDE.md`ファイルを配置してください。Claudeはそれらを階層的に読み込みます。ルートレベルのルールはすべての場所に適用され、子レベルのルールはそのディレクトリで作業しているときのみ適用されます。

`/init`コマンドは、権限制御や優先テキストフォーマットなどの重要なClaude Code機能の設定も案内します。約1分で完了し、Claudeがコードを扱う精度に測定可能な差をもたらします。

以下は、典型的なNext.jsプロジェクトにおける構造化された`CLAUDE.md`の例です。

```markdown
# CLAUDE.md

## Commands
- `npm run dev` - ポート3000で開発サーバーを起動
- `npm run build` - 本番ビルド
- `npm test` - Jestテストを実行
- `npm run lint` - ESLintチェック

## Architecture
- Next.js 15 with App Router
- PostgreSQL with Drizzle ORM
- Authentication via Clerk
- All API routes in src/app/api/

## Conventions
- Server components by default; use "use client" only when needed
- TypeScript strict mode; no any types
- Commit messages: imperative mood, < 72 chars
```

重要なポイントは、`CLAUDE.md`にはClaudeがコードを直接読んで理解できないことを記述すべきだということです。ビルドコマンド、命名規約、アーキテクチャの決定は、明確なガイダンスがないとClaudeが最も間違えやすい決定であるため、含める最も価値のある情報です。

## よくあるインストール問題のトラブルシューティング

インストールや初回起動で問題が起きても、多くはPATH、権限、重複インストールのどれかで、数分で解決できます。まずは組み込みの診断コマンドを実行してください。

```bash
claude doctor
```

何か問題を感じたらこのコマンドを実行してください。セッションを開始せずに、インストールの状態、設定ファイルの検証エラー、修正案付きの警告を表示します。最新の自動更新が成功したかどうかもここで確認できます。以下は、最も一般的な問題とその解決策です。

### 「command not found: claude」

これはインストール後に最も頻繁に発生するエラーで、シェルが新しいPATHエントリをまだ認識していないことを意味します。修正方法はプラットフォームによって異なります。

macOSとLinuxでは、新しいターミナルウィンドウを開いてください。それでも解決しない場合は、シェル設定を手動でリロードしてください。

```bash
source ~/.zshrc   # macOS（Catalina以降はZshがデフォルト）
source ~/.bashrc  # Linux（ほとんどのディストリビューション）
```

コマンドがまだ見つからない場合は、ネイティブ版の実体が`~/.local/bin/claude`にあるか、そのフォルダーがPATHに入っているかを確認してください。インストーラーはPATHが足りないときに出力の`Setup notes:`で知らせて修正コマンドを表示しますが、PATH自体は変更しません。

```bash
ls -la ~/.local/bin/claude
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
# 2行目で何も表示されなければPATHに追加（Zshの場合。Linuxのbashは~/.bashrc）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

Windowsでは、PowerShellを完全に閉じて再度開いてください。コマンドがまだ見つからない場合は、`where.exe claude`でPATH上にあるか、`Test-Path "$env:USERPROFILE\.local\bin\claude.exe"`でネイティブ版の実体があるかを確認します。実体があるのに見つからない場合は、`%USERPROFILE%\.local\bin`がPATHに入っていません。

### EACCESパーミッションエラー（npmメソッドのみ）

npmインストール方法を選択してEACCESパーミッションエラーが発生した場合、絶対に`sudo npm install -g`を使用しないでください。sudoをnpmで実行すると、npmディレクトリにroot所有のファイルが作成され、今後のすべてのnpmグローバルインストールでパーミッション問題が連鎖的に発生します。代わりに、根本的なパーミッション問題を修正してください。

```bash
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code
```

すでに入っているnpm版を入れ直す・更新するときは、`npm install -g @anthropic-ai/claude-code@latest`を使ってください。

さらに良い方法は、この種の問題を完全に回避できるネイティブインストーラーに切り替えることです。公式のトラブルシューティングも、npm固有の権限エラーに対しては`curl -fsSL https://claude.ai/install.sh | bash`でのネイティブインストーラーへの切り替えを挙げています。2.1.301では、npmのグローバルフォルダーに書き込めず自動更新できない場合、起動時に一度だけ通知が出て、`claude doctor`が3つの対処を示します。`claude install`でネイティブインストーラーに切り替える（sudo不要）、nvmなどsudoの要らないnpmで入れ直す、`npm config set prefix ~/.npm-global`を設定して`~/.npm-global/bin`をPATHに追加してから入れ直す、のいずれかです。

### 認証の失敗

OAuth中にブラウザリダイレクトが機能しない場合：

1. 開いたブラウザで[claude.ai](https://claude.ai)にログインしていることを確認
2. アカウントが有料プラン（Pro、Max、Teams、またはEnterprise）であることを確認
3. ログアウトしてから再度ログインしてみる：`claude auth logout`に続いて`claude auth login`（セッション内なら`/logout`）。`claude logout`というトップレベルのコマンドはありません
4. プロキシ設定のある企業ネットワークでは、`HTTPS_PROXY`環境変数の設定が必要な場合があります

ブラウザが利用できないCI環境では、上記の認証セクションで説明したAPIキー認証に切り替えてください。

**Windows固有の問題**

2026年10月時点ではGit for Windowsは任意で、入っていなくてもインストールは失敗しません。起動時に`Claude Code on Windows requires either Git for Windows (for bash) or PowerShell`と表示される場合は、Git BashもPowerShellも見つからなかったという意味です。PowerShellがPATHにないなら、既定の場所`C:\Windows\System32\WindowsPowerShell\v1.0\`をPATHに追加するか、PowerShell 7（`pwsh`）をインストールします。Git Bashを使いたいなら、Git for Windowsをインストールし（セットアップで「Add to PATH」を選択）、ターミナルを再起動してください。Gitが入っているのに見つからない場合は、`where.exe git`で場所を調べ、そのインストールの`bin\bash.exe`のパスをsettings.jsonの`env`で`CLAUDE_CODE_GIT_BASH_PATH`に指定します。

PowerShellで実行ポリシーエラーが表示される場合は、スクリプト実行を一時的に許可する必要があるかもしれません。

```powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
```

WSLユーザーでファイル操作が遅い場合は、プロジェクトファイルをWindowsファイルシステム（`/mnt/c/...`）からWSLファイルシステム（`~/projects/`）に移動してください。WSL経由のクロスファイルシステムアクセスは大幅な遅延を追加し、Claude Codeの頻繁なファイル読み取りで複合的に影響します。

**ネットワークとプロキシの問題**

プロキシサーバーを持つ企業ネットワークは、インストールスクリプトやOAuth認証フローをブロックすることがあります。インストール中に`curl`がタイムアウトする場合は、インストーラーを実行する前にプロキシ設定を構成してください。

```bash
export HTTPS_PROXY=http://proxy.yourcompany.com:8080
export HTTP_PROXY=http://proxy.yourcompany.com:8080
curl -fsSL https://claude.ai/install.sh | bash
```

プロキシ背後で認証が失敗する場合も、同じ環境変数で通常解決できます。一部の企業ファイアウォールはWebSocket接続を特にブロックしますが、Claude Codeはリアルタイム通信にこれを使用しています。この場合、IT部門に`claude.ai`と`api.anthropic.com`ドメインのホワイトリスト登録を依頼してください。

**インストール後のパフォーマンス低下**

Claude Codeは起動するが応答が遅い場合、最も一般的な原因はコンテキストウィンドウの過負荷です。セッション内で`/compact`を実行すると、会話履歴が圧縮されてコンテキストスペースが解放されます。非常に大きなコードベースのプロジェクトでは、`.claudeignore`ファイル（`.gitignore`に似たもの）を作成することで、`node_modules`、`dist`、大きなバイナリアセットフォルダなど、作業に関連のないディレクトリのスキャンを防げます。

## 最適なClaude Codeプランの選び方

![Claude Codeプラン比較：Pro、Max 5x、Max 20x、APIオプションの料金と機能](https://blog.laozhang.ai/posts/ja/how-to-install-claude-code/img/plan-comparison.webp)

適切なプランを選ぶことで、過剰な出費とフラストレーションのたまるレート制限の両方を防げます。決定は、Claude Codeをどれくらい頻繁に使用するかと、最も強力なモデルが必要かどうかに帰結します。

**月額20ドルのClaude Pro**は、ほとんどの個人開発者の出発点です。ターミナルとWebインターフェースでClaude Sonnet 4.6にアクセスでき、使用量はローリング5時間ウィンドウで測定されます。コードレビュー、バグ修正、小さな機能のために1日に数回Claude Codeを使用する開発者にはProで十分です。コミュニティの推定によると、Proユーザーは通常、週に40〜80 Sonnet時間を利用でき、適度な日常使用を快適にカバーします。

**月額100ドルのClaude Max**（5xティア）は、Pro で定期的にレート制限に達する場合に有意義です。これは通常、1日を通してClaude Codeをアクティブなペアプログラマーとして使い続ける開発者に当てはまります。5x倍率は週に約140〜280 Sonnet時間に相当し、ラインナップで最も強力なモデルであるClaude Opus 4.6へのアクセスも得られます。Proで週に1〜2回以上レート制限リセットを待つことがある場合、Max 5xへのアップグレードは通常、回復した生産性で元が取れます。

**月額200ドルのClaude Max**（20xティア）は、複数のプロジェクトにまたがってClaude Codeを同時に実行するパワーユーザーやリーダー向けです。週に約240〜480 Sonnet時間で、レート制限に達することはほぼありません。このティアは、大規模リファクタリング、自動テスト、継続的コードレビューワークフローにClaude Codeを広範に使用する開発者にも人気があります。

**Anthropic Console**（従量課金API）は、使用が散発的な場合や、主にCI/CDパイプラインでClaude Codeを実行する場合に最適な選択です。月額サブスクリプションの代わりに、クレジットをロードしてトークン消費ごとに支払います。Claude Sonnet 4.6の現在の価格は、入力100万トークンあたり3.00ドル、出力100万トークンあたり15.00ドルです（Anthropic Console、2026年3月）。このオプションはAPI集約サービスとの組み合わせで特にうまく機能します。1つのClaude Codeコマンドは通常8〜12のAPI呼び出しを生成するため、ヘビーなセッションでもAPI コストは0.50〜2.00ドル程度で、たまにしか使わない場合はサブスクリプションよりも大幅に安くなります。

チームでClaude Codeを評価する場合、シート月額25ドル（年払い20ドル）のTeams Standardプランが一元管理付きのProレベルアクセスを提供します。チームがアップグレードを決定した場合、シート月額125ドル（年払い100ドル）のTeams Premiumプランは、Maxに匹敵する5倍の使用量制限を追加します。レート制限を効果的に管理する方法の詳細については、[Claude Codeのレート制限に関する詳細ガイド](https://blog.laozhang.ai/ja/posts/claude-code-rate-limit-reached)をご覧ください。

## インストール方法の一覧比較

Claude Codeには6つの異なるインストール方法があるため、それらを並べて比較すると便利です。以下の表は、お使いの環境に適した方法を選べるよう、主な違いをまとめています。

| 方法 | プラットフォーム | コマンド | 自動更新 | 依存関係 | 最適な用途 |
|--------|---------|---------|-------------|-------------|---------|
| ネイティブCLI | macOS、Linux、WSL | `curl -fsSL https://claude.ai/install.sh \| bash` | あり | なし | ほとんどのユーザー |
| ネイティブPowerShell | Windows | `irm https://claude.ai/install.ps1 \| iex` | あり | なし（Git for Windowsは任意） | Windowsユーザー |
| Homebrew | macOS、Linux | `brew install --cask claude-code` | なし（既定） | Homebrew | Homebrewユーザー |
| WinGet | Windows | `winget install Anthropic.ClaudeCode` | なし（既定） | WinGet | Windowsパッケージ管理 |
| npm | 全プラットフォーム | `npm install -g @anthropic-ai/claude-code` | あり（グローバルフォルダーに書き込める場合） | Node.js 22以上（インストール時のみ） | npmでツールを管理したい場合 |
| WSL | Windows | WSL内でLinuxインストーラー | あり（Linux経由） | WSL2 | Linux優先の開発者 |

ネイティブインストーラーは、大多数のユーザーに推奨される方法です。依存関係がゼロで、サイレントに自動更新され、最も安定した体験を提供します。HomebrewとWinGetは、パッケージマネージャーでツールを管理することを好み、手動更新を気にしない場合の堅実な代替手段です。npm方式は2026年10月時点の公式ドキュメントに高度なインストールオプションとして引き続き掲載されており、2.1.113以降はネイティブインストーラーと同じバイナリが入ります。インストール時にNode.js 22以上が必要で（古いNode.jsでは`EBADENGINE`警告が出るだけでインストールは完了します）、更新は`npm install -g @anthropic-ai/claude-code@latest`で行います。特定のバージョンに固定したい場合は、ネイティブインストーラーでもバージョン番号を指定してインストールできます。

**よくある質問**

**Claude CodeにはNode.jsが必要ですか？** いいえ。ネイティブインストーラー、Homebrew、WinGetではNode.jsは不要です。npm方式だけはインストール時にNode.js 22以上が必要ですが（古いNode.jsでは`EBADENGINE`警告が出るだけでインストールは完了します）、入ったバイナリは実行時にNode.jsを使いません。

**Apple SiliconでClaude Codeを使用できますか？** はい。ネイティブインストーラーはアーキテクチャを自動検出し、Apple Silicon Mac用のARM64バイナリをダウンロードします。

**Claude Codeを完全にアンインストールするには？** インストール方法ごとに削除します。ネイティブ版はmacOS・Linux・WSLで`rm -f ~/.local/bin/claude`と`rm -rf ~/.local/share/claude`を実行し、Windowsでは`%USERPROFILE%\.local\bin\claude.exe`と`%USERPROFILE%\.local\share\claude`を削除します。Homebrewは`brew uninstall --cask claude-code`（`claude-code@latest`を入れた場合はその名前）、WinGetは`winget uninstall Anthropic.ClaudeCode`、npmは`npm uninstall -g @anthropic-ai/claude-code`です。`claude uninstall`というコマンドはありません。設定と履歴まで消したい場合だけ、別の手順として`rm -rf ~/.claude`と`rm ~/.claude.json`を実行します。設定、許可したツール、MCPサーバーの設定、セッション履歴がすべて消え、VS Code拡張機能やデスクトップアプリが残っているとこのディレクトリは再作成されます。

**サブスクリプションなしでClaude Codeを使用できますか？** 標準のインストールでは使用できません。有料のClaudeサブスクリプション（Pro、Max、Teams、Enterprise）またはAPIクレジット付きのAnthropic Consoleアカウントが必要です。Claude Code自体に無料ティアはありませんが、Consoleオプションでは使用分だけ支払うことができます。

**Claude CodeはVS Codeで動作しますか？** はい。Claude Codeは、このガイドで説明しているターミナルCLIに加えて、VS Code拡張機能とJetBrainsプラグインとして利用可能です。ここで説明したインストール方法でコアCLIがセットアップされ、IDE拡張機能はそれを基に構築されます。VS Codeマーケットプレイスで「Claude Code」を検索してインストールをクリックするだけです。インストールしたばかりの同じCLIバイナリに接続されます。

**Claude Codeにデスクトップアプリはありますか？** はい。Anthropicはターミナル機能とともにグラフィカルインターフェースを提供するClaude Codeデスクトップアプリをリリースしました。ログイン後にclaude.aiからダウンロードできます。デスクトップアプリとターミナルCLIは同じ認証と設定を共有するため、一方をインストールすれば両方にアクセスできます。

## まとめと次のステップ

2026年のClaude Codeのインストールは、わずか1年前と比べて驚くほどシンプルになりました。ネイティブインストーラーがインストールの頭痛の大部分を引き起こしていたNode.jsの依存関係を排除し、WinGetとCMDインストーラーの追加によりWindowsユーザーに適切なファーストクラスのサポートが提供されました。ワンラインのネイティブインストーラー、Homebrew、WinGetのいずれを選んだ場合でも、難しい部分は終わりました。

Claude Codeがマシンで動作するようになったら、最も価値のある次のステップを紹介します。まず、Claude Code内で`/init`を実行してプロジェクトの`CLAUDE.md`を生成してください。この1つのステップで、コードベースに関する永続的なコンテキストを提供することにより、Claudeの応答品質が大幅に向上します。次に、`/help`と入力して組み込みのスラッシュコマンドを探索してください。コードレビュー、コミット生成、テスト作成などの一般的なワークフローのショートカットが見つかります。第三に、MCP（Model Context Protocol）サーバーの接続を検討してください。これにより、Claude Codeにツールやデータソースへの直接アクセスを提供し、コーディングアシスタントから本格的な開発エージェントに変換できます。GranolaやRimo Voiceなどの議事録ツールをつなぐ場合は、[Claude Codeに議事録ツールをMCPで接続する方法](https://blog.laozhang.ai/ja/posts/connect-claude-code-to-note-taker)でツールごとの経路を確認できます。

Claude Codeを他のAIコーディングツールと比較検討している場合、[Claude CodeとOpenClawの比較](https://blog.laozhang.ai/ja/posts/openclaw-vs-claude-code)で、各ツールの長所、短所、理想的なユースケースを詳しく解説しています。すでにClaude Codeを使用していて使用量制限に達している開発者には、[Claude Codeのレート制限管理ガイド](https://blog.laozhang.ai/ja/posts/claude-code-rate-limit-reached)で、利用可能なクォータを最大化する実践的な戦略を紹介しています。

どのAIコーディングツールがどのワークフローに適しているかという幅広い視点については、[APIプロバイダーを通じたAIツールの接続](https://blog.laozhang.ai/ja/posts/openclaw-api-guide)で、Claude Codeと併用できる柔軟なマルチモデルアクセスの設定方法を解説しています。

AI支援コーディングの未来はここにあり、ターミナルで動作します。良いコーディングを。

## 参考資料

本文で参照している外部ページを、登場順に並べています。最終更新日：2026-10-16。

- [git-scm.com](https://git-scm.com/downloads/win) (git-scm.com)
- [claude.ai](https://claude.ai/) (claude.ai)