gh

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

shareAI-lab/learn-claude-codeTypeScript43.4k

learn-claude-codeは、Anthropic社のClaude Codeというコーディングエージェントがどのような仕組みで動いているかを、12段階のレッスンで段階的に学べる教材リポジトリです。AIモデル（頭脳）そのものではなく、AIモデルが実際に仕事をするための「ハーネス（道具・環境・作業場）」を設計する技術に焦点を当てています。たとえるなら、AIが優秀なドライバーだとすれば、learn-claude-codeはそのドライバーに渡す車（ファイル操作、ターミナル、知識読み込みなどの仕組み）の作り方を教えてくれます。Pythonの実装コードに加え、ブラウザで使えるインタラクティブな学習プラットフォーム（Web版）も付属しており、英語・中国語・日本語の3言語でドキュメントが用意されています。AIエージェント開発に興味があるエンジニアや、Claude Codeのようなツールを自分のアプリに組み込みたい人にとって最適な学習資料です。

🔥 なぜ話題？

Claude Codeが2024〜2025年に爆発的に普及し、多くのエンジニアが『なぜClaude Codeはこんなに賢く動けるのか？』という内部構造への関心を高めていることが背景にあります。さらに、AIエージェントを自社プロダクトに組み込みたいという実務的な需要が急増しており、フレームワークに頼らずゼロから原理を学べるこの教材が注目を集めています。

💡 こう使える！

例えば、自社の業務システムにAIコーディングアシスタントを組み込みたいとき、learn-claude-codeのセッション1から順番に進めていくことで、『AIにファイルを読み書きさせる仕組み』『大きなタスクを小さく分割して並列実行する仕組み』『チームのように複数のAIが協力して作業する仕組み』などを一つずつ理解し、最終的に自前のAIエージェント環境を構築できるようになります。

ユースケース: AIエージェントの動作原理をゼロから学び、Claude Codeのようなコーディングエージェントの仕組みを自分のプロジェクトに応用したいエンジニア向けの学習教材として使えます。

  • 12段階のレッスンで、1つのループからチーム協調・並列実行まで段階的にエージェントの仕組みを学べる
  • AIフレームワークに依存せず、Pythonの基本コードだけで原理を理解できる「Bash is all you need」の設計思想
  • コーディング以外の農業・ホテル運営・製造業など、あらゆるドメインに応用可能なハーネス設計パターンを解説
  • 日本語ドキュメント・Webインタラクティブ学習プラットフォーム付きで学びやすい
  • 関連プロダクト（Kode CLI / Kode SDK / claw0）で学んだ知識をすぐ実践に移せる
GitHubで見る →

Bash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1

技術情報

言語

TypeScript

ライセンス

MIT

最終更新

2026-03-29

スター数

43,446

フォーク数

6,666

Issue数

26

トピック

agentagent-developmentai-agentclaudeclaude-codeeducationalllmpythonteachingtutorial

技術詳細

アーキテクチャ・仕組み

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

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

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

12セッションの構成

セッションテーマツール数
s01エージェントループ（基本のwhile + stop_reason）1
s02ツール追加（名前→ハンドラのディスパッチマップ）4
s03TodoWrite（計画作成→実行、完了率が倍増）5
s04サブエージェント（子タスクに独立したmessages[]）5
s05スキル読み込み（SKILL.mdをtool_resultで注入）5
s06コンテキスト圧縮（3層圧縮戦略）5
s07タスクシステム（ファイルベースCRUD + 依存グラフ）8
s08バックグラウンドタスク（デーモンスレッド + 通知キュー）6
s09エージェントチーム（チームメイト + JSONLメールボックス）9
s10チームプロトコル（シャットダウン + 計画承認FSM）12
s11自律エージェント（アイドルサイクル + 自動タスク取得）14
s12Worktree分離（タスク管理 + ディレクトリ分離実行）16

ハーネスの構成要素

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

ツール:     ファイル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 でアクセス

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

QHow an Abuse Survivor's Survival Sensors Became an AI Detection Algorithm — A 50-Year and 5,000-Hour Implementation RecordQSCI・Carbon Aware SDK・Keplerで始めるグリーンソフトウェアエンジニアリング実践ガイドQ🔥 これもいい♪コード生成AIの能力を高める「Everything Claude Code」

過去のトレンド履歴

Claude Codeの仕組みを0から完全理解！12段階で学ぶAIエージェント開発の教科書 — learn-claude-code

2026-03-20

4+1.4k

Claude Codeの仕組みを12ステップで完全理解！AIエージェント開発の「裏方」を学ぶ教科書 — learn-claude-code

2026-03-17

6+1.5k

AIコーディングエージェントの仕組みを12ステップで完全理解！ゼロから作って学ぶ実践講座 — learn-claude-code

2026-03-16

6+872

AIコーディングエージェントの仕組みを12ステップで完全理解！ゼロから作って学ぶ実践講座 — learn-claude-code

2026-03-09

4+566

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

2026-02-26

13+175

関連リポジトリ

使うほど賢くなるAIエージェント — 学習ループ内蔵でどこからでも話しかけられる — hermes-agent

NousResearch/hermes-agentPython48.5k

Hermes Agentは、Nous Research社が開発した「自分で成長するAIエージェント」です。普通のAIチャットと違い、過去の会話を記憶し、複雑なタスクをこなした後に自動で「スキル」を作成

AIコーディング助手の「記憶」を永続化！セッションをまたいで文脈を自動引き継ぎ — claude-mem

thedotmack/claude-memTypeScript43.2k

claude-memは、AIコーディング助手「Claude Code」のプラグインで、作業セッション中にClaudeが行ったすべての操作や発見を自動的に記録・圧縮し、次回のセッションに関連する文脈を自

Claude Codeを「チーム」に進化させる！複数AIエージェント同時稼働のマルチエージェント司令塔 — oh-my-claudecode

Yeachan-Heo/oh-my-claudecodeTypeScript20.1k

oh-my-claudecodeは、Claude Code（AIコーディングアシスタント）を複数のAIエージェントが協力して動く「チーム」に変えるツールです。通常Claude Codeは1つのAIが1

AIコーディングエージェントを10体同時に走らせろ！並列開発を実現するターミナル — superset

superset-sh/supersetTypeScript4.6k

Supersetは、Claude CodeやOpenAI Codexなど複数のAIコーディングエージェント（自動でコードを書いてくれるAIツール）を同時並行で動かせる、macOS向けのデスクトップアプ

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

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

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