📜 要約
主題と目的
本レポートの主題は、Anthropicが提供するAIペアプログラマー「Claude Code」の性能を最大化するための、
CLAUDE.md
ファイル設定に関するベストプラクティスを明らかにすることです。目的は、
CLAUDE.md
の基本的な役割から、必須の記述項目、効果的な運用方法、さらには開発プロセスを革新する応用的なワークフローまでを網羅的に解説することにあります。これにより、ユーザーが自身のプロジェクトでClaude Codeの能力を最大限に引き出し、より効率的で質の高い開発を実現するための、具体的かつ実践的なガイドラインを提供します。回答
Claude.md
とは?AI開発パートナーの「記憶」を司る憲法
Claude.md
Claude Code
を最大限に活用する上で、その性能を左右する最も重要な要素がCLAUDE.md
ファイルです。これは単なる設定ファイルではなく、AI開発パートナーにプロジェクトの「記憶」と「憲法」を与える、いわばプロジェクトの魂を宿すコントロールパネルですanthropic.com
vocus.cc
大規模言語モデル(LLM)は膨大な一般知識を持っていますが、あなたのプロジェクト固有の文脈(どのファイルが重要か、チーム内のコーディング規約など)は理解できません。。
CLAUDE.md
は、このギャップを埋めるための特殊なMarkdownファイルであり、Claude Codeは対話を開始する際に自動的にその内容を読み込み、コンテキストとして利用しますdatacamp.com
anthropic.com
CLAUDE.md
は階層構造を持っており、異なるスコープの設定をインテリジェントに統合して利用しますanthropic.com
vocus.cc
配置場所 | スコープ | 主な用途 |
---|---|---|
プロジェクトルート ( ) | プロジェクト固有 | チーム全体で共有すべきプロジェクトのルール、構造、コマンドなどを定義します。 |
ホームディレクトリ ( ) | ユーザーグローバル | 個人のコーディングスタイルや好みのコマンドなど、全プロジェクト共通の設定を定義します。 |
サブディレクトリ ( ) | ディレクトリ固有 | モノレポなどで、テスト用ルールなど特定のディレクトリに特化したコンテキストを提供します。 |
ローカルオーバーライド ( ) | プロジェクトローカル | Gitで管理したくない個人用のメモや一時的な設定を記述します。 への追加が推奨されます。 |
【基本編】Claude.md
に記述すべき5つの必須項目
Claude.md
効果的な。
CLAUDE.md
を作成するためには、以下の5つの項目を網羅することがベストプラクティスとされていますapidog.com
-
技術スタック (Tech Stack)
- 目的: プロジェクトで使用する言語、フレームワーク、ライブラリを明記し、AIが適切な構文やバージョンに基づいたコードを生成できるようにします。
- 具体例:
# Tech Stack - Framework: Next.js 14 - Language: TypeScript 5.2 - Styling: Tailwind CSS 3.4 - Database: Supabase
apidog.com
-
プロジェクト構造 (Project Structure)
- 目的: 主要なディレクトリとその役割を説明し、AIがコードベースの「地図」を理解する手助けをします。
- 具体例:
# Project Structure - `src/app`: Next.js App Router pages - `src/components`: Reusable React components - `src/lib`: Core utilities and API clients
apidog.com
-
コマンド (Commands)
- 目的: ビルド、テスト、リンティングなど、日常的に使用するコマンドをリストアップし、AIにタスクを正確に実行させます。
- 具体例:
# Commands - `npm run dev`: Start the development server - `npm run test`: Run all unit tests with Jest - `npm run lint`: Run ESLint
apidog.com
-
コードスタイルと規約 (Code Style & Conventions)
- 目的: フォーマットや命名規則など、チームのコーディング規約を明記し、生成されるコードの一貫性を保ちます。
- 具体例:
# Code Style - Use ES modules (import/export), not CommonJS (require). - All new components must be function components with Hooks. - Prefer arrow functions for component definitions.
anthropic.com
-
禁止事項 (Do Not Section)
- 目的: AIに触れてほしくないファイルや避けるべき行動を指示し、意図しない変更や破壊的な操作を防ぐセーフガードとして機能させます。
- 具体例:
# Do Not Section - Do not edit any files in the `src/legacy` directory. - Do not commit directly to the `main` branch.
apidog.com
【運用編】Claude.md
を「生きているドキュメント」として育てる
Claude.md
CLAUDE.md
は、一度設定したら終わりではありません。プロジェクトの進化と共に成長させていく**「生きたドキュメント」**として捉えることが、その真価を引き出す鍵ですanthropic.com
-
から始める: プロジェクトのディレクトリで/init
コマンドを実行すると、Claudeがコードベースを分析し、/init
の雛形を自動生成してくれます。これは素晴らしい出発点となりますCLAUDE.md
datacamp.com。anthropic.com -
で動的に追記する: 対話中にClaudeに記憶させたいルールが見つかったら、メッセージの前に#
を付けて送信します。Claudeが#
への追記を提案してくれるため、日々の発見を即座に反映できますCLAUDE.md
apidog.com。anthropic.com -
チームの共有財産にする:
をGitリポジトリで管理し、変更をコードと共にコミットする文化を築くことで、チーム全員が同じコンテキストを共有できます。これにより、AIが生成するコードの品質が安定し、チーム全体の生産性が向上しますCLAUDE.md
apidog.com。anthropic.com -
パフォーマンスとコストを意識する:
の内容はトークンを消費するため、定期的に見直し、冗長な情報を削除して簡潔に保つことが重要です。また、タスクの区切りでCLAUDE.md
コマンドを使いコンテキストをリセットする習慣は、パフォーマンス維持に繋がります/clear
htdocs.dev。vocus.cc
【応用編】カスタムコマンドと高度なワークフローで開発を加速
基本を押さえたら、さらに一歩進んだテクニックで開発を自動化・高速化できます。
応用テクニック | 概要と効果 |
---|---|
カスタムコマンド | 頻繁に使うプロンプトを ディレクトリにファイルとして保存し、 のような簡単なスラッシュコマンドとして呼び出せるようにします。これにより定型作業を効率化し、チームのワークフローを標準化できますhtdocs.dev vocus.cc |
Headlessモード | フラグを付けて実行することで、対話なしにプロンプトを処理できます。これをCI/CDパイプラインやpre-commitフックに組み込むことで、コードレビューやフォーマットの自動化が可能になりますhtdocs.dev vocus.cc |
外部連携 (MCP) | MCP (Model Context Protocol) サーバーを設定すると、Claudeがデータベースや外部APIなど、ローカルファイルシステムの外にある情報源と直接対話できるようになり、タスクの幅が飛躍的に広がります medium.com htdocs.dev vocus.cc |
Vibe Codingと品質管理 | AIにコーディングの主導権を委ねる開発スタイル「Vibe Coding」は、開発の精神的負担を軽減しますが、品質管理が課題となります。 での厳格な規約定義と、自動化されたリンターやテストを組み合わせることが成功の鍵ですnathanleclaire.com |
調査の限界と今後の展望
今回の調査では、当初計画していたGitHub上の公開リポジトリから、多様な技術スタック(React、Python、Goなど)における実際の
CLAUDE.md
利用例を収集・分析するプロセスを完了できませんでした。このため、本レポートでは、特定の技術スタックやプロジェクト規模に応じた、より具体的で詳細な設定テンプレートの提供には至っておりません。例えば、「大規模なモノレポにおける。
@import
構文を使ったモジュール化の実例」や、「Webフロントエンドプロジェクトにおける状態管理ライブラリの規約」といった、より実践的な知見が不足していますsupabase.co
今後の調査でこれらの実例分析を行うことで、さらに具体的で応用範囲の広いベストプラクティスを提供できると考えています。
結果と結論
今回の調査から、
CLAUDE.md
はClaude Codeの応答品質と性能を決定づける、極めて重要な「憲法」ファイルであることが明らかになりました。そのベストプラクティスは、単一の設定方法ではなく、以下の3つの階層で構成される体系的なアプローチとして理解できます。
- 【基本】: 「技術スタック」「プロジェクト構造」「コマンド」「コードスタイル」「禁止事項」という5つの必須項目を網羅し、AIとの共通認識の基盤を築くこと。
- 【運用】: ファイルを静的なものと捉えず、
や/init
コマンド、チームでのGit管理を通じて、プロジェクトの成長に合わせて継続的に更新していく「生きたドキュメント」として育てること。#
- 【応用】: カスタムコマンドやHeadlessモード、外部連携などを活用し、開発ワークフローそのものを自動化・高度化すること。
結論として、
CLAUDE.md
を戦略的に構築・運用することは、単にAIの出力を改善するだけでなく、チーム全体の開発プロセスを標準化し、生産性を飛躍的に向上させるポテンシャルを秘めています。この「憲法」を磨き上げ、AIとの協業を深化させることが、これからのソフトウェア開発における新たな成功モデルとなるでしょう。コード実行
import React from 'react';
const BestPracticeCard = ({ title, content, example, sourceUrl, sourceText }) => (
<div className="bg-white shadow-lg rounded-lg p-6 border-l-4 border-indigo-500 hover:shadow-xl transition-shadow duration-300">
<h3 className="text-xl font-bold text-gray-800 mb-3">{title}</h3>
<p className="text-gray-600 mb-4">{content}</p>
{example && (
<pre className="bg-gray-100 p-3 rounded-md text-sm text-gray-700 overflow-x-auto mb-4">
<code>{example}</code>
</pre>
)}
{sourceUrl && sourceText && (
<a href={sourceUrl} target="_blank" rel="noopener noreferrer" className="text-sm text-indigo-600 hover:text-indigo-800 transition-colors duration-200">
出典: {sourceText}
</a>
)}
</div>
);
const App = () => {
const mainPractices = [
{
title: "1. プロジェクト概要 (Project Overview)",
content: "プロジェクトの目的、主要な機能、ターゲットユーザーなどを簡潔に記述します。",
example: "# Project Overview\nThis project is a Flask-based image uploading service for social media content creators.",
sourceUrl: "https://apidog.com/blog/claude-md/",
sourceText: "apidog.com"
},
{
title: "2. 技術スタック (Tech Stack)",
content: "使用言語、フレームワーク、ライブラリ、データベースなどを具体的にリストアップします。",
example: "# Tech Stack\n- Language: Python 3.11\n- Framework: Flask\n- Database: PostgreSQL\n- Cloud: AWS S3",
sourceUrl: "https://apidog.com/blog/claude-md/",
sourceText: "apidog.com"
},
{
title: "3. コーディング規約 (Coding Conventions)",
content: "命名規則、フォーマット、コメントスタイルなど、チームで定められたルールを明記し、コードの一貫性を保ちます。",
example: "# Coding Conventions\n- Use ES modules (import/export), not CommonJS (require).\n- All function names must be camelCase.",
sourceUrl: "https://apidog.com/blog/claude-code-beginners-guide-best-practices/",
sourceText: "apidog.com"
},
{
title: "4. 重要なファイルとディレクトリ構造",
content: "設定ファイル、エントリーポイント、コアロジックの場所など、プロジェクトの根幹をなす部分を説明します。",
example: "# Key Files & Directory Structure\n- Core logic is in `src/services/main_service.py`.\n- API routes are defined in `src/controllers/api.py`.",
sourceUrl: "https://apidog.com/blog/claude-md/",
sourceText: "apidog.com"
},
{
title: "5. セットアップと実行コマンド",
content: "開発環境のセットアップ方法、依存関係のインストール、テストやビルドの実行コマンドを記載します。",
example: "# Setup & Running Instructions\n- Install dependencies: `npm install`\n- Run tests: `npm run test`\n- Build project: `npm run build`",
sourceUrl: "https://apidog.com/blog/claude-md/",
sourceText: "apidog.com"
}
];
const operationalPractices = [
{
title: "/initコマンドで自動生成",
content: "プロジェクトのルートで `/init` を実行すると、Claudeがコードベースを分析し、`CLAUDE.md`の雛形を自動で生成します。",
sourceUrl: "https://htdocs.dev/posts/claude-code-best-practices-and-pro-tips/",
sourceText: "htdocs.dev"
},
{
title: "動的な情報追加",
content: "対話中に永続化したい情報が出たら、メッセージの前に`#`を付けて送信すると、`CLAUDE.md`に追記できます。",
sourceUrl: "https://htdocs.dev/posts/claude-code-best-practices-and-pro-tips/",
sourceText: "htdocs.dev"
},
{
title: "指示の強調",
content: "特に守ってほしいルールは `__IMPORTANT__` や `__YOU MUST__` で囲むことで、Claudeの指示遵守度を高めることができます。",
sourceUrl: "https://vocus.cc/article/685511d2fd8978000167bc7e",
sourceText: "vocus.cc"
},
{
title: "定期的なリファクタリング",
content: "`CLAUDE.md`はプロンプトの一部です。肥大化を防ぎ、常に簡潔で関連性の高い状態を保つため、定期的に見直しを行いましょう。",
sourceUrl: "https://htdocs.dev/posts/claude-code-best-practices-and-pro-tips/",
sourceText: "htdocs.dev"
},
{
title: "モジュール化とインポート",
content: "`@`構文を使い、他のMarkdownファイルをインポートできます。これにより`CLAUDE.md`本体を簡潔に保ち、知識ベースをモジュール化できます。",
sourceUrl: "https://tenten.co/learning/claude-code-guide/",
sourceText: "tenten.co"
},
{
title: "配置場所の戦略",
content: "プロジェクトルート、サブディレクトリ、ホームディレクトリ(~/.claude/)など、スコープに応じて複数の場所に配置できます。",
sourceUrl: "https://vocus.cc/article/685511d2fd8978000167bc7e",
sourceText: "vocus.cc"
},
];
return (
<div className="bg-gray-50 min-h-screen font-sans">
<div className="container mx-auto p-4 sm:p-6 lg:p-8">
<header className="text-center mb-10">
<h1 className="text-4xl sm:text-5xl font-extrabold text-gray-900 mb-2">Claude.md 設定ベストプラクティス</h1>
<p className="text-lg text-gray-600">Claude Codeの能力を最大限に引き出すための設定ガイド</p>
</header>
<section className="mb-12">
<h2 className="text-3xl font-bold text-gray-800 mb-6 border-b-2 border-indigo-500 pb-2">記載すべき5つの主要項目</h2>
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
{mainPractices.map((practice, index) => (
<BestPracticeCard key={index} {...practice} />
))}
</div>
</section>
<section>
<h2 className="text-3xl font-bold text-gray-800 mb-6 border-b-2 border-indigo-500 pb-2">効果的な運用のためのヒント</h2>
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
{operationalPractices.map((practice, index) => (
<BestPracticeCard key={index} {...practice} />
))}
</div>
</section>
<footer className="text-center mt-12 pt-6 border-t border-gray-200">
<p className="text-sm text-gray-500">出典: 調査結果コンテキスト [45, 44, 41, 40, 38, 37, 36, 31] に基づく</p>
</footer>
</div>
</div>
);
};
export default App;
🔍 詳細
🏷はじめに:Claude.mdとは?プロジェクトの記憶を司る重要ファイル
はじめに:Claude.mdとは?プロジェクトの記憶を司る重要ファイル
AIペアプログラマーであるClaude Codeを最大限に活用する上で、その性能を左右する最も重要な要素の一つが。
CLAUDE.md
ファイルです。これは単なる設定ファイルではなく、AI開発パートナーにプロジェクトの「記憶」と「憲法」を与える、いわばプロジェクトの魂を宿すコントロールパネルと言えるでしょうanthropic.com
anthropic.com
大規模言語モデル(LLM)は、Pythonの構文や一般的な設計パターンといった膨大な一般知識を持っていますが、あなたの目の前にあるプロジェクトの固有の文脈は何も知りません。例えば、どのファイルがシステムの中心的な役割を担っているのか、チーム内で共有されているコーディング規約は何か、あるいは「モジュール」という言葉がこのプロジェクトでは何を指すのか、といった「暗黙の了解」をAIは理解できません。
anthropic.com
anthropic.com
このコンテキストのギャップを埋めるのが。この特殊なMarkdownファイルにプロジェクト固有の情報を記述しておくことで、Claude Codeは対話を開始する際に自動的にその内容を読み込み、コンテキストとして利用します。これにより、Claudeは汎用的なチャットボットから、あなたのプロジェクトに特化した、頼れる専門家へと変貌を遂げるのです。
CLAUDE.md
の役割ですanthropic.com
anthropic.com
anthropic.com
Anthropicのチーム自身も「、このファイルを戦略的に活用することが、まさにベストプラクティスの中核をなすと言えます。
CLAUDE.md
の内容の品質が、Claudeの応答の精度に直接影響する」と強調しておりanthropic.com
CLAUDE.md
の仕組み:階層的な記憶システム
CLAUDE.md
CLAUDE.md
の強力さは、その柔軟な配置と階層的な読み込みシステムにあります。Claude Codeは複数の場所にあるCLAUDE.md
ファイルをインテリジェントに検出し、それらの情報を統合してコンテキストを構築しますanthropic.com
anthropic.com
配置場所 | スコープ | 主な用途 |
---|---|---|
プロジェクトルート ( ) | プロジェクト固有 | チーム全体で共有すべきプロジェクトのルール、構造、コマンドなどを定義。Gitでバージョン管理することが推奨されます anthropic.com anthropic.com |
ホームディレクトリ ( ) | ユーザーグローバル | 全てのプロジェクトに適用したい、個人のコーディングスタイルや好みのコマンドなどを定義します anthropic.com anthropic.com |
サブディレクトリ ( ) | ディレクトリ固有 | モノレポ構成などで、特定のサブディレクトリ内での作業に特化したコンテキスト(例:テスト用のルール)をオンデマンドで提供します anthropic.com anthropic.com |
ローカルオーバーライド ( ) | プロジェクトローカル | Gitで管理したくない個人用のメモや、一時的な設定を記述します。 に追加して使用しますanthropic.com |
この階層構造により、「全社共通のルール」「プロジェクト固有の規約」「個人の好み」といった異なるレベルの指示をシームレスに統合し、Claudeの振る舞いをきめ細かく制御することが可能になります。これは、単一の設定ファイルでは実現が難しい、非常に洗練されたアプローチと言えるでしょう。
「生きたドキュメント」としてのCLAUDE.md
CLAUDE.md
CLAUDE.md
は一度設定したら終わり、という静的なファイルではありません。むしろ、プロジェクトの進化と共に成長させていく**「生きたドキュメント」**として捉えるべきですanthropic.com
Claude Codeには、このファイルを簡単かつ有機的に育てるための仕組みが備わっています。
- 自動生成 (
): プロジェクトのディレクトリで/init
コマンドを実行すると、Claudeがコードベースを分析し、/init
の雛形を自動で生成してくれますCLAUDE.md
anthropic.com。これにより、ゼロから始める手間が省け、素晴らしい出発点を得ることができます。anthropic.com - 動的な追記 (
): 対話中に#
で始まるメッセージを入力すると、その内容を#
に追記するかどうかをClaudeが尋ねてくれますCLAUDE.md
anthropic.com。これにより、コーディング作業の流れを妨げることなく、発見した知見や新しいルールを即座に「記憶」させることが可能です。anthropic.com
多くのエンジニアは、この機能を活用して日々のコーディングの中で。
CLAUDE.md
を更新し、その変更をコミットに含めることで、チーム全体の知識ベースを常に最新の状態に保っていますanthropic.com
このように、
CLAUDE.md
はAIとのコミュニケーションの基盤となる重要なファイルです。次章以降では、この「プロジェクトの記憶」をどのように構築し、最適化していくかの具体的なベストプラクティスを掘り下げていきます。🏷【実践】Claude.mdに記述すべき5つの必須項目と具体例
はい、承知いたしました。
Claude Code
の性能を最大化するためのClaude.md
設定について、調査結果を基にレポートを作成します。Claude Codeの性能を最大化!Claude.md設定の最新ベストプラクティス
【実践】Claude.mdに記述すべき5つの必須項目と具体例
Claude Code
との協業、いわゆる「エージェンティック・コーディング」を成功させる鍵は、AIにプロジェクトの文脈をいかに正確に伝えるかにかかっています。その中心的な役割を担うのが、Claude.md
ファイルです。このファイルは単なる設定ファイルではなく、AIアシスタントにとっての「憲法」とも呼べる存在であり、プロジェクト固有のルールや規約、重要な情報を伝えることで、AIを汎用的なツールから専門性の高い開発パートナーへと進化させますapidog.com
では、具体的に
Claude.md
には何を記述すれば良いのでしょうか。調査結果から、特に重要とされる5つの必須項目と、その具体例を解説します。1. 技術スタック (Tech Stack)
プロジェクトで使用している言語、フレームワーク、ライブラリ、データベースなどを明記します。これにより、Claudeは適切な構文やバージョンに基づいたコードを生成し、的外れな提案を避けることができます。
apidog.com
- なぜ重要か?: AIがプロジェクトの技術的制約を理解し、互換性のないコードや古い手法を提案するのを防ぎます。
- 具体例:
# Tech Stack - Framework: Next.js 14 - Language: TypeScript 5.2 - Styling: Tailwind CSS 3.4 - Database: Supabase
apidog.com
2. プロジェクト構造 (Project Structure)
主要なディレクトリとその役割を説明することで、Claudeがコードベースを効率的に探索し、どこに何があるのかを迅速に理解できるようになります。
apidog.com
- なぜ重要か?: 新しい機能を追加する際、AIが適切なディレクトリにファイルを作成したり、関連するモジュールを正しく参照したりする手助けとなります。
- 具体例:
# Project Structure - `src/app`: Next.js App Router pages - `src/components`: Reusable React components - `src/lib`: Core utilities and API clients - `src/styles`: Global styles and Tailwind config
apidog.com
3. コマンド (Commands)
プロジェクトのビルド、テスト、リンティングなど、日常的に使用する重要なコマンドをリストアップします。これにより、Claudeにタスクを依頼する際に、これらのコマンドを正確に実行させることができます。
anthropic.com
- なぜ重要か?: 「テストを実行して」といった自然言語での指示を、プロジェクト固有の正確なコマンド (
など) に変換させることが可能になります。npm run test:unit
- 具体例:
# Commands - `npm run dev`: Start the development server - `npm run build`: Build for production - `npm run test`: Run all unit tests with Jest - `npm run lint`: Run ESLint to check for style issues
apidog.com
4. コードスタイルと規約 (Code Style & Conventions)
フォーマット、命名規則、インポート/エクスポートの構文など、チームで定められたコーディング規約を明確に記述します。これは、生成されるコードの一貫性を保つ上で不可欠です。
anthropic.com
- なぜ重要か?: AIが生成するコードがプロジェクトの既存のコードベースと調和し、コードレビューの負荷を大幅に削減します。
- 具体例:
# Code Style - Use ES modules (import/export), not CommonJS (require). - All new components must be function components with Hooks. - Prefer arrow functions for component definitions. - Destructure imports when possible (e.g., import { foo } from 'bar').
anthropic.com
5. 禁止事項リスト (Do Not Section)

Claude.md
はAIコーダーのコントロールパネルとして機能しますapidog.com
AIに触れてほしくないファイルや、避けるべき特定の行動を明記するセクションです。これは、意図しない変更や破壊的な操作を防ぐための重要なセーフガードとなります。
apidog.com
- なぜ重要か?: 動作しているレガシーコードの書き換えや、重要な設定ファイルの変更といったリスクの高い操作を未然に防ぎます。
- 具体例:
# Do Not Section - Do not edit any files in the `src/legacy` directory without explicit instruction. - Do not commit directly to the `main` or `develop` branches. - Do not add new dependencies without creating a discussion first.
apidog.com
Claude.md
の全体像と運用
Claude.md
これらの5つの項目を網羅した
Claude.md
は、AIとの円滑なコミュニケーションの基盤となります。以下は、これらの要素を組み合わせた全体的な構造例です。項目 | 説明 |
---|---|
技術スタック | 使用言語、フレームワーク、ライブラリとそのバージョンを定義します。 |
プロジェクト構造 | 主要なディレクトリの役割を説明し、コードベースの地図を提供します。 |
コマンド | ビルド、テスト、デプロイなどの重要なシェルコマンドをリストアップします。 |
コードスタイル | 命名規則やフォーマットなど、コードの一貫性を保つためのルールを明記します。 |
禁止事項 | AIが触れるべきでない領域や、避けるべき行動を明確に指示します。 |
▼
Claude.md
の記述例# Tech Stack
- Framework: Next.js 14
- Language: TypeScript 5.2
- Styling: Tailwind CSS 3.4
# Project Structure
- `src/app`: Next.js App Router pages
- `src/components`: Reusable React components
- `src/lib`: Core utilities and API clients
# Commands
- `npm run dev`: Start the development server
- `npm run build`: Build for production
- `npm run test`: Run all unit tests with Jest
# Code Style
- Use ES modules (import/export).
- All new components must be function components with Hooks.
- Prefer arrow functions for component definitions.
# Do Not Section
- Do not edit any files in the `src/legacy` directory.
- Do not commit directly to the `main` branch.
出典: Apidogの記事で紹介されている効果的な構造例
apidog.com
洞察:Claude.md
を「生きているドキュメント」として育てる
Claude.md
Claude.md
の真価は、一度設定して終わりにするのではなく、プロジェクトの進化に合わせて継続的に更新していくことで発揮されます。/init
から始める:
プロジェクトの初回実行時に/init
コマンドを使うと、Claudeがコードベースを分析し、基本的なClaude.md
を自動生成してくれますdatacamp.com
#
で動的に更新:
コーディングセッション中に、Claudeに記憶させたいルールやコマンドが見つかった場合、プロンプトの先頭に#
を付けて指示するだけで、その内容をClaude.md
に追記するかどうか尋ねられますhtdocs.dev
vocus.cc
Claude.md
を常に最新の状態に保つことができます。チームの共有財産として:
。これにより、AIが生成するコードの品質が安定し、新しいメンバーが参加した際のオンボーディングもスムーズになります。
Claude.md
をGitリポジトリにコミットすることで、チーム全員が同じコンテキストをClaudeと共有できますapidog.com
これらの必須項目を盛り込み、継続的にメンテナンスすることで、あなたの
Claude.md
はClaude Codeの能力を最大限に引き出すための、強力な羅針盤となるでしょう。調査のまとめ
Claude.mdの設定に関するベストプラクティス
Claude.md
は、AIコーディングアシスタントであるClaude Codeがプロジェクトの文脈を理解し、記憶を管理するために使用...🏷運用のベストプラクティス:効果を持続させるための保守・最適化手法

運用のベストプラクティス:効果を持続させるための保守・最適化手法
Claude Codeの真価を引き出す鍵は、。効果を持続させ、常に最高のパフォーマンスを発揮させるための運用ベストプラクティスを、具体的な手法とともにご紹介します。
CLAUDE.md
ファイルを一度設定して終わりにするのではなく、プロジェクトと共に成長する「生き物」として捉え、継続的に保守・最適化していくことにあります。このファイルは、単なる設定ファイルを超え、AIアシスタントの「憲法」や、チームの集合知が蓄積された「知識ベース」としての役割を担いますapidog.com
なぜ保守・最適化が重要なのか?
CLAUDE.md
の内容は、Claude Codeがタスクを処理する際のプロンプトの根幹をなしますvocus.cc
- パフォーマンス(精度と速度): 整理され、的確な情報が記述された
は、Claudeの思考を正確にガイドし、応答の精度を高めます。逆に、古く冗長な情報が溢れていると、AIは混乱し、パフォーマンスの低下や意図しない挙動を引き起こす可能性がありますCLAUDE.md
。htdocs.dev - コスト(トークン消費量):
の内容は、リクエストのたびにトークンを消費しますCLAUDE.md
。ファイルが不必要に肥大化すると、APIコストの増大に直結します。定期的な見直しによってファイルをリーンに保つことは、コスト効率を最適化する上で不可欠です。apidog.com - チーム開発の一貫性:
をバージョン管理し、チームの共通認識を反映させることで、誰がClaude Codeを使っても一貫性のあるコード生成やタスク実行が可能になります。これは、新しいメンバーのオンボーディングを円滑にし、開発プロセス全体の摩擦を減らす効果がありますCLAUDE.md
。apidog.com
イテレーティブ(反復的)な改善プロセス:「育てる」という意識
CLAUDE.md
は、最初から完璧を目指す必要はありません。むしろ、日々の開発プロセスの中で有機的に育てていくアプローチが最も効果的です。-
から始める: プロジェクトの初期段階で/init
コマンドを実行すると、Claudeがコードベースを分析し、/init
の雛形を自動生成してくれますCLAUDE.md
htdocs.dev。これは素晴らしい出発点となります。htdocs.dev -
コマンドで知識を追記する: 開発中にClaudeとの対話で有益な情報やルールが生まれたら、メッセージの前に#
を付けて送信しましょう#
htdocs.dev。Claudeがその情報をvocus.cc
に保存するかを尋ねてくれるので、日々の発見を即座に知識ベースへ反映できます。多くのエンジニアがこの機能を活用し、発見したコマンドやスタイルガイドラインを文書化していますCLAUDE.md
。anthropic.com -
定期的なリファクタリング:
は時間と共に情報が蓄積され、肥大化する傾向がありますCLAUDE.md
。定期的に内容を見直し、古い情報を削除したり、より簡潔な表現にリファクタリングしたりすることが極めて重要です。「Claudeのために書くのであって、新人開発者のオンボーディング資料を書くのではない」という意識を持つと、本質的で無駄のない内容に保つことができますhtdocs.dev。apidog.com
チームの知恵を結集する:バージョン管理と共有
CLAUDE.md
をチームで最大限に活用するには、バージョン管理システム(Git)との連携が不可欠です。運用プラクティス | 目的と効果 | 具体的な方法 |
---|---|---|
をGitで管理 | チーム全体のAIコラボレーションの「信頼できる唯一の情報源(Single Source of Truth)」を確立する。 | ファイルをリポジトリのルートに配置し、Gitにコミットするapidog.com |
の活用 | 個人の好みや設定をチーム共有の設定から分離し、競合を避ける。 | というファイル名で個人設定を記述し、 に追加するhtdocs.dev |
コミットへの変更含入を文化に | 日々の改善をチーム全体に還元し、知識ベースを常に最新の状態に保つ。 | の変更を、関連するコードの変更と一緒にコミットすることをチームの習慣にするvocus.cc |
この運用を徹底することで、
CLAUDE.md
は単なる個人の設定ファイルから、チーム全体の生産性を向上させる強力な共有資産へと進化します。パフォーマンスとコストを意識した最適化
CLAUDE.md
の運用は、常にパフォーマンスとコストのバランスを意識することが求められます。- コンテキスト管理: 長時間のセッションでは、無関係な会話履歴でコンテキストウィンドウが埋まってしまい、パフォーマンスが低下することがあります。タスクの区切りが良いタイミングでhtdocs.dev
コマンドを使い、コンテキストをリセットする習慣をつけましょう/clear
htdocs.dev。vocus.cc - コスト追跡: エージェントコーディングは強力ですが、無料ではありません。
コマンドccusage
や、OpenTelemetry (OTel) サポートapidog.comを活用してトークン使用量を定期的に監視し、コスト意識を持つことが重要です。htdocs.dev
を簡潔に保つことが、直接的なコスト削減に繋がることを忘れないでください。CLAUDE.md
高度な最適化テクニック
基本の運用に慣れたら、さらに一歩進んだテクニックで
CLAUDE.md
を最適化できます。- プロンプト改善ツールの活用: Anthropicは、プロンプトを改善するためのツールを提供しています。複雑化したanthropic.com
をこのツールにかけることで、よりモデルが理解しやすい構造にリファクタリングできます。CLAUDE.md
- 強調表現の利用: Claudeの指示遵守度を高めたい場合、「
」や「__IMPORTANT__
」のような強調表現を追加することが有効です__YOU MUST__
。vocus.cc - モジュール化と構造化: 大規模なプロジェクトでは、
構文を使って@import
を複数のファイルに分割し、モジュール化することが推奨されますCLAUDE.md
。これにより、管理性が向上し、コンテキストの切り替え効率が3.8倍向上したという報告もありますtenten.co。tenten.co - モデルの戦略的使い分け: 複雑な計画立案は思考能力の高い
モデルに任せ、計画に基づいた単純なコード生成は高速なOpus
モデルに切り替えるといったワークフローが非常に強力ですSonnet
。apidog.com
が一貫した制約を提供するため、モデル間の移行もスムーズに行えます。CLAUDE.md
最終的に、
CLAUDE.md
の運用と保守は、開発者自身の思考を整理し、プロジェクトへの理解を深めるプロセスでもあります。この「憲法」を継続的に磨き上げることで、Claude Codeは単なるコーディングツールから、プロジェクトの深い文脈を理解した真の「協業者」へと昇華していくのです。🏷応用編:カスタムコマンドと高度なワークフローで開発をさらに加速

はい、承知いたしました。
以下に、Claude Codeの
Claude.md
設定のベストプラクティスに関するレポートのセクション「応用編:カスタムコマンドと高度なワークフローで開発をさらに加速」を執筆します。Claude Codeの性能を最大化!Claude.md設定の最新ベストプラクティス
応用編:カスタムコマンドと高度なワークフローで開発をさらに加速
CLAUDE.md
の基本設定は、いわばClaudeにプロジェクトの「地図」を渡す行為です。しかし、真のポテンシャルを引き出すには、その地図を使ってどのように移動し、どのような行動を取るかを教え込む「応用編」の知識が不可欠です。ここでは、カスタムコマンドの作成から、複数のツールやAIを連携させた高度なワークフローまで、あなたの開発体験を根底から変える可能性を秘めたテクニックを深掘りします。定型作業を「スラッシュコマンド」で一掃する
日々の開発業務には、コードレビューの依頼、特定形式のIssue作成、定型的なテストの実行など、繰り返し発生するタスクが数多く存在します。これらを毎回手で入力するのは非効率です。そこで活躍するのが「カスタムスラッシュコマンド」です。
この機能を使えば、頻繁に利用するプロンプトを、まるでターミナルのエイリアスのように簡単なコマンドとして登録できます 。
medium.com
作成方法は驚くほど簡単です。プロジェクトのルート、またはホームディレクトリにある。
.claude/commands/
内に、コマンド名でMarkdownファイル(例: review.md
)を作成するだけ。そのファイル内にプロンプトを記述すれば、/review
というコマンドとして呼び出せるようになります htdocs.dev
コマンド作成例 ( ) |
---|
|
この機能の真価は、単なる時短に留まりません。チームで共通のカスタムコマンド集を共有することで、コードレビューの観点やIssueの報告形式といったワークフローを標準化し、開発プロセス全体の一貫性と品質を向上させることができるのです。これは、AIとの協業における「暗黙の了解」を「形式知」へと昇華させる、極めて戦略的な一手と言えるでしょう。
高度なワークフローで開発のパラダイムを変える
Claude Codeは、他のツールやプロセスと連携させることで、その能力を飛躍的に高めます。ここでは、開発の自動化と効率化を極限まで推し進めるための、より高度なワークフローを見ていきましょう。
1. コンテキスト管理:AIの「短期記憶」を操る
長時間の対話では、コンテキストが意図せず膨れ上がり、AIの応答精度が低下することがあります 。これを防ぐため、以下のコマンドを戦略的に使い分けることが重要です。
htdocs.dev
: 会話の文脈が複雑になりすぎた場合や、全く新しいタスクに移る際に使用します。これにより、会話履歴を完全に消去し、/clear
の基本情報だけを読み込んだクリーンな状態で再スタートできますCLAUDE.md
,datacamp.com。htdocs.dev
: 会話の重要な流れを維持しつつ、コンテキストを整理したい場合に有効です。このコマンドは、それまでの対話履歴を要約し、その要約のみをコンテキストとして保持します。タスクの区切りで実行することで、重要な情報を失わずに済みます/compact
。htdocs.dev
の活用: 大規模なリファクタリングや新機能開発など、複雑で多段階のタスクに取り組む際には、SCRATCHPAD.md
(引っかき回すノートの意)のような一時的なファイルを作成し、Claudeに思考の過程や計画を書き出させることが非常に有効ですSCRATCHPAD.md
。これは、AIの思考を外部化・可視化することで、コンテキストを明確に保ち、より正確な指示を与えるための強力な手法です。htdocs.dev
2. Headlessモード:CI/CDパイプラインにAIを組み込む
Claude Codeは対話的な利用だけでなく、。この機能の登場は、開発の自動化に新たな地平を切り拓きました。
-p
フラグを付けて実行することで、プロンプトを渡して結果を受け取るだけの「Headlessモード」としても機能します htdocs.dev
例えば、以下のような応用が考えられます。
- pre-commitフック: コミット前にコードの静的解析やフォーマットを自動で実行させ、修正を提案させる。
- CI/CDパイプライン: プルリクエストが作成された際に、変更内容を要約させたり、関連するテストケースを自動生成させたりする。
- Issueの自動トリアージ: 新しく作成されたIssueの内容を分析し、適切なラベルを付与したり、担当者を割り当てたりする 。htdocs.dev
このように、これまで人間が介在していた判断や作業の一部をAIに委譲することで、開発ライフサイクル全体をより高速かつ堅牢なものへと進化させることが可能です。
3. 外部連携(MCP)と並列処理:AIの能力を拡張する
Claude Codeの真骨頂は、その拡張性にあります。
-
MCP (Model Context Protocol): MCPサーバーを設定することで、Claudeはデータベースや外部API、社内ドキュメントなど、ローカルファイルシステムの外にある情報源と直接対話できるようになります。例えば、「最新のユーザー情報をデータベースから取得して、それに基づいたレポートを生成して」といった、これまで不可能だったレベルのタスクを実行可能にします。medium.com
-
複数のClaudeインスタンスの同時実行: 非常に強力ながら見過ごされがちなのが、複数のターミナルでClaudeインスタンスを並行して実行するテクニックです。vocus.cc
- 役割分担: 一方のターミナルでコードを生成させ、もう一方のターミナルでリアルタイムにそのコードのテストを実行させるといった役割分担が可能です。
- Git
との連携: 同じリポジトリの異なるブランチを別々のディレクトリとしてチェックアウトできるGitのworktree
機能と組み合わせれば、この並列作業はさらに強力になりますworktree
。vocus.cc
4. 「Vibe Coding」と品質のジレンマ
これらの高度な機能を駆使し、AIにコーディングの主導権を大きく委ねる開発スタイルは「Vibe Coding」と呼ばれています 。これは開発の精神的負担を劇的に軽減する一方で、品質管理という新たな課題を生み出します。
nathanleclaire.com
AIは時に、技術的には動作するものの、人間にとっては読みにくく保守性の低いコードを生成することがあります 。この問題に対処するため、開発者Nathan LeClaire氏は、自身のプロジェクトで非常に厳格なリンター設定(。
nathanleclaire.com
golang-cilint
)を適用し、AIが生成したコードが常に高い品質基準を満たすように強制しています nathanleclaire.com
CLAUDE.md
に明確なコーディング規約を記述すること、そして厳格なテストとリンティングを自動化することは、「Vibe Coding」を成功させるための両輪なのです。これらの応用テクニックは、もはや単なる「便利な機能」の範疇を超えています。これらは、開発者が「コードを書く人」から「AIにタスクを設計し、指示し、監督するアーキテクト」へと役割を変えていく、新しい開発パラダイムの到来を告げているのです。そしてその中心には、常に
CLAUDE.md
という、人間とAIの協調作業を司る「憲法」が存在し続けるでしょう。調査のまとめ
Claude.mdの設定に関するベストプラクティス
Claude Codeにおける
CLAUDE.md
ファイルは、Claudeが対話を開始する際に自動的に読み込む特別な説明ファイルです。...🏷補足:調査の限界と未取得の情報
補足:調査の限界と未取得の情報
今回の
Claude.md
に関するベストプラクティスの調査では、当初計画していた重要な情報収集プロセスの一部において技術的なエラーが発生し、残念ながら完了できませんでした。このセクションでは、その経緯と、それによって取得できなかった情報、そして今後の調査に向けた展望についてご報告します。調査の限界:GitHubからの実例収集の失敗
今回の調査の核心部分は、世界中の開発者が利用するGitHub上で公開されている、実際のプロジェクトにおける。
Claude.md
の利用例を収集・分析することでした。具体的には、以下の計画で調査を進める予定でしたsupabase.co
- ファイル検索: GitHub上で
という条件でファイルを検索。"filename:CLAUDE.md"
- 人気リポジトリの特定: 検索結果をスターの数が多い順に並べ替え、多くの開発者に支持されているプロジェクトを特定。
- 多様な事例の選定: React, Python/Django, Go, TypeScriptなど、異なる技術スタックのプロジェクトを3〜5つ選定。
- 詳細な分析: 各
ファイルの内容を精査し、「プロジェクト概要」「技術スタック」「コーディング規約」「ビルド/テストコマンド」「アーキテクチャに関する記述」といった項目がどのように記述されているかを分析・収集。CLAUDE.md
このアプローチにより、特定の技術スタックやプロジェクトの特性に応じた、非常に実践的で具体的なベストプラクティスを抽出できると期待していました。しかし、調査プロセス中のエラーにより、この実例データの収集が完了しなかったため、本レポートでは、コミュニティで共有されている生きた知見に基づく詳細なユースケース別の設定例をご提供するには至っておりません。
未取得の情報と今後の展望
この調査の限界により、特に以下の情報が未取得となっています。
- 技術スタック別のベストプラクティス:
- Webフロントエンド (React/TypeScript): 状態管理ライブラリ(Zustand, Redux Toolkitなど)の利用方針や、コンポーネント設計のルールをどのように記述しているか。
- バックエンド (Python/Go): データベースマイグレーションの際の手順や、APIのバージョン管理に関する規約の具体例。
- インフラ (IaC): TerraformやPulumiなどの構成管理ツールに関するコマンドや注意点の記述方法。
- プロジェクト規模に応じた設定例:
- 大規模モノレポ: 複数の
をディレクトリごとに配置し、CLAUDE.md
構文などでモジュール化している実例@import
。tenten.co - 小規模なライブラリ: 開発環境のセットアップ手順やコントリビューションガイドラインを中心に簡潔にまとめた例。
- 大規模モノレポ: 複数の
これらの情報は、
Claude.md
を単なる設定ファイルから、チーム全体の生産性を向上させる「生きたドキュメント」へと昇華させる上で極めて重要です。今回採用した、GitHub上の人気リポジトリを直接分析するというアプローチは、実践的なベストプラクティスを学ぶ上で非常に有効であることに変わりはありません。エラーの原因は特定できておりませんが、再度同じ手順で調査を試みることで、ご要望の情報を得られる可能性があります。
supabase.co
本レポートでは、公式ドキュメントや技術ブログから得られた普遍的なベストプラクティスを中心に解説しましたが、これらの実例分析が加わることで、より具体的で、すぐにあなたのプロジェクトに応用できる知見を提供できると確信しています。
...
調査のまとめ
CLAUDE.mdのベストプラクティスに関する調査結果
ご依頼いただいた、GitHub上で公開されている
CLAUDE.md
ファイルのベストプラクティスに関する調査ですが、計画してい...🖍 考察
調査の本質:AIとの協業を成功させる「コミュニケーション憲法」の設計
ユーザーの「
Claude.md
のベストプラクティスを知りたい」という要求の根底には、**「AI開発パートナーであるClaude Codeの能力を最大限に引き出し、開発の生産性と品質を飛躍的に向上させたい」**という本質的なニーズが存在します。これは単なるツール設定方法の探求ではなく、人間とAIが円滑に協業するための「コミュニケーションプロトコル」を確立しようとする試みです。Claude.md
は、そのプロトコルを定義する**「プロジェクトの憲法」**に他なりません。このファイルを通じて、私たちはAIに対し、プロジェクトの技術的制約、構造、チームのルールといった暗黙知を形式知として伝えます。本調査の目的は、この「憲法」をいかにして効果的に設計し、運用していくかの指針を提供することにあります。その価値は、単発のコード生成を効率化するだけでなく、開発プロセス全体を通じてAIとの間に一貫性と信頼性を構築し、持続可能な開発エコシステムを築く点にあります。分析と発見事項:静的な設定ファイルから「生きた知識ベース」へ
調査結果を多角的に分析すると、
Claude.md
のベストプラクティスに関して、いくつかの重要な発見がありました。分析の視点 | 発見事項 |
---|---|
トレンドと変化のパターン | は一度設定して終わりという**静的なファイルではなく、プロジェクトの進化と共に や コマンドを通じて継続的に更新・育成していく「生きたドキュメント」**として捉える思想が主流ですanthropic.com anthropic.com |
予想との差異や意外な発見 | 1. 防御的設定の重要性: 単に「何をすべきか」を指示するだけでなく、「何をしてはいけないか」を定義する が極めて重要視されていますanthropic.com (プロジェクト) と (グローバル)、 (個人) という階層的な設定が可能であり、チームの共通ルールと個人の好みを両立させる洗練された仕組みが提供されていますanthropic.com anthropic.com anthropic.com anthropic.com |
データ間の相関関係 | の**品質(Quality)**は、以下の3要素と強い正の相関関係にあります。<br>・ 応答の精度(Accuracy): 整理された は、AIの思考を正確にガイドし、高品質な出力を生み出しますanthropic.com は、開発者やAIを問わず、一貫したコードとワークフローを保証しますreddit.com の簡潔さは、APIのトークン消費量を直接的に削減し、コスト最適化に繋がりますapidog.com |
これらの発見は、
Claude.md
が単なるAIへの指示書ではなく、チームの開発文化、品質管理、コスト意識を体現する戦略的な資産であることを示唆しています。より深い分析と解釈:「プロンプトエンジニアリング」と「DevOps文化」の融合
発見事項をさらに掘り下げると、
Claude.md
の運用は、AI時代の新しいエンジニアリングスキルの核心に触れるものであることがわかります。なぜClaude.md
は「育てる」必要があるのか?
Claude.md
- Why?(プロジェクトの変化): ソフトウェアプロジェクトは静的なものではなく、要求仕様の変更、技術スタックのアップデート、アーキテクチャの進化が絶えず発生します。AIが常に最新の状況を反映した支援を提供するためには、その「憲法」もまた、プロジェクトと同期して変化し続ける必要があります。
- Why?(創発的な知見の獲得): AIとの対話の中では、人間だけでは思いつかなかった新しいコマンド、リファクタリングのアイデア、コーディング規約などが「創発的」に生まれることがあります。
コマンドでこれらを即座に#
に記録する行為は、この創発的な知見を形式知化し、チームの無形資産として蓄積するプロセスです。Claude.md
- Why?(開発者の思考の外部化):
を記述・更新するプロセスは、開発者自身の頭の中にある「プロジェクトの理想形」や「暗黙のルール」を言語化し、外部化する行為です。これにより、開発者自身の思考が整理され、チーム全体の認識合わせが促進されます。つまり、Claude.md
はAIのためだけではなく、人間チームのためのドキュメンテーションでもあるのです。Claude.md
「Vibe Coding」の光と影:自由と規律の弁証法
AIにコーディングの主導権を大きく委ねる「Vibe Coding」は、開発速度を劇的に向上させる可能性を秘めています。しかし、それは同時に、AIが生成する「技術的には正しいが保守性の低いコード」によって、プロジェクトの品質が徐々に蝕まれるリスクも内包します。
anthropic.com
この矛盾は、
Claude.md
による**「自由な指示(攻め)」と、CI/CDパイプラインに組み込まれた「厳格な品質ゲート(守り)」**という、弁証法的なアプローチによって解決されます。- テーゼ(自由):
でAIに柔軟かつ広範な裁量を与え、創造的なコーディングを促進する。CLAUDE.md
- アンチテーゼ(規律): 非常に厳格なリンターや網羅的なテストを自動実行し、AIが生成したコードが品質基準を満たさない限り、マージを許可しない。
- ジンテーゼ(統合): AIの速度と創造性を享受しつつも、人間が設定した品質基準というガードレールの中で安全に開発を進める、新しい開発パラダイムが実現する。
このアプローチは、
Claude.md
の運用が、単なるプロンプト作成技術ではなく、DevOpsの自動化思想と高度に連携した、包括的なエンジニアリング戦略であることを示しています。戦略的示唆:明日から始める「AI協業」ロードマップ
これらの分析と解釈に基づき、
Claude.md
を効果的に導入・運用するための実践的なロードマップを提案します。フェーズ1:即時導入(1日〜1週間)
- 雛形の自動生成: プロジェクトルートで
コマンドを実行し、/init
の雛形を作成しますClaude.md
anthropic.com。anthropic.com - 必須5項目の記述: 調査結果で明らかになった5つの必須項目を、チームで議論しながら記述します。
- 技術スタック (Tech Stack)
- プロジェクト構造 (Project Structure)
- コマンド (Commands)
- コードスタイルと規約 (Code Style & Conventions)
- 禁止事項リスト (Do Not Section)
- バージョン管理の開始: 作成した
をGitリポジトリにコミットし、チームの共有資産とします。同時に、CLAUDE.md
を作成してCLAUDE.local.md
に追加し、個人設定の置き場所を確保します.gitignore
。anthropic.com
フェーズ2:文化の醸成(1ヶ月〜3ヶ月)
- 動的更新の習慣化: 開発中に
コマンドを積極的に利用し、発見した知見を#
に追記する習慣をチームに根付かせますCLAUDE.md
anthropic.com。プルリクエストのマージ前に、anthropic.com
の更新が必要ないかを確認するステップを設けるのが効果的です。CLAUDE.md
- カスタムコマンドの整備: チーム内で頻繁に使われるプロンプトを特定し、
以下にカスタムスラッシュコマンドとして登録・共有します.claude/commands/
anthropic.com。これにより、定型作業を効率化し、ワークフローを標準化します。anthropic.com - 定期的リファクタリング: スプリントの振り返り会などで、定期的に
の内容を見直す時間を設けます。古くなった情報や冗長な記述を削除・修正し、ファイルを常にリーンな状態に保ちます。CLAUDE.md
フェーズ3:高度な自動化(3ヶ月以降)
- 品質ゲートの強化: CI/CDパイプラインに、厳格なリンティングルールとテストカバレッジのチェックを組み込み、「Vibe Coding」のリスクを管理します。
- Headlessモードの活用: pre-commitフックでの自動修正提案や、プルリクエスト作成時の変更内容の自動要約など、Headlessモードを活用して開発ライフサイクルの一部を自動化しますanthropic.com。anthropic.com
- 外部連携の検討: MCP(Model Context Protocol)の導入を検討し、データベースや社内ドキュメントなど、外部情報源と連携させた、より高度なタスクの自動化を目指しますanthropic.com。anthropic.com
今後の調査:より実践的な知見を求めて
今回の調査では、公式ドキュメントやブログから普遍的なベストプラクティスを抽出しましたが、調査プロセスのエラーにより、GitHub上の多様な実例分析が完了しませんでした。
Claude.md
のポテンシャルを最大限に引き出すためには、この欠落した部分を補う追加調査が不可欠です。今後の調査テーマとして、以下の項目を提案します。
- 主要技術スタック別の
実装パターン分析:CLAUDE.md
- React/TypeScriptプロジェクトにおける状態管理(Zustand等)のルール記述方法
- Python/Djangoプロジェクトにおけるデータベースマイグレーション手順の指示例
- Goプロジェクトにおけるエラーハンドリングや並行処理の規約
- 大規模モノレポにおける
のモジュール化戦略:CLAUDE.md
構文を活用し、複数の@import
を効果的に管理している先進的なリポジトリのケーススタディCLAUDE.md
- MCP(Model Context Protocol)の具体的なユースケースと実装:
- 外部APIと連携して、リアルタイムデータに基づいたコード生成を行う実装例の調査
- Headlessモードを用いたCI/CD自動化の先進事例研究:
- テストケースの自動生成や、Issueの自動トリアージを実現しているプロジェクトのワークフロー分析
📖 レポートに利用された参考文献
検索結果: 8件追加のソース: 9件チャット: 3件
69件の参考文献から20件の情報を精査し、約100,000語の情報を整理しました。あなたは約9時間の調査時間を削減したことになります🎉
調査された文献
69件
精査された情報
20件
整理された情報量
約100,000語
削減された時間
約9時間
🏷 はじめに:Claude.mdとは?プロジェクトの記憶を司る重要ファイル
Common workflows
File paths can be relative or absolute; @ file references add CLAUDE.md in the file's directory and parent directories to context; Directory references show ...
三大超好用功能公開!【2025年6月更新】【AI寫程式】 - 方格子
根據Claude Code 文件, CLAUDE.md 是Claude 在啟動對話時會自動讀取的說明檔,非常適合用來紀錄專案相關的關鍵資訊,例如常用指令、核心檔案與工具函式、 ...
Claude Code: 完整Vibe Coding 教學指南
你需要授權Claude Code 代表你生成API 金鑰並存取你的Anthropic 帳號資訊。 初始化專案:建立CLAUDE.md 檔案. 認證完成後,建議先運行專案初始化指令: /init.
Claude Code: From Zero to Hero
# Claude Code: From Zero to Hero
# What is Claude Code?
Claude Code is an AI-powered coding assist...
Claude Code Beginners' Guide: Best Practices
## Introduction to Your New AI Pair Programmer
Welcome to the future of software development. Artif...
🏷 【実践】Claude.mdに記述すべき5つの必須項目と具体例
Claude Code GitHub Actions
Create a CLAUDE.md file in your repository root to define code style guidelines, review criteria, project-specific rules, and preferred patterns. This file ...
What's a Claude.md File? 5 Best Practices to Use Claude ... - Apidog
5 Best Practices for Crafting an Effective claude.md · 1. Be Lean and Intentional: Respect the Token Budget · 2. Start with /init and Iterate · 3.
Create the perfect CLAUDE.md file - YouTube
Comments ; I was wrong about Claude Code (UPDATED AI workflow tutorial) · New 108K views ; You Aren't Using Claude Code to Its Full Potential...
Claude Code: A Guide With Practical Examples
Course
Claude Code is an agentic coding tool developed by Anthropic that operates directly in the t...
調査のまとめ
#### Claude.mdの設定に関するベストプラクティス
`Claude.md`は、AIコーディングアシスタントであるClaude Codeがプロジェクトの文脈を理解し、記憶を管理するために使用...
🏷 運用のベストプラクティス:効果を持続させるための保守・最適化手法
Claude Code: Best practices for agentic coding - Anthropic
Tune your CLAUDE.md files. Your CLAUDE.md files become part of Claude's prompts, so they should be refined like any frequently used prompt. A ...
Claude Code: Best Practices and Pro Tips - htdocs.dev
Refactor CLAUDE.md often CLAUDE.md files can grow. Periodically review and refactor them to keep them concise and relevant, as this file is ...
Claude Code: Best Practices and Pro Tips
This guide provides tips and tricks for effectively using Claude Code, a command-line tool for agent...
Claude Code:AI寫程式最佳實作指南【全文摘要翻譯】
本篇使用 AI 翻譯濃縮[原文],筆者人工校稿完成!
本篇適合正開始準備使用 Claude Code、甚至在觀望的你,官方針對這個工具 Highlight 的幾個重點!如果你還在猶豫,可以先看[我的...
claude-code-best-practices - AIXplore - Tech Articles - Obsidian Publish
claude-code-best-practices - AIXplore - Tech Articles - Obsidian Publish
🏷 応用編:カスタムコマンドと高度なワークフローで開発をさらに加速
Vibing Best Practices with Claude Code
[Vibing Best Practices with Claude Code](https://nathanleclaire.com/blog/2025/03/10/vibing-best-prac...
Claude Code: 完整 Vibe Coding 教學指南
跟著 Claude Code 學 Vibe Coding,輕鬆寫出超有感、超高效的程式碼,讓你 coding 功力 Level Up!
近期 Anthropic 發布了革命性的 [Claude Co...
調査のまとめ
#### Claude.mdの設定に関するベストプラクティス
Claude Codeにおける`CLAUDE.md`ファイルは、Claudeが対話を開始する際に自動的に読み込む特別な説明ファイルです。...
🏷 補足:調査の限界と未取得の情報
https://github.com/ にアクセスします。,ページ上部の検索バーに "filename:CLAUDE.md" と入力して、ファイル名でコード検索を実行します。,検索結果のドロップダウンメニューから「Most stars」を選択して、リポジトリをスターの数で並べ替えます。,検索結果の中から、React, Python/Django, Go, TypeScriptなど、異なる技術スタックのプロジェクトを3〜5つ特定し、それぞれのCLAUDE.mdファイルの内容を確認します。,特定した各CLAUDE.mdファイルから、「プロジェクト概要」「技術スタック」「コーディング規約」「ビルド/テストコマンド」「アーキテクチャに関する記述」などの項目がどのように記述されているかを分析し、その内容を収集します。
<result>An error occurred during task execution: </result>
<is_done>false</is_done>
<error></error>
調査のまとめ
#### CLAUDE.mdのベストプラクティスに関する調査結果
ご依頼いただいた、GitHub上で公開されている `CLAUDE.md` ファイルのベストプラクティスに関する調査ですが、計画してい...
📖 レポートに利用されていない参考文献
検索結果: 26件追加のソース: 0件チャット: 0件
Home - Anthropic
Explore the advanced features and capabilities now available in Claude. Anthropic Courses. Explore Anthropic's educational courses and projects.
Manage Claude's memory
Learn how to manage Claude Code's memory across sessions with different memory locations and best practices.
Claude Code overview
Learn about Claude Code, the agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster through natural language ...
Claude Code overview
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster through natural language commands.
Set up Claude Code
Generate a CLAUDE.md project guide. /init. 4. Commit the generated CLAUDE.md file. Ask Claude to commit the generated CLAUDE.md file to your repository.
Slash commands
Initialize project with CLAUDE.md guide. /login, Switch Anthropic accounts. /logout ... Edit CLAUDE.md memory files. /model, Select or change the AI model.
Prompt engineering overview
This guide focuses on success criteria that are controllable through prompt engineering. Not every success criteria or failing eval is best solved by prompt ...
Citations
Claude is capable of providing detailed citations when answering questions about documents, helping you track and verify information sources in responses.
Enterprise deployment overview - Anthropic
管理Claude 的記憶體- Anthropic
Claude Code GitHub Actions - Anthropic
Gérer la mémoire de Claude - Anthropic
Manage costs effectively - Anthropic
Claude Code - Anthropic
Claude Code:AI寫程式最佳實作指南【全文摘要翻譯】
此文章翻譯自Claude 官方文件,提供使用Claude Code的進階技巧,包含設定CLAUDE.md、整合工具、常見工作流程(例如測試先行、視覺輔助)、優化工作流程 ...
Claude Code Beginners' Guide: Best Practices - Apidog
Best Practices for CLAUDE.md. Think of your CLAUDE.md file as a carefully crafted prompt that you are constantly refining. Be Concise and ...
Vibing Best Practices with Claude Code - nathan leclaire
... CLAUDE.md , containing repo-specific instructions about how it ... best practices. Begin by clearly defining the overall objective and ...
claude-code-best-practices - AIXplore - Tech Articles
Your CLAUDE.md files become part of Claude's prompts, so they should be refined like any frequently used prompt. Take time to experiment with ...
Anthropic's Guide to Claude Code: Best Practices for Agentic Coding
Setting up a CLAUDE.md to guide Claude's behavior within your repo. How Claude uses your codebase + Claude.md to reason about your project.
Claude Code Top Tips: Lessons from the First 20 Hours
If Claude does something you don't like, don't just correct it once — ask it to update the CLAUDE.md file so it remembers for next time. This ...
Best Practices for Prompting Claude : r/ClaudeAI
Claude Code Best Practices Cheat Sheet | SwipeFile
Claude Code: A Guide With Practical Examples - DataCamp
In this tutorial, I'll explain how to use Claude Code to improve software development workflows by refactoring, documenting, and debugging code.
From Zero to Hero. What is Claude Code? | by Daniel Avila - Medium
Claude Code is an AI-powered coding assistant that lives in your terminal, understanding your codebase and accelerating development through ...
Claude Code Beginner Guide – Get Started in 20 Minutes (2025 ...
Claude Code Tutorial for Beginners
📊 ドメイン統計
参照ドメイン数: 13引用済み: 11総文献数: 69
1
引用: 3件/ 総数: 26件
引用率: 11.5%
2
引用: 2件/ 総数: 13件
引用率: 15.4%
3
引用: 2件/ 総数: 4件
引用率: 50.0%
4
引用: 2件/ 総数: 3件
引用率: 66.7%
5
引用: 2件/ 総数: 2件
引用率: 100.0%
6
引用: 1件/ 総数: 6件
引用率: 16.7%
7
引用: 1件/ 総数: 4件
引用率: 25.0%
8
引用: 1件/ 総数: 3件
引用率: 33.3%
9
引用: 1件/ 総数: 2件
引用率: 50.0%
10
引用: 1件/ 総数: 2件
引用率: 50.0%
11
引用: 1件/ 総数: 1件
引用率: 100.0%
12
引用: 0件/ 総数: 2件
引用率: 0.0%
13
引用: 0件/ 総数: 1件
引用率: 0.0%