スキル

Karpathy ガイド:1つの CLAUDE.md で Claude Code に慎重にコードを変えさせる

Claude Code のよくあるコーディング落とし穴を減らしたい人向け。ただしガイドは速度より慎重さ寄りなので、単純な誤字や1行修正に全手順は不要。

公式ソース · andrej-karpathy-skills

インストール

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

誰向けか

主に Claude Code でリポジトリを直し、LLM によくあるコーディングの落とし穴を減らしたいなら、この材料が合う。これは Claude Code の振る舞いを改善するための CLAUDE.md で、出典は Andrej Karpathy による LLM コーディングの落とし穴の観察である。

https://x.com/karpathy/status/2015883857489522876

ページには、4つの原則が同じファイルに書かれ、これらの問題に直接対応するとある。入手できるページ本文には、その4つの名称も本文も載っていない。だから自分で名前を付けたり、スローガン一式を作ったりしてはいけない。必要なのは、すでに Claude Code を使っていて、プラグインのインストールを受け入れる人だ。投稿を読むだけで、手元の Claude Code 設定を変えるつもりがない人は、上のリンクだけでよい。

3分で最初の試行を完える

公式の推奨インストールは連続した2ステップで、どちらか欠けると完了ではない。まず Claude Code で次を実行する。

/plugin marketplace add forrestchang/andrej-karpathy-skills

続けてすぐにプラグインをインストールする。

/plugin install andrej-karpathy-skills@karpathy-skills

これは Claude Code のプラグイン設定を書き換える操作であり、読み取り専用の確認ではない。実行前に、今いるのが書き込みたい Claude Code 環境であること、そして両ステップをやり切ることを確認する。marketplace だけ足して install しない、というやり方はダメ。

導入後はまず照合し、いきなりリポジトリを大きく変えない。些細ではない変更意図を1つ選び、Claude Code にどう直すつもりか、どのファイルを触るかを先に説明させ、あなたがうなずいてからコードを書かせる。成功の合図は「速度より慎重」で、先に説明してから手を動かし、大きなパッチをいきなり広げないこと。無関係なモジュールのリファクタを始めたら、まず止める。

使用例

例1:些細ではないコーディング作業。ガイドがある理由は、LLM のコーディング落とし穴に対する Claude Code の振る舞いを改善することだ。作業は「先に CLAUDE.md を照合してから直す」に限定する。入手できるページ本文にその4原則の見出しはないので、自分で作った原則名で実行させることはできない。できるのは「この1ファイルを読み、変更範囲を出す」こと。確認は2点:読んでいるのがこのガイドであること、ファイルを直す前に範囲を出していること。

例2:厳密な手順をフルで使うか判断する。ページは、これらのガイドが速度より慎重さ寄りだと明記している。些細な作業(簡単な誤字、一目で分かる1行修正)は自分で判断し、毎回フルセットにする必要はない。明らかな誤字だけ直すときは、「これは些細な修正なので手順を広げない」と明示する。「明らか」の自動ルールも、例外にできるファイル種別も書かれていない。境界はその場であなたが決める。Agent が誤字修正をリファクタに格上げしたら、この例から外れている。

利用上の境界

これは Claude Code 向けの CLAUDE.md であり、汎用エディタ用のルールパックではない。他製品向けに改名して使う手順はページにない。4つの原則は同じファイルにあるが、入手できるページ本文は「4つあり、これらの問題に対応する」までで止まり、原則の一覧はない。名前を補わず、ファイル内の原文を引用済みであるかのように装わない。

推奨インストールは上の marketplace add のあと plugin install。両ステップが必要。別のインストーラを並べない。出典の観察は Karpathy の投稿にあり、ガイド自体は派生的な使い方なので、その投稿の文脈の代わりにはならない。

最初は「先に説明してから直す」で止める。今の作業を超えるリファクタ、一括の並べ替え、新しい抽象の追加は、先に変更予定ファイルと理由を出させ、あなたが確認してから続ける。些細な修正では手順を自分から下げ、誤字1つにフルセットを使わない。