注目 claude-code tutorial guide automation ai-coding

Claude Code 完全ガイド 2026：ゼロからヒーローへ

2026年版 Claude Code 完全ガイド。インストール・必須コマンド・高度な自動化・Director Mode ワークフローを徹底解説。実践例20以上を収録。

• 更新日： • 15 min read • 著者：Claude World

2026年10月21日更新： Claude Code 2.1.305 に合わせて、インストール（ネイティブインストーラー）、サインイン、セッション、MCP のコマンドを修正し、Hooks の例を実際の settings.json 形式に書き直しました。Claude Code が読み込まない .claudeignore は権限の deny ルールに置き換え、モデルを Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1 に更新しています。

Claude Code は Anthropic が開発したターミナルで動作する AI コーディングアシスタントです。従来の IDE プラグインとは異なり、Claude Code はコードベース全体を読み込み、複雑なマルチファイル操作を実行し、繰り返しの開発タスクを自動化できるエージェント型アシスタントです。

この完全ガイドでは、2026年に Claude Code をマスターするために必要な知識をゼロから網羅的に解説します。

なぜ 2026年に Claude Code なのか？

Claude Code は単なる AI コーディングツールではありません。ソフトウェアを書く方法におけるパラダイムシフトです。

従来の AI アシスタント：
- チャットボットインターフェース
- 単一ファイルへの提案
- コードをコピー＆ペースト
- 限られたコンテキスト

Claude Code 2026：
- ターミナルネイティブ
- マルチファイルリファクタリング
- Claude が直接ファイルに書き込む
- コードベース全体の理解

主要な機能

機能あなたにとっての意味
エージェントアーキテクチャClaude が複雑なタスクを自律的に計画・実行できる
コードベース全体のコンテキストプロジェクト全体のファイル間の関係を理解する
マルチファイル操作複数のファイルを同時にリファクタリング・作成・編集する
ターミナル統合コマンド・テスト・git 操作を直接実行する
Hooks システムPreToolUse/PostToolUse フックでワークフローを自動化する
MCP サポートModel Context Protocol 経由で外部ツールや API に接続する

Part 1：インストールとセットアップ

前提条件

Claude Code をインストールする前に、以下を確認してください。

  • macOS 13 以降、Windows 10 1809 以降、Ubuntu 20.04 以降、Debian 10 以降、または Alpine Linux 3.19 以降（メモリ 4 GB 以上）
  • Claude の Pro、Max、Team、Enterprise プラン、または Claude Console アカウント（無料の Claude.ai プランには Claude Code が含まれません）
# Git のセットアップを確認（ネイティブ Windows では Git for Windows を推奨）
git --version

# Node.js 22 以上は npm でインストールする場合にのみ必要
node --version

インストール方法

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

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# インストールを確認
claude --version

ネイティブインストールはバックグラウンドで自動更新されます。

方法2：Homebrew、WinGet、npm

# Homebrew
brew install --cask claude-code

# WinGet（Windows）
winget install Anthropic.ClaudeCode

# npm（Node.js 22 以上が必要。sudo は使わない）
npm install -g @anthropic-ai/claude-code

Homebrew と WinGet のインストールは自動更新されないため、定期的にアップグレードしてください。

初期設定

# Claude Code を起動（初回）
claude

# ブラウザの案内に従い、Claude のサブスクリプションまたは
# Claude Console アカウントでサインイン（claude auth login でも可）

# API 課金にする場合は、Claude Console（https://platform.claude.com）の
# キーを設定し、Claude Code に確認されたら使用を承認する
export ANTHROPIC_API_KEY='your-api-key-here'

インストールの確認

# セッションを開始せずにインストールと設定を確認
claude doctor

# ワンショットのプロンプトを実行して終了
claude -p "Say hello"

Part 2：必須コマンド

基本的なワークフロー

Claude Code はターミナルで会話型インターフェースを使用します。

$ claude

🤖 Hi! I'm Claude, your AI coding assistant.
   I can help you write, refactor, and understand code.

💬 How can I help you today?

You: Create a React login form component

Claude: I'll create a Login component for you.
   Let me first check your project structure...
   [Reading src/]
   [Reading package.json]

   I'll create src/components/Login.jsx with:
   - Email/password fields
   - Form validation
   - Submit handler
   - Error display

   [Writing src/components/Login.jsx]
   ✅ Created Login component!

   Would you like me to:
   1. Add form validation
   2. Create API integration
   3. Write tests
   4. Something else

You:

コアコマンド

コマンド説明例
claudeインタラクティブセッションを開始claude
claude "prompt"初期プロンプト付きでセッションを開始claude "fix this bug"
claude -p "prompt"ワンショットコマンド（プリントモード）を実行して終了claude -p "explain this function"
claude --model sonnetモデルを指定claude --model sonnet "review code"
claude --helpすべてのオプションを表示claude --help
Ctrl+C を 2 回、または /exitセッションを終了-

セッション管理

# このディレクトリの直近の会話を続行
claude --continue

# 一覧から以前のセッションを選ぶ（ID や名前を渡すことも可能）
claude --resume

# セッション内で：プロジェクトのメモリは残したまま新しく始める
/clear

Part 3：プロジェクト理解

Claude Code はコードベース全体を理解することに優れています。その活用方法を紹介します。

自動コードベース分析

Claude Code はリポジトリを事前にインデックス化しません。各セッションでは CLAUDE.md（または AGENTS.md）の指示と git の状態を読み込み、その後はタスクに必要なファイルを Claude が検索して読みます。最初に一度 /init を実行しておくとスムーズです。

$ claude
> /init

# Claude がコードベースを分析し、見つけたビルドコマンド、
# テスト手順、規約を含む初期の CLAUDE.md を書き出す。
# 以降のセッションで自動的に読み込まれ、/memory でいつでも調整できる。

明示的なコンテキストコマンド

# Claude にファイルを説明させる
You: Explain how auth works in this project

Claude: Let me trace through your authentication system...
   [Reading src/auth/context.tsx]
   [Reading src/auth/provider.tsx]
   [Reading src/middleware.ts]

   Your auth flow:
   1. User logs in via Login component
   2. Credentials sent to /api/auth/login
   3. Server validates and returns JWT
   4. JWT stored in localStorage
   5. AuthProvider manages session state
   6. Protected routes check auth context

   Key files:
   - src/auth/context.tsx (Auth state)
   - src/middleware.ts (Route protection)
   - src/api/auth.ts (API calls)

クロスファイルリファクタリング

# 実例：コードベース全体で関数名を変更する
You: Rename handleSubmit to onSubmitForm throughout the project

Claude: I'll rename handleSubmit to onSubmitForm.
   Searching for all occurrences...

   Found in 8 files:
   - src/components/Form.jsx
   - src/components/Signup.jsx
   - src/utils/form.js
   - tests/form.test.js
   (and 5 more)

   [Updating src/components/Form.jsx]
   [Updating src/components/Signup.jsx]
   ...

   ✅ Renamed in 8 files successfully
   ✅ Updated all imports and references

Part 4：高度な自動化

Hooks：自動化のスーパーパワー

Claude Code の Hooks は、ツール呼び出しの前後など、Claude のライフサイクルの決まったタイミングで独自のコマンドを実行します。Hooks は settings.json（ユーザー、プロジェクト、ローカル）に登録し、各 Hook はイベント内容を JSON として stdin で受け取ります。

Hook の種類

// .claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' >> ~/claude-edits.log" }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm test --silent" }
        ]
      }
    ]
  }
}

よく使うイベントは PreToolUse（ツール呼び出しの前に実行され、ブロックも可能）、PostToolUse、UserPromptSubmit、Stop、SessionStart、Notification です。command のほか、http、prompt、agent、mcp_tool のハンドラーも使えます。登録済みの Hooks はセッション内で /hooks を実行すると確認できます。

実践的な Hook の例

自動セキュリティチェック：

#!/bin/bash
# .claude/hooks/protect-files.sh：Claude が機密ファイルを変更しないようにブロック
FILE_PATH=$(jq -r '.tool_input.file_path // empty')

for pattern in ".env" "secrets.json" "prod-config"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: cannot modify $FILE_PATH" >&2
    exit 2  # 終了コード 2 でツール呼び出しをブロックし、理由を Claude に伝える
  fi
done
exit 0
// .claude/settings.json（先に chmod +x でスクリプトを実行可能にする）
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh" }
        ]
      }
    ]
  }
}

単純なパスのブロックなら、Edit(.env*) のような permissions.deny ルールでスクリプトなしに同じことができます。

保存時に自動フォーマット：

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
        ]
      }
    ]
  }
}

MCP 統合

Model Context Protocol（MCP）により、Claude Code を外部ツールや API に接続できます。

MCP サーバーのインストール

# 例：Notion（リモート HTTP サーバー）
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 例：GitHub MCP サーバー（リモート、個人アクセストークンを使用）
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

# 例：カスタムのローカル MCP サーバー（stdio）
claude mcp add my-server -- node ./my-mcp-server/index.js

claude mcp install というコマンドはありません。各サーバーが接続できたかは、セッション内の /mcp（または claude mcp list）で確認します。

会話での MCP の使用

You: Check if there are any new issues in our GitHub repo

Claude: Let me check your GitHub issues...
   [MCP: github.list_issues]

   Found 5 open issues:

   1. #142 - Memory leak in useEffect (3 days ago)
   2. #141 - Add dark mode support (5 days ago)
   3. #140 - Fix mobile navigation (1 week ago)

   Would you like me to:
   - Tackle the memory leak issue?
   - Implement dark mode?
   - Fix mobile navigation?

Part 5：Director Mode

Director Mode は Claude Code の真の可能性を引き出す鍵です。コードをマイクロマネジメントするのではなく、テクニカルリードのように Claude を指揮します。

考え方の転換

マイクロマネジメントモード（非効率）：
- "Write a function that..."
- "Change this variable to..."
- "Add a parameter for..."
- "Refactor this loop to..."

Director Mode（効率的）：
- "Implement user authentication with JWT"
- "Optimize this database query for performance"
- "Add error handling to this API endpoint"
- "Refactor this component for better testability"

Director Mode のベストプラクティス

1. 明確な目標を与える

# ❌ 曖昧
You: Make the code better

# ✅ 明確な目標
You: Refactor this component to improve maintainability:
- Extract logic into custom hooks
- Add TypeScript types
- Write unit tests
- Follow React best practices

2. コンテキストを提供する

# ❌ コンテキストなし
You: Fix the bug

# ✅ コンテキストあり
You: Users report that the login form doesn't submit on mobile.
   I suspect it's a form validation issue.
   The form is in src/components/Login.jsx
   Can you investigate and fix it?

3. Claude に計画させる

# ❌ マイクロマネジメント
You: First check the file, then look at line 42,
   then change the condition, then add a console log...

# ✅ Claude に計画させる
You: Users are experiencing slow load times on the dashboard.
   Investigate performance issues and propose optimizations.

Part 6：一般的なワークフロー

ワークフロー 1：新機能の構築

$ claude

You: I need to add user comments to blog posts

Claude: I'll help you add a commenting system. Let me plan this:
   1. Create Comment component
   2. Add comment API endpoints
   3. Update blog post display
   4. Add comment form
   5. Store comments in database

   Does this plan work for you?

You: Yes, but use the existing database schema

Claude: Let me check your schema first...
   [Reading prisma/schema.prisma]

   I see you already have a Comment model.
   I'll use that instead.

   [Implementing commenting system...]
   ✅ Created components/CommentSection.tsx
   ✅ Created api/comments/route.ts
   ✅ Updated pages/blog/[id].tsx
   ✅ Added comment form

   Ready for testing!

ワークフロー 2：デバッグ

You: The search feature isn't working

Claude: Let me investigate...
   [Reading components/SearchBar.tsx]
   [Reading api/search/route.ts]
   [Reading utils/search.js]

   Found the issue! In utils/search.js line 42:
   The filter function is case-sensitive, but your data
   has mixed case. This causes search failures.

   [Fixing utils/search.js]
   ✅ Fixed: Added toLowerCase() to filter

   Would you like me to write a test to prevent regression?

ワークフロー 3：コードレビュー

You: Review this PR for best practices

Claude: I'll review the changes...
   [Reading PR #142 - Feature/user-dashboard]

   Review Summary:

   🟢 Strengths:
   - Good separation of concerns
   - Proper error handling
   - Clear variable names

   🟡 Suggestions:
   - Consider adding TypeScript strict mode
   - Some functions could be extracted for reusability
   - Missing unit tests for utility functions

   🔴 Issues:
   - Line 87: Potential SQL injection risk
   - Missing authentication check on /api/dashboard
   - Memory leak in useEffect (missing cleanup)

   I can fix these issues. Should I proceed?

Part 7：パフォーマンスとコストの最適化

トークン使用量の削減

Claude Code は .claudeignore ファイルを読み込みません。生成物や機密ファイルを Claude のファイルツールから遠ざけるには、代わりに Read の deny ルールを追加します。

// .claude/settings.json
{
  "permissions": {
    "deny": [
      "Read(./node_modules/**)",
      "Read(./dist/**)",
      "Read(./build/**)",
      "Read(./coverage/**)",
      "Read(./.env*)"
    ]
  }
}

コンテキストウィンドウの内訳は /context で確認し、混み合ってきたら /compact か /clear を使います。

コンテキストのキャッシュ

# Claude はプロジェクトのコンテキストをキャッシュする
# ファイルの再読み込みを避けるためにセッションを再利用

$ claude --continue

# キャッシュされたコンテキストで再開

モデル選択

タスク推奨モデルコスト/パフォーマンス
簡単な質問Haiku 5.5最速・最安
コード生成Sonnet 5.5速くて低コスト
複雑なリファクタリングOpus 5.5デフォルトモデルで、Anthropic が推奨する出発点（/fast 対応）
最難関の設計・判断タスクFable 5.1最も高性能なティア。デフォルトにはならない
大規模コードベースSonnet 5.5コストパフォーマンス最良、1M トークンのコンテキストウィンドウ

Anthropic API 上の Claude Code では、haiku、sonnet、opus、fable のエイリアスが上記のモデルを指します。Opus 5.5、Sonnet 5.5、Haiku 5.5 はデフォルトで medium effort で動作するため、難しい作業では /effort で引き上げてください。

Part 8：トラブルシューティング

よくある問題

問題：“API key not found”

# 解決策：サインインし、使用中の認証情報を確認する
claude auth login
claude auth status --text
# API 課金にする場合は Claude Console のキーを設定する
export ANTHROPIC_API_KEY='your-key'

問題：“Context too large”

# 解決策：/context で確認して /compact するか、より具体的に指定する
You: Only look at src/auth/, not the whole project

問題：“Hook not triggering”

# 解決策：Hook が登録されていて、スクリプトが実行可能かを確認する
/hooks                         # セッション内：登録済みの Hooks を一覧
chmod +x .claude/hooks/*.sh
claude --debug                 # Hook の実行は ~/.claude/debug/<session-id>.txt に記録される

Part 9：ベストプラクティス

やるべきこと・やってはいけないこと

✅ やるべきこと：

  • 明確な目標とコンテキストを伝える
  • 実装前に Claude に計画させる
  • コミット前に変更をレビューする
  • 自動化に Hooks を使用する
  • MCP 統合を活用する

❌ やってはいけないこと：

  • コードのすべての行をマイクロマネジメントする
  • Claude の提案を無視する
  • コードレビューをスキップする
  • Claude の出力をテストするのを忘れる
  • 1行の変更に Claude を使う（代わりに IDE を使う）

プロのヒント

  1. 会話を明確に始める：「[目標] をしたい。コンテキストはこちら：[詳細]」
  2. Claude に説明させる：「なぜこのアプローチを選んだのか？」と聞く
  3. 協力的に反復する：「良いですが、X を最適化できますか？」
  4. Claude から学ぶ：見慣れないパターンについて質問する
  5. ワークフローを構築する：よく使うタスクに Hooks を作成する

Part 10：次のステップ

学習を続ける

  1. 練習：Claude Code だけを使って小さなプロジェクトを構築する
  2. 探索：さまざまな MCP サーバーを試す
  3. カスタマイズ：自分だけの Hooks を作成する
  4. 共有：チームのためにワークフローをドキュメント化する

高度なトピック

  • マルチファイルリファクタリング：大規模なコードベース改善
  • テスト生成：Claude Code を使った自動テスト
  • ドキュメント生成：コードからドキュメントを自動生成
  • CI/CD 統合：デプロイメントワークフローの自動化

よくある質問

Claude Code は無料ですか？

いいえ。Claude Code には Claude の Pro、Max、Team、Enterprise サブスクリプション、またはトークン課金の Claude Console アカウントが必要です。無料の Claude.ai プランには含まれません。API 課金の場合、料金は使用量と使うモデルによって異なります。Haiku 5.5（100K トークン以下のプロンプトで入力／出力 100 万トークンあたり $0.10/$0.50）、Sonnet 5.5（$2/$10）、Opus 5.5（$4/$20）、Fable 5.1（$10/$50）です。最新の料金は Anthropic 公式の料金ページをご確認ください。

Anthropic のコストに関するドキュメントによると、企業導入での平均は開発者 1 人あたりアクティブな 1 日で約 $13、月 $150〜250 です。

Claude Code は IDE の代替になりますか？

いいえ、Claude Code は IDE を補完するものです。以下に Claude を使いましょう：

  • 複雑なマルチファイル操作
  • 大規模なコードベースの理解
  • 繰り返しタスクの自動化

以下には IDE を使いましょう：

  • クイック編集
  • シンタックスハイライト
  • デバッグ

Claude Code でコードは安全ですか？

はい。Claude Code は：

  • あなたのマシン上でローカルに動作する
  • 関連するコードコンテキストのみを API に送信する
  • 機密ファイルには Read(./.env) のような permissions.deny ルールを適用する
  • Amazon Bedrock、Google Cloud’s Agent Platform、Microsoft Foundry 経由でリクエストを送れる

Claude Code と Claude.ai の違いは何ですか？

  • Claude Code：ターミナル、IDE、デスクトップアプリ、Web で使えるエージェント型コーディングツール
  • Claude.ai：汎用 AI アシスタント向けの Web インターフェース

どちらも同じ Claude モデルを使用していますが、インターフェースとユースケースが異なります。

まとめ

2026年の Claude Code は、AI コーディングアシスタント以上のものです。効果的に使い方を知っている開発者にとって、力を何倍にも増幅するツールです。

重要なポイント：

  1. ✅ 明確な目標とコンテキストから始める
  2. ✅ より良い結果のために Director Mode を採用する
  3. ✅ Hooks でワークフローを自動化する
  4. ✅ 拡張された機能のために MCP サーバーを統合する
  5. ✅ Claude の出力をレビューしてテストする

次のステップ：次の機能開発に Claude Code を使い始めましょう。使えば使うほど、AI 開発チームの指揮がうまくなります。

開発ワークフローをレベルアップする準備ができましたか？Claude Code vs Cursor 比較や Director Mode 方法論もご覧ください。

参考資料：