自動修正システムは、Claude Code Headlessを使用して本番環境のエラーを検出し修正します。

自動修正システムの仕組み

開発者が、ヘッドレスモードのClaude Code CLIを使用して本番環境のエラーを検出・修正する自動システムを構築しました。このシステムは数週間稼働しており、無料でオープンソースとして公開されており、Claudeのサブスクリプションのみが必要です。

システムアーキテクチャ

ワークフローは以下の順序で進行します：

• 本番環境のログを監視
• ウォッチャーがエラーを識別し、重複をグループ化し、重大度を分類
• 30秒の待機ウィンドウ
• 重大/高優先度のエラー検出でシステムが起動
• Gitワークツリーを作成（メインブランチに影響を与えない分離されたブランチ）
• Claude Codeをヘッドレスで起動し、特定のエラーに限定
• Telegram通知：「新規エラー — 修正を承認しますか？」に承認/スキップのオプション
• 承認されると自動的にPRを作成

主要な実装詳細

開発者は、gitワークツリーを重要なコンポーネントとして特定しました — 各エラーに対してリポジトリの分離されたコピーが作成されます。Claudeはこの分離環境内で読み取り、編集、テスト実行、その他の操作を実行できます。修正が不十分な場合、ワークツリーを削除してもメインブランチに影響はありません。

Claudeセッションには以下の情報を含む焦点を絞ったプロンプトが送信されます：

• エラーメッセージ
• スタックトレース
• 影響を受けるパス
• 重大度レベル

ヘッドレスセッションは限定されたツールで実行されます：読み取り、書き込み、編集、グロブ、グレップ、Bash。提供された例のプロンプト：「LevProductAdvisorコードベースのこの本番環境エラーを修正してください。エラー：MongoServerError: connection pool closed。スタック：at MongoClient.connect (mongo-client.ts:88)。パス：POST /api/products/list。重大度：CRITICAL。」

結果とパフォーマンス

開発者によると：

• 重要なインフラストラクチャエラー（データベース接続、認証）：Claudeは70-80%を正しく修正
• 明確なスタックトレースがあるロジックバグ：安定したパフォーマンス
• 適切なスタックトレースがない曖昧なエラー：当たり外れがあり、通常はスキップ

このシステムは、nullチェックの欠落や不適切なクエリロジックなどの単純な問題を効果的に処理し、多くの場合最初の試行で修正に成功します。

追加機能

開発者は監視用のインタラクティブなTelegramダッシュボードを構築しました：

• キュー状況
• 最近のエラー
• システム状況
• 更新機能

/errorsビューはMongoDBからデータを取得し、「修正中・5分前」、「検出・12分前」、「修正済み・2時間前」などのステータス情報を表示します。

技術スタック

このシステムはTypeScript、Express、MongoDB、node-telegram-bot-api、Claude Code CLIを使用しています。開発者は、ヘッドレスCLIを使用することでAPIコストを回避でき、ローカルで実行されるClaudeサブスクリプションのみが必要であると指摘しています。各セッションはワークツリー内で限定され分離されているため、リスクが最小限に抑えられます。

開発者はGitHubでリポジトリを公開する予定で、汎用的なシステムとして説明しています — ユーザーはウォッチャーをログファイルに向け、重大度パターンを設定するだけです。