Claude Code インストールチュートリアル：macOS、Linux、Windows、WSL

Anthropic は現在ネイティブインストーラーを推奨しています。これは Claude Code をユーザーディレクトリにインストールし、管理者権限での実行を要求せず、対応するプラットフォームではバックグラウンド更新を担います。Homebrew、WinGet、Linux のパッケージマネージャーは、すでにソフトウェア管理プロセスが統一されているチームに適していますが、通常は自身でアップグレードを行う必要があります。

コマンドを実行する前にターミナルの種類を確認してください：macOS、Linux、WSL は Bash コマンドを使用します。Windows PowerShell は irm を使用します。PowerShell と CMD は構文が異なるため、インストールコマンドを混用しないでください。

インストールコマンドの終了は、PATH、設定ファイル、更新チャネルがすべて正常であることを意味しません。まず現在の端末で shell の設定を再読み込みし、その後バージョンチェックと読み取り専用診断をそれぞれ実行してください。

claude doctor はインストールの健全性、設定ファイルの解析、更新状態をチェックします。繰り返し再インストールするよりも、PATH や設定エラーの切り分けに適しています。

Claude Code は起動ディレクトリを現在の作業スコープとして扱います。実際のプロジェクトディレクトリに入ってから claude を実行してください。初回利用時は認証フローに入り、認証完了後に読み取り専用の質問を送信してプロジェクトを読み取れることを確認します。

無関係なリポジトリが多数含まれる親ディレクトリで起動しないでください。作業スコープが明確であるほど、ファイル探索が集中し、その後の権限判断も容易になります。

Claude Code は Windows 上でネイティブに実行することも、WSL 上で実行することもできます。ネイティブな Windows は Windows ツールチェーンに適しています。WSL 2 は Linux ツールチェーンにより適しており、Claude Code の Bash サンドボックスもサポートします。

ネイティブの Windows で Git for Windows がインストールされていない場合、Claude Code は PowerShell ツールを使用します。インストール後は Git Bash を使用できます。プロジェクトのファイルがある場所に CLI をインストールして起動することで、ファイルシステムをまたぐことで生じるパスやパフォーマンスの問題を回避できます。

ネイティブインストールは既定でバックグラウンド更新されます。チームが安定性を重視する場合は、設定で stable チャネルを選択できます。新機能を即座に取得したい場合は latest を使用します。Homebrew と WinGet のインストールは、既定でそれぞれのパッケージマネージャーによってアップグレードされます。

チュートリアルや自動化スクリプトの中で、未検証の新しいパラメーターに依存しないでください。アップグレード後はまず claude --version と claude doctor を実行し、その後によく使うワークフローを検証してください。

コマンドが存在しない場合は、まず PATH と実際にヒットする実行ファイルを確認してください。403、HTML がスクリプトや TLS エラーとして扱われている場合は、ダウンロード経路の問題です。npm、Homebrew、WinGet とネイティブインストーラーを立て続けに切り替えると、同名のバイナリが複数残りやすくなります。

現在のインストール方法を記録した上で、1つのチャネルだけで修正を進めてください。インストール完了後に認証とプロジェクト設定に進み、ネットワークのダウンロード問題をアカウントやモデルの問題と誤判断しないようにしてください。