Windy3f3f3f3f/claude-code-from-scratch

何を解決するか

このプロジェクトは、Claude Code のような複雑な AI コーディングアシスタントの内部構造を理解するのに役立つ、最小限で教育的なコードエージェントの実装を提供します。生産コードの数十万行を扱う必要なく、シンプルな LLM チャットと完全に自律的なエージェントの間のギャップを埋めます。ファイルの管理、シェルコマンドの実行、長期記憶の維持が可能なエージェントを実現します。

動作方法

プロジェクトは、大規模言語モデル（LLM）とツール群の間の相互作用を管理するコア「エージェントループ」を実装しています。TypeScript と Python の両方の実装をサポートしています。システムは、LLM（Anthropic および OpenAI 互換バックエンドをサポート）にプロンプトを送信し、ツール呼び出しを受信し、ローカルでツールを実行し、結果をループに戻すことで、タスクが完了するまで繰り返します。

主なアーキテクチャコンポーネントは以下の通りです：

• ツールシステム：ファイル編集、検索、シェル実行のための 13 の組み込みツール。変更の上書きを防ぐための mtime 保護機能を備えています。
• コンテキスト管理：トークン使用量を効率化するための四段階圧縮パイプライン（予算トリケーション、古くなったスニペットの除去、マイクロ圧縮、自動圧縮）。
• メモリシステム：セマンティックリコールシステム。サイドクエリを使用して関連する記憶を取得します。
• スキルとエージェント：ディレクトリからカスタムスキルを読み込み、複雑なタスク用にサブエージェントを起動するシステム。
• MCP統合：JSON-RPC を stdio を介して使用し、外部ツールサーバーに Model Context Protocol (MCP) を接続するサポート。

対象読者

ステップバイステップのチュートリアルに従い、基本的なループからマルチエージェントオーケストレーションやセマンティックメモリといった高度な機能まで、自律的な AI エージェント、特にコードエージェントの構築方法を学びたい開発者。

特徴

• ステップバイステップのチュートリアル：実行可能なコードスナップショット付きの 13 章のガイド付き開発。
• キーゼロ実行：各章のコードをローカルモックで実行可能。API キーなしで学習が可能。
• 二言語対応：TypeScript と Python の両方で完全な実装。
• 高度なエージェント機能：並列ツール実行、ストリーミング出力、安全なための宣言的権限システムを含む。
• 予算制御：USD 金額とターン数の上限を内蔵しており、API の費用が暴走するのを防ぎます。