Claude Code 使い方ガイド：インストールからMCP連携まで

Claude Codeとは — エージェント型AIコーディングツール

Claude CodeはAnthropicが開発したエージェント型AIコーディングツール。ターミナル、VS Code拡張、デスクトップアプリ、Webアプリ（claude.ai/code）から利用でき、自然言語の指示でコードベース全体を理解した上でファイル編集・テスト作成・Git操作・シェルコマンド実行を自律的に行う。

従来のコード補完ツールとの最大の違いは「計画→実行→検証」を自律的に繰り返すエージェント動作にある。1つの指示から複数ファイルを横断的に変更し、ビルドやテストまで実行して結果を確認する。

Claude Codeが実行できる操作の例:

• コード生成・編集 — 新機能の実装、バグ修正、リファクタリング
• テスト作成 — ユニットテスト・E2Eテストの自動生成
• Git操作 — コミット、ブランチ作成、PR作成まで一括実行
• ドキュメント生成 — READMEやAPI仕様書の作成・更新
• 外部ツール連携 — MCPサーバー経由でDB・API・Slackなどに接続

Claude Codeのインストール方法（Mac・Windows・Linux）

前提条件

• Node.js 18以上（推奨: 20 LTS）
• Anthropicアカウント（Pro以上のサブスクリプション、またはAPIキー）

Mac / Linuxの場合

# Node.jsがなければnvmでインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install 20

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

# バージョン確認
claude --version

Windowsの場合（2つの方法）

WindowsではWSL2経由とPowerShellネイティブの2つの方法がある。安定性を重視するならWSL2、手軽に試すならネイティブを選ぶ。

方法1: WSL2経由（推奨）

# 1. WSLを有効化（管理者PowerShellで実行）
wsl --install

# 2. Ubuntuを起動してNode.jsをインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 20

# 3. Claude Codeをインストール
npm install -g @anthropic-ai/claude-code

WSLのファイルアクセス: Windowsの C:\Users\ は WSL上で /mnt/c/Users/ にマウントされる。Windows側のプロジェクトをWSLから直接編集できるが、パフォーマンスはWSL側のファイルシステム（~/ 配下）の方が高い。

方法2: PowerShellネイティブ

# PowerShellで直接インストール（実行ポリシーの変更が必要な場合あり）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
irm https://claude.ai/install.ps1 | iex

初回認証

# プロジェクトディレクトリに移動して起動
cd your-project
claude

# ブラウザが自動で開く → Anthropicアカウントでログイン
# 認証完了後、ターミナルに戻って対話開始

Claude Codeの基本的な使い方

Claude Codeはターミナルで claude コマンドを実行するとインタラクティブモードに入る。自然言語で指示を出すだけで、ファイルの読み書き・コマンド実行・Git操作を行う。

よく使う基本操作

# インタラクティブモード（対話型）
claude

# ワンショットモード（1回の指示で完了）
claude -p "このプロジェクトのREADMEを日本語で作成して"

# 特定ファイルを指定して操作
claude "src/auth.tsのバリデーションにメールアドレス形式チェックを追加して"

# テストを作成
claude "src/utils/format.tsのユニットテストを作成して"

# Git操作
claude "変更内容をコミットしてPRを作成して"

キーボードショートカット

VS Code拡張での使い方

VS CodeのClaude Code拡張をインストールすると、エディタ内のサイドパネルからClaude Codeを操作できる。ターミナルとの切り替えが不要になり、コード選択→右クリック→「Claude Codeに質問」という操作も使える。

CLAUDE.mdでプロジェクトルールを設定する

CLAUDE.mdはClaude Codeの動作をプロジェクト単位でカスタマイズする設定ファイル。プロジェクトルートに置くと、Claude Codeが自動的に読み込んでルールに従う。

# CLAUDE.md の例

## コーディング規約
- TypeScript strictモードを使用
- 関数にはJSDocコメントを付ける
- テストはVitestで書く

## プロジェクト構成
- src/ — メインソースコード
- tests/ — テストファイル
- docs/ — ドキュメント

## 禁止事項
- anyの使用禁止
- console.logをコミットしない
- 外部APIキーをコードに直書きしない

3段階のCLAUDE.md: グローバル（~/.claude/CLAUDE.md）→ プロジェクト（./CLAUDE.md）→ ディレクトリ（./src/CLAUDE.md）の順に適用される。チーム共有のルールはプロジェクトルートに、個人設定はグローバルに置くのが定石。詳しくはClaude Code実践ガイドを参照。

Claude Code・Cursor・Copilotの違いを比較

AIコーディングツールは大きく「エージェント型」と「補完型」に分かれる。Claude Codeはエージェント型の代表で、Cursor・Copilotとは設計思想が異なる。

自動化パイプラインやCI/CD連携まで含めた開発ワークフローの構築にはClaude Codeが向いている。対話的にコードを書きながら試行錯誤する場面ではCursorの方が使いやすい。目的に応じた使い分けが実用的で、OpenCodeのようにClaude Code互換のOSSも登場している。

MCP・Hooks・Skillsで機能を拡張する使い方

Claude Codeは3つの拡張メカニズムを備えている。

MCPサーバーの設定例

MCPサーバーを設定すると、Claude Codeから外部サービスに直接アクセスできる。設定は .claude/settings.json に記述する。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

MCPの具体的な設定方法や活用パターンはClaude Code全機能まとめで詳しく解説している。

Hooksの設定例

Hooksはツール実行の前後に自動でシェルコマンドを実行する仕組み。コミット前のlintやテスト実行を強制できる。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Bash tool used'"
          }
        ]
      }
    ]
  }
}

Skillsの例

Skillsは .claude/commands/ ディレクトリにMarkdownファイルとして定義する再利用可能なプロンプト。 /review や /test のようにスラッシュコマンドで呼び出す。Anthropic公式のSkills集も公開されている。

# .claude/commands/review.md

コードレビューを実施してください。

## チェック項目
- セキュリティ脆弱性（OWASP Top 10）
- パフォーマンス問題
- エラーハンドリングの網羅性
- テストカバレッジ

## 出力形式
CRITICAL / HIGH / MEDIUM / LOW の4段階で報告してください。

Claude Codeの料金プラン

コスト最適化のコツ: CLAUDE.mdで出力ルールを絞る（不要なコメント・説明を省く指示）とトークン消費を抑えられる。日常のコーディングにはMax 5x、自動化パイプラインにはAPI従量課金という使い分けが多い。Claude Coworkガイドのプロンプト集も参考になる。

参照ソース: Claude Code公式ドキュメント · Anthropic料金ページ · Model Context Protocol公式 · Claude Code GitHub