第 2 章

セットアップとインストール

Claude Code には Desktop アプリと CLI（ターミナル） の 2 種類のセットアップ方法があります。 目的や好みに合わせて選んでください。どちらも同じ claude.ai アカウントでログインして使えます。

おすすめ：手軽に始めたい方
🖥️

Desktop アプリ

インストーラーを実行してログインするだけ。コマンドライン操作が不要でとにかく簡単。

  • Mac / Windows 対応
  • Node.js 不要
  • GUI で操作できる
  • 所要時間：約 5 分
本講座で使用 ★
⌨️

CLI（ターミナル）

npm でインストールしてターミナルから使う。並列エージェント処理やスクリプト連携など、Desktop アプリより高度な機能を使いこなせる。

  • Mac / Windows / Linux 対応
  • Node.js v18 以上が必要
  • スクリプトやパイプと組み合わせ可
  • 所要時間：約 10〜15 分
⚡
本講座では CLI（ターミナル版）を使用します Desktop アプリは手軽に使い始められますが、CLI には以下のような優位点があります。
  • 複数エージェントの並列処理（複数のタスクを同時実行）
  • シェルスクリプトやパイプとの組み合わせによる自動化
  • Git・npm・テストランナーなど開発ツールとのシームレスな連携
  • VS Code / JetBrains などの IDE 拡張との統合
より高度な使い方を学ぶために、本講座では CLI を前提に進めます。

2.1 共通の動作要件

項目Desktop アプリCLI（ターミナル）
OSmacOS 12+ / Windows 10+macOS 12+ / Windows 10+ / Ubuntu 20.04+
Node.js不要v18 以上（npm 付属）
Claude アカウント必須（Pro / Team / Enterprise プラン）
インターネット接続必須（AI モデルはクラウドで動作）
ディスク容量約 200 MB約 100 MB（npm パッケージ含む）

Desktop アプリのセットアップ

2.2 ダウンロードとインストール

公式サイトから OS に合ったインストーラーをダウンロードしてインストールします。

  • 1

    インストーラーをダウンロード

    公式サイト（claude.ai/download）にアクセスし、「Download for Mac」 をクリックします。.dmg ファイルがダウンロードされます。

  • 2

    .dmg を開いてアプリをインストール

    ダウンロードした .dmg ファイルを開き、Claude のアイコンを Applications フォルダにドラッグしてインストールします。

  • 3

    アプリを起動する

    Launchpad または Applications フォルダから Claude を起動します。初回は「開いてもよいですか？」の確認ダイアログが表示されるので「開く」をクリックしてください。

💡
Apple Silicon（M1/M2/M3）でも動作します Universal Binary 形式で配布されているため、Intel Mac・Apple Silicon Mac どちらでもネイティブに動作します。
  • 1

    インストーラーをダウンロード

    公式サイト（claude.ai/download）にアクセスし、「Download for Windows」 をクリックします。.exe インストーラーがダウンロードされます。

  • 2

    インストーラーを実行する

    ダウンロードした .exe をダブルクリックして実行します。「このアプリがデバイスに変更を加えることを許可しますか？」のダイアログが表示されたら「はい」をクリックしてください。

  • 3

    インストール完了・アプリを起動

    インストーラーの指示に従って進めると完了します。スタートメニューまたはデスクトップのショートカットから Claude を起動してください。

💡
Windows 11 でのスマートスクリーン警告について 「詳細情報」→「実行」をクリックして続行できます。

2.3 起動とログイン（Desktop アプリ）

アプリを起動すると、最初にログイン画面が表示されます。claude.ai のアカウントでサインインするだけで、すぐに使い始められます。

  • 1

    ログイン画面が表示される

    アプリを起動するとウェルカム画面が表示されます。「Sign in」 ボタンをクリックしてください。

  • 2

    claude.ai アカウントでサインイン

    メールアドレスとパスワード、または Google / Apple アカウントでログインします。

  • 3

    セットアップ完了

    ログインが完了するとメイン画面が表示され、すぐに Claude Code を使い始められます。

💡
Desktop アプリのセットアップはここで完了です ログインできたら 2.7 動作確認 に進んでください。

CLI（ターミナル）のセットアップ

2.4 Node.js のインストール

CLI 版は npm（Node.js に付属するパッケージマネージャー）でインストールします。まず Node.js が入っているか確認しましょう。

バージョン確認
node --version
# v18.0.0 以上が表示されれば OK

npm --version
# 8.0.0 以上が表示されれば OK

インストールされていない・バージョンが古い場合は OS に合わせてインストールします。

macOS — Homebrew（推奨）
# Homebrew がない場合はまずインストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js のインストール
brew install node

node --version
💡
複数バージョンを管理したい場合は nvm が便利
brew install nvm → nvm install 20
Windows — winget または公式インストーラー
# winget を使う場合（Windows 10/11）
winget install OpenJS.NodeJS.LTS

# または nodejs.org から LTS 版をダウンロード

node --version
💡
推奨環境：Windows Terminal + PowerShell 7
Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

node --version && npm --version

2.5 Claude Code のインストール

Node.js の準備ができたら、npm でグローバルインストールします。インストール後はどのディレクトリからでも claude コマンドが使えます。

インストール
# グローバルインストール
npm install -g @anthropic-ai/claude-code

# インストール確認
claude --version
# 例: 1.0.40 (claude-sonnet-4-6)
⚠️
macOS / Linux でパーミッションエラーが出た場合
sudo npm install -g ... は推奨しません。nvm を使うか、npm のグローバルディレクトリをホームに変更すると回避できます。

2.6 起動とログイン（CLI）

インストールが完了したら claude コマンドを起動します。初回は自動的に認証画面が表示されるので、claude.ai アカウントでログインするだけです。API キーの手動設定は不要です。

  • 1

    claude コマンドを起動する

    ターミナルを開き、claude と入力して Enter を押します。

  • 2

    認証画面で「Login with Claude.ai」を選択

    ターミナルに認証オプションが表示されます。「Login with Claude.ai」 を選び Enter を押してください。

  • 3

    ブラウザで claude.ai にログイン

    自動的にブラウザが開き、claude.ai のログイン画面が表示されます。メールアドレス・Google・Apple アカウントでログインします。

  • 4

    ターミナルに戻り、対話モードへ

    ブラウザでの認証が完了すると、Logged in as ... と表示されて対話モードが始まります。

初回起動の様子
$ claude

# ── 認証画面 ─────────────────────────
  Welcome to Claude Code!
  ❯ Login with Claude.ai     ← Enter で選択
    Enter API key manually
    Exit

# ブラウザでログイン後…
  ✓ Logged in as you@example.com
  >
💡
2 回目以降はログイン不要 認証情報はローカルに保存されます。次回から claude を起動するだけですぐ使えます。

2.7 動作確認（共通）

Desktop アプリ・CLI どちらのセットアップが終わったら、動作を確認してみましょう。

アプリを開いてチャット欄に入力するだけです。

  • 「こんにちは！」と入力して返答が来ることを確認する
  • 「簡単な Python の Hello World を書いて」と試してみる
基本操作の確認
cd ~/Desktop
claude

> こんにちは！簡単なPythonのHello Worldを書いて

> /exit

便利なコマンド一覧

コマンド説明
claude対話モードで起動
claude "指示文"ワンライナーで指示して結果を返す
claude --versionバージョン確認
/helpコマンド一覧を表示
/clear会話履歴をリセット
/exit終了

2.8 IDE 拡張機能（任意）

CLI 版と組み合わせて、IDE から Claude Code を使うこともできます。

🔵

VS Code 拡張

Extensions タブで「Claude Code」を検索してインストール。サイドパネルから直接チャットできる。

🟠

JetBrains プラグイン

Plugins マーケットで「Claude Code」を検索。IntelliJ IDEA・WebStorm・PyCharm 等で使用可能。

ℹ️
CLI にログイン済みなら IDE も追加設定不要 ターミナルで claude にログインしていれば、IDE 拡張でも同じアカウントが自動的に使われます。

2.9 トラブルシューティング

Desktop アプリが起動しない

  • macOS：システム設定 → プライバシーとセキュリティ で「開く」を許可する
  • Windows：スマートスクリーンの警告で「詳細情報」→「実行」を選択する

Q: CLI で claude: command not found と表示される

PATH の確認
# npm グローバルの bin パスを確認
npm bin -g

# 含まれていない場合 ~/.zshrc か ~/.bashrc に追加
export PATH="$(npm bin -g):$PATH"

Q: ログイン後も認証エラーが出る

再ログイン
claude logout
claude

2.10 まとめ

セットアップ完了おめでとうございます！

方法完了したこと
🖥️ Desktop アプリインストーラーを実行 → アプリ起動 → claude.ai でログイン
⌨️ CLINode.js インストール → npm install -g @anthropic-ai/claude-code → claude 起動 → ログイン
🎯
次のステップ（第3章） 次の章では、実際のプロジェクトで Claude Code を使う基本的な操作方法を学びます。