たった100行のコードでClaude風AIエージェントを作れる究極の学習プロジェクト — learn-claude-code

アーキテクチャ・仕組み

learn-claude-codeの核心は「エージェントループ」と呼ばれるシンプルなパターンです:

1. ユーザーのメッセージをLLM（大規模言語モデル）に送信
2. LLMの応答が「ツール使用」の場合、ツールを実行して結果をメッセージに追加し、ループを継続
3. 「ツール使用」でない場合（テキスト応答）、結果を返してループ終了

このループ自体は変えず、12のセッションで以下の「ハーネス機構」を1つずつ追加していきます。

12セッションの構成

ハーネスの構成要素

ハーネス = ツール + 知識 + 観察 + アクションインターフェース + 権限

ツール:     ファイルI/O、シェル、ネットワーク、DB、ブラウザ
知識:       プロダクトドキュメント、APIスペック、スタイルガイド
観察:       git diff、エラーログ、ブラウザ状態
アクション: CLIコマンド、API呼び出し、UI操作
権限:       サンドボックス、承認ワークフロー、信頼境界

対応環境

• 言語: Python（エージェント実装）、TypeScript/Next.js（Webプラットフォーム）
• 必要なAPI: Anthropic API（ANTHROPIC_API_KEY が必要）
• ドキュメント言語: 英語・中国語・日本語の3言語対応
• CI: GitHub Actions（TypeCheck + Build）

ディレクトリ構成

learn-claude-code/
├── agents/          # Python実装（s01〜s12 + s_full）
├── docs/{en,zh,ja}/ # メンタルモデル重視のドキュメント
├── web/             # インタラクティブ学習プラットフォーム（Next.js）
├── skills/          # s05用スキルファイル
└── .github/workflows/ci.yml

関連プロダクト

• Kode Agent CLI: オープンソースのコーディングエージェントCLI。GLM / MiniMax / DeepSeekなどのオープンモデルに対応
• Kode Agent SDK: アプリ埋め込み用のエージェントSDK。CLIプロセス不要でバックエンドやブラウザ拡張に組み込み可能
• claw0: 常時稼働型エージェント（ハートビート + Cron + IMチャット + メモリ + ソウル）の学習用姉妹リポジトリ

意図的に省略されている範囲（本番用途との違い）

• 完全なイベント/フックバス（PreToolUse、SessionStart/Endなど）
• ルールベースの権限ガバナンス
• セッションライフサイクル制御（再開/フォーク）
• MCP（Model Context Protocol）ランタイムの詳細

ライセンス

MIT（商用利用可能）

git clone https://github.com/shareAI-lab/learn-claude-code
cd learn-claude-code
pip install -r requirements.txt
cp .env.example .env   # .envファイルにANTHROPIC_API_KEYを設定

# 最初のレッスンを実行
python agents/s01_agent_loop.py

# 最終レッスン（全機能統合版）を実行
python agents/s12_worktree_task_isolation.py

# すべての仕組みを統合した集大成版
python agents/s_full.py

Web学習プラットフォーム:

cd web && npm install && npm run dev
# http://localhost:3000 でアクセス