Claude Code Best Practice要点｜86Tipsを実践者が厳選解説

Claude Codeの活用ノウハウをまとめたGitHubリポジトリ「claude-code-best-practice」が、開発者コミュニティで注目を集めています。86個のTipsが体系的に整理されており、私自身もリポジトリ全体を読み込んだうえで日々の業務に取り入れています。

ただし、86個を一つずつ読んでいくのは相当な労力です。この記事では、実際に業務で使い込んでいる実践者の視点から、特に重要なポイントを厳選して解説します。「何から手をつければいいのか」が明確になるはずです。

Best Practiceリポジトリの全体像

このリポジトリは、Claude Codeの拡張機能を7つのカテゴリに分類しています。

• Memory（CLAUDE.md）：プロジェクト知識の永続化
• Skills：再利用可能な手順・ドメイン知識
• Commands：ユーザー起動のワークフロー
• Sub-agents：独立コンテキストで動く自律エージェント
• Settings：権限・サンドボックス・モデル設定
• MCP Servers：外部ツール・API連携
• CLI Startup Flags：起動時オプション

さらに、これらをTier 1（入門）→ Tier 2（実践）→ Tier 3（応用）の3段階にマッピングしており、学習の優先順位が明確です。Boris Cherny氏やThariq氏といったClaude Codeのヘビーユーザーの知見も随所に反映されています。

最重要コンセプト：Command → Agent → Skill オーケストレーション

86個のTipsの中で、私が最も業務インパクトが大きいと感じているのが「Command → Agent → Skill」のオーケストレーションパターンです。

この3つのコンポーネントは、それぞれ明確に役割が分かれています。

Commandの役割：エントリーポイント

Commandは/command-nameでユーザーが明示的に呼び出すエントリーポイントです。Claudeが自動で呼び出すことはありません。ワークフローの起点として、AgentやSkillを呼び出す「オーケストレーター」として機能します。

Boris Cherny氏が推奨しているのは、「1日2回以上やることはCommand化する」というルールです。私自身もこの基準を採用しており、記事執筆→MicroCMS投稿、提案書PDF生成、リサーチ→要約など、繰り返す業務はすべてCommand化しています。

Agentの役割：自律的なデータ取得・処理

Agentは独立したコンテキストウィンドウで動作する自律エージェントです。メイン会話のコンテキストを汚さずに、複雑なマルチステップタスクを実行できます。

重要なフロントマターフィールドは以下の通りです。

• description：PROACTIVELYを含めると自動呼び出しが促進される
• maxTurns：設定しないと無制限に動作する可能性がある
• tools：必要最小限に制限することで暴走を防ぐ
• memory: project：セッション間で学習結果を永続化
• skills：ドメイン知識をプリロードして精度を上げる

Skillの役割：再利用可能な手順・知識

Skillは再利用可能な手順やドメイン知識をMarkdownで定義したものです。ユーザーが/skill-nameで呼び出すか、Claudeが文脈に応じて自動的に呼び出します。

Skillには2つのパターンがあります。

1. 直接呼び出しSkill：独立した処理タスク（例：SVG生成、PDF出力）
2. Agent Skill（プリロード）：Agentのskills:フィールドで注入し、ドメイン知識として組み込む

この2つのパターンを使い分けることで、「知識としてAgentに持たせるSkill」と「独立した処理を実行するSkill」を明確に分離できます。

Agent・Command・Skill 比較表

3つのコンポーネントの違いを整理します。

この比較から分かる通り、AgentだけがSkillのプリロードとメモリの永続化に対応しています。複雑な業務ワークフローを構築する際は、Agentを中心に設計するのが効果的です。

Tierマッピング：何から始めるか

リポジトリでは全トピックを3つのTierに分類しています。私の実体験からも、この順序は非常に理にかなっています。

Tier 1（入門）：CLAUDE.mdと基本設定

最も基本的でありながら、最もインパクトが大きい設定です。

• CLAUDE.md：プロジェクトのコーディング規約、アーキテクチャ、指示を永続化
• 基本設定：model、language、permissions
• 基本コマンド：/compact、/clear、/model、/memory

CLAUDE.mdには「Ancestor Loading」と「Descendant Loading」という2つの読み込みメカニズムがあります。Ancestor Loadingはカレントディレクトリからルートに向かって上方向に辿り、起動時に即座に読み込まれます。一方、Descendant Loadingは子ディレクトリのCLAUDE.mdで、ファイルアクセス時に遅延読み込みされます。

ここで注意すべき点があります。ある論文では、CLAUDE.mdへの記載量が一定以上増えるとコンテキスト量の増加により逆に作業精度が下がるという指摘がなされています。私自身も「あまり書き込みすぎない」方針で運用しており、本当に必要な情報だけを記載するようにしています。

Tier 2（実践）：Skills・Commands・MCP

日常業務での活用に必要な実践的なトピックです。

• Skill作成：フロントマターの13フィールドを理解し、カスタムSkillを構築
• Command作成：$ARGUMENTSで引数を受け取り、!`command`で動的コンテキストを注入
• MCP基本：Context7やPlaywrightなど外部ツールの導入
• Permission設定：ツール権限の詳細設定

MCP Serversについては、Redditで682 upvotesを獲得した投稿に「15個のMCPサーバーを入れたが、実際に使うのは4個だけだった」というコメントがあります。私も同じ経験をしており、現在はMicroCMSとSupabaseを主要な接続先として絞り込んでいます。以前はデザイン系MCPも接続していましたが、プロンプトやスキルでガイドラインを制定し、コード上でデザインを整える方がトータルの作業コストが下がると判断して外しました。

Tier 3（応用）：Sub-agent・オーケストレーション

高度なワークフロー設計のトピックです。

• Sub-agent作成：永続メモリ・ツール制限・Git Worktree分離
• オーケストレーション：Command → Agent → Skillの階層パターン
• Agent Skill：プリロードによるドメイン知識注入
• ヘッドレスモード：--print、--output-formatでCI/CD連携

Thariq氏が強調しているのは、「use subagentsでコンピュート（計算資源）を投入する」という考え方です。つまり、サブエージェントを使うことで、メインのコンテキストを保ちながら並列で処理を進められるため、結果的に効率が上がるという発想です。

Boris Cherny氏の主要Tips

リポジトリに反映されているBoris Cherny氏のTipsから、特に実務で効果が高かったものを紹介します。

「1日2回以上やることはCommand化」

前述の通り、これは最もシンプルで効果的なルールです。私の場合、以下のような業務をCommand化しています。

• SEO記事の執筆→CMS投稿
• クライアント向け提案書のPDF生成
• リサーチ→要約→レポート生成

Command化の基準を「1日2回」と明確にすることで、「これはCommand化すべきか」の判断が即座にできるようになります。

「最後の10%はHooksで整形」

Boris氏はHooksについて、成果物の最終仕上げを自動化する手段として位置づけています。私も公開する成果物（記事・提案書・メール）を生成する際、Hooksで事前に定義したチェックリスト（表記ルール・クライアント特定防止・数字の正確性）と自動照合する仕組みを構築しています。

これにより、人間が毎回チェックリストを目視確認する手間を省きつつ、品質を自動的に担保できます。

実践者として感じるBest Practiceの本質

86個のTipsを読み込んで実務に適用してきた中で、私が最も重要だと感じているのは「自分の業務をSkill化するプロセスそのものが価値」という点です。

おすすめのSkillを一覧で紹介するよりも、以下のプロセスを回すことが本質的な活用法です。

1. まずは口頭で一つずつClaude Codeに指示しながら業務を進める
2. 繰り返し行う業務パターンが見えたらSkill化して自動化
3. 何度も使う中で見つけた問題点を修正・改良してブラッシュアップ

Claude Codeの真価は、最先端の機能を個別に使うことではなく、Command → Agent → Skillのオーケストレーションで業務フロー全体を設計することにあります。Best Practiceリポジトリはそのための設計図として非常に優れた資料です。

まとめ

claude-code-best-practiceリポジトリの要点を整理します。

• 7カテゴリ・86Tipsが体系的に整理されている
• Tier 1 → 2 → 3の段階的な学習パスが明確
• 最重要パターンはCommand → Agent → Skillのオーケストレーション
• CLAUDE.mdは書きすぎると逆効果。必要最小限に
• MCPサーバーは本当に使うものだけに絞る
• Boris氏の「1日2回ルール」「最後の10%はHooks」は即実践可能
• 本質は自分の業務をSkill化するプロセスにある

まずはTier 1のCLAUDE.md設定から始めて、繰り返す業務をCommand化し、最終的にオーケストレーションパターンで業務全体を設計する。この順序で進めれば、Claude Codeのポテンシャルを段階的に引き出せるはずです。