💻 Claude Code入門 | 📖 15分

インストール手順(Windows/Mac)

Claude Codeのインストール完全ガイド

このレッスンでは、Windows、Mac、LinuxそれぞれのOS別に、Claude Codeのインストールから起動確認まで、ステップバイステップで解説します。トラブルシューティングも網羅しています。

Windows でのインストール

前提条件: Git for Windows

Windows環境ではGit for Windowsが必須です。未インストールの場合は先にインストールしてください。

# winget でインストール(推奨)
winget install Git.Git

# または git-scm.com から公式インストーラーをダウンロード

Step 1: Claude Code のインストール(ネイティブインストーラー)

方法A: PowerShellコマンド(推奨)

# PowerShellで実行
irm https://claude.ai/install.ps1 | iex

方法B: winget を使う方法

winget install Anthropic.ClaudeCode

インストールには1〜3分程度かかります。完了するとプロンプトに戻ります。

Step 2: インストール確認

PowerShell を新しく開いて(スタートメニューで「PowerShell」と検索)以下を実行:

claude --version
# バージョン番号が表示されれば成功!

Mac でのインストール

Step 1: Claude Code のインストール(ネイティブインストーラー)

方法A: curlコマンド(推奨)

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

方法B: Homebrew を使う方法

# Homebrewがまだなら先にインストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

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

Step 2: インストール確認

ターミナル.app を新しく開いて(⌘+Space → 「ターミナル」と入力)以下を実行:

# インストール確認
claude --version
# バージョン番号が表示されれば成功!

Linux でのインストール

ネイティブインストーラー(全ディストリビューション共通)

# curlコマンドで実行
curl -fsSL https://claude.ai/install.sh | bash

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

トラブルシューティング完全ガイド

エラー: claude が認識されない / command not found: claude

原因:Claude CodeのインストールパスがPATHに登録されていない

対処法(Windows):

# PowerShell でPATHを確認
$env:PATH -split ";"

# ターミナルを再起動して再試行
# それでもダメな場合は再インストール
irm https://claude.ai/install.ps1 | iex

# または winget を使用
winget install Anthropic.ClaudeCode

対処法(Mac/Linux):

# ターミナルを再起動して再試行

# PATHを確認
echo $PATH

# 再インストール
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew を使う場合
brew install --cask claude-code

エラー: 権限エラー(Permission denied)

原因:インストール先ディレクトリに書き込み権限がない

# Mac/Linux: sudo を付けてインストーラーを実行
curl -fsSL https://claude.ai/install.sh | sudo bash

# Windows: PowerShellを管理者として実行してから
irm https://claude.ai/install.ps1 | iex

# Mac で Homebrew を使う場合(権限問題が起きにくい)
brew install --cask claude-code

エラー: Git for Windowsが見つからない(Windows環境)

原因:Windows環境ではGit for Windowsが必須だがインストールされていない

対処法:

  1. gitforwindows.orgからGit for Windowsをインストール
  2. または winget install Git.Git でインストール
  3. ターミナルを完全に閉じて開き直す
  4. git --version が動くか確認

エラー: 実行ポリシーの制限(Windows PowerShell)

症状: claude コマンドが「このシステムではスクリプトの実行が無効になっています」と表示される

# PowerShell を管理者権限で開いて実行
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

# 確認メッセージで Y を入力

エラー: ネットワークタイムアウト / プロキシエラー

原因:企業ネットワークのプロキシやファイアウォール

# 環境変数でプロキシを設定(Mac/Linux)
export HTTPS_PROXY=http://プロキシアドレス:ポート
export HTTP_PROXY=http://プロキシアドレス:ポート

# Windows PowerShellの場合
$env:HTTPS_PROXY="http://プロキシアドレス:ポート"
$env:HTTP_PROXY="http://プロキシアドレス:ポート"

# 永続化する場合(Mac/Linux: ~/.bashrc or ~/.zshrc に追加)
echo 'export HTTPS_PROXY=http://プロキシアドレス:ポート' >> ~/.zshrc
source ~/.zshrc

エラー: OSバージョンが古い

症状: インストーラー実行時にOS互換性エラーが表示される

# macOSのバージョン確認(13 Ventura以上が必要)
sw_vers

# Windowsのバージョン確認(Windows 10以上が必要)
winver

# macOSのアップデート
# 「システム設定」→「一般」→「ソフトウェアアップデート」

# Windowsのアップデート
# 「設定」→「Windows Update」→「更新プログラムのチェック」

PATHトラブルシューティング早見表

症状確認コマンド対処法
claudeが見つからないwhich claude (Mac) / where claude (Win)ターミナルを再起動。解決しない場合は再インストール
gitが見つからない(Windows)where gitGit for Windowsをインストール
インストーラーが実行できないcurl --version (Mac) / PowerShellバージョン確認curlをインストール、またはPowerShellを更新
PATHを確認したいecho $PATH (Mac) / $env:PATH (Win)インストール先パスが含まれているか確認

まとめ

  • ネイティブインストーラーを使うのが最も簡単(Node.js不要)
  • Claude Codeは1つのコマンドでインストール可能
  • インストール後は claude --version で動作確認
  • エラーが出たら、まずターミナルの再起動を試す
  • 権限エラーは管理者権限での実行またはHomebrew/wingetで対処

やってみよう

以下の手順でインストールを完了させましょう。

  1. Windowsの場合: Git for Windowsをインストール
  2. 自分のOSに合ったネイティブインストーラーを実行
  3. claude --version でインストール成功を確認

エラーが出たら、上のトラブルシューティングを参照してください。どうしても解決しない場合は、エラーメッセージ全文をコピーして検索すると解決策が見つかることが多いです。