Claude Codeを自作アプリから操作する方法

stream-jsonは、Claude Codeを動かす他の2方式、対話型ターミナル画面と単発のclaude -pコマンドの中間策と位置づけられる。単発モードでは1回答でプロセスが終わるため、会話を続けるには--resumeで再起動が必要で、ターン途中の許可確認に答える手段もない。これに対しstream-jsonは標準入力が閉じられるまでCLIプロセスを開いたままにし、プログラムはターンの進行に合わせてユーザー行を続けて送り、assistant・result・control_requestの各行を受け取れる。

開発者自身のアプリtanacodeは、これが実務でなぜ重要かを示す。バージョン1.xは対話型画面をバックグラウンドで動かしてテキストを読み取り、チャットと許可カードを組み立てていたため、Claude Codeの画面が少し変わるたびに壊れた。バージョン2.0.0はチャットをstream-jsonで作り直して画面読み取りコードを削除し、許可プロンプトや質問はcan_use_tool要求から作るカードになり、回答はcontrol_response行として返る。

運用上の注意点も挙げられている。プログラムは使わない要求にもすべて応答すべきで、中断したメッセージは会話に残り、stream-jsonセッションはclaude --resumeの一覧に表示されないため再開にはinit行のsession_idが必要だ。開発者はstream-jsonの行形式がClaude Codeの更新で変わりうるとし、tanacodeは新たな行種別を検知するため毎日モックAPIに対して最新のClaude Codeを動かしているという。