AIコーディングの暴走を防ぐ4原則!Karpathy流Claude Code調教術 — andrej-karpathy-skills

forrestchang/andrej-karpathy-skills52.9k

andrej-karpathy-skillsは、AIコーディングアシスタント「Claude Code」の振る舞いを改善するためのガイドライン(設定ファイル)です。AI研究の第一人者であるAndrej Karpathy氏が指摘した「AIが勝手に間違った前提で突き進む」「コードを無駄に複雑にする」「頼んでいない部分まで書き換える」といった問題を、たった4つの原則をまとめた1つのファイル(CLAUDE.md)で解決します。プログラマーがClaude Codeを使って開発する際に、AIの出力品質を大幅に向上させるための「AIへの指示書」のようなものです。プログラミングでAIアシスタントを使っているすべての開発者に役立ちます。

🔥 なぜ話題?

AI著名研究者のAndrej Karpathy氏がX(旧Twitter)でAIコーディングの問題点を具体的に指摘した投稿が大きな反響を呼び、その知見をすぐに実践できる形にまとめたリポジトリとして注目を集めています。Claude Codeなどの「AIコーディングエージェント」の利用が急速に普及する中、AIの出力品質を制御する実用的なノウハウへの需要が高まっていることが背景にあります。

💡 こう使える!

例えば、チームで開発しているWebアプリのバグ修正をClaude Codeに依頼したとき、通常だとAIがバグとは無関係なコードのスタイルや変数名まで勝手に書き換えてしまい、コードレビューで大量の不要な変更が混じって確認が大変になることがあります。andrej-karpathy-skillsを導入すると、AIが「依頼された修正箇所だけ」を変更し、修正前にテストを書いて検証するようになるため、差分がクリーンで安全なPR(変更提案)を出せるようになります。

ユースケース: AIコーディングアシスタント(Claude Code)を使って開発する際に、AIが余計なことをしないよう行動ルールを設定し、出力品質を高めるために使います。

  • AI研究の第一人者Andrej Karpathy氏の知見を4つの原則に凝縮
  • CLAUDE.mdファイル1つを置くだけで導入でき、プラグインとしてもインストール可能
  • 「コードの過剰な複雑化」「頼んでいない変更」「前提の勝手な決めつけ」といったAI特有の問題を直接解決
  • プロジェクト固有のルールとの併用も可能で柔軟にカスタマイズできる
GitHubで見る →

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

技術情報

最終更新

2026-04-15

スター数

52,912

フォーク数

4,404

Issue数

65

技術詳細

4つの原則の詳細

1. Think Before Coding(コードを書く前に考える)

  • 不確かな場合は推測せず質問する
  • 曖昧さがある場合は複数の解釈を提示する
  • よりシンプルなアプローチがあれば提案する
  • 混乱した場合は止まって確認を求める

2. Simplicity First(シンプルさ優先)

  • 依頼された機能以外は実装しない
  • 一度しか使わないコードに抽象化を加えない
  • 依頼されていない「柔軟性」「設定可能性」を追加しない
  • 起こりえないシナリオのエラーハンドリングを書かない
  • 200行が50行で書けるなら書き直す

3. Surgical Changes(外科的な変更)

  • 隣接するコード・コメント・フォーマットを「改善」しない
  • 壊れていないものをリファクタリングしない
  • 既存のスタイルに合わせる(たとえ自分なら違う書き方をしても)
  • 自分の変更で不要になったインポートや変数は削除するが、元からあった不要コードは触らない
  • 変更した全行がユーザーの要求に直接紐づくかを確認する

4. Goal-Driven Execution(目標駆動の実行)

  • 命令的な指示を検証可能な目標に変換する
  • 例:「バリデーション追加」→「無効な入力のテストを書き、それを通す」
  • 例:「バグ修正」→「バグを再現するテストを書き、それを通す」
  • 複数ステップのタスクはステップごとに検証方法を明記する

仕組み

CLAUDE.mdはClaude Code(Anthropic社のAIコーディングエージェント)がプロジェクトルートで自動的に読み込む設定ファイル。ここにガイドラインを記述することで、Claude Codeのセッション全体の振る舞いを制御できる。

導入効果の判断基準

以下のような変化が見られれば、ガイドラインが機能している証拠:

  • diffに不要な変更が含まれなくなる
  • コードが最初からシンプルに書かれる
  • 実装前に確認の質問が来るようになる
  • PRがクリーンで最小限になる

カスタマイズ

プロジェクト固有のルール(例: TypeScript strict mode使用、全APIエンドポイントにテスト必須など)を追加セクションとして併記可能。

トレードオフ

このガイドラインは速度よりも慎重さを重視する設計。単純なtypo修正や明白な一行変更のような些細なタスクでは、全てのルールを厳密に適用する必要はない。非自明な作業でのコストの高いミスを減らすことが目的。

関連プロジェクト

作者は Multica というコーディングエージェントの管理・実行プラットフォームも開発しており、再利用可能なスキルとしてこのガイドラインを活用できる。

ライセンス

MITライセンス(商用利用含め自由に利用可能)

インストール・クイックスタート

方法A: Claude Codeプラグインとして導入(推奨)

Claude Code内で以下を実行:

/plugin marketplace add forrestchang/andrej-karpathy-skills

次にプラグインをインストール:

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

方法B: CLAUDE.mdファイルとして導入(プロジェクト単位)

新規プロジェクトの場合:

curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

既存プロジェクトに追記する場合:

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

参考になる外部の関連記事

過去のトレンド履歴

関連リポジトリ

WhatsApp・Telegram・Slack…22以上のチャットアプリを1つのAIアシスタントに統合! — openclaw

openclaw/openclawTypeScript301.9k

OpenClawは、自分のパソコンやサーバーで動かせる個人用AIアシスタントです。WhatsApp、Telegram、Slack、Discord、LINE、iMessageなど22以上のメッセージアプ

自分のパソコンでAIを動かそう!最新の大規模言語モデルをワンコマンドで実行 — ollama

ollama/ollamaGo168.0k

Ollamaは、ChatGPTのようなAIモデルを自分のパソコン上で簡単に動かせるツールです。通常、AIモデルを使うにはクラウドサービスへの課金や複雑な環境構築が必要ですが、Ollamaを使えばたった

AIへの「話しかけ方」が14万人に支持された世界最大のプロンプト集 — prompts.chat

f/prompts.chatHTML157.4k

prompts.chatは、ChatGPTやClaude、Geminiなど様々なAIチャットツールで使える「お手本の質問文(プロンプト)」を集めた世界最大のオープンソースライブラリです。2022年12

有名AIツールの「裏側の指示書」を大公開!開発者の秘密が丸見え — system-prompts-and-models-of-ai-tools

x1xhlol/system-prompts-and-models-of-ai-tools124.7k

Claude、Cursor、Devin AI、Perplexityなど、話題のAIツールが内部で使っている「システムプロンプト(AI への指示書)」や開発ツールを大量に集めたリポジトリです。AIがどの

AIコーディングアシスタントを最強にチューニング!28エージェント×119スキルの包括的パフォーマンス最適化システム — everything-claude-code

affaan-m/everything-claude-codeJavaScript103.3k

everything-claude-codeは、Claude CodeやCodex、Cursorなどの「AIコーディングアシスタント」の性能を最大限に引き出すための総合チューニングシステムです。28種