AIエージェントの仕組みを完全理解する—AIのプロが徹底解説

概要

AIエージェント(Claude Code、Codexなど)がなぜ「ファイルを読んで書き換える」といった作業までこなせるのかを、チャットAIとの違いから解説する回。AIエージェントは単一のAIモデルではなく、「モデル(判断=脳)」と「ハーネス(実行環境=手足)」の組み合わせであるという構造を軸に、動作の仕組みを整理している。

主なポイント

• AIエージェントは「モデル単体」ではなく、モデル(判断する脳)+ハーネス(それ以外の環境・仕組み)の総体を指す
• モデルの役割は「次に何をするか判断する」ことのみで、ファイルの読み書きや実行など実際の操作は「ツール」が担う
• ハーネスが担う4つの仕事は、作業材料をモデルに渡す/使えるツールを用意する/権限を確認して実行する/結果を次の判断サイクルに戻すこと
• AIエージェントは「指示→判断→ツール要求→権限確認→実行→結果をモデルに返す」という小さなループを、完了条件を満たすまで繰り返している
• モデルに見えるのはツールで実際に読み込んだ情報だけで、フォルダ内の全ファイルが自動的に見えているわけではない(読むためのツールが必要)
• 同じモデルでも搭載ツールや付与権限が異なれば挙動は変わる(読み取り専用しか持たないエージェントと、編集・実行・検証まで持つエージェントでは結果が違う)
• Claude CodeやCodexといった製品は「ハーネス」であり、内部のモデルは理論上差し替え可能
• 最近のエージェントがオートモードで自律的に進められるのは、モデルが賢くなり「確認が必要かどうか」の判断精度が上がったため
• エージェントが失敗・低品質な結果を出す主な原因は、必要な情報がない/使えるツールがない/正しさを検証する基準がないことの3つ
• ハーネスエンジニアリングの理解を深めることが、AIエージェントの仕組みの理解を深めることとほぼ同義

実践に使えること

• AIエージェントが期待通り動かない時は、「モデルの判断力の問題」か「ツール・権限などハーネス側の問題」かを切り分けて考える
• ファイルの内容が反映されない・見落とされる場合、そのAIに該当ファイルを「読む」「編集する」ツールが実際に装備・許可されているか確認する
• 検証基準(テストや期待結果)を明確に与えることで、エージェントの判断精度とアウトプット品質を上げられる
• Claude CodeやCodexなどのツールを選ぶ/使い分ける際は、内部モデルの性能だけでなく、装備されているツール構成や権限設定の違いにも注目する