
なぜClaude Agent SDKでSlack常駐AIボットを作ったのか — サブプロセス方式の限界と設計判断
Claude Agent SDKを使って、Slack上で24時間常駐するAIアシスタントを構築・運用しています。26日間稼働させた結果、144リクエストを処理し、84回の自動再接続を経験し、2件のAPIエラーに遭遇しました。
この記事では、最初に採用したサブプロセス方式(claude -p)がなぜ破綻し、SDK移行に至ったかの経緯を共有します。
背景: 24時間動くSlack AIボットが欲しかった
個人の日常を管理する自律型AIアシスタント「分身OS」を開発しています。Slack経由で常時待機し、タスク管理、スケジュール確認、外部API連携(Googleカレンダー、Jira、HealthPlanet等)を行うシステムです。
要件は明確でした:
・Slackでメッセージを送ったら、AIが応答する
・スレッド内の会話を記憶する(セッション継続)
・ファイル(画像・PDF)を送ったら読み取る
・外部ツール(CLI、MCP Server)を呼び出せる
・24時間落ちない
最初の実装: サブプロセス方式(claude -p)
最初はシンプルに、Slackメッセージを受信するたびに claude -p "質問" をサブプロセスで呼ぶ方式を採用しました。実装は簡単で、1日で動くプロトタイプができました。
しかし2週間の運用で以下の問題に直面し、断念しました:
1. セッション継続ができない
サブプロセスは毎回新規プロセスなので、前のメッセージの内容を覚えていません。Slackのスレッド内で「さっきの件だけど」と言っても通じない。会話履歴を自前で管理してプロンプトに毎回詰め込む必要があり、コンテキストが膨らみます。
2. 起動オーバーヘッド(毎回2-3秒)
claude CLIの起動に毎回2-3秒かかります。人間が待てる時間ですが、自律ループ(10分間隔で自動実行)では無視できないオーバーヘッドです。
3. stdout/stderrのパースが不安定
CLIの出力をパースしてSlackに返す処理で、ツール呼び出しの出力とAIの応答が混在し、切り分けが困難でした。
4. コスト追跡ができない
APIコストの情報がstdoutに含まれないため、どのリクエストにいくらかかったか把握できませんでした。
SDK移行で全て解決した
Claude Agent SDK の query() に移行したところ、上記の問題が全て解決しました:
【サブプロセス方式 vs SDK query()】
・セッション継続: 不可能(毎回新規) → resumeで継続可能
・起動オーバーヘッド: 2-3秒/回 → 初回のみ
・コスト追跡: stdout解析が必要 → total_cost_usdフィールドで取得
・中断制御: killシグナル → AbortController
・stderr: 混在して不安定 → 専用イベントで分離
ただし、SDKに移行すれば全て順調かというと、そうではありませんでした。query()のストリーミングメッセージの型が未ドキュメントだったり、Socket Modeの切断問題があったり、セキュリティ設計が必要だったり、別の「地雷」が待っていました。
26日間の運用で得た数値
・総リクエスト数: 144件
・総セッション数: 165件
・WebSocket再接続: 84回(平均3.2回/日、メッセージ喪失0件)
・APIエラー: 2件(400エラー1件、500エラー1件)
・合計コスト: $53.46(平均$0.37/リクエスト)
これらの詳細な分析と、運用で踏んだ5つの地雷(query()の型の罠、resume失敗条件、Socket Mode切断、Slack mrkdwn問題、ファイル受信の落とし穴)については、別の記事で詳しく解説します。
まとめ
・claude -p のサブプロセス方式は「プロトタイプには最適」だが「運用には耐えない」
・Claude Agent SDK query() はセッション管理、コスト追跡、中断制御を全てネイティブにサポート
・ただしSDK固有の地雷もある(詳細は有料記事で解説予定)
Claude Agent SDKでSlackボットを作ろうとしている方の参考になれば幸いです。
続きはこちら(有料記事)
この記事で触れた「5つの地雷」の詳細、query()のメッセージ型の全容、セキュリティ設計、26日間の運用データの分析は、以下の有料記事で解説しています:
👉 Claude Agent SDK query() 実践ガイド — Slack Bot実装で踏んだ地雷と設計判断(¥500)