Claude Code: 実践:Chrome 拡張機能と並列タスク
最終更新:2026-08-31
実践の時間です。本章では2つの実践的シナリオを通じて Claude Code の能力を実演します — Chrome 拡張機能開発と並列タスク管理。
💡 ヒント: 実践における Claude Code の価値は単発の出力ではなく、「要件を理解 → タスクを分解 → 実行 → 検証 → 反復」の完全なクローズドループにあります。
📋 前提条件: 第20章 - チェックポイントとロールバック
1. 学ぶ内容
- Chrome 拡張機能開発の全流れ
- 並列タスクの実践的応用
- 大規模タスクの分解戦略
- 反復開発の実践
- 実践におけるコスト制御
2. 実践1:Chrome 拡張機能開発
(1) プロジェクト概要
Alice は Chrome 拡張機能「Webpage Highlight Annotation Tool」が必要です:
- あらゆる Web ページで選択テキストをハイライト
- 複数のカラーラベルをサポート
- 注釈の永続的ストレージ
- 注釈を Markdown でエクスポート
(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つの独立したタスクを同時に処理する必要があります:
- ユーザーアバターアップロードの追加
- データエクスポート API の実装
- ログシステムのリファクタリング
- 不足しているテストの追加
(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 タスク分解 + チェックポイント。大きなタスクを小さく分割し、各チェックポイントで検証し、エラー時は正確にロールバック。
📖 まとめ
- Chrome 拡張機能:Claude Code はゼロから完全な機能まで構築可能
- 並列タスク:独立したサブタスクを同時実行、50-70%の時間節約
- 分解:独立性、原子性、検証可能性、可逆性
- 段階的実行 + チェックポイントで各ステップを可逆的に
- コスト制御:正確な指示、段階的実行、Sonnet 優先
📝 練習問題
- 基本 (⭐): Claude Code でシンプルな Chrome 拡張機能(例:ページタイマー)を作成してください。
- 応用 (⭐⭐): Chrome 拡張機能を開発し、チェックポイントを使用して2つの機能を反復的に追加してください。
- 高度 (⭐⭐⭐): 4タスク並列プランを設計し、直列との実際の時間と Token 消費を比較してください。