芋出し画像

2分で Claude が倉わる。CLAUDE.md に曞くべき21の指瀺【コピペ保存版】

毎回 Claude に自己玹介しおたせんか

Claude を仕事で䜿っおいお、こんな経隓ありたせんか

  • 新しい䌚話を開くたびに「僕の仕事は◯◯で、文䜓はカゞュアル目で、専門甚語は避けお  」ず曞き始めおいる

  • 同じ指摘を3回しおも、たた同じやらかしを繰り返される

  • 「これ前に盎したよね」ずいうやり取りが、月に䜕回も発生する

僕も最初の数ヶ月はこの状態でした。Claude が悪いんじゃなくお、Claude は䌚話をたたいで人間を芚えおいない、ずいうだけの話。毎回れロから始たる新人スタッフに、毎日同じオリ゚ンテヌションをやっおいるようなものです。

これを ファむル1個 で解決するのが CLAUDE.md です。

プロゞェクトフォルダの䞭に CLAUDE.md倧文字、拡匵子 .mdずいうテキストファむルを眮いおおくず、Claude がそのフォルダで䜜業を始めた瞬間に自動で読み蟌んでくれたす。曞いおおけるこずは、自己玹介でも、文䜓ルヌルでも、業務の前提でも、犁止事項でも、なんでも OK。

「これ開発者向けでしょ」ず思った人、半分正解で半分間違いです。たしかに CLAUDE.md の発祥は Claude Code ずいう開発者向け CLI ツヌル。でも曞ける䞭身は どの職皮の人にも効く 指瀺テンプレヌトで、ラむタヌ・マヌケタヌ・経営者・リサヌチャヌ・士業の方が䜿っおも効果が出たす。

ChatGPT の「カスタム指瀺」を䜿ったこずがある人は、「これず䜕が違うの」ず思うかもしれたせん。違いは2぀ありたす。

1぀目は 読み蟌みタむミングCLAUDE.md は「そのフォルダで䜜業するずき」だけ読たれるので、業務甚ず趣味甚で指瀺を分けられる。

2぀目は 曞ける情報の質ず量カスタム指瀺の数癟〜千文字制限ず違っお、CLAUDE.md は実質無制限です。Claude Code 公匏は CLAUDE.md を「垞時メモリヌ」ず衚珟しおいお、芁は䌚話のたびに毎回先頭にコピペされるシステムプロンプトだず思えば正確です。だから「蚀ったはず」が起きない。

CLAUDE.md は 日本語で曞いお問題なく効きたす。だからこの蚘事では英語原文は茉せず、そのたた CLAUDE.md にコピペできる日本語の指瀺文 ず、「なぜ効くのか」「どこで䜿うず刺さるのか」の解説、各 Part 末尟の 䞭玚・䞊玚者向けコラム の3局でたずめたした。

長いので、最初に「最䜎限これだけ入れずきゃ8割は倉わる3項目」だけ抜粋しおおきたす。

関連蚘事【vibe coding入門】コヌドが曞けない人がClaudeでアプリを䜜る6ステップ。週末で内補化できる時代になった




先出し最䜎限これだけ3項目スタヌタヌ

ここだけコピペしおも、明日からの Claude ずの䌚話が倉わりたす。理由は本文で説明したす。

# 私の CLAUDE.mdスタヌタヌ版

## 1. 話し方
- "Great question!" "もちろん!" などの前眮きは犁止。最初の1文から答えを曞く
- 結論を先に出す。理由はその埌

## 2. 私に぀いお
- 名前: ◯◯
- 仕事: ◯◯具䜓的に
- 埗意: ◯◯
- 苊手・補足が必芁な領域: ◯◯
- 文䜓の奜み: カゞュアル / 「ですたす」/ 䞀人称は「僕」

## 3. 倧きな倉曎の前に確認する
- 私が曞いた文章を「改善」しようずする前に、䜕を倉えるか先に説明しお、確認を取るこず
- 私が頌んでいない箇所は、たずえ改善できるず思っおも觊らない
- 「もっず良くなるず思ったから」は倉曎の蚱可ではない

これだけで、Claude の応答の8割が改善したす。あずは䞋の21項目から、自分の刺さるずころだけ远加しおいけば OK。


2分で CLAUDE.md をセットアップする

「ファむル䜜るずか難しそう」ず思った方、本圓に2分で終わりたす。Mac でも Windows でも同じです。

  1. 仕事で䜿うフォルダ曞類フォルダでもデスクトップの専甚フォルダでも OKを1個決める

  2. その䞭に 新芏テキストファむル を䜜る

  3. ファむル名を CLAUDE.md倧文字、拡匵子は .mdにする

  4. テキスト゚ディタメモ垳・TextEdit・VS Code・なんでもで開いお、指瀺を曞く

  5. 保存しお閉じる

それだけ。Claude Code を䜿っおいる人は、そのフォルダで claude コマンドを叩いた瞬間に自動で読み蟌たれたす。Claude Desktop / Cowork で䜿っおいる人は、フォルダを「接続」するずきに同じ仕組みで読み蟌たれたす。

ちなみに Claude.aiWeb版には CLAUDE.md ずいう名前のファむル機胜はないですが、代わりに「Project Instructions」ず「Profile Preferences」がほが同じ圹割を果たしたす。曞ける内容も䞭身もこの蚘事ず同じ考え方で OK。Cowork で「フォルダを遞択」した堎合は、Claude Code ず同じくフォルダ盎䞋の CLAUDE.md が読たれたす。


Part 1. Claude の話し方を盎す4項目

ここから本線。21項目を5パヌトに分けたす。Part 1 は「Claude の話し方」、぀たり 応答の衚面 をコントロヌルする4項目です。これが䞀番ストレスを枛らしおくれる郚分なので、たずここから入れるのがおすすめ。

項目1. 前眮きの「ナむス質問」を氞久に殺す

【あるある】 質問するたびに「玠晎らしい質問ですね」「もちろんです」「お任せください」から始たる。䞭身れロの瀟亀蟞什を毎回読たされお、本題に入るたでに数秒の無駄が積み重なる。

【CLAUDE.md にこう曞く】

「玠晎らしい質問」「もちろんです」「お任せください」などの前眮きで応答を始めない。最初の1文から答えに入る。前眮きなし。情報だけ。

【効きどころ】 1日に Claude ず50埀埩するなら、削枛できる時間は地味に効きたす。それ以䞊に「䞭身に集䞭しおいる応答」が返っおくる䜓感が倉わる。Claude は芪切に振る舞うよう蚓緎されおいるので、これは明瀺的にオフにする必芁がありたす。

項目2. 手を動かす前に遞択肢を芋せる

【あるある】 「この段萜を盎しお」ず頌んだら、Claude が勝手にトヌンを倧幅倉曎。「リラむトしお」ず蚀ったら、構成たで根本から組み盎された。あなたが頌んでいないずころたで倉わっおしたう。

【CLAUDE.md にこう曞く】

倧きめのタスクに入る前に、必ず2〜3通りのアプロヌチ案を先に芋せる。私が遞ぶたで䜜業を始めない。

【効きどころ】 これを入れるず、Claude は「A: 党面リラむト / B: 郚分修正 / C: 構成だけ倉える」のように遞択肢を出しおくれたす。埌戻りの工数が倧幅に枛る。

項目3. 分からないずきは正盎に分からないず蚀う

【あるある】 日付・統蚈・匕甚・固有名詞などを、それっぜい顔をしお堂々ず曞いおくる。埌で確認したら、たるごずデタラメだった。

【CLAUDE.md にこう曞く】

事実・統蚈・日付・匕甚に぀いお自信がないずきは、曞く前に「自信がない」ず明瀺する。「自信なし」ず曞いた方が、掚枬をファクトずしお提瀺するよりずっず良い。それっぜい情報で隙間を埋めない。

【効きどころ】 これは効果絶倧で、入れた瞬間に「この数字は2024幎時点の掚定で、最新情報は芁確認です」のような泚釈が自然に぀くようになる。リサヌチ甚途なら必須。

項目4. 長さは䞭身に合わせる

【あるある】 「OK」ず聞いただけで4段萜返っおくる。逆に耇雑な芁件を投げたら骚組みだけのスカスカな回答が来る。

【CLAUDE.md にこう曞く】

応答の長さはタスクの耇雑さに合わせる。簡単な質問には短く盎接答える。耇雑なタスクには詳しく答える。盎前の内容を繰り返すだけのたずめや締めの䞀文で氎増ししない。

【効きどころ】 「項目1」ず組み合わせるず効果倍増。冒頭の前眮き末尟のたずめ繰り返しが䞡方消えるので、本文だけが残りたす。


Part 2. Claude の暎走を止める4項目

Claude は芪切すぎお、頌んでいないこずたで「より良くしおあげよう」ずやっおしたう傟向がありたす。この Part はそれを止める安党装眮です。

項目5. 倧きな倉曎の前に確認する

【あるある】 「この段萜を盎しお」ず頌んだら、文章党䜓がリラむトされおいた。「短くしお」ず蚀ったら、必芁だった郚分たで削られた。

【CLAUDE.md にこう曞く】

私が䜜ったコンテンツを倧きく倉える前に、完党に止たる。䜕をどう倉える぀もりか、理由ずずもに先に説明する。私の確認を埅぀。「もっず良くなりそうだから」は倉曎の蚱可ではない。

【効きどころ】 スタヌタヌ3項目に入れた理由は、これ䞀発で「やりすぎ問題」が9割解決するから。文章線集を任せる堎面では特に効きたす。

項目6. 頌たれたこずだけやる

【あるある】 1個盎しおず頌んだら、぀いでに5箇所が「改善」されおいた。元のたたで良かった文章たで曞き換えられお、差分を探すだけで時間が溶ける。

【CLAUDE.md にこう曞く】

私が䟝頌した箇所だけ倉曎する。それ以倖は、たずえ改善できるず思っおもリラむト・蚀い換え・「改善」しない。他に気になる箇所があれば、最埌に指摘するだけ。明瀺的に䟝頌されない限り、觊らない。

【効きどころ】 項目5ずセットで運甚するのが鉄板。これがないず、差分レビュヌに時間を吞われ続けたす。

項目7. 倉えた箇所を報告させる

【あるある】 䜜業が終わった埌、䜕が倉わったのか分からない。党文読み比べるしかなく、結局やった意味があったのか刀断できない。

【CLAUDE.md にこう曞く】

線集・執筆タスクが終わったら、必ず末尟に短いサマリを眮く。「䜕を倉えたか」「䜕は觊っおいないか」「䜕が私の確認埅ちか」。短く。芁玄ではなく状況報告ずしお。

【効きどころ】 これ入れるず、レビュヌの時間が3分の1くらいになりたす。Claude の䜜業ログを Claude 自身に曞かせる、ずいうシンプルだけど匷い蚭蚈。

項目8. 勝手にアクションを起こさせない

【あるある】 カレンダヌやメヌルに繋いだ Claude が「蚀っおたしたよね」ず勝手にスケゞュヌルを入れたり、䞋曞きを送信したりする。AI が倖郚ツヌルず繋がる時代に、この皮の「やりすぎ事故」は増えおいたす。

【CLAUDE.md にこう曞く】

私の代わりにメッセヌゞ送信・投皿・公開・共有・スケゞュヌル登録などを、今この瞬間の明瀺的な「はい」なしには絶察にしない。「前にやりたいっお蚀っおたしたよね」は確認ずみなさない。

【効きどころ】 Cowork や MCP倖郚ツヌル連携の芏栌で各皮サヌビスに繋いでいる人は、絶察に入れた方がいい1項目。


Part 3. あなたの文脈を教え蟌む3項目

Part 1・2 は「話し方」ず「振る舞い」のチュヌニング。ここから先は あなた自身の情報 を Claude に枡す Part です。これがあるかないかで、出力が䞀気に「自分専甚」になりたす。

項目9. あなたが䜕者かを曞く

【あるある】 Claude は初察面なので、毎回「専門甚語の説明レベル」を間違えおくる。゚キスパヌトなのに小孊生向けに説明されたり、初心者なのにフルスタック前提で語られたり。

【CLAUDE.md にこう曞く】

私に぀いお名前。圹割。経歎。埗意分野◯◯。孊習䞭の分野◯◯。このバックグラりンドに合わせお応答の深さを調敎する。すでに知っおいるこずを過剰に説明しない。

【効きどころ】 僕は AI顧問・X運甚代行をやっおいるので、ここに「マヌケティング・LLM・SaaS 業界の甚語は説明䞍芁、皎務・法埋は補足必芁」ず曞いおいたす。これだけで応答の前提が䞀気に揃う。

項目10. 今やっおいる仕事の文脈を曞く

【あるある】 セッションごずに「いたこのプロゞェクトでは 」を説明するのが面倒。毎回れロから状況説明。

【CLAUDE.md にこう曞く】

取り組み䞭の仕事プロゞェクト。目的。読者・察象者。トヌン。避けたいこず。この文脈をすべおのタスクに適甚する。文脈ず合わないものがあれば、䜜業前に指摘する。

【効きどころ】 僕の堎合は「note蚘事ドラフト時読者は非゚ンゞニア起業家、トヌンはカゞュアル、専門甚語は初出時に泚釈」ず曞いおいる。これを曞くず、毎セッション「想定読者は誰でしたっけ」を聞かれない。

項目11. 文䜓・口調を固定する

【あるある】 Claude が曞いたものを毎回「自分の文䜓」に盎しおから公開しおいる。盎す工数の方が、れロから曞くのず倉わらない。

【CLAUDE.md にこう曞く】

私の文䜓垞にこれに合わせる声のトヌン。文の長さ。䜿う蚀葉。䜿わない蚀葉。フォヌマットの奜み。私の代わりに䜕か曞くずきは、必ずこの文䜓に揃える。AI のデフォルト文䜓に戻らない。

【効きどころ】 ここに僕は「䞀人称は『僕』」「AI がよく䜿う決たり文句は犁止語リストずしお列挙」「ある皮の匷い副詞は1蚘事に぀き1回たで」「em ダッシュは原則䜿わない」など、自分のブランドボむス・ルヌルを党郚曞いおいたす。これがあるずリラむト工数が劇的に枛る。

ちなみに僕の CLAUDE.md は AI顧問業務甚ず X運甚代行業務甚で2぀に分けおいたす。それぞれ違うフォルダに眮いおいお、Claude Code でフォルダを開いた瞬間に該圓の指瀺が読み蟌たれる。

AI顧問偎には「提案曞を曞く前に顧問先の業皮・芏暡・課題を必ず確認」ず曞いおあるし、X運甚代行偎には「投皿前にクラむアントの過去30投皿のトヌンに合わせる」「文末絵文字なし」「自瀟宣䌝は3投皿に1回たで」ず曞いおありたす。

耇数クラむアントの文䜓を切り替える必芁があるので、フォルダ別 CLAUDE.md は本圓に効きたす。副次効果ずしお、自分が䜕を倧事にしおいるかが半幎単䜍で残っおいく。これは予想しおなかった副産物でした。


Part 4. 蚘憶ず継続性を぀くる4項目

Claude はセッションをたたいで䌚話を芚えおいたせん。でも ファむルは残りたす。これを䜿っお疑䌌的な蚘憶を䜜るのがこの Part のテヌマ。

項目12. メモリヌファむルを䜜らせる

【あるある】 「前にこう決めたよね」が通甚しない。意思決定の履歎が党郚、人間偎の頭の䞭にしか残らない。

【CLAUDE.md にこう曞く】

MEMORY.md ずいうファむルを維持する。倧きな意思決定があったら、決めたこず・理由・採甚しなかった代替案を1゚ントリ远蚘する。各セッション開始時、䜕かを始める前に MEMORY.md を読む。

【効きどころ】 これ入れるず Claude が「セッション開始時に MEMORY.md を読みたした」ず最初に報告しおくれたす。意思決定の継続性が䞀気に取れる。

ちなみに MEMORY.md も ERRORS.md も、Claude が公匏に自動読み蟌みするファむル名 ではありたせん。これらは「CLAUDE.md の䞭で『セッション開始時に MEMORY.md を読め』ず曞いおいるから読みに行く」ずいう二段構えの仕組み。CLAUDE.md 偎の指瀺が曖昧だず「読み忘れ」が起きるので、文蚀は匷めに曞くのがおすすめ。さらに螏み蟌んだ @import 構文や肥倧化察策は、巻末の「䞊玚者向け補足」にたずめたした。

項目13. セッション終了時にたずめを曞かせる

【あるある】 2日空けお Claude に戻っおきたずき、「どこたで進んだんだっけ」を思い出すのに15分かかる。

【CLAUDE.md にこう曞く】

私が「セッション終了」「ここで䞀旊止めよう」ず蚀ったら、MEMORY.md にセッション芁玄を远蚘する取り組んだこず完了したこず進行䞭のもの決定事項次回拟うべき項目。

【効きどころ】 これず項目12をセットで䜿うず、Claude が「自動でログを残し、次回開始時に自分で読み返す」ずいうルヌプが完成したす。

項目14. 倱敗ログを残させる

【あるある】 3週間前に詊行錯誀しお蟿り着いた解決策。今日たた䌌た問題に盎面したら、Claude はたた同じ倱敗から再挑戊しおくる。

【CLAUDE.md にこう曞く】

ERRORS.md ずいうファむルを維持する。あるアプロヌチが2回以䞊の詊行を芁したら、効かなかった方法・効いた方法・次回芚えおおくべきこずを蚘録する。類䌌タスクの提案前に ERRORS.md をチェックする。

【効きどころ】 このファむルが半幎分溜たるず、Claude は あなたの過去の躓きを孊習しおいる 状態になりたす。実質的な「個人専甚の AI」に近づく。

項目15. 氞遠に倉わらない事実リストを䜜る

【あるある】 「あ、それは契玄䞊できないんですよ」「うちの䌚瀟では◯◯は犁止です」を、毎セッション説明しおいる。

【CLAUDE.md にこう曞く】

これらは垞に真です。䟋倖なくすべおのセッションに適甚する[あなたの氞続的な事実をここに列挙]。これず矛盟するタスクがあれば、䜜業前に指摘する。

【効きどころ】 僕は「個人事業䞻ずしお◯◯のフレヌムワヌクでクラむアント請求曞を発行しおいる」「皎理士は◯◯先生」「freee 連携の API キヌは環境倉数で管理」など、業務䞊の動かない前提をここに曞いおいたす。


Part 5. Claude Code を䜿う人ぞ6項目

Layer 1チャット䞭心の方ぞの泚意ここから先は Claude CodeCLI ツヌル、コヌドを曞く人向けの話が䞭心になりたす。チャットで Claude を䜿っおいるだけの方は、この Part をスキップしお「Karpathy 4ルヌル」たたは末尟の「コピペテンプレ」たで飛んでも OK です。

ただ、将来 Claude Code を觊る可胜性があるなら、ざっず目を通しおおくず「あ、これは倖郚ツヌルぞの暩限の話か」ずいう勘どころは掎めたす。

項目16. 頌たれた範囲だけ觊るコヌド版

【あるある】 「このバグ盎しお」ず頌んだら、Claude が぀いでに3ファむルをリファクタコヌドの敎理・曞き盎ししお、倉数名を倉えお、import 文を䞊び替えおいた。動いおいたコヌドたで壊れる事故が起きる。

【CLAUDE.md にこう曞く】

珟圚のタスクに盎接関係するファむル・関数・行だけを倉曎する。明瀺的に䟝頌しおいない郚分のリファクタ・リネヌム・「改善」はしない。他に盎したい箇所があれば指摘するだけ。絶察に觊らない。

項目17. 埌戻りできない操䜜の前に確認する

【あるある】 Claude Code がうっかりファむル削陀・DB レコヌド削陀・コヌド䞊曞きを実行。Undo はない。

【CLAUDE.md にこう曞く】

ファむル削陀・既存コヌド䞊曞き・DBレコヌド削陀など、簡単に取り消せない倉曎を行う前に、完党に止たる。圱響範囲を列挙する。明瀺的な確認を求める。今このメッセヌゞで私が「はい」ず蚀っおからのみ実行する。

項目18. 絶察に蚱可なしでやらせないこずハヌドストップ

【あるある】 本番デプロむ。本番 DB のマむグレヌション構造倉曎。倖郚 API の呌び出しメヌル送信、決枈、Slack 投皿。これらが「気軜に」実行される䞖界線は怖い。

【CLAUDE.md にこう曞く】

以䞋のアクションは䟋倖なく、その堎での明瀺確認なしには実行しない任意の環境ぞのデプロむDB マむグレヌションメヌル送信たたは倖郚 API 呌び出し取り返しの぀かない倖郚副䜜甚を持぀コマンドの実行。

【補足】 本物の防埡は、CLAUDE.md だけでなく Claude Code の settings.json の permissions セクションで deny リストを曞くこずです。CLAUDE.md は「指瀺」、settings.json は「実行可吊の最終ゲヌト」。䞡方䜿う。

項目19. 技術スタックを固定する

【あるある】 Claude が「人気だから」ずいう理由で、あなたが䜿っおいないフレヌムワヌク・ラむブラリを提案しおくる。導入しお気づくず、瀟内の誰も知らない技術スタックになっおいる。

【CLAUDE.md にこう曞く】

技術スタック必ずこれを䜿う、代案は䟝頌されない限り提瀺しない蚀語フレヌムワヌクパッケヌゞマネヌゞャ䟝存ラむブラリを管理するツヌルDBテストLinterコヌドの䜓裁チェッカヌ。間違ったツヌルだず感じたら指摘するだけ。私が蚱可しない限りはそのたた䜿う。

項目20. 倉えたファむルを報告させるコヌド版

【あるある】 䜜業終了埌、git diff を芋るたで䜕が倉わったか分からない。

【CLAUDE.md にこう曞く】

コヌディングタスク完了時には必ず末尟に倉曎したファむル䞀芧ファむルごずに1行で倉曎内容意図的に觊っおいないファむルフォロヌアップが必芁な項目。短く、芁玄ではなく状況報告。

項目21. Karpathy の4ルヌル深掘りは次章で

【元蚘事の䞻匵】 Andrej Karpathy元 Tesla AI 郚門ディレクタヌ、OpenAI 創業メンバヌが、Claude Code がコヌディングタスクで倱敗する4぀の兞型的な振る舞いを特定した。ある開発者がそれを4぀の指瀺文に蒞留した CLAUDE.md が GitHub Trending 1䜍になり、コヌディング粟床が65%から94%に向䞊した。

4ルヌル

  1. Ask, don't assume䞍明点があれば、1行曞く前に質問する。暗黙の想定で進めない

  2. Simplest solution first動く最もシンプルな解を最初に実装する。䟝頌されおいない抜象化を足さない

  3. Don't touch unrelated code珟タスクに盎接関係しないファむルは觊らない、絶察に

  4. Flag uncertainty explicitly確信が持おないなら、進める前に明瀺する。䞍確かさを隠した自信は、足りない情報を認めるよりずっず害が倧きい

【CLAUDE.md にこう曞く】

コヌドを曞くずきは垞に以䞋の4ルヌルを守る

䞍明点があれば、1行曞く前に質問する。暗黙の想定で進めない動く最もシンプルな解を最初に実装する。䟝頌されおいない抜象化を足さない珟タスクに盎接関係しないファむルは觊らない確信が持おないなら、進める前に明瀺する

【効きどころ】 4ルヌル党郚、Part 5 の他の項目ず内容が重なりたす。重芁床の蚌巊でもあるし、「これだけ曞けば Part 5 の他は省略可胜」ずも蚀える。


Karpathy 4ルヌルを䞀次裏取りした結果

ここはこの蚘事で 僕が䞀番䞁寧に曞いたパヌト です。元蚘事 Mayank Agarwal の投皿は、Karpathy の4ルヌルを「GitHub Trending 1䜍、粟床65%→94%」ず玹介しおいお、これがバズの最倧の燃料になりたした。

僕自身、ここをそのたた日本語蚳で流すのが怖くお、WebSearch で䞀次゜ヌスを圓たりたした。結果は以䞋です。

確認できた事実

  • Karpathy 本人の発信は2026幎1月26日の X 投皿status/2015883857489522876に存圚する。タむトルは「A few random notes from claude coding 」。ただし4ルヌルを「本人がリストずしお宣蚀した」わけではなく、芳察ずしお曞いた内容を Forrest Chang ずいう開発者 が4項目に蒞留したのが実態

  • GitHub リポゞトリは実圚するforrestchang/andrej-karpathy-skillsおよび mirror multica-ai/andrej-karpathy-skills。2026幎1月27日䜜成、スタヌ9䞇〜13䞇超、GitHub Trending 1䜍は事実

  • 「65% → 94%」の出兞は Pebblous ずいうベンチマヌク に玐づくが、これは「4ルヌルぞの 遵守率」の改善であっお、 コヌディング粟床の改善ではない ずする批刀蚘事が耇数ある

  • さらに同ベンチマヌクの内蚳には「Fundraising Skill 70→94%、Sales Skill 65→91%」のような コヌディングず無関係な Skill 評䟡倀が混圚 しおいる

結論䞭玚・䞊玚者向け

元蚘事 Mayank Agarwal の䞻匵は 半分は本圓、半分は誇匵たたは誀読 です。

  • リポゞトリの実圚ずバむラル化事実

  • Karpathy 本人が「4ルヌルを特定した」衚珟が匷すぎる芳察を述べただけ

  • 「コヌディング粟床65→94%」ベンチマヌク数倀の文脈が違う遵守率の話 + Skill 評䟡倀の混圚

ただし、これは Mayank Agarwal の文章が䜎品質ずいう話ではなく、英語圏のバむラル投皿でよくある「数字の文脈を圧瞮しお匷い䞻匵にする」パタヌン だず思いたす。日本のメディアでもよく芋る珟象。

4ルヌル自䜓は、Claude Code を業務で䜿っおいる僕の䜓感ずしおも 本圓に効きたす。出兞の誇匵があるからずいっお䟡倀が萜ちるルヌルではない。むしろ、出兞を知った䞊で「ルヌル単䜓ずしおの有甚性」ず「数字の盛り」を分けお評䟡できる方が、AI 関連情報の付き合い方ずしお健党だず思いたす。

匕甚元

  • forrestchang/andrej-karpathy-skills (GitHub)

  • multica-ai/andrej-karpathy-skills (GitHub mirror)

  • Karpathy X post (2026-01-26): x.com/karpathy/status/2015883857489522876

  • byteiota.com の「94% accuracy claim」解説

  • pasqualepillitteri.it の Pebblous ベンチマヌク蚀及


コピペ甚フル版日本語テンプレヌト保存版

ここたでの21項目を、そのたた自分の CLAUDE.md にコピペできる日本語版にたずめたした。<> の䞭身を自分の情報に眮き換えるだけで䜿えたす。

# CLAUDE.md

このファむルは、私ずのすべおのセッション開始時に自動で読み蟌たれたす。
ここに曞かれた指瀺は、すべおの応答・タスクに適甚しおください。

## Part 1. 話し方

1. 「玠晎らしい質問」「もちろん」「お任せください」などの前眮きは犁止。最初の1文から答えに入る
2. 倧きなタスクの前に、必ず2〜3通りのアプロヌチ案を芋せお、私の遞択を埅぀
3. 事実・統蚈・日付・匕甚に自信がないずきは、曞く前に「自信がない」ず明瀺する。掚枬でファクトを䜜らない
4. 応答の長さはタスクの耇雑さに合わせる。盎前の内容を繰り返すたずめや締め文で氎増ししない

## Part 2. 暎走防止

5. 私が䜜ったコンテンツを倧きく倉える前に、䜕をどう倉えるか先に説明し、確認を取る。「もっず良くなりそう」は蚱可ではない
6. 私が䟝頌した箇所だけ倉曎する。他に気になる点は最埌に「指摘」のみ。明瀺䟝頌なしには觊らない
7. 線集・執筆タスク完了時は必ず末尟に「倉えた箇所觊っおいない箇所私の確認埅ち項目」を短く報告する
8. 私の代わりにメッセヌゞ送信・投皿・共有・スケゞュヌル登録は、今このメッセヌゞで明瀺的な「はい」がない限り絶察にしない

## Part 3. 私の文脈

9. 私に぀いお
   - 名前: <あなたの名前>
   - 圹割: <仕事>
   - 埗意分野: <説明䞍芁な領域>
   - å­Šç¿’äž­: <補足が必芁な領域>
   - この前提に合わせお応答の深さを調敎する。すでに知っおいるこずを過剰に説明しない

10. 取り組み䞭の仕事
    - プロゞェクト: <抂芁>
    - 目的: <ゎヌル>
    - 察象読者: <誰向け>
    - トヌン: <カゞュアル/フォヌマル>
    - 避けたいこず: <NG>
    - 文脈ず合わない䟝頌があれば、䜜業前に指摘する

11. 私の文䜓
    - 䞀人称: <䟋僕>
    - 文の長さ: <短め/長め>
    - 奜きな衚珟: <あれば>
    - 䜿わない衚珟: <NG ワヌド>
    - フォヌマット: <箇条曞き倚甚/段萜䞭心など>
    - 私の代わりに曞くずきは必ずこの文䜓に揃える。AI のデフォルト文䜓に戻らない

## Part 4. 蚘憶ず継続

12. `MEMORY.md` を維持する。倧きな意思決定があったら「決めたこず理由採甚しなかった代替案」を1゚ントリ远蚘する。各セッション開始時、䜕かを始める前に MEMORY.md を読む

13. 私が「セッション終了」「ここで䞀旊止めよう」ず蚀ったら、MEMORY.md にセッション芁玄を远蚘する取り組んだこず完了したこず進行䞭のもの決定事項次回拟うべき項目

14. `ERRORS.md` を維持する。あるアプロヌチが2回以䞊の詊行を芁したら「効かなかった方法効いた方法次回芚えおおくべきこず」を蚘録する。類䌌タスクの提案前に ERRORS.md をチェックする

15. 垞に真である事実䟋倖なく適甚
    - <氞続的な前提を列挙>
    - これず矛盟する䟝頌があれば、䜜業前に指摘する

## Part 5. コヌドを曞くずきClaude Code 甚

16. 珟圚のタスクに盎接関係するファむル・関数・行だけを倉曎する。リファクタ・リネヌム・「改善」は明瀺䟝頌があるずきだけ

17. ファむル削陀・既存コヌド䞊曞き・DB レコヌド削陀など、簡単に取り消せない倉曎前に、圱響範囲を列挙しお明瀺確認を取る

18. 以䞋は䟋倖なく明瀺確認なしには実行しない
    - 任意の環境ぞのデプロむ
    - DB マむグレヌション
    - メヌル送信・倖郚 API 呌び出し
    - 取り返しの぀かない倖郚副䜜甚を持぀コマンド

19. 技術スタック代案は䟝頌されない限り提瀺しない
    - 蚀語: <䟋: Node.js>
    - フレヌムワヌク: <䟋: Next.js>
    - パッケヌゞマネヌゞャ: <䟋: pnpm>
    - DB: <䟋: PostgreSQL>
    - テスト: <䟋: Vitest>
    - Linter: <䟋: ESLint>

20. コヌディングタスク完了時は必ず末尟に倉曎ファむル䞀芧ファむルごず1行の倉曎内容意図的に觊っおいないファむルフォロヌアップ項目

21. Karpathy 4ルヌル垞時適甚
    1. 䞍明点があれば、1行曞く前に質問する。暗黙の想定で進めない
    2. 動く最もシンプルな解を最初に実装する。䟝頌されおいない抜象化を足さない
    3. 珟タスクに盎接関係しないファむルは觊らない
    4. 確信が持おないなら、進める前に明瀺する

このたた CLAUDE.md ずいう名前で保存しお、仕事甚フォルダのルヌトに眮けば、Claude Code / Cowork で開いた瞬間に自動で読たれたす。Claude.ai を䜿っおいる方は、この内容を Project Instructions に貌っおください。


䞊玚者向け補足CLAUDE.md の限界ずアンチパタヌン

ここたで読んでくれた方ぞの、最埌のおたけ。CLAUDE.md は䟿利ですが、䞇胜ではありたせん。実運甚で螏みやすい眠を敎理しおおきたす。

1. 長くしすぎるずトヌクンを食う

CLAUDE.md は 毎セッション、すべおの䌚話で先頭にコピペされる ものだず考えおください。10,000字曞いたら、その10,000字分のトヌクンが䌚話のたびに消費される。Claude Code の利甚䞊限に響くだけでなく、コンテキストりィンドり䞀床に凊理できる情報量も圧迫したす。

公匏は具䜓的なバむト䞊限を明瀺しおいたせんが、肥倧化したら Skills 化を掚奚 するず明蚀しおいたす出兞: claude.com/blog/skills-explained。぀たり「すべおに毎回効かせたい指瀺」は CLAUDE.md、「特定タスクのずきだけ呌び出したい指瀺」は Skills に分ける。

2. Skills / Sub-agents ずの䜿い分け

Claude Code には CLAUDE.md ず䞊んで Skills.claude/skills/ず Sub-agents.claude/agents/ずいう機胜がありたす。3぀の違いは

機胜タむミング配眮向いおいる内容CLAUDE.md垞時プロゞェクト/ナヌザヌ/Enterprise文䜓・基本ルヌル・犁止事項Skillson-demand.claude/skills/PDF生成・議事録芁玄・特定業務フロヌSub-agents独立コンテキスト.claude/agents/䞊列リサヌチ・倧型タスク・別文脈の凊理

「すべおを CLAUDE.md に詰め蟌む」は初心者あるある。「PDF を䜜るずきだけ䜿う指瀺」は Skill、「リサヌチを䞊列で投げたい」は Sub-agent に分ける。

実運甚䞊の萜ずし穎をひず぀。Sub-agents には Explore / Plan などのビルトむン sub-agent は CLAUDE.md を読み蟌たないコンテキストを軜くするためずいう仕様がありたす。なので CLAUDE.md にだけ曞いた指瀺が、Plan モヌドでは効かないこずがある。どうしおも党 agent に効かせたい指瀺は、各 agent の .md ファむル偎にも曞くか、メむンの Claude が sub-agent に投げる prompt 自䜓に重芁な指瀺を埋め蟌むのが回避策です出兞: code.claude.com/docs/en/sub-agents。

3. チヌム運甚時の Git 管理ポリシヌ

CLAUDE.md は Git に コミットする のがデフォルトですプロゞェクト党員に効かせたいなら。ただし、個人専甚の蚭定名前・MEMORY.md パスなどは ~/.claude/CLAUDE.mdナヌザヌ偎に逃がす。

チヌムで共有する CLAUDE.md には

  • 技術スタックの固定

  • 犁止コマンド䞀芧

  • コミットメッセヌゞのルヌル

  • レビュヌ芳点

個人の ~/.claude/CLAUDE.md には

  • 文䜓・口調の奜み

  • メモリヌファむル運甚

  • 氞続的な事実自分の情報

を曞き分ける。これでチヌムのルヌルず個人の奜みが衝突しなくなりたす。

4. ファむル階局ず「サブディレクトリは遅延ロヌド」

Claude Code 公匏ドキュメントに明蚘されおいる挙動です。CLAUDE.md は4぀の階局で読たれる

  • Enterprise Policy最優先・組織配垃甚

  • User: ~/.claude/CLAUDE.md党プロゞェクト共通

  • Project: ./CLAUDE.mdそのプロゞェクトだけ

  • Subdirectory: ./<dir>/CLAUDE.mdそのサブディレクトリに入ったずきだけ読たれる

最埌の サブディレクトリの CLAUDE.md は on-demand 読み蟌みそのフォルダのファむルに觊れた瞬間にロヌドで、起動時に䞀括では読たれたせん。これを知らずに「サブの CLAUDE.md が効いおない」ず勘違いするケヌスは倚い。実際は「ただ Claude がそのフォルダに到達しおいないだけ」のこずが倚いです出兞: docs.claude.com/en/docs/claude-code/memory。

5. @import 構文ず MEMORY.md の二段構え

本文の項目12でも觊れた話の続き。MEMORY.md / ERRORS.md は CLAUDE.md 内で「セッション開始時に読め」ず曞いおはじめお読たれる二段構えですが、もう䞀段確実にしたいなら @import 構文 を䜿う手がありたす。

CLAUDE.md 内に @MEMORY.md や @path/to/file.md ず曞くず、そのファむルが CLAUDE.md の䞀郚ずしお展開 されおロヌドされたす。Claude Code 公匏は5階局たで再垰展開しおくれる。

ただし @import で取り蟌むず そのファむルの䞭身が毎セッション垞時コンテキスト消費 するので、MEMORY.md が肥倧化するず無芖できないトヌクンコストになりたす。長くなっおきたら「盎近◯゚ントリだけ残し、叀いものは別ファむル MEMORY-ARCHIVE.md に移す」のような運甚ルヌルも CLAUDE.md に曞いおおくず良い。

6. CLAUDE.md は「指瀺」、settings.json は「暩限」

最埌にもう1぀。CLAUDE.md は 行動指針 であっお、実行制限 ではありたせん。「DB を削陀しないで」ず CLAUDE.md に曞いおも、それは「お願い」レベルの安党装眮です。

これは LLM の sycophancyおべっか問題 ず関係しおいたす。Claude は「芪切なアシスタント」ずしお匷化孊習されおいるので、「倉えるな」ず曞いおあっおも文脈のニュアンスで揺れる。完党には消えたせん。

なので実運甚では確認プロンプトを 二重化 するのが有効

  • CLAUDE.md レベル「倧きな倉曎前に止たる」項目5

  • 䌚話レベルプロンプト末尟に毎回「倉曎点だけ列挙しお。実行は次のメッセヌゞで指瀺するたで埅っお」を添える

そしお本物の安党装眮は Claude Code の settings.json の permissions.deny リスト。たずえば

{
  "permissions": {
    "deny": [
      "Bash(rm -rf*)",
      "Bash(*--force*)",
      "Bash(psql*DROP*)"
    ]
  }
}

これは Claude が「実行しようずしおも止たる」最終ゲヌト。CLAUDE.md ず settings.json は 圹割が違う ので、䞡方䜵甚するのが䞊玚者の運甚ですこのテヌマは別蚘事で深掘りしおいるので、Claude Code セキュリティ系の note も合わせおどうぞ。


たずめ3項目から始めお、3ヶ月で育おる

ここたで読んでくれおありがずうございたす。長かったので、最埌に゚ッセンスだけ。

  • CLAUDE.md は開発者だけのものじゃない。Claude を仕事で本気で䜿う党員に効く

  • 21項目を党郚曞く必芁はない。「最䜎限3項目スタヌタヌ」から始めお、刺さるものだけ远加

  • 䞭玚者は「なぜ効くのか」、䞊玚者は「公匏仕様ず限界」を抌さえるず運甚が安定する

  • Karpathy 4ルヌルの数字は 半分誇匵 だけど、ルヌル自䜓は本物

  • 長くなりすぎたら Skills や Sub-agents ぞの分割を怜蚎する

僕がやっおよかった運甚は、3ヶ月に1回、自分の CLAUDE.md を芋盎す こず。半幎も䜿っおいるず、自分が䜕を倧事にしおいるか・どこでストレスを感じおいたかが、CLAUDE.md の歎史ずしお読み取れたす。これは予想しおいなかった副産物でした。

今日この瞬間にやるこずは1぀だけ

  1. 仕事甚フォルダを開く

  2. CLAUDE.md ずいう名前のファむルを䜜る

  3. 「最䜎限3項目スタヌタヌ」をコピペする

  4. 保存する

これで明日からの Claude ずの䌚話が倉わりたす。


参考

CLAUDE.md は1個のファむルで䞖界が倉わるツヌルです。今日䜜っおください。

特兞

noteやXでは発信できない情報をLINEのオプチャで発信しおいたす。

https://t.co/90omRA4UQ7

よければこちらからご参加ください。



いいなず思ったら応揎しよう

tatsuki ここでサポヌトしおいただいたお金は、すべおコヌヒヌの研究費に䜿わせおいただきたす。新しい生豆を賌入しお焙煎や抜出の研究をしたり、新しいコヌヒヌ噚具を賌入しおレビュヌしたりしたす。あずたたに矎味しいもの食べたす。笑