Claude Code in Action「Adding context」章に学ぶ、コンテキスト設計の実践メソッド

Anthropicの公式コース「Claude Code in Action」の「Adding context」章が、AIコーディング実践者の間で注目を集めています。本章では、Claude Codeに「適切なコンテキスト」をどう渡すかという、AIコーディングの核心となるテーマが扱われています。

コンテキスト設計は、AIアシスタントの出力品質を決定づける最重要要素です。どれほど強力なモデルを使っていても、必要な情報が欠けていれば的外れな提案しか得られません。逆に、適切なコンテキストがあれば、AIは驚くほど正確で実用的なコードを生成します。

この章では、コンテキストの渡し方を3つの比喩で整理しています：

攻略本アプローチ

「攻略本」は、プロジェクト全体の設計思想やアーキテクチャ指針を指します。新しいメンバーがプロジェクトに参加したとき、まず読むべきドキュメントと同じです。Claude Codeに対しても、コーディング規約、使用しているフレームワークの選定理由、ディレクトリ構造の意図などを明示的に伝えることで、プロジェクトの「文脈」に沿ったコードが生成されます。

自習ノートアプローチ

「自習ノート」は、過去の試行錯誤や学習履歴を指します。「この実装パターンは以前失敗した」「このライブラリは特定のバージョンでのみ動作する」といった経験知をコンテキストとして提供することで、同じ失敗を繰り返さない提案が得られます。

器具出しアプローチ

「器具出し」は、手術室で看護師が執刀医に必要な器具を適切なタイミングで渡すように、Claude Codeに「今必要な情報だけ」を的確に渡す手法です。関連するファイル、依存関係、API仕様など、タスクに直接関係する情報に絞り込むことで、AIの処理効率と精度が向上します。

GitHub CopilotやCursorとの比較

GitHub Copilotは主にファイル内のコンテキストとコメントから推論しますが、Claude Codeはより広範囲かつ構造化されたコンテキストを扱えます。Cursorも同様にプロジェクト全体を理解しますが、Claude Codeの強みは「Memory機能」を通じてセッション間でコンテキストを保持できる点にあります。

従来のコード補完ツールが「その場しのぎ」の提案をしがちだったのに対し、Claude Codeは「プロジェクトの歴史を知る協力者」として機能します。この違いは、リファクタリングや大規模な機能追加といった複雑なタスクで顕著に現れます。

メリットと注意点の両面分析

**メリット：**

**注意点：**

適用範囲の考察

この手法が特に効果的なのは：

1. **レガシーコードのモダナイゼーション**：過去の設計判断を明示的に伝えることで、互換性を保ちながら改善できます

2. **チーム開発での標準化**：共通のコンテキストテンプレートを作ることで、チーム全体の出力品質が均一化されます

3. **複雑なビジネスロジックの実装**：ドメイン知識をコンテキストとして整理することで、要件に正確に沿った実装が可能です

逆に、単純なスクリプトや使い捨てのコードでは、詳細なコンテキスト設計は過剰投資になる可能性があります。

アクション1：プロジェクトコンテキストファイルを作成する

`.claude/project-context.md`のようなファイルを作成し、以下の情報を記載します：

# プロジェクトコンテキスト

## アーキテクチャ
- フレームワーク: Next.js 14 (App Router)
- 状態管理: Zustand
- スタイリング: Tailwind CSS

## コーディング規約
- 関数コンポーネントのみ使用
- 型定義は必ず明示
- エラーハンドリングはtry-catchで統一

## 重要な制約
- IE11サポート不要
- API呼び出しは必ずaxiosインスタンスを使用

このファイルをClaude Codeとの会話の冒頭で共有することで、一貫した提案が得られます。

アクション2：タスク別コンテキストチェックリストを用意する

タスクの種類ごとに、必要なコンテキストをリスト化します：

これにより、コンテキストの渡し忘れを防げます。

アクション3：セッションログを活用する

Claude CodeのMemory機能を意識し、セッション内で学んだことを明示的に要約します：

「今回のセッションで決定したこと：〇〇コンポーネントはサーバーサイドでのみ使用する。理由は△△」

こうした要約をプロンプトに含めることで、次回以降のセッションでも一貫した判断が得られます。

コンテキスト設計は、AIコーディングツールを「単なる補完ツール」から「知的な協力者」に変える鍵です。攻略本・自習ノート・器具出しという3つの視点を意識し、プロジェクトに最適なコンテキスト戦略を構築しましょう。初期投資は必要ですが、長期的には開発効率と品質の両面で大きなリターンが期待できます。

この情報は @なべコーチ さんの投稿を参考にしています。