AIエージェントとコード補完・チャットは何が違うのか

「AIエージェント」という言葉は、いま指す範囲が広がりすぎています。エディタの補完機能を指して使う人もいれば、チャットで質問することを指す人もいる。同じ言葉で違うものを話していると、議論も判断もかみ合いません。

この本は最後まで「エージェント」を扱うので、最初に何を指しているのかを固定します。

学習者

補完もチャットもエージェントも、結局AIが手伝ってくれるって意味では同じじゃないの？

3つを並べて区別する

まず全体像です。

3列目の「繰り返しを誰が回すか」が本質的な違いです。チャットでは、返ってきた答えを読んで、次に何を聞くかを人間が考えます。エージェントでは、その判断をエージェント自身が行います。

なぜエージェントは自分で回せるのか。答えは単純で、手があるからです。

Claude Codeの公式ドキュメントは、この点を明快に書いています。ツールがなければ、モデルはテキストを返すことしかできない。ツールがあると、行動できる。ファイルを読み、コードを編集し、コマンドを実行し、Webを検索し、外部サービスとやり取りする。

そして重要なのは次の部分です。ツールを使った結果は、次の判断の材料としてループに戻ります。

ツールが加わった瞬間に、一方通行のやり取りが繰り返しの輪に変わります。これがエージェントとチャットを分ける線です。

公式が挙げているツールの分類は5つです。

公式は、エージェントの動作を3つの局面の繰り返しとして説明しています。

コンテキストを集める → 行動する → 結果を確かめる。この3つは明確に分かれているわけではなく、混ざり合いながら進みます。

公式が挙げている具体例が分かりやすいので借ります。「失敗しているテストを直して」と頼んだとき、エージェントは次のように動きます。

それぞれのツール利用が新しい情報を返し、それが次の判断を決めます。公式の表現では、エージェントは前のステップで学んだことをもとに次に何が必要かを判断し、数十の行動を連鎖させながら途中で軌道修正します。

先生

1から6まで、人間が指示したのは最初の一言だけだよね。この「間を自分で埋める」ところがエージェントの正体なんだ。

そして人間もこの輪の中にいます。公式が明記しているとおり、いつでも割り込んで方向を変えられます。自律的に動きますが、こちらの入力には反応し続けます。

もう1つ、この本を通して重要になる概念があります。公式ドキュメントは、Claude Code自身をエージェンティック・ハーネスと呼んでいます。ツール、コンテキスト管理、実行環境を提供することで、言語モデルを実用的なコーディングエージェントに変える層という意味です。

ここから重要な帰結が出ます。モデルとエージェントは別物です。同じモデルを使っていても、ハーネスの作りが違えば結果は変わります。逆に言えば、エージェントの性能を上げる方法は、モデルを変えることだけではありません。

この本で扱う内容の大半は、モデルの話ではなくハーネスの話です。何を渡し、何を許し、どう検証させるか——すべてハーネス側の設計です。

定義の話が長くなりましたが、これは言葉遊びではありません。数字にはっきり現れます。

Stack Overflowの2025年の開発者調査では、AIツールを使っている、または使う予定だと答えた人が84%に達しています。ほぼ全員です。ところが同じ調査で、業務でAIエージェントを使っていると答えた人は31%にとどまります。

「AIを使っている」と「エージェントを使っている」は、まったく別の話です。その差が50ポイント以上あります。

この差を無視して「開発者の8割以上がAIエージェントを使っている」と書いてある記事は珍しくありません。次の章で、こうした数字の読み方を扱います。

チャットの延長として使う。 一問一答を繰り返す使い方だと、エージェントの利点である「間を自分で埋める」部分を使っていないことになります。

ツールを与えずにエージェントと呼ぶ。 ツールがなければ、できるのはテキストを返すことだけです。

うまくいかない原因をモデルの性能だと考える。 ハーネス側——渡している情報、許している操作、検証手段——の問題であることのほうが多いです。

「AIの導入率」の数字をエージェントの話として読む。 前述のとおり、別のものを測っています。

次の章では、そのエージェントが実際にどれだけ使われているのかを、公開されている調査から確認します。ただし主題は数字そのものではなく、その数字が何を測っていないかのほうです。