プログラミング未経験者から開発者まで、アイデアからリリースまでAI支援で実際のプロダクトを作るVibe Codingの実践講座です。
shareAI-lab/learn-claude-code
単一のループとbashから始めて、Claude Code風のエージェントハーネスをゼロから構築する全17章のPythonチュートリアル。
代替できる製品:Claude Code
- スター
- 78,839
- フォーク
- 12,616
- 未解決の Issue
- 70
- 最終コミット
- 22 日前
これは何?
このリポジトリはハーネスエンジニアリングを学ぶための教材です。LLMをエージェントとして動作させるために、その周囲で使うツール、権限、コンテキスト管理、調整用コードを構築します。エージェント性を生み出すのは学習済みモデルであり、ハーネスはモデルが動作する環境、ツール、境界を提供するという考え方に基づいています。
全17章で構成され、s01からs17へと段階的に進みます。各章では、エージェントの基本ループ、ツールのディスパッチ、権限システム、フック、todoを使った計画、サブエージェント、スキルの読み込み、コンテキストの圧縮、メモリ、ファイルベースのタスクグラフ、バックグラウンドタスク、cronによるスケジューリング、タスクごとにworktreeを割り当てるマルチエージェントチーム、MCPツール連携、ワークフローランタイム、目標ベースのループ制御など、1つの仕組みを個別に扱います。各章には実行可能なcode.pyが含まれ、s15では各仕組みを1つの統合ループにまとめます。
コードはAnthropic messages APIを対象としており、APIキーを設定したうえでPythonから実行します。以前のリンク向けに旧版の全12章のコースも残されており、Webプラットフォームではコースを閲覧できます。
主な機能
- 01tool_useブロックを使ったエージェントループを、単一のbashツールから構築します。
- 02権限ルール、承認フロー、ツール実行前後のフックを扱います。
- 03計画、メッセージリストを分離したサブエージェント、コンテキストの圧縮を含みます。
- 04ファイルベースのタスクグラフ、バックグラウンド実行、cronによるスケジューリングを実演します。
- 05タスクごとにworktreeを割り当てるマルチエージェントチームと、MCPツール連携を紹介します。
- 06各章には、単独で実行できるcode.pyと、中国語・日本語の翻訳が用意されています。
ユースケース
- Claude Codeのようなコーディングエージェントが内部でどのように構成されているかを学ぶ。
- コースで紹介される仕組みのパターンを使って、特定の分野向けのカスタムエージェントハーネスを構築する。
- ワークショップや講座でエージェント設計の概念を教える。
- ツールのディスパッチ、コンテキストの圧縮、マルチエージェント間の調整方法を、小さく実行可能な例で比較する。
クイックスタート
- 1
リポジトリをクローンする
git clone https://github.com/shareAI-lab/learn-claude-code - 2
最初のレッスンのフォルダを開き、READMEに従う
- 3
レッスンのコードファイルを実行する
python s01_agent_loop/code.py
使う前に知っておきたいこと
- READMEにはインストールコマンドが記載されていないため、Pythonの依存関係とAPIキーは自分で設定する必要があります。
- レッスンのコードはClaude APIを呼び出すため、有料のAPIキーが必要です。
トピック
よくある質問
- learn-claude-code とは?
- 単一のループとbashから始めて、Claude Code風のエージェントハーネスをゼロから構築する全17章のPythonチュートリアル。 このリポジトリはハーネスエンジニアリングを学ぶための教材です。LLMをエージェントとして動作させるために、その周囲で使うツール、権限、コンテキスト管理、調整用コードを構築します。エージェント性を生み出すのは学習済みモデルであり、ハーネスはモデルが動作する環境、ツール、境界を提供するという考え方に基づいています。
- learn-claude-code は無料で使えますか?ライセンスは?
- learn-claude-code は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- learn-claude-code は今もメンテナンスされていますか?
- 活発にメンテナンス中。learn-claude-code の最終コミットは 2026年9月28日 です。
- learn-claude-code は何に使えますか?
- Claude Codeのようなコーディングエージェントが内部でどのように構成されているかを学ぶ。 コースで紹介される仕組みのパターンを使って、特定の分野向けのカスタムエージェントハーネスを構築する。 ワークショップや講座でエージェント設計の概念を教える。 ツールのディスパッチ、コンテキストの圧縮、マルチエージェント間の調整方法を、小さく実行可能な例で比較する。
- learn-claude-code のインストール方法は?
- リポジトリをクローンする: git clone https://github.com/shareAI-lab/learn-claude-code 最初のレッスンのフォルダを開き、READMEに従う レッスンのコードファイルを実行する: python s01_agent_loop/code.py
- learn-claude-code はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/shareAI-lab/learn-claude-code
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
エージェント構築に役立つ、Pi-Agent SDKのバイリンガル解説とサンプルコード、AIアシスタント向けスキル
次の行動を先に示し、番号付きの手順で余計な前置きを省く、コーディングアシスタント向けスキル。
プロジェクトを読み、ターミナルやデスクトップ、ブラウザ、エディタからファイル編集やテスト実行を行うオープンソースのコーディングエージェント。
AIアシスタントがプロンプトでBlenderの3Dシーンを作成・編集・確認できるアドオンとMCPサーバー。
質問を計画し、Webやローカルの情報源を集め、任意のLLMプロバイダーで引用付きレポートを作成する自律型リサーチエージェント。