💻 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が必須だがインストールされていない
対処法:
- gitforwindows.orgからGit for Windowsをインストール
- または
winget install Git.Gitでインストール - ターミナルを完全に閉じて開き直す
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 git | Git for Windowsをインストール |
| インストーラーが実行できない | curl --version (Mac) / PowerShellバージョン確認 | curlをインストール、またはPowerShellを更新 |
| PATHを確認したい | echo $PATH (Mac) / $env:PATH (Win) | インストール先パスが含まれているか確認 |
まとめ
- ネイティブインストーラーを使うのが最も簡単(Node.js不要)
- Claude Codeは1つのコマンドでインストール可能
- インストール後は
claude --versionで動作確認 - エラーが出たら、まずターミナルの再起動を試す
- 権限エラーは管理者権限での実行またはHomebrew/wingetで対処
やってみよう
以下の手順でインストールを完了させましょう。
- Windowsの場合: Git for Windowsをインストール
- 自分のOSに合ったネイティブインストーラーを実行
claude --versionでインストール成功を確認
エラーが出たら、上のトラブルシューティングを参照してください。どうしても解決しない場合は、エラーメッセージ全文をコピーして検索すると解決策が見つかることが多いです。