AI プロファイルのロールは、以下で実行できます:ご自身のマシン上で動作するコーディングエージェントモデル CoRoid が呼び出すのではなく、代わりにエージェントがその場でロールの推論を実行します。 設定した通りにあなたのアカウントでサインインし、プロバイダーと連携して作業します。CoRoid は そのロール用のツールを提供し、ワークフローの残りの部分――タスク、チェックやゲート、履歴――も管理します。
対応範囲
- Decisionエンジンを除く、プロファイル内のすべてのロールです:その アーキテクトおよびコーディネーター、 デベロッパー、QA、 レビュアー、ウェブテスター、翻訳者なども含まれます。Decisionエンジンはエージェントとして実行されるものではなく、許可された回答ごとの確率を決定モデルに問い合わせる仕組みであり、コーディングエージェントでは対応できません。
- 4種類のエージェント:CodexとOpenCode、そして一部の組織向けにはClaude CodeとCursorも利用可能です。各エージェントはそれぞれのプロバイダーが提供するプランで動作します(詳しくはご自身のエージェント用プラン)。
- タスクの実行方法コーディネーターモードでは、コーディネーターとその下で割り当てられた子エージェントが、他のロールと同様にエージェント上で作業を実行します。
ご自身のエージェント用プラン
エージェントは、あなた自身のサインイン情報を使い、プロバイダーのプランに基づいて動作します。Claude CodeはAnthropic、CodexはOpenAI、CursorはCursor社、OpenCodeは設定したプロバイダーが対象です。CoRoid はそのサインイン情報を一切参照せず、誰かのプランを再販売したり共有したりすることもありません。各ユーザーが自分のマシンを接続し、そこで開始した作業をエージェントが処理します。
あるプランの利用条件が他の製品経由での使用を許可しているかどうか、またそれがどのような作業に適用されるかは、ユーザーとプロバイダーの間で決定されます。プロバイダーや個人/法人プランによって異なり、処理量や変更の影響も受けるため、必ずプランの利用規約を確認し、不明な点はプロバイダーに問い合わせてください。
エージェントにロールを割り当てる組織は、従業員のプランについても同様に確認する必要があります。ポリシーでは、利用規約を確認済みのエージェントのみを許可する場合があります(詳しくは組織で許可される内容)。
接続方法
あなたのマシン
CoRoidコネクター
オープンソース。新しい空のディレクトリでエージェントを起動し、終了後に停止させます。
あなたのコーディングエージェント
使用するエージェントは、あなたのアカウントでサインインし、自身のツールは無効化されています。
- 1作業を依頼します。 各要求の処理時間は最大25秒で、コネクターは3秒ごとにエージェントの発言を報告します。
- 2その役割のツールを呼び出します。 この処理専用のトークンが使用され、処理終了と同時に無効になります。
- 3自身のモデルに問い合わせます。 CoRoidがなければ通常通りの動作となります。CoRoidはそのサインイン情報を一切参照しません。
CoRoid
オーケストレーター
タスクを開始した人のマシンに、役割に応じた作業を割り当てます(1)。
その役割が利用するツール
タスクのサンドボックス内で実行され、あなたのコードはそこに保持されます(2)。
エージェントのプロバイダー
あなたのアカウントでサインインし、ご自身のプランに基づいてエージェントのモデル要求に応答します(3)。
マシン内に侵入することはありません:コネクターはポートを開放せず、ファイルを送信せず、自身のコマンドを実行しません。
マシン内には、エージェントへのあなたのサインイン情報と、処理中にエージェントが保持するデータのみが残ります。
マシンは CoRoid に対して、以下を通じて機能します:CoRoid コネクター、これはインストールして実行する小さなオープンソースプログラムです。接続はすべてマシン側から開始されます。コネクターが CoRoid に作業を依頼し、エージェントがタスクのサンドボックス内でロール用のツールを呼び出し、あなたのサインイン情報を使ってプロバイダーにモデルの回答を求めます。コネクターはポートを開かず、マシンのファイルを送信することもありません。コネクターのセキュリティでは、その機能と制限、およびリリース版の確認方法について説明しています。
マシンを接続する
-
マシンにエージェントをインストールし、通常通りにサインインします。
-
macOSまたはLinuxではHomebrewを使ってコネクターをインストール:
brew install coroid-ai/tap/coroid-connectorまたは、Node.js 20以降を搭載する環境ではnpmを使用:
npm install --global @coroid/connector -
CodexまたはClaude Codeの場合は、エージェントを追加:
coroid-connector add codex(またはadd claude)。これによりエージェント用のACPアダプターがインストールされ、独自のエージェントコピー(約350 MB)が~/.coroid/connector、コネクターがハッシュでロックするパッケージから取得されます。OpenCodeとCursorは追加不要で、CoRoid は既存のインストール版を利用します。 -
開く設定 → 接続 → ご自身のマシンを開き、そこに表示されるコマンドを実行します(
coroid-connector --api …)。ブラウザが開き、組織用のマシンを承認するよう求められます。承認するのは、直前に起動したコネクターのみです。
その後、コネクターは停止するまで継続して CoRoid に作業を依頼し続けます。ご自身のマシンには接続済みのマシンが一覧表示され、コネクターが検出したエージェントとそのバージョンが示されます。エージェントが利用可能なのは、CoRoid が試験済みのバージョンのみで、別のバージョンでは表示されても使用されません。
coroid-connector statusにはマシン側の同じ情報と、各エージェントに設定されているモデルが表示されます。
ご自身のマシン情報は、あなただけが閲覧できます。接続を解除するを実行すると、マシンのサインインが終了し、1分以内にコネクターが停止します。
エージェントにロールを割り当てる
組織のオーナーは、カスタムプロファイル内で以下の手順で設定します:設定 → AI プロファイル(詳しくはAI プロファイル)。
- プロファイルの詳細を開きます。ロールの最初のフィールドには、以下が一覧表示されます:ご自身のマシンで実行:組織で利用可能なエージェントと、それぞれがご自身のマシンで利用可能かどうかが示されます。
- エージェントを選択します。さらに2つのフィールドが表示されます:
- モデルを:この役割に使用するエージェントのモデルで、接続されたマシンが報告するモデルの中から選択します。マシン上で設定された通りですエージェントは、所有者が設定したモデルを使用します。
- 接続されたマシンがない場合:作業を行うマシンがないときにその役割を実行するモデルで、その役割が以前使用していたモデルです。
- 保存
最初のフィールドで別のモデルを選択すると、エージェントは切り替わり、対応するモデルも変更されます。
タスクが実行される際の流れ
割り当ては組織側のものです;マシンは個人のものです。役割が開始されると、CoRoidはタスクを開始したユーザーのマシンを探します:
- 過去1分間にこの組織内で接続されていたマシンで、
- CoRoidが試したバージョンで、割り当てられたエージェントが準備完了しているマシンで、
- 割り当てでモデルが指定されていれば、そのモデルを提供するマシンです。
該当するマシンがあれば、役割の作業はそのマシンで実行されます。なければ、役割は「接続されたマシンがない場合」で指定されたモデルで動作します。接続されたマシンがない場合、本来の通りに処理されます。マシンを待つことはありません。誰も開始していない作業(イベントに基づく自動化やスケジュール)には該当するマシンがなく、そのモデルで実行されます。
マシン上では、コネクターが新しい空のディレクトリでエージェントを起動し、そのセッションに一連のツールを渡します:この役割用のCoRoidのツールで、この作業専用です。Developerはこれらを通じてコードを変更し、CoRoid内のタスクワークスペースでモデルと同様に作業します。QAやReviewerもこれらを通じてその変更を評価します。エージェントが作業中にタスクに追加されたメッセージは、次のツール結果と共にエージェントに届きます。
待機中の役割はエージェントに戻されます。コーディネーターがDeveloper、QA、Reviewerに作業を割り当て、各工程の完了を待ちます。子役割はコーディネーターの回答を待つこともあります。待機が終了すると、役割はエージェントに戻され、これまでの会話内容が引き継がれます。マシンは最大4つの役割を同時に実行できます(コネクター0.4.0)。そのため、Developerが起動したエクスプローラーも並行して動作します。
役割の実行中にマシンが応答を停止しても、役割は同じ会話を継続し、クラウドモデルで処理が続けられ、発生した事象が伝えられます。停止されたタスクではエージェントも停止します。役割が終了すると、エージェントは停止され、ディレクトリも削除されます。
マシン上に残るデータ
コネクターは役割が実行されたディレクトリを削除します。エージェントが自身のストレージに保持する作業データはエージェントにより異なります:
| エージェント | 保持されるデータ |
|---|---|
| Claude Code | トランスクリプトはなし:コネクターはセッション永続化機能をオフにして起動します |
| Codex | 各セッションのトランスクリプトが~/.codex/sessionsに保存され、読み込まれたファイルも含まれます |
| OpenCode | セッション情報は独自のデータベースの~/.local/share/opencode |
| Cursor | 各セッションは独自のデータベースの~/.cursor/acp-sessions |
Codex、OpenCode、Cursorには現在この設定を切り替える機能はありません。組織でノートパソコンにコードを残さないよう求める場合は、ポリシーでClaude Codeのみを許可してください(下記参照)。
組織で許可される内容
所有者または管理者が設定 → IDおよびアクセス → 組織ポリシーで設定し、ユーザーのマシン上で動作するコーディングエージェント、すべてのプランで適用されます:
- ユーザーのマシン上でコーディングエージェントを許可するこの設定がオフの場合、すべての役割はそのモデルで実行され、プロファイルで既にエージェントに割り当てられている役割も同様です。
- エージェントごとに1つのスイッチ組織で利用可能な設定に加え、そのエージェントがマシン上に保持するデータも考慮されます。すべてのエージェントが有効な場合、後からCoRoidが提供するエージェントも自動的に有効になります。
AIのプロファイルフォームにはポリシーで許可されたエージェントのみが表示され、役割を別のエージェントに再割り当てすることはできません。ポリシー変更前に割り当てられた役割はその設定が維持され、フォームには「そのモデルで実行される」と表示されます。プロジェクトのポリシーは組織のポリシーを狭めることはあっても、広げることはできません。
エージェントの実行可能・不可な操作
- CoRoidのツールのみ。各エージェント固有のツール(シェル、ファイル編集、ウェブ検索、独自のMCPサーバーやコネクター)は、そのエージェントが提供する方法でセッション中は無効化されます。他のツールの使用要求は拒否されます。
- マシンのデータは一切使用不可。エージェントはユーザーのチェックアウト環境で作業せず、マシンのファイルにもアクセスできません。CoRoidもマシンへのアクセス権を持たず、コネクターはCoRoidに作業を依頼し、エージェントの返答を報告するだけです。
- 同じチェックが適用されます。エージェントが行った変更は、モデルの作業と同様に同じQA、レビュー、ゲート、ステップ制限を経ます。
- 送信されるデータ役割に必要な情報(読み込むコード、要件、ツールの実行結果、添付ファイルの画像など)はマシンに送られ、そこからそのエージェントが持つサインイン情報を使ってエージェントプロバイダーに渡されます。組織で特定のプロバイダーとコードを共有する必要がある場合は、エージェントに役割を割り当てる前にそれを考慮してください。
コストと記録
エージェントの処理結果は、作業を実行したマシンを使用したユーザーの負担となり、CoRoidのモデル利用料には含まれません。タスクの活動履歴には次のような実行内容が表示されます。Codex (gpt-6-luna) がAdaのノートパソコンで実行・課金対象外ゼロトークンになることはありません。役割がクラウドモデルで処理された場合、その部分は通常通り課金対象となります。
CoRoidは、マシンに割り当てられた各作業内容を記録します。どのマシンとエージェントが使用され、モデル名、処理結果、ツール呼び出し回数などです。
エクスポートとインポート
割り当てられたエージェントとそのモデルは設定エクスポート時にプロファイルと共に保存され、ポリシーで指定されたエージェントの選択内容は組織ポリシーと共に保存されます。ローカルエージェントが存在しない、またはそのエージェントが利用できない、あるいはポリシーで許可されていない組織の場合、割り当て内容はクラウドモデルのみでインポートされ、インポート時にはその旨が表示されます。詳細はこちらをご覧ください。エクスポートおよびインポート設定。