Claude Codeの深夜自動化に8日ハマった。答えは公式ドキュメントにあった

定時タスクが承認待ちで止まり続けた。8日間、allowlist の追記、コマンド語彙の制約、指示書の修正を繰り返した。それでも止まる。しかし実は、答えはずっと公式ドキュメントに書いてあった。タスク編集フォームの権限モードを「自動」に設定するだけで良かったのだ。一行。なぜ 8 日間気づかなかったのか。その原因追跡が、この記事の本題である。

根本にあったのは調査の順序の誤りだ。API スキーマを見て「パラメータに権限モードの欄がない＝存在しない」と結論し、以後のあらゆる対策がその前提に積まれた。AI が内部ログを速く解析して自信を持つ。人間がその断定を前提に判断する。そして誰も UI の設定項目を確認しなかった。特に鋭いのは、著者が指摘する「境界の盲点」だ。設計・運用の責任範囲が明確でなかった時、「誰も見ていない」場所が生まれた。AI は内部観測が得意、人間は UI を見ている——はずなのに、その両者の接点にある UI の中の設定項目は両者の盲点になった。今後のシステム運用ではこのリスクを避けられない。

中小企業が AI ツールを導入する際、この教訓は即座に活きる。導入後、何か止まったり変だったりした時、社内だけでデバッグするな。まず公式ドキュメントを全部読む、ユーザーコミュニティで同じ症状を探す、UI の現物を見る。その上で内部ログを掘る。この順序の逆転だけで、8 日かかる問題が数時間で解決する可能性が高い。問題解決の効率は「得意な道具」ではなく「調査の流れ」で決まるのだ。