Claude Code

Claude Code には公式の Chorus プラグインがあります。対話的な Claude Code セッションで Chorus ツールとワークフロースキルをサポートし、サポートされる Chorus デーモンのバックエンドとしても動作します。

インストール前に、エージェントのアクセスを準備するに従って API キーを作成します。

バックグラウンド子エージェント（0.22.0）

Claude daemon 実行では主ターン後に既定で 60 分（3600000 ms）子を待ちます。CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS が CHORUS_CLAUDE_BG_WAIT_CEILING_MS より優先し、実行全体の制限ではありません。親は完了結果を集めるか子を明示的に停止してからターンを終了します。子が強制終了されれば実際の終了コードがゼロでも異常となり、起点のアイデアやタスクにコメントしようとします。状態修復や新たな自動再試行はありません。ゼロ・空値の危険、設定、診断は daemon のタイムアウト設定を参照してください。

プラグインをインストールする

最も手早い方法は chorus CLI です。プラグインをインストールし、認証情報を保存してくれます。

npm install --global @chorus-aidlc/chorus
chorus agents add --agents claude

プロンプトが出たら、Chorus URL と API キーを入力します。chorus agents add は claude plugin marketplace add / claude plugin install を代わりに実行し、CHORUS_URL、 CHORUS_API_KEY、CHORUS_AGENT_PROFILE をユーザー全体の ~/.claude/settings.json の env ブロックに書き込むため、対話的な Claude Code セッションは手動の環境設定なしで認証されます。その後、Claude Code を再起動します。

手動でインストールする場合は、起動するシェルで認証情報を設定します。

export CHORUS_URL="https://chorus.example.com"
export CHORUS_API_KEY="cho_REDACTED"

次に、Claude Code 内からプラグインを追加します。

/plugin marketplace add Chorus-AIDLC/chorus
/plugin install chorus@chorus-plugins

インストール後に Claude Code を再起動します。

リモート起動を有効にする

対話的な Claude Code セッションからのみ Chorus を使う場合は、このセクションを飛ばしてください。それ以外の場合は、エージェントランタイムを接続するに従い、バックエンドとして claude-code を選びます。Chorus デーモンを運用するに従ってオンラインを維持する前に、フォアグラウンドで接続を確認してください。

0.20.0 のデーモン動作

起動ごとに一つの claude -p プロセスを作り、ターン終了後に終了する点は従来どおりです。Chorus は双方向の stream-json 入出力を使い、制御応答のために接続を開いたままにします。既存セッションと claude --resume は引き続き利用できます。プレーンテキストへのフォールバックや通信方式の切り替えはありません。Linux 上の Claude Code 2.1.283 と 2.1.284 で実行検証済みです。これは検証済みバージョンであり、すべての Claude リリースに対する最低互換バージョンの保証ではありません。

中断：デーモンはまずプロトコル経由で中断を送ります。sigintTimeoutMs 以内にプロセスが停止しなければ、プロセスツリーを強制終了します。既定値は従来どおり 10 秒です。
制限対象ツール：--chorus-only モードでは Chorus 以外のツールを明示的に拒否し、Chorus ツールを使うか Chorus のコメントで質問するようエージェントに伝えます。ログには拒否したツール名だけを記録し、入力内容は記録しません。YOLO の動作は変わりません。
質問：デーモンによる起動では、YOLO を含めて常に AskUserQuestion が無効になります。端末で回答する人がいないため、エージェントは Chorus のコメントか要件詳細化を通じて質問します。対話的な Claude Code セッションの質問フローは変わりません。

更新後は、ホストに実際にインストールされている Claude Code のバージョンで、チェックイン、追加ターン、中断と再開を確認してください。プロトコルエラーの診断にはデーモンのログを、作業の続け方はセッションを中断して再開するを参照してください。

接続を確認する

Claude Code で /plugin list を実行し、chorus@chorus-plugins が有効になっていることを確認します。次に、Claude Code に check in to chorus を依頼します。成功すると、応答が接続されたエージェントとその権限を示します。

デーモンモードでは、Chorus の設定 → エージェントを開き、想定したホストと作業ディレクトリがオンラインであることを確認します。

機能と制限

プラグインは Chorus MCP ツール、ワークフロースキル、そしてライフサイクル統合を提供します。
デーモンモードは、リモート起動、追加指示、中断、再開をサポートします。
リモート作業は、登録された作業ディレクトリ内で、ローカルの OS ユーザーが利用できるすべてにアクセスできます。信頼できるディレクトリのみを登録してください。

共通の運用手順については、リモートのエージェントで作業を始めるとセッションを中断して再開するを参照してください。

ターミナルから再開する

自分のターミナルから進行中の会話を引き継ぐには、チャット UI からそのセッション ID をコピーし（トランスクリプトのヘッダーにある セッション ID をコピー）、その会話の作業ディレクトリで実行します。

claude --resume <sessionId>

コピーした ID は、Chorus がセッションを再開するときに Claude Code へ渡すのと同じ ID です。 Claude Code バックエンドの場合、それはそのセッションがひもづく着想の UUID です。完全な流れはセッションを中断して再開するを参照してください。

よくある問題

プラグインが表示されない： Claude Code を再起動し、/plugin list を確認します。
チェックインが認可されない： API キーを作成またはローテーションし、次に chorus agents add を再実行して（または ~/.claude/settings.json の env ブロックを更新して）、 Claude Code を再起動します。
デーモンがオフライン： chorus daemon status を実行し、次にエージェント接続のトラブルシューティングを参照します。
想定と異なる作業ディレクトリがオンラインになっている： 意図した絶対パスの --cwd 値でデーモンを再インストールします。

サブエージェントのセッション

プラグインが管理するサブエージェントのセッション名にはエージェントの種類を使います。同じ種類の並列サブエージェントは Chorus セッションを共有でき、最後の一つが終了するまで開いたままです。これにより、一つが終了しても、まだ動いている他のサブエージェントの追跡は途切れません。