MetaのスタッフエンジニアによるClaude Code活用法：エージェント型開発のための50のヒント

MetaのスタッフエンジニアであるJohn Kimが、手動でコードを書くスタイルからClaude Codeをエージェント型オーケストレーターとして最大限に活用する方法について、50のヒントを含む包括的なガイドを共有しました。以下にトピック別に整理した全ヒントを紹介します。

元動画: How a Meta Staff Engineer Uses Claude Code

基礎とセットアップ

ルートディレクトリで実行 — 常にプロジェクトのルートディレクトリでClaudeを起動し、正しいコンテキストとルールファイルを読み込ませましょう。
/initを使う — 新しいプロジェクトごとに実行しましょう。Claudeがアーキテクチャを分析し、最適化されたCLAUDE.mdを自動生成します。
メモリの階層構造 — Claudeはローカルプロジェクトメモリを最優先に、次にグローバルユーザーメモリ（~/.claude/）、最後に組み込みシステム命令という階層を使用します。
ルールは簡潔に — CLAUDE.mdは約300行を目安にしましょう。冗長になるとトークンコストが上がり、動作の精度が下がります。
技術アーキテクチャ — ハイレベルな技術要件とドメインコンテキストをルールファイルに含めましょう。
デザインパターン — プロジェクトが採用しているデザインパターンを明示的に記述し、セッション間でAIの一貫性を保ちましょう。
バリデーションループ — 最も重要な基礎：ビルドとバリデーションコマンドを定義し、コードのコンパイルに失敗した際にAIが人間の介入なしに自己修正できるようにしましょう。

キーボードショートカット

モード切替（Shift + Tab） — プランモード（設計）と編集承認（実行）を瞬時に切り替えます。
Escapeで中断 — Claudeが「思考中」でも方向がずれている場合、Escapeを押してすぐに停止し、方向を修正できます。
プロンプトのキューイング — 複数のプロンプトを連続で入力しても大丈夫です。Claude Codeは論理的にキューイングして重複を排除します。
入力のクリア（Escapeダブルタップ） — コピー&ペーストした大きなブロックや長いプロンプトを入力フィールドから即座にクリアします。
コンテキストの巻き戻し（空の入力でEscape） — 会話の以前のポイントに巻き戻し、そのコンテキストを復元します。
Vimモード — Vimユーザーなら、より効率的なターミナルナビゲーションのためにこれを有効にしましょう。
スクリーンショットのドロップ — スクリーンショットをターミナルに直接ドラッグ&ドロップして、UIデバッグの視覚的コンテキストを提供できます。

必須スラッシュコマンド

/clear — 新機能を開始する際に現在のコンテキストウィンドウをクリアし、古い情報がAIに影響するのを防ぎます。
/context — Claudeのコンテキストウィンドウに現在どのファイルとトークンがあるかを視覚的に確認します。
肥大化の監査 — /contextを使って、不必要にトークンを大量消費しているMCPやファイルを特定しましょう。
自動コンパクション — 長いセッションではClaudeに自動コンパクションさせて、コンテキストウィンドウを新鮮で関連性の高い状態に保ちましょう。
/models — Sonnet、Haiku、Opusを切り替えます。Kimはハイレベルなアーキテクチャ作業にはOpusをデフォルトとして推奨しています。
/resume — 誤ってターミナルインスタンスを終了してしまった場合、これを使って会話とコンテキストを復元できます。
/mcp — Model Context Protocolの拡張機能を表示・管理します。
MCPを制限する — 不要なトークンの肥大化を避けるため、特定のプロジェクトに必要なMCPのみをインストールしましょう。
/help — Claude Codeの更新に伴い、組み込みウィザードを使って新しいコマンドを発見しましょう。
Gitセーフティネット — 内部の巻き戻し機能だけに頼るのではなく、コード変更の主要なセーフティネットとしてGitを使いましょう。

ルール管理（CLAUDE.md）

上から下への優先順位 — ルールは最も重要なものから順に記述しましょう。Claudeは順番に読み取ります。
「絶対にしない」と「必ずする」 — 明示的な否定・肯定の制約を使い、明確なガードレールを定義しましょう。
コードスニペット — プロジェクト固有のDSLやレガシーパターンの明確な例を提供し、Claudeが代替手段を勝手に作らないようにしましょう。
ルールの自動更新 — CLAUDE.mdを手動で編集する代わりに、Claudeに 「このミスを二度としないようにルールを更新して」 と伝えましょう。
トリガーワード — ルール内にキーワードを設定し、特定のスキルやビルドコマンドを自動的にトリガーさせましょう。
複合エンジニアリング — CLAUDE.mdをコードベースにコミットして、AIのベストプラクティスをチーム全体で共有しましょう。
バイブチェック評価 — AIの評価は定量化が困難です。ルールの変更はメインブランチにマージする前に数週間テストしましょう。

高度なワークフロー

権限チェックの危険なスキップ — --dangerously-skip-permissionsを使うと、Claudeが承認を求めずにファイルを編集できます。使い捨て環境でのみ、極めて慎重に使用してください。
/permissions — スキップモードでも手動承認が必要な破壊的操作（rm -rfなど）を明示的に定義します。
プランモードから始める — コードを1行書かせる前に、必ずプランモードでClaudeと議論する時間を取りましょう。
「スタークラフト」ワークフロー — 複数のターミナルタブでClaude Codeのインスタンスを複数開き、複数の機能を同時に進めましょう。
新鮮さが肥大化に勝る — 古い履歴が残る長い循環的な会話よりも、常に新鮮で凝縮されたコンテキストを優先しましょう。
「セカンドブレイン」 — セッションの要約をローカルディレクトリに保存し、新しいセッションに遅延読み込みすることで、アーキテクチャの決定を日をまたいで保持できます。
To-Doの遅延読み込み — プロジェクトのTo-Doリストをローカルインデックスに保管し、必要な時だけClaudeに読み込ませましょう。すべてのセッションに含めて肥大化させないようにしましょう。
エミュレータの制御 — MCPを通じて、Claudeにモバイルエミュレータを制御させ、デバッグログを追加し、トレースを読み取らせましょう。
/chromeでのWeb操作 — APIが利用できない場合、ヘッドレスブラウザを通じてClaudeにドキュメントサイトのナビゲーションやフォーム入力をさせましょう。

パワーユーザーのコンポーザビリティ

スキルの作成 — 繰り返し行うワークフローを再利用可能なスキルに変換するには、Claudeに 「今やったことを新しいスキルとして保存して」 と伝えましょう。
スキルはMDファイル — スキルは特定のディレクトリに保存されたシステムプロンプトに過ぎません。プレーンテキストとして開いて編集できます。
スキルの拡張 — Claudeに 「このスキルを拡張して」 と頼み、新しいソース（例：既存のHacker NewsスキルにTwitterを追加）に対応させましょう。
副作用のためのサブエージェント — フルプロジェクトコンテキストが不要なアトミックタスクにはサブエージェントを使い、メインウィンドウをクリーンに保ちましょう。
サブエージェントの使いすぎを避ける — 深いアーキテクチャ知識が必要なタスクにはサブエージェントを使わないでください。メインのコンテキストウィンドウを共有しません。
iTerm2インスタンスの切り替え — Cmd + DとCmd + [ / ]を使って、複数のClaudeセッション間を素早く切り替えましょう。
タブの名前変更 — ターミナルタブの名前を変更し（例：「Local」「Remote SSH」）、多数の並列エージェントの中で方向を見失わないようにしましょう。
音声通知 — バックグラウンドタスクが完了した時に、Claudeに「ベルを鳴らして」またはテキスト読み上げで実行内容を要約させましょう。
Gitワークツリー — Gitワークツリーを使って、セッション間のコード競合なしに異なるブランチで並行作業しましょう。
エコシステムの探索 — コミュニティ製のプラグインやMCPをダウンロードして、Claudeの機能をデフォルト以上に拡張しましょう。

私の所感

50のヒントすべてに通じるテーマは、意図と結果の間のフィードバックループを短縮することです。バリデーションループ、セカンドブレイン、スタークラフトワークフローのいずれも、Claudeにサイクルのより多くの部分を自律的に処理させるためのパターンです。

すぐに実践するヒント：

CLAUDE.mdにビルドとリントのコマンドを定義し、Claudeに自身の出力を検証させる
/contextを使ってトークン使用量を監査し、肥大化を削減する
複雑なタスクはコードに触れる前に必ずプランモードから始める
セッションの要約をローカルに保存し、コンテキストを失わずに複数日にわたる作業を再開する

Claudeによる翻訳