Repolode
投稿する
decodingai-magazine

decodingai-magazine/building-a-coding-agent-from-scratch-course

PythonでClaude Code風のコーディングエージェントをゼロから構築し、ハーネスエンジニアリングを学べる無料のオープンソース講座。

代替できる製品:Claude Code

GitHub で見る
スター
1,126
フォーク
267
未解決の Issue
6
最終コミット
14 日前

これは何？

この講座では、decodeというコーディングエージェントを、最小限のエージェントループからクラウドエージェント群まで段階的に構築します。中核となるのはヘッドレスハーネスで、ツール呼び出しループ、ファイルの読み書き、bash、grep、編集用のツール、権限レイヤー、サンドボックスで構成されます。このハーネスは、対話型のターミナルUIと、CLI・webhook・cronから起動できるModalのサーバーレス関数上でのリモート実行という2つのインターフェースから利用できます。

また、コンテキストエンジニアリング（メモリファイル、スキル、コンパクション、LSP診断）、並列に処理を振り分けるサブエージェント、評価についても扱います。評価にはベンチマークと回帰テストスイートを使い、Opikでトレースします。セッションの記録とリプレイにはKitaruを使用します。モデルプロバイダーには、Modalでホストするオープンウェイトモデル、OpenRouter、Geminiが含まれます。

教材は全8回の文章レッスンと6本の動画で構成され、リポジトリにはセットアップガイドも用意されています。コードはPydantic AIを使ってPythonで記述し、フレームワークに頼らず各コンポーネントを手作業で構築します。

主な機能

  • 01read、edit、bash、grepなどのツールを使う、ツール呼び出し型のエージェントループを構築します。
  • 02エージェントをターミナルUI上で実行するか、Modalのサーバーレス関数上でヘッドレスに実行できます。
  • 03ツールコマンドをローカルのDockerまたはリモートのModalサンドボックスで実行します。
  • 04allow、ask、denyのルールを備えた権限レイヤーが含まれます。
  • 05メモリファイル、スキル、自動コンパクションなどのコンテキストエンジニアリングを扱います。
  • 06Opikでトレースするベンチマークと回帰テストを備えた評価ツールを提供します。

ユースケース

  • Claude Codeのような本番向けコーディングエージェントが内部でどのように構成されているかを学ぶ。
  • 同じハーネスのパターンを使い、コーディング以外の分野向けにカスタムエージェントを構築する。
  • Modal上でホストされたオープンウェイトモデルを、エージェントのバックエンドとして実行する。
  • ベンチマークと回帰テストスイートを使ったエージェント評価に取り組む。

クイックスタート

  1. 1

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

    git clone https://github.com/decodingai-magazine/building-a-coding-agent-from-scratch-course.git
  2. 2

    プロジェクトフォルダー内で依存関係をインストールする

    make install
  3. 3

    envファイルのサンプルをコピーし、LLM APIキーを設定する

    cp .env.example .env
  4. 4

    ターミナルでdecode agentを起動する

    uv run decode

使う前に知っておきたいこと

  • エージェントの実行には、Gemini、OpenRouter、またはModalのLLM APIキーが必要です。
  • 一部の機能は、Modal、Opik、Kitaruなどのサードパーティサービスに依存しています。

収録されている特集

Claude Code のツール・スキル・プラグインオープンソースの AI エージェント・フレームワークとアプリAI コーディングアシスタントとエージェント

トピック

#ai-agent#coding-agent#llm#agent-evals#sandboxing#context-engineering#python#tutorial#ai-coding-assistant#claude-code

よくある質問

building-a-coding-agent-from-scratch-course とは？
PythonでClaude Code風のコーディングエージェントをゼロから構築し、ハーネスエンジニアリングを学べる無料のオープンソース講座。 この講座では、decodeというコーディングエージェントを、最小限のエージェントループからクラウドエージェント群まで段階的に構築します。中核となるのはヘッドレスハーネスで、ツール呼び出しループ、ファイルの読み書き、bash、grep、編集用のツール、権限レイヤー、サンドボックスで構成されます。このハーネスは、対話型のターミナルUIと、CLI・webhook・cronから起動できるModalのサーバーレス関数上でのリモート実行という2つのインターフェースから利用できます。
building-a-coding-agent-from-scratch-course は無料で使えますか？ライセンスは？
building-a-coding-agent-from-scratch-course は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
building-a-coding-agent-from-scratch-course は今もメンテナンスされていますか？
活発にメンテナンス中。building-a-coding-agent-from-scratch-course の最終コミットは 2026年10月24日 です。
building-a-coding-agent-from-scratch-course は何に使えますか？
Claude Codeのような本番向けコーディングエージェントが内部でどのように構成されているかを学ぶ。 同じハーネスのパターンを使い、コーディング以外の分野向けにカスタムエージェントを構築する。 Modal上でホストされたオープンウェイトモデルを、エージェントのバックエンドとして実行する。 ベンチマークと回帰テストスイートを使ったエージェント評価に取り組む。
building-a-coding-agent-from-scratch-course のインストール方法は？
リポジトリをクローンする: git clone https://github.com/decodingai-magazine/building-a-coding-agent-from-scratch-course.git プロジェクトフォルダー内で依存関係をインストールする: make install envファイルのサンプルをコピーし、LLM APIキーを設定する: cp .env.example .env ターミナルでdecode agentを起動する: uv run decode
building-a-coding-agent-from-scratch-course はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/decodingai-magazine/building-a-coding-agent-from-scratch-course

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト