Claude Code使い方ガイド2026｜導入から実践まで

1. Claude Code CLIとは？ -- 2026年の進化

Claude Codeは、Anthropicが開発したエージェント型コーディングツールだ。元々はターミナル専用のCLIだったが、2026年に入りWeb版（claude.ai/code）、デスクトップアプリ（Mac/Windows）、VS Code拡張機能、JetBrainsプラグインと利用経路が広がった。プロジェクト全体を読み取り、コードの生成からGit操作、PR作成まで自律的にこなす。

デフォルトモデルはClaude Opus 4.6（100万トークンコンテキスト）。2026年5月時点では最新のOpus 4.7も --model opus で選択できる。Hooksによるワークフロー自動化、MCP Server統合、サブエージェントによる並列タスク実行など、コード補完ツールの枠を超えた「AI開発プラットフォーム」になっている。

GitHub Copilotがリアルタイム補完に特化しているのに対し、Claude Codeはコードベース分析からリファクタリング、Git操作、PR作成、テスト実行まで開発ライフサイクル全体を自律的にカバーする。ここが最大の違いだ。

2. システム要件と事前準備

対応OS

• macOS: 10.15（Catalina）以降
• Linux: Ubuntu 20.04+ / Debian 10+
• Windows: Windows 10以降（WSL 1/2 または Git Bash経由）

ハードウェア要件

• メモリ: 4GB以上
• インターネット接続（必須）

事前に必要なもの

3. インストール・利用開始（5つの選択肢）

方法1: ネイティブインストール（推奨）

ターミナルで使うならこれが最速。

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

方法2: Homebrew（macOS）

brew install --cask claude-code

方法3: npm

npm install -g @anthropic-ai/claude-code

方法4: Web版（インストール不要）

ブラウザで claude.ai/code にアクセスするだけで利用開始できる。環境構築なしで試せるため、初回の体験に向いている。

方法5: デスクトップアプリ

Mac版とWindows版のデスクトップアプリが提供されている。CLIと同等の機能をGUIで操作可能。Anthropicの公式サイトからダウンロードする。

インストール確認（CLI版）

claude --version

バージョン番号が出ればインストール完了だ。

4. 認証とセットアップ

インストール後、初回起動時に認証が必要になる。

認証方法の選択肢

初回セットアップ手順

# プロジェクトディレクトリで起動
cd /path/to/your/project
claude

初回起動時にブラウザが開き、Anthropicアカウントでの認証を求められる。認証完了後、そのままターミナルでClaude Codeが使える。

5. 基本コマンドと最新機能

起動コマンド

セッション内コマンド（2026年5月最新）

便利なCLIフラグ

# モデルを指定（デフォルトはOpus 4.6、最新はOpus 4.7）
claude --model opus       # Opus 4.6
claude --model claude-opus-4-7  # 最新のOpus 4.7を指定

# ultrathink: 高精度モードで分析
claude "ultrathink このバグの根本原因を分析して"

# プランモード（読み取り専用で分析）
claude --permission-mode plan

# バックグラウンドで長時間タスク
claude --background "テスト全件を実行してレポートを作成"

# 詳細ログ
claude --verbose

6. CLAUDE.mdによるプロジェクト設定

CLAUDE.mdはClaude Codeの「永続的メモリ」だ。プロジェクトルートに置くとセッション開始時に自動で読み込まれ、コーディング規約やプロジェクト固有のルールがClaude Codeに伝わる。新人に渡す「プロジェクトの歩き方」と同じ役割と考えればいい。

CLAUDE.mdの配置場所と優先順位

CLAUDE.mdの記述例

# プロジェクトルール

## コーディング規約
- TypeScriptではanyの使用を禁止
- 関数はアロー関数で統一
- テストは必ずvitest で実行: npm run test

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

## 注意事項
- .envファイルを絶対にコミットしない
- APIキーをコードにハードコードしない

7. Hooks・MCP・サブエージェント

Hooks -- ワークフロー自動化の要

HooksはClaude Codeのライフサイクルの特定タイミングで自動実行されるシェルコマンドだ。LLMの外側で動く純粋なスクリプトなので、リンター自動実行や危険コマンドのブロックなど、確実に動作させたい処理に向いている。

Hooksは .claude/settings.json に定義する。

{
  "hooks": {
    "PostToolUse": [
      {
        "event": "Write",
        "command": "npx prettier --write $FILE_PATH"
      }
    ],
    "PreToolUse": [
      {
        "event": "Bash",
        "command": "echo $COMMAND | grep -q 'rm -rf /' && exit 1 || exit 0"
      }
    ]
  }
}

MCP Server統合 -- 外部ツールとの接続

MCP（Model Context Protocol）は、Claude Codeに外部サービス・ツール・DBを接続するためのプロトコルだ。Slack、GitHub、データベース、ブラウザ操作など、100以上のMCPサーバーが公開されている。

MCP Elicitation（MCPサーバーがタスク実行中に構造化された入力を要求する機能）と、MCP Tool Search（遅延読み込みでコンテキスト使用量を最大95%削減）が追加され、実用性が大幅に上がった。

サブエージェント / Agent SDK

サブエージェントは、カスタムプロンプト・ツール制限・権限モードを持つ独立したAIエージェントだ。複数のサブエージェントが協調して作業を分担する。さらにClaude Agent SDK（旧Claude Code SDK）を使えば、サブエージェントのオーケストレーション・ツールアクセス・権限を完全制御したカスタムエージェントをコードで構築できる。

# サブエージェントの定義（Markdownファイル + YAMLフロントマター）
---
name: test-runner
tools: [Bash, Read]
permission_mode: plan
---
テストを実行し、失敗したテストの原因を分析してレポートを作成してください。

8. IDE連携（VS Code・JetBrains）

ターミナル単体でも十分使えるが、IDEと統合すると差分レビューやファイル指定が格段に楽になる。

VS Code拡張機能（推奨）

「Claude Code for VS Code」拡張機能は、VS Code内にネイティブGUIを提供する。ターミナルを開かず、エディタ上でフル機能が使える。

# VS Code拡張のインストール
# 方法1: VS Code内のExtensionsパネルで "Claude Code" を検索
# 方法2: コマンドラインから
code --install-extension anthropic.claude-code

JetBrains IDEプラグイン

IntelliJ IDEA、PyCharm、WebStorm、GoLandなどJetBrains系IDEでは、Claude Codeプラグインが使える。IDE内の統合ターミナルでCLIを実行しつつ、コード変更をIDEのDiffビューアで確認・承認する流れだ。

9. 実践的なワークフロー

ワークフロー1: コードベース分析

cd /path/to/project
claude
> このプロジェクトは何をしていますか？
> メインのエントリーポイントを教えて
> 認証はどのように処理されている？

ワークフロー2: バグ修正（ultrathink活用）

claude
> ultrathink npm test で3件のテストが失敗しています。
> 原因を調べて修正してください
# ultrathinkにより高精度モードで分析 → 修正案を提示 → 承認を求める

ワークフロー3: バックグラウンドでの長時間タスク

# バックグラウンドで大規模リファクタリングを実行
claude --background "src/ディレクトリ内の全てのクラスコンポーネントを
関数コンポーネントに変換して、テストも更新して"
# 完了通知を受け取るまで他の作業が可能

ワークフロー4: Agent Teamsでコードレビュー

claude
> /agents でレビューチームを起動して、このPRを多角的にレビューして
# セキュリティ・パフォーマンス・コード品質の各サブエージェントが並列実行

ワークフロー5: PR作成

claude
> 今日の変更内容をまとめてPull Requestを作成して

ワークフロー6: 音声で指示

claude
> /voice
# スペースキーを長押しして発話
# 「ユーザー登録のバリデーションを追加して」と音声で指示

10. 料金体系（2026年最新）

Claude Code自体のインストールは無料。使用にはAnthropicへの課金が必要だ。2026年5月時点のプラン構成は以下のとおり。

11. よくある質問（FAQ）

12. まとめ

自分なら、まずWeb版（claude.ai/code）で5分触ってみて、手応えを感じたらCLIをインストールする。CLAUDE.mdに3行のプロジェクトルールを書くだけで、Claude Codeの出力品質は目に見えて変わる。

2026年5月時点で、Claude Codeは「コード補完ツール」ではなく「AI開発プラットフォーム」だ。Hooks・MCP・サブエージェントの3つを組み合わせれば、開発ライフサイクルの大半を自動化できる。