// 実戦
ゼロから
エージェントを組む。
実際に動くコードを積み上げていくハンズオン連載。現在進行中:Mini Claude Code —— 全 6 話で組む本物の coding agent、フレームワークで隠されていない全パーツ公開。
Mini Claude Code · Episode 01: ちゃんと記憶する 40 行の REPL
TypeScript でゼロから動くコーディングエージェントを組み上げるハンズオン連載の第 1 回。まずは最小限のループを動かす——stdin、ストリーミング、そしてターンをまたいで生き残る会話。
Mini Claude Code · Episode 03: リポジトリを破壊せずにファイルを編集する
Episode 3 では apply_patch ツールを追加する——多くのエージェントがひっそりと作業成果を破壊する、あのツールだ。ドライランでのプレビュー、ワークスペースのガードレール、機嫌の悪い Claude にも耐える確認ゲートを備えた、厳格な unified diff アプライヤを構築する。
Mini Claude Code · Episode 02: エージェントにツールの使い方を教える
Episode 2 では REPL に最初の 3 つのツール——read_file、list_dir、run_bash——を与え、Anthropic SDK を使ったツールユースのループを一通り見ていく。ストップリーズン、ツールのエラー、そして会話に何を戻すべきかという意外に厄介な部分まで扱う。
Mini Claude Code · Episode 06: 悪化させたかどうかをついに教えてくれるエバルループ
シーズンフィナーレ。15 タスクからなる SWE-lite ハーネスを構築し、検証可能なコードタスクに対してエージェントをエンドツーエンドで走らせ、さらにプロンプトキャッシングを配線してイテレーションを安価にする。パスレート、平均ターン数、タスクあたりのコスト——将来リグレッションを検出するためのベースラインとしてピン留めする。
Mini Claude Code · Episode 05: 独自のコンテキストを持つサブエージェントを起動する
Episode 5 ではエージェントを二つに分割する。spawn_subagent ツールを追加し、独自のツールセットと独自のコンテキストウィンドウを持つ新しい Claude にスコープを絞ったタスクを委ね、コンパクトなサマリーを返してもらう。Anthropic の『トークン使用量は結果の品質分散の 80% を説明する』という発見の背後にあるパターンを、約 90 行で実装する。
Mini Claude Code · Episode 04:エージェントに意図的に忘れさせる
エピソード 4 ではトークン料金の問題に真正面から取り組む。observation masking(コストと品質の両面で LLM summarization を上回る JetBrains 流のトリック)を実装し、max_tokens による切り詰めでツール列が黙って壊れないよう auto-continue の経路を追加する。