AIエージェントの仕組みを知ろう

チャットAIは答えるだけ、コーディングエージェントは動いて確かめる

チャットAIは、聞かれたことに文章で答えるだけの相手です。 手元のファイルは見えず、実際に何かを実行することもありません。知っていることの範囲で、それらしい答えを返します。

例えるなら、電話越しに質問へ答えるだけの相談窓口です。窓口の担当者は、あなたの机の上にある書類を見ることも、代わりに書類を整理することもできません。答えられるのは、質問された内容についてだけです。

コーディングエージェントは、チャットAIとは別の性質を持ちます。 手元のファイルを実際に読み、内容を書き換え、指定したコマンドを実行し、その結果を自分で確かめてから次の行動に移ります。

この動きは、実際に現場へ来て、資料を取り出し、作業をして、結果を確認してから報告してくれる担当者に近い性質です。聞かれたことに答えるだけでなく、頼まれた作業そのものを進めます。

この違いを知らないまま使うと、頼み方を誤ります。 チャットAIに「ファイルを直して」と頼んでも、実際には何も変わりません。逆にコーディングエージェントには、実際に変更してよい範囲を自分で決めて伝える必要があります。

自分がふだん使っているAIが、答えるだけの相手か、実際に動く相手かを、まず区別してみましょう。

「考える部分」と「動く部分」の2つでできている

コーディングエージェントは、単体の1つの機能ではありません。 「考える部分」と「動く部分」という、役割の違う2つの部品が組み合わさってできています。

「考える部分」にあたるのが、大規模な言語モデルです。文章を読んで意味を理解し、次に何をすべきかを判断します。本モジュールでは、この部分にClaudeというAnthropicの言語モデルを使います。

「動く部分」にあたるのが、実際に手足として働くツール一式です。ファイルを読む、書き換える、コマンドを実行する、Webで調べる。こうした具体的な操作を、言語モデルの判断に従って実行します。

「考える部分」だけでは、文章を返すことしかできません。 逆に「動く部分」だけでは、何をすべきか判断できません。両方が組み合わさって、初めて「読んで、判断して、実際に動く」という一連の作業が成立します。

本モジュールでは、この2つを合わせた仕組み全体をClaude Codeと呼びます。 以降のレッスンでは、実装例としてClaude Codeを使って説明します。

自分が頼んだ作業が動かないとき、「考える部分が誤って判断したのか」「動く部分が使えなかったのか」を切り分けて考えると、原因をつかみやすくなります。

文脈を集め、行動し、確かめる、を繰り返す

コーディングエージェントは、1回の指示で作業を終わらせません。 状況を確かめながら、同じ3つの動きを何度も繰り返します。これを「エージェントループ」と呼びます。

3つの動きは、次の順で進みます。

この3つは、1回で終わらず何度も回ります。 たとえば「動かないテストを直して」と頼むと、テストを実行して失敗を確認し、原因のファイルを読み、書き換え、もう一度テストを実行して確かめる、という流れを、うまくいくまで繰り返します。

このループを知っていると、1回の指示で完璧な結果を求めなくてよいと分かります。 途中で違う方向に進んでいたら、その場で止めて、指示を足せば軌道が戻ります。

作業を頼んだあとは、結果が出るまで黙って待つのではなく、途中経過を見て気になったら声をかける、という関わり方を意識してみましょう。

本モジュールでは、実装例としてClaude Codeを使う

ここまでの2つの部品と1つのループは、特定の製品に限った話ではなく、コーディングエージェント全般に共通する仕組みです。本モジュールでは、この仕組みの実装例として、Claude Codeを一貫して使います。

以降のレッスンでは、次の順で進みます。渡す前提の作り方、繰り返す指示の仕組み化、自分のPCへの導入、最初の依頼から運用への引き継ぎです。

このレッスンで押さえた「考える部分・動く部分」「文脈を集める→行動する→確かめる」という2つの見方は、この先すべてのレッスンで前提として使います。ここが曖昧なまま進むと、後のレッスンで頼み方を誤りやすくなります。