Claude Codeを極める：カジュアルなプロンプトから自律的なエンジニアリングへ

Claude Codeは、カジュアルなユーザーと「日常的なメインツール（daily driver）」との間に巨大な隔たりがあるツールです。ほとんどのユーザーは高度なオートコンプリートとして扱いますが、パワーユーザーは、永続的なメモリ、カスタムコマンド、そして時間の経過とともに価値が増大するプロジェクト固有の設定を備えた、プログラマブルなエージェントとして活用しています。この転換は、Claudeをチャットボットとして考えるのをやめ、明確なガードレールと検証ループを必要とする自律的なエンジニアとして扱い始めたときに起こります。

コア・フィロソフィー：検証と委譲

Claudeの出力を改善するための最も影響力のある原則は、Claude自身に自分の作業を検証する方法を提供することです。決定論的なフィードバックループがない場合、人間が唯一の検証ポイントとなり、プロセスが遅延し、エラーの可能性が高まります。Claudeがテストを実行し、リンティングエラーをチェックし、ビルドを検証できるとき、出力の品質は大幅に向上します。

パワーユーザー向けの運用パターン

  • Explore $\rightarrow$ Plan $\rightarrow$ Code: 読み取り専用の探索にはPlan mode (Shift+Tab を2回) を使用します。プランを要求する前に、データモデルを理解し、フローを追跡してください。複数のファイルにまたがる複雑なタスクの場合、プランニングフェーズを絶対にスキップしないでください。
  • The Staff Engineer Review: コンテキストのバイアスを排除するために、一つのClaudeセッションでプランを書き、別の新しいセッションでそれを「スタッフエンジニア」としてレビューさせ、ギャップを見つけさせます。
  • Reference, Don't Describe: 問題を文章で説明するのではなく、正確なパス（例：@src/auth/login.py）を使用し、エラーを直接パイプします (cat error.log | claude)。
  • Delegate, Don't Pair-Program: Claudeを、一行ずつガイドするペアプログラマーとしてではなく、ブリーフ（指示書）を委譲するエンジニアとして扱ってください。簡潔なブリーフを書き、エージェントに実行させます。

.claude ディレクトリ：階層化された設定システム

Claude Codeは、プロジェクト・スコープ（チーム共有のためにgitにコミットされる）とグローバル・スコープ（個人の好みのために ~/.claude/ に保存される）に分かれた階層化された設定システムを使用します。

File Scope Commit Purpose
CLAUDE.md Project/Global Yes Instructions loaded every session
CLAUDE.local.md Project No Private project notes and personal rules
settings.json Project/Global Yes Permissions, hooks, and model defaults
.mcp.json Project Yes Team-shared MCP servers
skills/<name>/SKILL.md Project/Global Yes Reusable prompts invoked via /name
rules/*.md Project/Global Yes Topic-scoped, path-gated instructions

CLAUDE.md ファイルの極意

CLAUDE.md はプロジェクトのメモリの鼓動です。最も効果的なファイルは、短く直接的であり、ビルドコマンド、テストの呼び出し、および「PR作成前の儀式」に焦点を当てています。

「Gotchas」戦略: CLAUDE.md の最も価値のある部分は「Gotchas」セクションです。Claudeが間違いを犯したときはいつでも、次のように指示してください：「これを繰り返さないように CLAUDE.md を更新して。」 これにより、すべてのエラーを永続的なルールへと変え、エージェントがプロジェクト固有の癖にますます適応していくという、複利的なエンジニアリング効果を生み出します。

スキルとサブエージェントによる専門知識の拡張

スキル (Skills): 再利用可能な専門知識

スキルは SKILL.md ファイルを含むフォルダです。これにより、Claudeは汎用的なエンジニアからスペシャリストへと移行できます。

  • Progressive Disclosure: Claudeは開始時にフロントマターの記述のみをロードし、呼び出されたときのみ完全なスキルをロードするため、コンテキスト・ウィンドウのスペースを節約できます。
  • Inline Shell: スキルは ! を使用してシェルコマンドを実行し、呼び出し時に出力をインジェクト・エージェントに注入できます。
  • Recommended Skills: mattpocock/skills のようなコミュニティ主導のレポジトリは、/grill-me（ユーザーにプランの検討を仰ぐ）や /diagnose（規律あるデバッグ）といった高価値なツールを提供しています。

サブエージェント (Subagents): コンテキストの分離

サブエージェントは、特定のツール権限を持つ独自のコンテキスト・ウィンドウで動作し、メインセッションに要約を報告します。これにより、エージェントが数十個のファイルを読み込む必要があるときに、メインセッションが肥大化するのを防ぎます。

The Reviewer Pattern: 一般的な高レバレッジなパターンは、メインセッションに機能を実装し、その後に pr-review サブエージェントを呼び出すことです。サブエージェントは新しいコンテキストで開始するため、元のセッションの「実装バイアス」が欠き、バグを見常つける可能性が高くなります。

MCP (Model Context Protocol) によるシステム認識能力

MCPは、Claudeをコーディング・エージェントからシステム認識型エージェントへと変貌させます。外部サーバーに接続することで、Claudeはターミナル以外のツールと対話できます：

  • GitHub/Linear: イシュー・プログラミングやPRを直接管理します。
  • Sentry: ライブ・スタックトレースを取得してバグを診断します。
  • Figma: デザイン・トークンやコンポーネントの参照にアクセスします。
  • Obsidian: 3層のメモリ・アーキテクチャ（デイリーログ $\rightarrow$ プロジェクト・ノート $\rightarrow$ アーキテクチャ決定事項）を構築し、セッションを越えて長期的なコンテキストを維持します。

高度なコマンドと自動化

基本的なプロンプトを超えて、いくつかの使いこなれていないコマンドが生産性を大幅に向上させます：

  • /rewind: セッションの「元に戻す」機能です。Claudeが誤った方向に進んだとき、チャットで修正を試みるのではなく、チェックポイントまで巻き戻すことで、コンテキストを汚染せずに対処できます。
  • /goal: 決定論的な完了条件を設定します（例：/goal all tests in test/auth pass）。Claudeは条件が満たされるまで反復を行います。
  • /batch: タスクを複数の git worktrees にわたって並列エージェントに分散させます。これは大規模なマイグレーションに理想的です。
  • /compact: セッションの要約です。情報の損失を伴う要約を作成します。重要な決定事項を保持しつつ、ノイズをクリアにするために、マイルストーンごとに使用してください。

批判的な視点と反論

パワーユーザー・ワークフローは強力ですが、批判も存在します。一部の開発者は、.md ファイルや「オーケストレーション」への過度な依存が、偶発的な複雑さを導入すると主張しています。

"I don't want to spend my time developing skills andスキルを開発したり、マークダウン・ファイルを書くことに時間を費やしたくない。なぜAIがコードベースを読み取って、何をすべきか理解してくれないのか？"

他の人々は、「エージェント的」なワークフローは、時として手動介入よりも遅くなることがあると指摘しています。特に、エージェントが同様のミスのループに陥ったときです。懐疑的な人々の間で共通するテーマは、「SaaS lock-in」のリスク、つまりプロジェクトのインジェリジェンスが、独自のプラグインや設定の構成要素のエコシステムにロックインされるリスクです。

Ultimately, the transition to a

Sources