コンテンツにスキップ
Chorus Chorus

エージェントランタイムを接続する

Chorus の管理者からエージェントの API キーを受け取った後に、このガイドを使ってください。Claude Code、Codex、Kiro、Pi を、Chorus からリモートで作業を始められる常駐ランタイムとして接続します。

Hermes は Chorus daemon ではなく自前のゲートウェイでオンラインを維持します。コメント承認と中断・再開に対応しますが、調査とアイデア作成の専用操作ターンは実行しません。

始める前に

Section titled “始める前に”

次のものが必要です。

  • Chorus の URL とエージェントの API キー。
  • Node.js 22 以降。
  • 選んだエージェント CLI がインストールされ、認証済みであること。
  • 承認された作業ディレクトリが少なくとも一つ。

Chorus コマンド（0.17.2 以降）をインストールします。

Terminal window
npm install --global @chorus-aidlc/chorus

エージェントを設定する

Section titled “エージェントを設定する”

chorus agents add は、このマシンのエージェントを 1 つのコマンドで Chorus に接続します。すでにインストールしているエージェントを検出し、それぞれの Chorus プラグインをインストールし、Chorus の URL と API キーを ~/.chorus/daemon.json に一度だけ保存します。Claude Code、Codex、Hermes、DeepSeek Harness については、認証情報をそのエージェント自身の設定にも書き込むため、対話型のセッションでも、環境変数を手動で設定しなくても認証されます。

Terminal window
chorus agents add

プロンプトが出たら、Chorus の URL と API キーを入力し、設定するエージェントを選びます。このコマンドは冪等なので、エージェントの追加、プラグインの更新、キーの交換のためにいつでも再実行できます。プロンプトなしで特定のエージェントを設定するには、次のようにします。

Terminal window
chorus agents add --agents claude,codex \
  --url https://chorus.example.com --api-key cho_REDACTED --yes

プラグインをインストールせずに認証情報だけを保存したい場合（例えば、エージェントがすでにセットアップ済みのマシンなど）は、代わりに chorus login を実行してください。URL とキーを検証し、接続を ~/.chorus/daemon.json（モード 0600）に書き込みます。

chorus agents と chorus mcp のすべてのオプションについては、chorus CLIを参照してください。

ランタイムを起動する

Section titled “ランタイムを起動する”

承認された作業ディレクトリを一つ指定して起動します。

Terminal window
chorus daemon --agent claude-code --cwd /path/to/your/project --chorus-only

必要に応じて claude-code を codex または kiro に置き換えます。--chorus-only は、エージェントが使えるツールを Chorus のツールに制限します。このオプションを省略するのは、エージェントにローカルのツールをすべて使わせることを意図していて、そのセキュリティ上の影響を確認済みの場合だけにしてください。

接続を確認する間、このコマンドは実行したままにします。ログイン時にデーモンが起動するようサービスをインストールするには、chorus agents add に --daemon-autostart を追加するか、Chorus デーモンを運用するを参照してください。

接続を確認する

Section titled “接続を確認する”

Chorus で 設定 → エージェント（Settings → Agents）を開き、エージェントの接続を確認します。次を確かめます。

  • ステータスがオンライン（Online）であること。
  • バックエンドが、選んだ CLI と一致すること。
  • ホストが、あなたが運用しているマシンであること。
  • 作業ディレクトリが、あなたが承認したディレクトリであること。
Codex バックエンド、ホスト、作業ディレクトリを表示しているオンラインのエージェント接続
オンラインのランタイムには、バックエンド、ホスト、登録済みの作業ディレクトリが表示されます。

このマシンに設定されたエージェントは、いつでも chorus agents で一覧できます（名前、UUID、バックエンドが表示され、API キーは決して出力されません）。1 つを削除するには chorus agents remove <name|uuid> を使います。

確認後は Ctrl+C でフォアグラウンドのランタイムを停止します。ログインや再起動をまたいで使えるようにするには、Chorus デーモンを運用するへ進んでください。