ghuntley/how-to-build-a-coding-agent
Claude APIを使ったコーディングエージェントの作り方を、ファイル・シェル・検索ツールを順に追加しながら学ぶ、Goのハンズオンワークショップです。
- スター
- 5,907
- フォーク
- 668
- 未解決の Issue
- 8
- 最終コミット
- 3 日前
これは何?
Goで独自のAIコーディングアシスタントを作る、実践型のワークショップです。Anthropic API経由でClaudeと会話する基本的なチャットボットから始め、ファイルの読み込み、ディレクトリ一覧の取得、シェルコマンドの実行、ファイルの編集、ripgrepによるコード検索と、ツールを一つずつ追加していきます。
各段階はchat.go、read.go、edit_tool.goなどの単独で実行できるGoプログラムになっているため、それぞれのバージョンを実行して比較できます。ユーザー入力をモデルに渡し、ツール呼び出しを実行して結果を返す処理をClaudeが最終回答を出すまで繰り返す、エージェントの基本的なイベントループについても解説しています。また、ツールを名前、Goのstructから生成する入力スキーマ、関数で定義する方法も紹介します。
Cline、Cursor、Claude Codeのようなエージェントの内部の仕組みを理解したい開発者向けのプロジェクトです。実行にはAnthropic API keyが必要です。
主な機能
- 01Goでコーディングエージェントを段階的に発展させた6つのバージョンを作成できます。
- 02基本的なチャットループでAnthropic Claude APIに接続します。
- 03ファイルの読み込み、ディレクトリ一覧の取得、シェルコマンドの実行、ファイル編集、コード検索のツールを利用できます。
- 04Goのstructからツールの入力スキーマを生成します。
- 05詳細なログを出力するverboseモードと、実験用のサンプルファイルが含まれています。
ユースケース
- ClineやCursorなどのAIコーディングエージェントの内部の仕組みを学ぶ。
- 独自のツールを使うカスタムのローカル開発者アシスタントを作る。
- Go開発者にLLMのtool callingの基本を教える。
クイックスタート
- 1
devenv の開発環境に入る(推奨)
devenv shell - 2
または Go の依存関係を手動でインストールする
go mod tidy - 3
Anthropic API キーを環境変数に設定する
export ANTHROPIC_API_KEY="your-api-key-here" - 4
基本的なチャットプログラムを実行する
go run chat.go
使う前に知っておきたいこと
- Claude の利用には、有料の Anthropic API キーが必要です。
- リポジトリにライセンスが指定されていません。
トピック
よくある質問
- how-to-build-a-coding-agent とは?
- Claude APIを使ったコーディングエージェントの作り方を、ファイル・シェル・検索ツールを順に追加しながら学ぶ、Goのハンズオンワークショップです。 Goで独自のAIコーディングアシスタントを作る、実践型のワークショップです。Anthropic API経由でClaudeと会話する基本的なチャットボットから始め、ファイルの読み込み、ディレクトリ一覧の取得、シェルコマンドの実行、ファイルの編集、ripgrepによるコード検索と、ツールを一つずつ追加していきます。
- how-to-build-a-coding-agent は無料で使えますか?ライセンスは?
- how-to-build-a-coding-agent にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。
- how-to-build-a-coding-agent は今もメンテナンスされていますか?
- 活発にメンテナンス中。how-to-build-a-coding-agent の最終コミットは 2026年10月17日 です。
- how-to-build-a-coding-agent は何に使えますか?
- ClineやCursorなどのAIコーディングエージェントの内部の仕組みを学ぶ。 独自のツールを使うカスタムのローカル開発者アシスタントを作る。 Go開発者にLLMのtool callingの基本を教える。
- how-to-build-a-coding-agent のインストール方法は?
- devenv の開発環境に入る(推奨): devenv shell または Go の依存関係を手動でインストールする: go mod tidy Anthropic API キーを環境変数に設定する: export ANTHROPIC_API_KEY="your-api-key-here" 基本的なチャットプログラムを実行する: go run chat.go
- how-to-build-a-coding-agent はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/ghuntley/how-to-build-a-coding-agent
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIアシスタントがプロンプトでBlenderの3Dシーンを作成・編集・確認できるアドオンとMCPサーバー。
質問を計画し、Webやローカルの情報源を集め、任意のLLMプロバイダーで引用付きレポートを作成する自律型リサーチエージェント。
AIエージェント専用のDocker化されたLinuxデスクトップ、ブラウザー、文書ツールを備えたオープンなエージェントフレームワーク。
再利用可能なコンポーネント、グラフによるオーケストレーション、Human-in-the-loopの割り込み機能を備えた、LLMアプリケーションとAIエージェント構築のためのGoフレームワーク。
LLMアプリケーション構築用のRustライブラリと、その上に構築されたBevyプラグイン方式のターミナルコーディングエージェント。