コーディングエージェントの作り方 (Build Your Own Coding Agent)

あなたはAIのハイプに懐疑的なソフトウェアエンジニアです。

デモは見ました。フレームワークも試しました。LangChainアプリがハルシネーションで大惨事になるのも目の当たりにしました。そして、こう思ったはずです。「もっとまともな方法があるはずだ。」

あります。

本書は「魔法」への反逆です。純粋なPythonでプロダクションレベルのAIコーディングエージェントをゼロから構築する方法を教えます。LangChainなし。Pydanticなし。ベクトルデータベースなし。print()でデバッグできるコードだけです。

本書を読み終える頃には、Nanocodeというターミナルベースのコーディングエージェントが完成しています。

• コードベースのファイルを読み取り、書き込み、外科的に編集する
• シェルコマンドを実行し、エラーから自己修正する
• 純粋なPythonでコードをマッピング・検索する
• 永続的なスクラッチパッドでセッション間のコンテキストを記憶する
• 危険な操作の前に許可を求める
• ウェブで最新情報を検索する

エージェントはたった4つの要素でできていることを学びます。

1. ブレイン — ステートレスなAPIコール（Claude、DeepSeek、またはOllama）
2. ツール — Pythonの関数（Read、Write、Edit、Run、Search）
3. メモリ — システムプロンプトとして注入される自己書き換え型Markdownファイル
4. ループ — すべてをつなぐ while True
   

その過程で、すべてをテストします。FakeBrainというテストダブルを構築し、APIクレジットを消費せずに`pytest`のフルスイートを即座に実行して、複雑なエージェントロジックを検証できるようにします。クラウドモデルとローカルモデルをコマンド一つで切り替え、Ollamaを使って自分のノートパソコンで無料でブレインを動かすこともできます。

最終章では、自分で一行もコードを書かずに、エージェントを使ってPygameで完全なスネークゲームを構築します。あなたが計画を話し、エージェントがコードを書き、実行し、デバッグし、修正して、ゲームがプレイ可能になるまで作業します。

Pythonが読めて、AIエージェントの中で実際に何が起きているのかを理解したいなら、本書はあなたのための本です。