A file named CLAUDE.md hit #1 on GitHub Trending.
スター数 82,000、フォーク数 7,800。
発端は Andrej Karpathy 氏。Tesla の AI 元ディレクターで、OpenAI の創設メンバーでもあります。彼は Claude Code が失敗する 4 つの行動を特定し、それらを 1 つのファイルにまとめました。
ある開発者がその 4 つのルールを基に拡張し、ファイルを公開しました。すると、瞬く間に拡散されました。
その理由は、コーディング精度が 65% から 94% に向上したからです。
Claude Code を日常的に使っている開発者のほとんどが、この設定を行っていません。毎セッションゼロから始め、同じコンテキストを再度説明し、不要なスコープ変更を掃除し、誰も頼んでいないリファクタリングを元に戻しています。
これが完全なファイルです。
ほとんどの開発者が見逃している設定
Claude Code を開くたびに、何もない状態から始まります。
あなたのスタックも、コーディング規約も、プロジェクトのコンテキストも、すでに試したことも、3 セッション前に明確にやらないと決めたことも、何も知りません。
そのため、推測で動きます。そして推測すると、触れてほしくないコードをリファクタリングし、既存のアーキテクチャを壊すフレームワークを提案し、ファイルを無断で削除し、すでに下した判断に反することを行います。
CLAUDE.md はプロジェクトのルートに配置するプレーンテキストファイルです。Claude Code はセッション開始時に自動的に読み込みます。
1 回の設定で、説明の繰り返しはゼロ。3 種類の高くつくミスを修正できます。
1 / 3 | デフォルト: 同じ説明を繰り返すのに週 $375 も費やしている
平均的な開発者は毎日 30 分を Claude にコンテキストを再説明するのに費やしています。
スタック、コーディング規約、プロジェクトの背景、すでに試したこと。これらは、一度書き留めて毎回 Claude に読ませない限り、セッション間で保持されません。
開発者単価 $150/時間として、1 日 30 分で週 $375。開発者 1 人あたりです。
5 人チームなら週 $1,875 が消えています。
以下の 7 つのルールを CLAUDE.md ファイルの先頭に追加します。
→ 無駄を省く:
→ タスクに合わせて長さを調整する:
→ 実行前に選択肢を示す:
→ コストが発生する前に不確かさを認める:
→ 自分が誰で何を知っているか:
→ 現在のプロジェクトコンテキスト:
→ 口調を固定する:
コンテキストの再説明にかかる時間（1 日あたり）: 30 分 開発者単価 $150/時間: $75/日 週あたり: $375/週（開発者 1 人） 5 人チーム: $1,875/週 このセクションの CLAUDE.md 設定時間: 合計 45 分
避けるべきミス: CLAUDE.md をゼロから書かないでください。まずこのプロンプトを使ってから、出力を編集しましょう:
2 / 3 | 挙動: あなたが許可していない $150/時間 の変更
あなたが Claude に 1 つの関数の修正を依頼したとします。
すると Claude は 3 つのファイルをリファクタリングし、変数をリネームし、インポートを再編成し、あなたが時間をかけて書いたコメントを書き換えます。
すべて、許可なく。
不要な変更のレビューと元に戻すのに 1 時間: $150。週 3 回で $450/週。開発者 1 人あたり。
5 人チームなら、誰も許可していない変更の後始末に週 $2,250 かかっています。
以下の 7 つのルールを CLAUDE.md の挙動セクションに追加します。
→ スコープ内にとどまる:
→ 大きな変更の前に確認する:
→ 破壊的な操作の前に確認する:
→ 本番環境では厳格にストップ:
→ 常に変更内容を表示する:
→ 明示的な確認なしには決して行動しない:
→ コードを書く前に考える:
不要なスコープ変更の元に戻し: 週 1 時間 = $150/週 各タスク後の手動 diff 確認: 週 30 分 = $75/週 挙動関連の無駄（開発者 1 人あたり）: $225/週 5 人チーム: $1,125/週 CLAUDE.md 挙動セクションの設定: 30 分
3 / 3 | メモリ + スタック: Claude Code を本当に信頼できるものにする設定
Claude はセッション間で全てを忘れます。
あなたが下したすべての判断、失敗したすべてのアプローチ、6 ヶ月前に Prisma を Drizzle ではなく選んだ理由、特定のクライアント要件による制約。
忘れてしまいます。そして、あなたがすでに除外したものを提案してきます。
このセクションは、現在存在する最もリアルなメモリに近いものを Claude に与えます。また、テクノロジースタックを固定することで、既存のアーキテクチャを壊すツールを提案しなくなります。
→ MEMORY.md の判断ログ:
→ セッション終了時のサマリー:
→ ERRORS.md の失敗ログ:
→ 恒久的な事実リスト:
→ テクノロジースタックを固定する:
→ 難しい判断には拡張思考:
→ 拡散された 4 つのルール:
Karpathy 氏は Claude Code が失敗する 4 つの行動を特定しました。ある開発者がそれらをこの 4 行に凝縮しました。コーディング精度は 65% から 94% に向上しました。
忘れた判断や誤った提案からの回復: 週 2 時間 = $300/週（開発者 1 人） 間違ったスタック推奨や互換性のないツール: $75/週 メモリ関連の無駄（開発者 1 人あたり）: $375/週 5 人チーム: $1,875/週 MEMORY.md + ERRORS.md + スタック設定: 20 分
結論
完全な計算は以下の通りです。
$375/週: 毎セッションのコンテキスト再説明 $225/週: 許可されていない変更の元に戻し $375/週: 忘れた判断からの回復 開発者 1 人あたりの総無駄: $975/週
5 人開発者チーム: $4,875/週 年間: $253,500
CLAUDE.md 設定: 合計 2 時間 Karpathy 氏の 4 つのルールのみ: コーディング精度 65% → 94%
1 つのプレーンテキストファイル。21 のルール。2 時間の作業。
この設定を行った開発者は、判断を記憶し、スコープ内にとどまり、何かを破壊する前に確認し、アーキテクチャを壊すフレームワークを提案しない Claude のバージョンで作業しています。
設定していない開発者は、同じことを繰り返すのに週 $975 も費やしています。
追伸: Karpathy 氏の 4 つのルールから始めましょう。たったの 4 つです。今すぐプロジェクトルートに CLAUDE.md という新しいファイルを作成して貼り付けてください。2 分もかかりません。不足に気づいたら、1 週間に 1 つずつ追加していきましょう。
埋もれてしまう前にブックマークしてください。役に立ったなら、必要としている人に 1 人でいいのでシェアしてください。
