💻 Claude Code入門 📖 約30分で読めます

Claude Code導入ガイド ― Windows/Mac完全対応

Claude Codeのインストールから初回起動まで、OS別に完全対応

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

はじめに

Claude Code（クロード・コード）は、ターミナル（コマンドライン）上で動作するAIコーディングアシスタントです。VS Codeなどのエディタを使わず、ターミナルからClaude AIの能力を最大限に活用してプログラミング作業を効率化できます。

このガイドでは、Windows / Mac それぞれの環境でClaude Codeをゼロからインストールし、実際に動かすまでの全手順を解説します。よくあるエラーの対処法も網羅しています。

Claude Codeとは？何ができるのか
動作要件と事前準備
Step 1: Claude Codeのインストール
Step 3: 認証設定
Step 4: 初回起動と動作確認
Step 5: 基本的な使い方
Step 6: 設定のカスタマイズ
VS Codeとの連携
トラブルシューティング完全ガイド
効率的に使うための上級テクニック
FAQ（よくある質問）

Claude Codeとは？何ができるのか

Claude Codeは、Anthropicが公式に提供するCLI（コマンドラインインターフェース）ツールです。ターミナル上でClaudeと対話しながら、以下のような作業を実行できます。

Claude Codeの主な機能

コードの自動生成 ― 自然言語で指示するだけでコードを書いてくれます
ファイルの読み書き ― プロジェクト内のファイルを読み取り、修正・新規作成できます
コマンドの実行 ― npm install、git commit などのシェルコマンドを実行できます
プロジェクト全体の理解 ― フォルダ構成やコードの関係性を把握して作業してくれます
Git操作 ― コミット、ブランチ作成、PR作成などもAIが支援
バグの発見と修正 ― エラーメッセージを伝えると原因を特定して修正案を提示
リファクタリング ― 既存コードの改善提案と実行

Claude Code と Webブラウザ版Claudeの違い

項目	Claude Code（CLI）	Webブラウザ版（claude.ai）
操作場所	ターミナル	Webブラウザ
ファイル操作	直接読み書き可能	添付のみ
コマンド実行	可能	不可
プロジェクト理解	フォルダ全体を認識	添付ファイルのみ
主な用途	開発作業全般	一般的な会話・文章作成
必要なプラン	Pro以上またはAPIキー	無料プランでも利用可

動作要件と事前準備

システム要件

項目	Windows	Mac
OS	Windows 10以上（64bit）	macOS 13 (Ventura) 以上
メモリ	4GB以上（8GB推奨）	4GB以上（8GB推奨）
ディスク空き容量	500MB以上	500MB以上
インターネット	必須	必須

必要なアカウント（いずれか1つ）

Claude Pro / Teamサブスクリプション（推奨 ― ブラウザ認証で簡単に使える）
Anthropic APIキー（従量課金 ― 開発者向け）

Windowsの追加要件: Git for Windows

Windows環境でClaude Codeを使用するには、Git for Windowsのインストールが必須です。gitforwindows.orgからダウンロードし、インストールしてください。Git BashがClaude Codeの動作に必要です。

Step 1: Claude Codeのインストール

Claude Codeはネイティブインストーラーで簡単にインストールできます。Node.jsは不要です。

Mac の場合

手順

ターミナルを開きます（Spotlight検索で「ターミナル」と入力）
以下のコマンドを実行してインストールします：
```
curl -fsSL https://claude.ai/install.sh | bash
```
インストール完了後、ターミナルを再起動します

Windows の場合

手順

PowerShellを管理者として開きます
以下のコマンドを実行してインストールします：
```
irm https://claude.ai/install.ps1 | iex
```
インストール完了後、ターミナルを再起動します

インストール確認

claude --version

バージョン番号が表示されればインストール成功です。

インストールに失敗する場合

ターミナルを一度閉じて開き直す（環境変数の反映に必要）
Windowsの場合：PowerShellを管理者として実行しているか確認してください
Macの場合：sudoを付けて再度実行してみてください
ネットワーク接続を確認してください

Step 3: 認証設定

Claude Codeを使うにはAnthropicのアカウント認証が必要です。2つの方法があります。

方法A: Claude Pro/Teamアカウントでログイン（推奨）

手順

ターミナルで claude と入力してEnter
初回起動時、自動的にブラウザが開きます
claude.ai にログイン（すでにログイン済みならスキップ）
「Claude Codeにアクセスを許可しますか？」と表示されるので「Allow（許可）」をクリック
ブラウザに「認証成功」のメッセージが表示されます
ターミナルに戻ると、Claude Codeが使えるようになっています

方法B: APIキーを使用（開発者向け）

APIキーの取得手順

console.anthropic.com にアクセスしてログイン
左メニューの「API Keys」をクリック
「Create Key」をクリック
キーの名前を入力（例：「claude-code」）して「Create」
表示されたキー（sk-ant-で始まる文字列）をコピー

APIキーの設定

# Mac / Linux の場合
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxx

# 永続化する場合（Mac）
echo 'export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxx' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell の場合
$env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxx"

# Windows 永続化する場合
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxxxxxxxxxxxxxxx", "User")

APIキーの取り扱い注意

APIキーは絶対に他人と共有しないでください
GitHubなどにコードと一緒にアップロードしないでください
万が一漏洩した場合は、すぐにconsole.anthropic.comで無効化してください

Step 4: 初回起動と動作確認

手順

作業するプロジェクトのフォルダに移動（または新規作成）
```
mkdir my-test-project
cd my-test-project
```
Claude Codeを起動
```
claude
```

プロンプトが表示されたら、以下を入力してみましょう

> こんにちは！このフォルダにHello Worldプログラム（Python）を作ってください。

Claudeがhello.pyファイルを作成してくれます

ファイルが作成されたか確認

> このフォルダの中身を教えて

Step 5: 基本的な使い方

よく使うコマンド

コマンド	説明
`claude`	対話モードで起動（最も一般的）
`claude "質問内容"`	ワンショットで質問して結果を得る
`claude -c`	前回の会話を引き継いで起動
`/help`	対話モード中にヘルプを表示
`/clear`	会話履歴をクリア
`/cost`	現在のセッションのトークン使用量を表示
`Ctrl+C`	現在の処理を中断
`Ctrl+D`	Claude Codeを終了

実際の使用例

例1: 既存プロジェクトの理解

cd /path/to/your/project
claude
> このプロジェクトの構成を説明してください。主要なファイルとその役割を教えてください。

例2: バグの修正

> app.jsの35行目でTypeErrorが出ます。原因を調べて修正してください。
> エラーメッセージ: TypeError: Cannot read properties of undefined (reading 'map')

例3: 新しい機能の追加

> ユーザー登録フォームに、メールアドレスのバリデーション機能を追加してください。
> 要件：正規表現でチェック、エラーメッセージを赤字で表示

Step 6: 設定のカスタマイズ

CLAUDE.md ― プロジェクト固有の設定

プロジェクトのルートにCLAUDE.mdファイルを置くと、Claude Codeがプロジェクトの文脈を自動的に理解してくれます。

CLAUDE.md の例

# プロジェクト概要
ECサイトのバックエンドAPI

## 技術スタック
- Node.js + Express
- PostgreSQL
- TypeScript

## コーディング規約
- インデント: スペース2つ
- 変数名: camelCase
- コメント: 日本語OK

## よく使うコマンド
- npm run dev  → 開発サーバー起動
- npm test     → テスト実行
- npm run lint → Lint実行

VS Codeとの連携

VS Codeのターミナルパネルから直接Claude Codeを使えます。

手順

VS Codeでプロジェクトフォルダを開く
ターミナルパネルを開く（Ctrl+` またはメニュー「ターミナル」→「新しいターミナル」）
ターミナルで claude と入力して起動
VS Codeで編集中のファイルをClaude Codeが直接読み書きしてくれます

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

インストール時のエラー

エラー	原因	解決策
`command not found: claude`	PATHが通っていない	ターミナルを再起動。PATHにインストール先が含まれているか確認
`curl: command not found`	curlが未インストール（Mac/Linux）	パッケージマネージャーでcurlをインストール（例: `brew install curl`）
PowerShell実行ポリシーエラー	Windowsのセキュリティ設定	`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
Git for Windowsが見つからない	Windows環境でGitが未インストール	gitforwindows.orgからGit for Windowsをインストール
インストーラーのダウンロード失敗	ネットワーク接続の問題	インターネット接続を確認。プロキシ環境の場合はプロキシ設定を確認
インストールがタイムアウト	ネットワーク速度が遅い	安定した接続で再試行。Windowsの場合は `winget install Anthropic.ClaudeCode` を試す

起動時のエラー

エラー	原因	解決策
`command not found: claude`	パスが通っていない	ターミナルを再起動。再インストールを試行（Mac: `curl -fsSL https://claude.ai/install.sh \| bash`、Windows: `irm https://claude.ai/install.ps1 \| iex`）
認証エラー（401）	APIキーが無効	APIキーを再確認・再発行
認証ブラウザが開かない	デフォルトブラウザの設定問題	手動でURLをコピーしてブラウザに貼り付け
`Rate limit exceeded`	利用制限に到達	しばらく待ってから再試行
`ECONNREFUSED`	ネット接続の問題	インターネット接続を確認。VPN使用時はオフにしてみる

使用中のエラー

症状	原因	解決策
応答が遅い	サーバー混雑 / 大量のコンテキスト	新しいセッションを開始（`/clear`）
ファイルを読めない	パス指定の問題	絶対パスで指定。日本語パスは避ける
コマンドを実行してくれない	安全制限	リスクのある操作は確認を求められます。「はい」と回答
回答が途中で切れる	トークン制限	「続けてください」と入力

効率的に使うための上級テクニック

CLAUDE.mdを充実させる ― プロジェクトの情報を詳しく書くほど、適切な回答が得られます
具体的なファイルを指定する ― 「src/app.jsを修正して」のように明確に伝えましょう
段階的に指示する ― 大きなタスクは小さなステップに分けて依頼すると精度が上がります
/clearを活用する ― コンテキストが長くなると精度が落ちるため、区切りの良いところでクリア
ワンショットモードを使い分ける ― 簡単な質問は claude "質問" で素早く回答を得る

FAQ（よくある質問）

Q: Claude CodeはClaudeの無料プランで使えますか？

A: いいえ。Claude Code を使うには、Claude Pro / Team サブスクリプション、またはAnthropic APIキー（従量課金）が必要です。

Q: Claude Codeでファイルが壊れることはありますか？

A: Claude Codeはファイルの編集前に確認を求めます。重要なプロジェクトでは必ずGitで管理し、変更前にコミットしておくことをおすすめします。

Q: 社内のプロキシ環境でも使えますか？

A: 環境変数でプロキシを設定してください。IT部門に確認の上、HTTPS_PROXY 環境変数（例: export HTTPS_PROXY=http://proxy:8080）を設定してください。

Q: アップデートはどうすればいいですか？

A: 以下のコマンドで最新版にアップデートできます。

claude update

まとめ

Claude Codeは、開発者の生産性を大幅に向上させる強力なツールです。インストールは「インストーラーを実行 → 認証」の2ステップだけ。セットアップが終われば、あとは自然言語で指示するだけでコーディング、デバッグ、リファクタリングなどの作業をAIがサポートしてくれます。まずは小さなプロジェクトで試して、使い方に慣れていきましょう。