この記事は誰が書いているか（一次情報であることの明示）
AI企業・クリスタルメソッド株式会社で、Claude（Anthropic）の3.5時代から1年以上、Claude Code（CLIのエージェント型コーディングツール）を実務で使ってきた現場の記録です。監修は代表・河合継（AIマルチモーダル関連の特許の発明者。当社の登録特許は16件）。
「AIエージェントを実務に載せるとどうなるか」を、成功例だけでなく、AIがやらかした失敗と、その結果として作らざるを得なかった運用ルールまで、宣伝抜きで書きます。まとめ記事にはまず載っていない、自分たちが1年やって初めて分かった話です。
1. 具体的な成果：自社サイトを実際に速くした
いちばん分かりやすい成果から。自社のWordPressサイト（AIメディア）の表示速度を、Claude Codeを“社員”のように使って改善しました。実測値です。
| 指標 | 改善前 | 改善後 |
|---|---|---|
| モバイルの読み込み時間（主要ページ） | 12.89秒 | 2.03秒 |
| LCP（トップ） | 約8.1秒 | 約1.7秒（-79%） |
実際にやったことは、地味で具体的な積み重ねです。
- Tailwind CSS を 250KB → purge済み 19KB に削減
- 画像の遅延読み込み（lazy-load）を全面適用
- FontAwesome を、使うアイコンだけの SVG に置換
- jQuery を defer 読み込みに
- ロゴPNG → webp 9.7KB に圧縮
- ヒーロー画像の読み込み優先度・プリロードの調整
- 一覧の画像を large → medium サイズに
工数は正直に書きます。「あっという間」ではありません。 主要部分を激速化するのに、残業込みでおおむね丸1日かかりました（当初この工数を「2時間」と社内資料に書いてしまい、実測と違うので訂正しています。この“盛り”がまさに次章の話につながります）。
2. でも、AIは“そのまま”だと事故る
ここからが本題です。エージェント型AIは強力ですが、放っておくと平気で事故ります。 私たちが実際に踏んだもの：
- 検証せずに「できました」と報告する。 画面表示も実機確認もしていないのに完了報告が返ってくる。
- 数値を作ってしまう（ハルシネーション）。 上の「2時間」もそうですし、別の場面では実績値を都合よく盛った表現が生成されたこともありました。
- 修正のたびに影響範囲を頭の中だけで判断し、呼び出し元を見落とす → 一箇所直して別を壊す“モグラ叩き”。
つまり、AIエージェントの実務投入で本当に大事なのは「速くコードを書かせること」ではなく、**「事故らせないための運用の枠組み」**でした。
3. 運用ルールが「20項目 → 105項目」に増えた理由
私たちはClaude Code用に、プロジェクト直下の設定ファイル（CLAUDE.md）へ運用ルールを書いています。これが最初は20項目でしたが、1年運用する中で105項目まで増えました。 増えた項目は全部、上のような“実際に起きた事故”の再発防止です。代表例：
- ファイルの生成・更新・実行の前に、必ず作業計画を報告して人間の y/n 確認を取る（勝手に走らせない）。
- 「できた」と報告する前に、実際にユーザーが使う経路で結果を自分で見て確認する（静止画やテスト単体で済ませない）。
- 編集の前に、変更対象の“生の名前”で全文 grep して、呼び出し元を1件残らず列挙する（影響分析を頭でなく証拠で行う）。
- テスト用のダミーデータ・ダミー数値を、コメントであってもコードに書かない（捏造の芽を断つ）。
さらに、Claude Codeの PreToolUse Hook（ツール実行前に割り込むフック）を使って、Edit/Write の直前にファイルを自動バックアップする仕組みも入れました。人が気をつけるのではなく、仕組みで事故を防ぐ発想です。
4. 1年使って言えること
- AIエージェントは「優秀だが、検証と影響分析を自分からはサボる新人」だと思って運用すると、いちばん噛み合います。
- 生産性が本当に上がるのは、**「速く書かせる」ではなく「検証と影響範囲の網羅をAIにやらせる」**設計にできたとき。
- そのための資産は、派手な自動化ではなく、“やらかしの再発防止ルール”を1つずつ地道に積むことでした（私たちの場合それが 20→105 項目という形になりました）。
同じようにAIエージェントを実務へ入れようとしている方の、失敗を1つでも減らせれば幸いです。
参考（当社の一次事例・詳細）
※本文の数値は当社の実測記録に基づきます。