会話セッションを邪魔せずに Claude Code / Codex / Cursor を外部イベントで動かすCLIの作り方まとめ

ブラウザ上でファイル要素をクリックして指摘を書くと、Claude Code・Codex・Cursor が自動でファイルを直し、リロードで結果を見せるシステムの仕組みを、著者が解析した。核になった設計判断は2つ。会話セッションを邪魔せずにエージェントを起こす合図は、3つのエージェントで別々に作るしかなかったこと。そして常駐デーモンは不要で、1ファイル1プロセスで事足りたこと。ここに「便利に見える自動化」の裏側にある地味な複雑さが詰まっている。

Claude Code はバックグラウンドタスク完了で自動再開する仕組みを持つが、Codex は実行中セッションへのメッセージキュー投入、Cursor は ACP（Agent Client Protocol）経由の専用セッション——と起動経路が全く異なる。同じ体験を3つのプラットフォームで実現するために、著者は3つの別解を実装した。指摘の中身はエージェントが毎回取りに行く形にして、通知経路が漏れても本文は流出しない設計になっている。これは「統一性が取れない」という制約下での現実的な回答だ。

中小企業の視点から見ると、AI開発の「非エンジニア化」が進むほど、こうした統合の複雑さは表に出ない。複数プラットフォームで同じに動くと思うのは気持ちよいが、実際に自動化ツールを組むなら各プラットフォームの個性を知ることが避けられない。今後共通プロトコルが標準化される見込みは薄いと著者も指摘している。つまり「AI エージェント複数本の統合」は当面、手作業の調整を前提にした運用を覚悟する必要がある。便利さの代償として何を払うか。その計算が、実務的なAI導入の分岐点になる。