07
基礎知識 / FUNDAMENTALS
AI コーディングエージェントとは
一般的な AI エージェントとの違い、3つの特徴、現在実用に耐える範囲を整理。
公開 2026.05.17
「AI エージェント」と「AI コーディングエージェント」、何が違うか。Claude Code、Cursor の Composer、Aider など、ここ1〜2年で爆発的に普及した「コード書く系エージェント」の特徴と、実用上の境界を整理する。
一般エージェントとの違い
| 一般エージェント | コーディングエージェント | |
|---|---|---|
| 目的 | タスクの自律実行（旅行予約、データ調査、自動化など） | コードベースの読み・書き・実行 |
| 入力 | 自然言語のタスク指示 | 自然言語 + コードベース全体 |
| 出力 | テキスト、API 呼び出し、何かの操作 | ファイル編集、コマンド実行、git 操作 |
| 評価軸 | タスク完了したか | テストが通るか・既存挙動が壊れていないか |
| 主要リスク | 誤情報の発信 | データ消失、本番事故 |
コーディングエージェントは「読み書き対象がプログラムソースコード」に絞られた特殊化エージェント、と言える。
3つの特徴
1. ファイルシステムへの双方向アクセス
普通のチャット AI は会話履歴の中で完結する。コーディングエージェントは:
- ローカルファイルを読み込む
- ファイルを編集・新規作成・削除する
- ディレクトリ構造を変更する
この「実ファイルを触る」能力があるから、人間の代わりに作業を進められる。
2. シェル / ターミナルの実行権
ファイル編集だけでは不十分で、
npm testでテストを走らせて結果を見るgit diffで変更を確認するpnpm buildでビルド失敗を検出する
ような実行と検証のループが必須。コーディングエージェントは「コマンドを実行して、出力を見て、次の判断をする」というループを内部に持っている。
3. プロジェクト文脈の保持
単発の質問なら関係ないが、複数ファイルにまたがる作業では:
- 「このプロジェクトでは Tailwind を使う」
- 「テストランナーは Jest ではなく Vitest」
- 「触ってはいけないファイルは
src/legacy/」
のような前提を毎回伝えるのは現実的でない。だからエージェントは:
CLAUDE.md/GEMINI.md/.cursorrulesのような 前提知識ファイル を読む- プロジェクトの README・package.json・既存コード構造から状況を把握する
- セッション中に学んだことを記憶（メモリ機構）
現在実用に耐える範囲（2026 年時点）
正直に言うと、得意・不得意の差が大きい。
よく回る作業
- テストを書く — 既存コードから振る舞いを推測してテストケースを生成。素直に強い
- 小〜中規模リファクタリング — 関数の分割、型の厳密化、ファイル分割など機械的なもの
- ドキュメント整備 — コードから README やコメントを生成
- バグ修正（再現可能なもの） — エラーログとスタックトレースを渡すと、原因特定 → 修正まで自律的に
- CRUD レベルの新機能追加 — 既存パターンを踏襲する系
- CI/CD の workflow ファイル作成 — テンプレが豊富にある領域
まだ厳しい作業
- アーキテクチャ判断 — 「マイクロサービスに分けるべきか」のような戦略判断は人間が必要
- パフォーマンスチューニング — 計測ベースの最適化はエージェント単独では難しい
- 複雑な並行処理・分散系のデバッグ — 状態空間が広すぎて、ログだけでは推測ミスが多い
- 既存大規模リポジトリの大改造 — context window の制約と、副作用の連鎖が見えにくい
- エッジケースの網羅 — 「99%動くが残り1%で本番事故」のパターンは検知しづらい
「全自動で任せる」と「対話で進める」の違い
エージェントには2つの使い方がある。
対話型運用
ターン単位で:
- 人間が指示
- エージェントが提案
- 人間が承認 / 差し戻し
- 反復
時間はかかるが、ミスが本番に出るリスクは最小。学習目的・重要なリポジトリ向け。
自律型運用
「全部やっておいて」と投げて放置:
- Claude Code の
--dangerously-skip-permissions - Codex の
--full-auto - Gemini の
--yolo - Copilot CLI の
--allow-all-tools
速いが、暴走時の被害が大きい。隔離環境（VM、Docker、サブモジュール）でのみ推奨。
詳細は AI CLI の権限モード総まとめ を参照。
チームでの使い分け
実務でコーディングエージェントを導入するときの典型的な分かれ目:
| シナリオ | 適したスタイル |
|---|---|
| 個人プロダクト・プロトタイピング | 自律型でガンガン進める |
| 業務・本番リポジトリ | 対話型 + PR レビュー必須 |
| 学習目的 | 対話型 + 出力を読み込む |
| 大規模 refactor | 対話型 + 段階的に PR を分割 |
| 緊急バグ修正 | 対話型 + ホットフィックス用ブランチで |
関連記事
- AI エージェントとは — 一般エージェントの仕組み
- AI CLI の権限モード総まとめ — 自律性の制御
- MCP（Model Context Protocol）とは — エージェントが触れるツールを増やす