メインコンテンツへスキップ
見出し画像

なぜ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)

     
     
    面倒な作業をAIに任せる方法を試して書いてます。エンジニアじゃないけど、Claudeを使って通知・集計・レポートを自動化中。手順は全部公開。

    あなたへのおすすめ