Partnered With:

GitHubのトレンド入り、Claude Codeユーザーの必読ガイド

この記事を読むのに必要な時間は 29 分

クロード・コードに業務手順書を提供してください。

原文タイトル：Karpathy氏のCLAUDE.md がGitHubで1位にランクインし、8.2 万のスターを獲得。ほとんどの開発者がまだ読んでいない。

原文著者：Dep

Editor's Note: 多くの人がClaude Codeを使用する際の最大の問題は、モデルが強力でないことよりも、毎回ゼロから始める必要があることです。

各情報が固定されていない限り、Claudeは推測に頼ることになり、間違ったファイルの変更、要求されていないコードのリファクタリング、プロジェクトに適さないツールの推奨などが発生する可能性があります。

本文で紹介されているCLAUDE.mdは、Claude Codeへのガイドラインです。これをプロジェクトのルートディレクトリに配置するだけで、Claudeは起動時に自動的に読み込みます。これにより、Claudeに事前にプロジェクトについて教えることができます：回答方法、コーディング方法、最初に尋ねるべきこと、勝手に実行してはいけない操作、プロジェクトがどの技術スタックを使用しているか、過去に行われた重要な意思決定など。

要するに、CLAUDE.mdの目的は、繰り返し説明を減らし、モデルの領域外操作を制限し、AIプログラミングをより安定させ、よりコントロール可能にすることです。

Claude Codeを使用している場合は、まずKarpathy氏がまとめた4つのルールから始めてみてください：わからないことは最初に尋ねる、最も単純な解決策を最初に実施する、関係のないコードに触れない、不確実性を明示する。これらのルールをCLAUDE.mdに書き込んだ後、プロジェクトに応じて段階的に追加していくことで、使用体験を大幅に改善できます。

以下は原文です：

CLAUDE.mdというファイルがGitHubのトレンド1位に輝きました。

8.2 万のスター、7800 回のフォーク。

これはAndrej Karpathy氏によるものでした。彼は以前、テスラのAI責任者を務め、OpenAIの創設メンバーでもありました。彼はClaude Codeが失敗する4つの行動をまとめ、それらを1つのファイルに記述しました。

後に、1人の開発者がこれら4つのルールを基にさらに拡張し、このファイルを公開しました。その結果、急速に話題となりました。

理由は非常に明確です：正確さのレベルが65％から94％に向上しました。

しかし、ほとんどの毎日 Claude Code を使用する開発者は、実際にはこの設定を行ったことがありません。彼らは毎回セッションをゼロから始めます：同じ文脈を再説明し、不要な範囲変更をクリーンアップし、誰も要求していないリファクタリングを元に戻します。

以下は完全なファイルです。

ほとんどの開発者が見落としている設定

あなたがClaude Codeを開くたびに、それはデフォルトで何も知りません。

それはあなたのテクノロジースタックを知らず、コーディング規約を知らず、プロジェクトの背景を知らず、あなたが既に試みたことを知らず、３回前にあなたが明確にしないことを知りません。

ですので、それは単なる推測しかできません。そして一旦それが推測し始めると、あなたが動かしてほしくなかったコードをリファクタリングし、既存のアーキテクチャを破壊するフレームワークを推奨し、確認せずにファイルを削除し、以前に行った決定を覆す可能性があります。

CLAUDE.md はプロジェクトのルートディレクトリに配置されるプレーンテキストファイルです。Claude Code は各セッションの開始時に自動的にそれを読み込みます。

１度の設定で繰り返しの説明が不要になり、高コストの３つのエラーを修正できます。

デフォルト設定：週に375ドルを自己説明するだけで消費

通常の開発者は、Claudeにコンテキストを再説明するのにおよそ30分かかります。

テクノロジースタック、コーディング規約、プロジェクトの背景、試みたことのあるメソッド—これらの情報は、一度に書き留め、Claudeが毎回自動的に読み込まない限り、異なるセッション間で保持されません。

開発者の時給が150ドルとして：

・毎日30分は75ドルです；

・週に375ドルになります。

・5人チームの場合、週には1875ドルの隠れたコストがかかります。

以下の7つのルールは、CLAUDE.md ファイルの先頭に配置する必要があります。

→ 余計なことは省く

回答する際には、「素晴らしい質問」「もちろんできます」「問題ありません」といった前置きを使用しないでください。直接回答してください。挨拶は不要であり、質問の再述も行わないでください。

→ タスクに応じた回答長

回答の長さはタスクの複雑さに合わせるべきです。簡単な質問には直接的かつ簡潔な回答を；複雑なタスクには完全かつ詳細な説明を行ってください。回答において、質問の再述や結論の繰り返しによる文章の膨張は避けてください。

→ アクションの前にソリューションを提示

重要なタスクを開始する前に、2–3つの実行可能なアプローチを提示し、私が選択した後に作業を継続してください。

→ 損失が確定する前に、不確実性を認める

事実、データ、日付、または技術情報に自信がない場合は、引用する前に明示的に述べてください。一見合理的な情報で知識の欠落を埋めようとしないでください。迷っている場合は、その状況を遠慮なく認めてください。

→ 私は誰で、何を知っているか

自己紹介: [名前] / 役割: [あなたの役割] / バックグラウンド: [領域]。

得意なこと: [習熟している内容]。

まだ学習中のこと: [知識のギャップ]。

これらの情報に基づいて、各回答の深さを調整してください。私がすでに知っている内容を過度に説明したり、必要なバックグラウンドを省略したりしないでください。

→ 現在のプロジェクトコンテキスト

私が取り組んでいること: [プロジェクト名] / ゴール: [具体的な結果] / 対象ユーザー: [誰が使用するか] / 技術スタックの背景: [関連する制約事項] / 回避すべき点: [リスト]。

これらのコンテキストをすべてのタスクに適用してください。コンテキストと一致しない要件がある場合は、実行前に指摘してください。

→ あなたの表現スタイルを固定する

私の執筆スタイル: [あなたの表現スタイルの説明]。

文の長さ: [好み]。

よく使う単語: [例]。

絶対に使用しない単語: [例]。

フォーマット: [散文または構造化]。

あなたが私を代表して何かを書く際には、厳密にこのスタイルに従ってください。独自の表現スタイルをデフォルトとして使用しないでください。

毎日コンテキストを説明する時間: 30分

開発者の時給が 150 ドルの場合：1 日あたり 75 ドル

週ごと：1 人の開発者あたり 375 ドル

5 人チーム：週ごと 1875 ドル

このセクション CLAUDE.md の設定にかかる時間：合計 45 分

避けるべきエラー：CLAUDE.md をゼロから書かないでください。まず、以下のプロンプトを使用してから、出力結果を編集してください：

私から提供された、自分自身について、私のプロジェクトについて、および私がどのように働きたいかに関する情報に基づいて、完全な CLAUDE.md ファイルを作成してください。内容は、次のとおりです：私は誰か、私の技術的バックグラウンド、私のコミュニケーションの好み、および各セッションで遵守すべきデフォルトの動作。具体的でプレーンテキストであり、500 ワード以下である必要があります。

行動の制約：あなたには許可されていない「時給 150 ドル」の変更はありません

あなたはクロードに関数の修正を依頼しました。

その結果、3 つのファイルがリファクタリングされ、変数が名前変更され、インポートが再編成され、あなたが時間をかけて書いたコメントが書き換えられました。

そして、すべてがあなたの確認なしに行われました。

これら不要な変更をレビューして元に戻すには、1 時間かかる場合があります。これは 150 ドルに相当します。週に 3 回発生すると、450 ドルになります。5 人チームの場合、週に 2250 ドルかかります。誰もが認めない変更をクリーンアップするための費用です。

以下の 7 つのルールは、CLAUDE.md の行動の制約部分に配置する必要があります。

→ スコープを厳密に制御する

現在のタスクに直接関連するファイル、関数、およびコード行のみを変更します。私が明示的に変更を要求していないコンテンツをリファクタリング、名前変更、再編成、再フォーマット、または「最適化」しないでください。

修正すべき他の場所が見つかった場合は、最後に注釈を付けてください。それに触れないでください。絶対に。

→ 重大な変更を行う前に確認する

私がすでに作成したコンテンツに重大な変更を加える前に、セクションの再執筆、段落の削除、構造のリファクタリング、トーンの変更などを含みますが、まず立ち止まり、変更する内容とその理由を正確に説明し、私が確認した後に継続してください。

→ 破壊的な操作の前に確認が必要

どんなファイルを削除する、既存のコードを上書きする、データベースのレコードを削除する、または依存関係を削除する前に、一旦停止し、具体的にどのような内容に影響するかをリストアップし、私が明示的に確認するよう要求してください。このメッセージで「はい」と言った場合のみ継続してください。

「以前に言及した」は確認とはみなしません。

→ プロダクション環境の操作は必ず一時停止してください

以下の操作は、現在のセッションでの明示的な確認が必要であり、例外はありません：

· どの環境にデプロイまたはプッシュすること；

· マイグレーションを実行するか、データベースの構造を変更すること；

· 任意の外部API呼び出しを行うこと；

· 任意の不可逆的な副作用を持つコマンドを実行すること。

· 私はこのメッセージで明確に「はい」と言わなければなりません。

→ 常に変更内容を表示する

どんなコーディングタスクを完了した後は、エンドには次の内容を含める必要があります：

変更されたファイル：変更されたすべてのファイルをリストアップすること；

変更内容：各ファイルについて一文で説明すること；

意図的に変更されていないファイル；

後続の対応が必要な事項。

→ 明示的な確認がない限り、私に代わって行動してはいけません

このメッセージで私の明確な確認がない場合、私を代表して何らかのコンテンツを送信、公開、共有、または手配してはなりません。メール、カレンダーの招待、ドキュメント共有、またはこの会話の外で発生することなどを含みます。私はこのメッセージで明確に「はい」と言わなければなりません。

→ コーディングに取りかかる前に考えてください

アーキテクチャの決定、複雑な問題のデバッグ、または単純でない機能の開発に関わるタスクにおいては、問題を段階的に整理し、コードを書く前に検討してください。あなたの推論プロセスを示し、不確かな点を指摘した後に実行してください。

週あたりの不要なスコープの変更のロールバック：150ドル

週あたりの手動diffチェック：75ドル

各デベロッパの行動に関連する浪費：週あたり225ドル

5人のチーム：週あたり1125ドル

CLAUDE.mdの行動部分の設定時間：30分

メモリと技術スタック：Claude Codeを本当に信頼性のあるものに設定する

クロードは異なるセッション間ですべてを忘れます。

あなたが下したすべての決定、失敗したすべてのアプローチ、なぜ半年前に Drizzle ではなく Prisma を選んだのか、また特定の顧客要求からのある制約など、それらはすべて忘れられます。

そして、それは以前に除外したはずのアプローチを再度提示します。

この部分は、Claude に「実際の記憶」に最も近いメカニズムを提供すると同時に、あなたのテクノロジースタックをロックし、既存のアーキテクチャを壊す可能性のあるツールを引き続き推奨しないようにします。

→ MEMORY.md デシジョンログ

プロジェクト内に MEMORY.md という名前のファイルを維持します。重要な決定を下した際には、常に新しい記録を追加してください：

・何を決定したか；

・なぜそのように決定したか；

・何を除外し、なぜ除外したか。

各セッションが開始されるたびに、まず MEMORY.md を読み込んでください。リマインダーなしに、記録された決定と矛盾しないようにしてください。

→ セッション終了サマリー

「session end」「wrapping up」「ここで終了しましょう」と言ったときは、MEMORY.md にセッションの要約を記入してください。内容は以下を含みます：

・今回取り扱った内容；

・完了した項目；

・進行中の項目；

・下した決定；

・次回セッションのトッププライオリティ。

→ ERRORS.md 失敗ログ

ERRORS.md という名前のファイルを維持してください。特定のアプローチが2回以上試行しても成功しなかった場合、次の情報を記録してください：

・何がうまくいかなかったか；

・最終的にどのアプローチが成功したか；

・次回注意すべきこと。

同様のタスクに対して提案をする前に、ERRORS.md をチェックしてください。

→ 永続的事実リスト

以下の事実は常にこのプロジェクトに当てはまり、すべてのセッションで例外なく適用する必要があります：

[Your Everlasting Constraints, Architectural Decisions, and Rules]

If a task conflicts with these facts, please point it out before execution.

→ Locked-in Tech Stack

The project's tech stack is as follows; always use these tools. Do not recommend alternative solutions unless I explicitly request:

Language: [e.g., TypeScript]

Framework: [e.g., Next.js 14]

Package Manager: [e.g., pnpm]

Database: [e.g., PostgreSQL with Prisma]

Testing: [e.g., Vitest]

Styling: [e.g., Tailwind CSS]

If a tool seems unsuitable, feel free to point it out. However, unless I explicitly state otherwise, the defined tech stack must be used.

→ Difficult Decision Enablement for Extended Thinking

For issues involving system architecture, performance trade-offs, database design, or long-term technical decisions, please use extended thinking mode.

Analyze the problem step by step, present trade-offs I might not have considered, highlight assumptions that may not hold up at scale, and then provide your recommendation.

→ The 4 Rules that Went Red Hot

Karpathy distilled 4 types of behaviors that would cause Claude Code to fail. A developer condensed them into the following 4 rules. As a result, coding accuracy increased from 65% to 94%.

Ask First, Assume Never.
If anything is unclear, ask before writing the first line of code. Do not make silent assumptions about intent, architecture, or requirements.

Do the Simplest Thing First.
Always implement the simplest working solution first. Do not introduce unrequested abstraction layers or flexibility.

Hands Off Irrelevant Code.
If a file or function is not directly related to the current task, do not modify it. Even if you think it can be optimized, do not touch it.

Explicitly Mark Uncertainties.
If you are unsure about a solution or technical detail, state it before proceeding. Projecting confidence without certainty causes more damage than admitting a knowledge gap.

・毎週、意思決定の忘れと誤ったアドバイスによる回復コスト: 開発者あたり 300 ドル

・誤ったテックスタックの推薦と非互換なツール: 週に 75 ドル

・開発者ごとの記憶に関連する浪費: 週に 375 ドル

・5 人チーム: 週に 1875 ドル

・MEMORY.md + ERRORS.md + テックスタックの設定時間: 20 分