Claude Code のインストール手順【macOS / Windows / Linux 完全対応】
Claude Code を macOS / Windows / Linux にインストールする完全手順。Homebrew・curl・npm・WSL すべて網羅し、認証・初期設定・トラブルシュートも実例付きで解説します。
Claude Code のインストールは、macOS なら brew install anthropic/claude/claude の1コマンド、Windows は WSL2 経由で5分、Linux は curl ワンライナーで完了します。本記事では3つのOSすべてに対応した手順を、認証・初期設定・トラブルシューティングまで実機検証付きで解説します。
非エンジニアでも30分以内に最初の claude コマンドが動く状態を目指せる構成です。
週1ニュースレター(無料)に登録すると、Claude Code のアップデートと実装テンプレが毎週木曜に届きます。
1. インストール前の準備
Claude Code を動かすには以下が必要です。
- OS: macOS 13+ / Windows 11 (or WSL2) / Ubuntu 22.04+
- Node.js: 20.x 以降(npm 経由でインストールする場合)
- Anthropic アカウント: claude.ai で作成済み(Pro / Max いずれかのプラン推奨)
ターミナル操作が初めての方は 非エンジニアのためのターミナル超入門 も参照してください。
2. macOS — Homebrew が最速
brew install anthropic/claude/claude
claude --version
claude --version で Claude Code 1.x.x が表示されればOKです。
代替手段(curl 直接):
curl -fsSL https://claude.ai/install.sh | sh
3. Windows — WSL2 推奨
Claude Code は WSL2(Ubuntu 22.04)での動作が公式推奨です。
# PowerShell から WSL を有効化
wsl --install Ubuntu-22.04
# WSL に入ってから
sudo apt update && sudo apt install -y curl
curl -fsSL https://claude.ai/install.sh | sh
ネイティブ Windows でも winget install Anthropic.Claude で動作しますが、Bash ツールが弱いため WSL2 を強く推奨します。
4. Linux (Ubuntu / Debian)
curl -fsSL https://claude.ai/install.sh | sh
systemd 配下のサーバーで自律エージェントとして動かす場合はClaude Code 自律運転設定も参照してください。
5. 初回認証
claude auth login
ブラウザが開き、Anthropic アカウントでログイン → トークンが ~/.config/claude/credentials.json に保存されます。
API キー直接利用の場合:
export ANTHROPIC_API_KEY=sk-ant-xxx
.zshrc / .bashrc に追記して永続化します。
6. 初期設定 — .claude/settings.json
プロジェクトディレクトリで以下を実行すると、.claude/ が生成されます。
cd ~/your-project
claude init
.claude/settings.json で hooks やツール権限を制御できます。詳細は Claude Code Hooks 完全ガイド を参照。
7. 動作確認
claude -p "このプロジェクトの README を要約して"
数秒で要約が返れば成功です。
8. トラブルシューティング
Q: claude: command not found
A: PATH に /opt/homebrew/bin(macOS)または ~/.local/bin を通してください。
Q: 認証が通らない
A: claude auth logout → claude auth login で再認証。VPN がブロックする場合があるので、一時的に無効化を試してみてください。
Q: WSL でファイル権限エラー
A: WSL の /mnt/c/ を避け、Linux ホームディレクトリ配下にプロジェクトを置く運用を推奨します。
9. 次のステップ
インストールが完了したら、以下の3記事で実装パターンを身につけるのが最短ルートです。
最新のアップデートや実装事例は 週1ニュースレター(無料)で毎週木曜に配信しています。インストール後に詰まりやすいポイントも先回りで紹介しているので、登録しておくと安心です。
Related
続けて読む
- ·10分
Claude Code 使い方 完全ガイド|非エンジニアが30分で始める手順
Claude Codeの使い方を非エンジニア向けに解説。インストール・初期設定・最初の自動化までを30分で完了するステップを実機検証付きで紹介します。
- ·11分
Claude Code Hooks 完全ガイド|自動化と品質ゲートを仕込む方法
Claude Code Hooks(PreToolUse / PostToolUse / Stop)の使い方を解説。コスト管理・品質チェック・自動フォーマットを仕込んで運用品質を担保する実装パターンを紹介します。
- ·12分
Claude Code × GitHub 完全ガイド|PRレビュー・CI/CDを自動化する手順
Claude Code と GitHub を連携してPRレビュー・Issue対応・CI/CDを自動化する方法を解説。GitHub App / Actions / MCP の3つの統合パターンを実装サンプル付きで紹介します。
