実践Claude Code入門

読書メモ

第1章 コーディングエージェントをソフトウェアエンジニアリングと統合する

• コーディングエージェントの特徴と歴史の紹介

• 各種コーディングエージェントの紹介・比較

• Claude Codeの特徴 → スペック駆動開発との親和性が高い

• ソフトウェアエンジニアリングの仕事がどう変わるか

• ビジネス上の問題発見やビジネス要件の探索

• ビジネス価値の評価：何を作るべきか、なぜ作るべきでないかの判断

• アーキテクチャ判断：トレードオフを理解し、適切な技術を選定すること

• 品質管理：AIが生成・検証するコードの妥当性を評価すること

• チームでの協働：コミュニケーション計画、メンタリング、文化やルールの醸成

• 技術の変化に対する素早い学習能力

• AI協働スキル：出力制御、評価・フィードバック、協働作業の設計

• システム思考・デザイン思考

1. コーディングエージェントはLLMの能力を最大限引き出してソフトウェア開発に利用できるAIエージェント

2. スペック駆動開発で作りたいものを確実に実現する（要求仕様書→設計書→テスト仕様→実装→検証）

3. エンジニアの役割は「より高いレベルの問題解決」へ

第2章 Claude Codeの基礎（流し読み）

• インストール、認証、料金プランの解説

• ハンズオン環境のセットアップ

• GitHubリポジトリ（プライベート推奨）の用意・クローン

• 本書はDev Container環境でハンズオンを進める構成

• Dev Container: https://code.claude.com/docs/en/devcontainer

• Dev Container Features: https://github.com/anthropics/devcontainer-features

• でセッション再開可能

• Claude CodeはAnthropicが公開したCLI型コーディングエージェント

• 自然言語の指示でファイル作成・編集、コマンド実行でコーディングを進める

• 基本操作だけでも簡単なアプリ実装可能

• 使いこなすにはMCPの活用とエージェントの性質理解が重要

第3章 MCPを使いこなせ！（流し読み）

• MCPの基本解説

• Claude CodeでPlaywright MCPを設定してハンズオン

• MCP Registryの紹介

• MCPはAnthropicが提案した、LLMにコンテキストを提供する方法を標準化したプロトコル

• AIアプリケーションを外部システムに接続するために使用

• 便利なMCPサーバーが次々と公開中、エコシステムが発展途上

• MCPはCLIコマンドで代替可能な場合も（コンテキスト消費とのトレードオフ）

• で有効化

• MCPツール定義が事前にコンテキストに含まれなくなる

• 必要なときにで動的に検索・呼び出し

• トークン使用量を大幅削減可能（85%削減の報告も）

• で実際にロードされたツールとトークン量を確認可能

• 参考: https://azukiazusa.dev/blog/enable-claude-code-tool-search-to-reduce-mcp-token-usage/

• MCP Registry: https://github.com/modelcontextprotocol/registry

第4章 達人に学ぶスペック駆動開発

• 田中さん（AI初心者）と達人のストーリー形式で学ぶ

• まずVibe Codingで失敗 → スペック駆動開発の必要性を理解

• 明確な設計のない場当たり的な実装

• AIとの合意形成不足（何を作るか、どう作るかの共通理解がない）

• 低品質なコードの増加（脆弱な実装が放置される）

• 課題の潜在化・放置（ドキュメントがなく、その場しのぎ）

• コード品質が安定しない

• 保守性・拡張性が低い

• トラブルシューティングが困難

• 人間とAIの間で要件や設計に関する合意形成のプロセスが必要