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

forrestchang/andrej-karpathy-skills38.2k

andrej-karpathy-skillsは、AIコーディング助手「Claude Code」の悪い癖を直すための設定ファイル(CLAUDE.md)です。AI研究の第一人者アンドレイ・カーパシーが指摘した「AIが勝手に余計なことをする」「コードを無駄に複雑にする」「関係ない部分まで書き換える」といった問題を、たった4つの原則で改善します。具体的には「考えてからコードを書く」「シンプルさ最優先」「必要な部分だけ変える」「ゴール駆動で動く」というルールをClaude Codeに教え込むことで、まるでベテランエンジニアのように慎重で的確なAIに変えることができます。プログラマーやAIを使って開発をしている人なら誰でも恩恵を受けられるツールです。

🔥 なぜ話題?

AI研究の著名人アンドレイ・カーパシー(OpenAI/Tesla出身)がSNSで投稿した「AIコーディングの落とし穴」が大きな反響を呼び、その課題を実際に解決するツールとして注目を集めています。Claude Codeなどの「AIエージェント(自律的にコードを書くAI)」の利用が急拡大する中、AIの品質管理という実務的なニーズに応えている点がトレンドの理由です。

💡 こう使える!

例えば、Claude Codeに「ログイン画面にバリデーション(入力チェック)を追加して」とお願いした際、通常のAIだと頼んでもいないエラーハンドリングや抽象化を大量に追加して1000行のコードにしてしまいがちですが、andrej-karpathy-skillsを導入すると「まずテストを書いてから必要最小限の50行で実装する」「わからないことは勝手に判断せず質問してくる」「関係ないファイルには触らない」という振る舞いに変わります。

ユースケース: AIにコードを書かせている開発者が、AIの「余計なことをする」「複雑にしすぎる」といった問題行動を減らし、信頼性の高いコードを書かせるために使う。

  • AI研究の権威カーパシーの知見を実用的な設定ファイル1つに凝縮
  • 4原則(考える・シンプル・最小限の変更・ゴール駆動)でAIの悪い癖を矯正
  • Claude Codeプラグインとして簡単に導入でき、既存プロジェクトにも追加可能
GitHubで見る →

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

技術情報

最終更新

2026-04-13

スター数

38,234

フォーク数

3,120

Issue数

60

技術詳細

アーキテクチャ・仕組み

andrej-karpathy-skillsは単一の CLAUDE.md ファイルで構成されています。CLAUDE.md はClaude Code(Anthropic社のAIコーディングエージェント)がプロジェクトのコンテキストとして読み込む設定ファイルで、AIの振る舞いを制御するプロンプト(指示書)として機能します。

4つの原則の詳細

1. Think Before Coding(考えてからコードを書く)

  • 不確かな場合は推測せず質問する
  • 曖昧さがある場合は複数の解釈を提示する
  • よりシンプルな方法がある場合は提案する
  • 混乱したら立ち止まって確認する

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

  • 要求されていない機能を追加しない
  • 一度しか使わないコードに抽象化を入れない
  • あり得ないシナリオのエラー処理を書かない
  • 200行が50行で済むなら書き直す
  • 判定基準: 「シニアエンジニアが複雑すぎると言うか?」

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

  • 隣接するコードやコメント、フォーマットを「改善」しない
  • 壊れていないものをリファクタリングしない
  • 既存のスタイルに合わせる
  • 自分の変更で不要になったインポート等は削除するが、既存の不要コードは削除しない
  • 判定基準: 「変更した各行がユーザーの要求に直接紐づくか?」

4. Goal-Driven Execution(ゴール駆動の実行)

命令的な指示を宣言的なゴールに変換する:

指示変換後
「バリデーション追加」「不正入力のテストを書き、通るようにする」
「バグ修正」「再現テストを書き、通るようにする」
「Xをリファクタ」「リファクタ前後でテストが通ることを確認」

導入方法

  • Claude Codeプラグイン: マーケットプレイスから直接インストール。全プロジェクトに適用可能
  • CLAUDE.mdファイル: プロジェクトルートに配置。既存のCLAUDE.mdに追記も可能

カスタマイズ

プロジェクト固有のルール(TypeScript strict mode、API テスト必須など)を追記して使うことを想定しています。

トレードオフ・注意点

  • 慎重さ > スピード に寄せた設計
  • 単純なタイポ修正や明白な1行変更には過剰な場合がある
  • 非自明な作業でのコストの高いミスを減らすことが主目的

効果の確認方法

READMEでは以下のサインが見られれば効果が出ていると説明:

  • diffに不要な変更が減る
  • 過度に複雑なコードの書き直しが減る
  • 実装前に確認の質問が来る
  • PRがクリーンで最小限になる

ライセンス

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コーディングエージェントに「正しい開発手順」を叩き込む!自律的なソフトウェア開発フレームワーク — superpowers

obra/superpowersShell153.3k

Superpowersは、AIコーディングエージェント(Claude Code、Cursor、Codexなど)に対して、プロのソフトウェア開発者が踏む正しい手順を自動的に守らせるためのフレームワークで

有名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がどの