Claude Code: 実践:Chrome 拡張機能と並列タスク

最終更新:2026-08-31

実践の時間です。本章では2つの実践的シナリオを通じて Claude Code の能力を実演します — Chrome 拡張機能開発と並列タスク管理。

💡 ヒント: 実践における Claude Code の価値は単発の出力ではなく、「要件を理解 → タスクを分解 → 実行 → 検証 → 反復」の完全なクローズドループにあります。

📋 前提条件: 第20章 - チェックポイントとロールバック

1. 学ぶ内容


2. 実践1:Chrome 拡張機能開発

(1) プロジェクト概要

Alice は Chrome 拡張機能「Webpage Highlight Annotation Tool」が必要です:

(2) Claude Code に開発を任せる

TEXT 📖 参照専用
> Create a Chrome extension: Webpage highlight annotation tool

Features:
1. Right-click menu "Highlight" after selecting text
2. Support 4 colors: yellow/green/blue/red
3. Persistent annotations (Chrome storage API)
4. Popup panel to manage annotation list
5. One-click export to Markdown

Tech: Manifest V3, TypeScript, no framework, native DOM

Claude Code:
  → プロジェクト構造を作成(7ソースファイル)
  → manifest.json を作成(Manifest V3)
  → background.ts、content.ts、popup UI を作成
  → storage.ts、export.ts を作成
  → 実行中: npm run build ✓
  Project created! Features complete.

▶ 例1:反復的機能追加

TEXT 📖 参照専用
# ラウンド1:基本機能完了、反復開始

> Add feature: Click existing highlight to remove annotation
Claude Code: ✅ click-to-remove ハンドラを追加

> Add feature: Annotation list search support
Claude Code: ✅ フィルタ付き検索を追加

> Add feature: Support annotation in PDF pages
Claude Code: ✅ PDF.js 統合を追加

(3) プロジェクト構造

TEXT 📖 参照専用
chrome-highlighter/
├── manifest.json
├── src/
│   ├── background.ts
│   ├── content.ts
│   ├── popup/
│   ├── storage.ts
│   ├── export.ts
│   └── pdf-viewer.ts
├── dist/
├── package.json
└── tsconfig.json

3. 実践2:並列タスク管理

(1) シナリオ

Bob は4つの独立したタスクを同時に処理する必要があります:

  1. ユーザーアバターアップロードの追加
  2. データエクスポート API の実装
  3. ログシステムのリファクタリング
  4. 不足しているテストの追加

(2) 直列 vs 並列

TEXT 📖 参照専用
# 直列:8 + 6 + 10 + 5 = 29 分合計

# 並列:max(8, 6, 10, 5) = 10 分合計
# 65%の時間節約

▶ 例2:並列タスクの注意点

TEXT 📖 参照専用
# 問題:同じファイルへの並列修正が競合を引き起こす

# 解決策:各タスクは異なるファイルを修正
> Avatar only touches avatar.ts files
> Export only touches export.ts files
> Don't modify index.ts (I'll register routes manually)

Claude Code:
  Sub-agent 1 [avatar files] → ✅
  Sub-agent 2 [export files] → ✅
  Main agent: 手動挿入用のルート登録コードを生成

4. 大規模タスクの分解戦略

(1) 分解原則

原則 説明
独立性 サブタスク間にファイル依存なし
原子性 各サブタスクに明確な完了基準
検証可能性 各サブタスクは独立してテスト可能
可逆性 各サブタスクは個別にロールバック可能

(2) 分解ステップ

TEXT 📖 参照専用
元のタスク:"Migrate project from REST to GraphQL"

分解:
1. GraphQL Schema を定義(独立)
2. User Resolver を作成(独立、Schema 後)
3. Order Resolver を作成(独立、Schema 後)
4. Payment Resolver を作成(独立、Schema 後)
5. N+1 最適化用 DataLoader を追加(独立)
6. ルートレイヤーを移行(全 Resolver 後)
7. 古い REST ルートを削除(最後のステップ)

▶ 例3:段階的実行

TEXT 📖 参照専用
# Phase 1:Schema → /checkpoint "schema-complete"
# Phase 2:並列 Resolver → /checkpoint "resolvers-complete"
# Phase 3:ルート移行 → /checkpoint "migration-complete"
# 検証:134テストがすべて合格 ✅

5. 実践的コスト制御

TEXT 📖 参照専用
Phase 1 (Schema):    $0.45
Phase 2 (Resolvers): $2.30 (4サブエージェント)
Phase 3 (Migration): $1.80
Total:               $4.55

vs. 手動開発:~4時間 × $50/時 = $200+

❓ よくある質問

Q Claude Code は完全なアプリを構築できますか?
A はい、反復により。最初の生成は通常80%を達成し、残り20%は複数回の反復が必要です。
Q 並列タスクの最大数は?
A ハードリミットはありませんが、5-6を推奨します。それ以上は競合の確率と Token 消費が増加します。
Q Chrome 拡張機能の特別な注意点は?
A Manifest V3 の制限、content script の CSP 問題、非同期メッセージング。CLAUDE.md で Manifest V3 を指定してください。
Q 最も重要な実践的テクニックは?
A タスク分解 + チェックポイント。大きなタスクを小さく分割し、各チェックポイントで検証し、エラー時は正確にロールバック。

📖 まとめ


📝 練習問題

  1. 基本 (⭐): Claude Code でシンプルな Chrome 拡張機能(例:ページタイマー)を作成してください。
  2. 応用 (⭐⭐): Chrome 拡張機能を開発し、チェックポイントを使用して2つの機能を反復的に追加してください。
  3. 高度 (⭐⭐⭐): 4タスク並列プランを設計し、直列との実際の時間と Token 消費を比較してください。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%