Claude Code のインストール手順【macOS / Windows / Linux 完全対応】
Claude Code を macOS / Windows / Linux にインストールする完全手順。Homebrew・curl・npm・WSL すべて網羅し、認証・初期設定・トラブルシュートも実例付きで解説します。
Claude Code のインストールは、Node.js 18 以上が入っていれば npm install -g @anthropic-ai/claude-code の1コマンドで完了します(macOS / Windows / Linux 共通)。本記事では各OSの手順を、認証・初期設定・トラブルシューティングまで解説します。最新の手順は公式ドキュメントもあわせて確認してください。
非エンジニアでも30分以内に最初の claude コマンドが動く状態を目指せる構成です。
週1ニュースレター(無料)に登録すると、Claude Code のアップデートと実装テンプレが毎週木曜に届きます。
1. インストール前の準備
Claude Code を動かすには以下が必要です。
- OS: macOS 13+ / Windows 11 (or WSL2) / Ubuntu 22.04+
- Node.js: 18.x 以降(npm 経由でインストールする場合)
- Anthropic アカウント: claude.ai で作成済み(Pro / Max いずれかのプラン推奨)
ターミナル操作が初めての方は Claude Code 非エンジニア完全ガイド も参照してください。
2. macOS / Windows / Linux — npm が最も確実
npm install -g @anthropic-ai/claude-code
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ニュースレター(無料)で毎週木曜に配信しています。インストール後に詰まりやすいポイントも先回りで紹介しているので、登録しておくと安心です。
関連記事
- Claude Code の始め方 — インストール後30分で動かすまでの完全手順
- Claude Code 使い方 完全ガイド — 非エンジニアが30分で始める手順
- Claude Code 料金比較 — 無料・Pro・Max・Team の選び方
- Claude Code アップデート完全手順 — 最新版の適用・確認方法
- Claude Code 完全ガイド — 料金・Skills・MCP・Hooks を網羅したピラー記事
- Claude Code とは? — できること・仕組みを初心者向けに解説
この記事の著者
claude-code-media 編集部/ Claude Code 専門編集チーム
Claude Code の非エンジニア向け業務効率化メディア『claude-code-lab.jp』を運営。フリーランス・中小企業・個人開発者向けに、実装テンプレ・業務自動化テクニック・Vibe Coding 入門を配信。
