Repolode
shareAI-lab

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. 1

    リポジトリをクローンする

    git clone https://github.com/shareAI-lab/learn-claude-code
  2. 2

    最初のレッスンのフォルダを開き、READMEに従う

  3. 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 の数値は毎日更新されます。

関連プロジェクト