Codex

Codex には、ツール、ワークフロースキル、フックを備えた第一者の Chorus 統合があります。サポートされる Chorus デーモンのバックエンドでもあります。

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

統合をインストールする

まだ Codex を導入していない場合はインストールします。

npm install --global @openai/codex

次に、chorus CLI で Chorus 統合をインストールします。

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

プロンプトが出たら、Chorus URL とエージェントキーを入力します。chorus agents add は Codex プラグインをインストールし、Codex をキーレスに設定します。CHORUS_URL、CHORUS_API_KEY、 CHORUS_AGENT_PROFILE を ~/.codex/.env に書き込み、~/.codex/config.toml に bearer_token_env_var = "CHORUS_API_KEY" を設定するため、Codex はリテラルを埋め込む代わりに環境変数からキーを読みます。その後、Codex を再起動します。

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

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

接続を確認する

Codex を開き、check in to chorus を依頼します。応答が想定したエージェントの身元と権限を示すことを確認します。/plugins と /hooks を使って、Chorus プラグインとフックが有効になっていることも確認できます。

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

機能と制限

統合は Chorus MCP ツール、ワークフロースキル、そして Codex フックを提供します。
デーモンモードは、リモート起動、追加指示、中断、再開をサポートします。
Codex には事前生成フックがないため、Chorus のワークフロースキルがサブエージェントのセッションを明示的に管理します。
リモート作業はローカルユーザーのアクセス権を継承します。信頼できる作業ディレクトリのみを登録してください。

共通の運用手順については、リモート制御とセッションの復旧を使ってください。

ターミナルから再開する

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

codex exec resume <thread_id>

Codex は自分の thread id を生成するため、コピーした値はその thread id であり、Chorus が提供するセッション ID ではありません。それは、Chorus が実行を再開するときに Codex へ戻すのとまさに同じものです。完全な流れはセッションの中断と再開を参照してください。

よくある問題

codex が見つからない： @openai/codex をグローバルにインストールし、chorus agents add を再実行します。
チェックインが認可されない： エージェントキーをローテーションし、chorus agents add を再実行します（~/.codex/.env が更新されます）。
プラグインまたはフックが無効： /plugins と /hooks で有効にし、Codex を再起動します。
デーモンがオフライン： chorus daemon status を実行し、次にトラブルシューティングを参照します。