OrcaとほかのAIをつなぐ手順（その1）公式が用意する連携：Claude Code・Codex・Cursor CLIの接続、Orca CLIとスキル、Orchestrationで別のエージェントに仕事を渡す、自動実行、MCP――設定する場所、渡るデータ、外し方、うまくいかないときの確認点

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者は Orca を入れていますが、使い心地はこの記事には書いていません。設定やコマンドは「公式ページの例を、取得した要約から並べたもの」と、「この記事で組んだ案（動作は確かめていません）」を、そのつど区別します。コマンドや、スキル・サービスの登録など、システムに何かを足す操作は、公式ページの原文を見て入力してください。

先に結論

• 接続の中心は、各エージェントCLIのログインです。 OrcaがClaude Codeなら ~/.claude、Codexなら ~/.codex を読みます（公式のエージェント別ページ）。
• 「エージェントにOrcaを操作させる」道は3段階あります。 ①orca コマンドを使わせる（Orca CLIとスキル orca-cli）、②仕事のまとまりと割り当てを使わせる（Orchestration、Experimental）、③自動実行を作らせる（orca automations）。
• MCPは、登録の場所だけが書かれています。
• 渡るデータと、設定で切れる権限は、連携ごとに違います。 各節の表で確かめてください。
• 外のサービスとの連携は、その2（08）に分けました。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIのツールと外のサービスをつなぐ共通の決まりです。「MCPサーバー」は、ツールを提供する側のプログラムや接続先です。
• スキル（skill）：エージェントに使い方を教える手引きのフォルダです（公式は SKILL.md を含む形と書いています）。
• Orchestration：公式の複数エージェントの仕組みです。「Run」（まとまり）の中に「Task」（作業）を作り、ワーカー（エージェント）に割り当てます。
• フック（hook）：エージェントのCLIが、状態などをOrcaに知らせる仕掛けです。Orcaの「status hooks」は、working、waiting、doneの表示に使われます。
• OAuth / APIトークン：サービスにログインするときの方式（ブラウザで許可する）と、自分で発行する合言葉です。トークンは、パスワードのように扱います。
• Relay：スマホとデスクトップのOrcaをつなぐ経路の1つです。公式は、サインインが要ると書いています。

連携の地図

連携1：エージェントCLIをOrcaに接続する

手順

1. エージェントのCLIを入れて、Orcaの外のターミナルで一度ログインします（05の手順0）。
2. Orcaで、worktreeを作り、agent comboboxからエージェントを選びます。
3. 設定の「Agents → Installed agents」で、見つかったCLIの有効・無効を切り替えられます（起動メニューに出すものを絞る）。
4. 「Agents → Per-agent launch defaults」で、実行ファイルのパス・名前、コマンド、引数、環境変数を、エージェントごとに上書きできます。

エージェントごとの記載

渡るデータ

• プロンプトやコードは、Orcaではなく、選んだエージェントCLIから、そのエージェントの会社へ送られます。この記事の根拠にしたOrcaの資料には、各社の扱い（学習への利用など）は書かれていません。各社の公式の資料で確かめてください。
• Orcaは、利用状況の匿名データだけを、PostHog Cloud（米国）へ送る、と公式の「Privacy & Telemetry」に書かれています（プロンプト、応答、ターミナルの中身、ファイルパスなどは送られない、と書かれています。04）。

権限

• 「Agents → Agent permissions」は、新しいセッションの許可の方式（Manual、Auto、Yolo）です。公式の「Supported agents」は、新しい起動で、各CLIの許可を省くフラグ（Claude Codeは --dangerously-skip-permissions、Codexは --dangerously-bypass-approvals-and-sandbox、ほかの一部は --yolo）を事前入力する、と書いています。
• 引数や環境を自分で上書きしたエージェントは、この切り替えの対象になりません。1つのエージェントだけ許可の確認を戻すには、そのエージェントの既定の引数や環境を編集します。
• 「Trust the folder when Orca starts an agent」（既定でオン）は、Orcaが起動したエージェントの、フォルダの信頼の確認を省きます。
• Autoを使えるのは、Claude、Claude Agent Teams、Codexです。

外し方

• エージェントを使わないなら、「Installed agents」で無効にする（起動メニューから消える）。
• 状態表示のフックは、orca agent hooks off、または「Agents → Agent status hooks」で切れます（orca agent hooks status で状態の確認）。
• 認証そのものの取り消し（ログアウト）は、各エージェントの側の操作です。Orcaのページには書かれていません。
• Codexのhomeの削除や、Orcaのアカウント用データの消し方は、読んだページには書かれていません。

うまくいかないとき

連携2：Claude Agent Teams

• 公式の「Supported agents」は、「Claude Agent Teams」は既定で無効で、「Settings → Agents」で有効にすると、orca claude-teams で起動できる、と書いています。
• Claude Codeのページは、バックグラウンドのサブエージェントやAgent Teamsのチームメイトが、リードのエージェントの下に、開閉できる子の行として出る、と書いています（worktreeのエージェント一覧とAgent Dashboard）。子を選ぶと、リードのターミナルにフォーカスが移ります。
• 設定の一覧は、Autoの許可を使えるものにClaude Agent Teamsを含めています。
• 外し方：同じ設定で無効に戻す、と読めますが、戻す手順そのものは、読んだページには書かれていません。

連携3：Orca CLIとスキル（エージェントにOrcaを操作させる）

3-A：Orca CLIを登録する

1. 「Settings → General → Orca CLI」で登録します（CLI referenceは、「Settings → Experimental → CLI」と書いており、表記が食い違います。手元の画面で確かめます）。
2. 確認：

command -v orca
orca status --json

1. CLIは、動いているOrcaのアプリを操作します。Orcaは、端末のPATHの先頭に自分の orca を置き、古い別のインストールより優先する、と書かれています。
2. Linuxのコマンド名は orca-ide です（Installページ）。

CLIのコマンド群（CLI referenceの目次から。詳細はそのページで確認）：orca repo、orca worktree、orca agent launch、orca terminal、orca linear、orca automations、orca environment、orca skills、orca account、orca artifacts、orca computer、orca emulator、orca orchestration、ブラウザの操作（goto、snapshot、click など）。orca github の群は、そのページには見当たらない、と取得できました。

CLI overviewが載せている例（要約から並べたもの。全文は公式ページで確認）：

orca worktree create --repo id:<repoId> --name my-task --issue 123 --json
orca terminal send --text "continue" --enter --json
orca terminal wait --for tui-idle --timeout-ms 30000 --json
orca goto --url https://example.com --json

3-B：スキルを入れる

公式の「Orca skills registry & MCP」の記載です。

標準のエージェント設定では、通常 orca-cli、computer-use、orchestration が入る、と書かれています。入れ方の例（公式ページの例。実行前に原文で確認し、--dry-run を使うと、実行する内容を先に見られます）：

npx skills add https://github.com/stablyai/orca --skill <name> --global
orca skills install --skill orca-cli --agent claude-code,codex
orca skills install --all --dry-run

• 範囲は、既定でグローバル。--local で現在のプロジェクトだけ。
• 入れる先は、Orcaが見つけたエージェントと、共有の .agents/skills。見つからなければ --agent が必要です。
• 入れる前に、中身（ファイル、スクリプト、実行ファイル）を確かめてください。公式は、skills/<名前>/SKILL.md を持つ任意のリポジトリを npx skills add で入れられる、と書いています（自分や他人のスキルの場合は、作者と内容の確認が要ります）。
• 入れたスキルは「ハイブリッドのスタブ」で、エージェントはCLIを探し（ORCA_CLI_COMMAND、orca-dev、Linuxは orca-ide、orca）、orca skills get <topic> で最新の手引き全文を読み、フラグは作り出さず --json を使う、と書かれています。

3-C：エージェントに何が渡るか、何ができるか

• スキルを入れたエージェントは、orca のコマンドで、worktreeを作る、ほかのターミナルに入力する、ブラウザを動かす、自動実行を作る、などの操作ができるようになります（公式のCLIの説明）。
• スキルのファイルは、npx を通して公開のGitHubから取得されます。その通信が何を送るかは、読んだページに書かれていません。
• 公式のSSH先の記載：SSHのホスト上の orca は、既定ではそのホストのターミナルとOrchestrationのメッセージにしか届きません。ホストのエージェントに、worktreeの作成、ターミナルを開く、仕事の割り当てをさせるには、「Settings → SSH → ホストを編集 → Advanced Connection」の「Allow this host's orca CLI to control Orca」をオンにします。
• Artifacts（HTMLやMarkdownの公開の閲覧リンク）の作成・一覧・更新・削除は、サインインしたOrcaのアカウントが要り、公開は設定の「Allow publishing public artifact links」でオフが既定です。公式のCLI referenceは、「許可を与えるCLIのフラグはない」と書いています。Settings referenceは、この設定をオンにすると、本人、エージェント、そのマシンの orca CLIのどれもが、アップロードして公開の閲覧リンクを作れる（上限10 MiB）と書いています。リンクを開くだけならサインインは要りません。

3-D：外し方

• スキルの削除：アプリのスキル画面で、「Actions menu → Delete…」。複数なら「More actions → Delete skills…」。同梱、プラグイン管理、読み取り専用などのコピーは消せず、理由が表示されます。
• スキルの更新：「Update skills」は npx --yes skills update <names> --global -y を背景で動かします。手動なら npx skills update orca-cli orchestration computer-use --global。
• Orca CLIの登録の解除方法は、読んだページには書かれていません。

3-E：うまくいかないとき

連携4：Orchestration（リードのエージェントが、別のエージェントに仕事を渡す）

これは「AI同士の連携」にいちばん近い、公式の仕組みです。公式は、「Experimental」と書いています。

設定

1. 「Settings → Experimental」でOrchestrationをオンにします（Orchestrationのページの記載です。Settings referenceのExperimentalの一覧には、Orchestrationの項目が載っていません。手元の画面と照らして確かめてください）。
2. orca status --json で、ランタイムが動いていることを確かめます。
3. エージェントに、orchestration スキルを入れます（3-B）。公式は、エージェントが orca skills get orchestration --full で現在のフラグを読むよう書いています。

流れ（公式のページに書かれた順）

1. リードのエージェントが、Runを作り、目的をTaskに分けます。
2. Taskごとに、worker-start でワーカーを起動します。エージェントは、例として claude、codex、cursor、opencode、muse、antigravity が挙がっています。worktreeは、current（いまの）か、new-child（新しい子）です。ページには、ほかに new-top-level（--on を使う連合の起動だけ）も載っています。
3. ワーカーは、前置きの指示で、worker_done を必ず1回送ること、長い作業のあいだ heartbeat を送ること、止まる質問は ask で聞くことを伝えられます。
4. リードは、check --wait で待ち、届いたメッセージを処理して、確認（ack）します。
5. 作業を止める質問は、「decision gate」（判断のゲート）にします。
6. worker_done を受けたら、ワーカーを解放するか、同じターミナルを次の依頼に使います。

コマンドの例（公式ページの例を、要約から並べたもの。全文と最新のフラグは、公式ページと orca skills get orchestration --full で確認）：

orca orchestration run-create --objective "Split checkout QA and summarize blockers" --json
orca orchestration task-create --spec "Audit billing settings for mobile layout" --task-title "Billing audit" --json
orca orchestration worker-start --task <taskId> --worktree current --agent codex --json
orca orchestration check --wait --types worker_done,escalation,question --timeout-ms 900000 --json

この記事の案：リードにClaude Code、ワーカーにCodex

下は、この記事で組んだ案です。公式の例そのものではなく、動作は確かめていません。

1. 設定でOrchestrationをオンにし、両方のエージェントに orchestration スキルを入れる。
2. Claude Codeのworktreeを開き、リードに、次のような依頼を出す（この記事の例）。

orchestration スキルを読んで、次の作業を2つのタスクに分けて。タスク1は設定画面のレイアウト確認、タスク2は請求画面のレイアウト確認。それぞれ codex のワーカーに渡して、worker_done が来たら結果を短くまとめて。

1. ワーカーのworktreeを、リードが選ぶので、そのとき「現在のworktree」を使うか、新しい子を作るかを、依頼の中で指定する。
2. 流れの途中で、リードが「判断のゲート」を出したら、画面かCLI（orca orchestration gate-resolve）で答える。

渡るデータと権限

• リードとワーカーの間のメッセージ（status、dispatch、worker_done、escalation、question、heartbeat）は、Orcaのランタイムの中の受信箱を通ります。Orchestrationのデータがディスクのどこに残るかは、読んだページには書かれていません。
• ワーカーのエージェントには、それぞれの会社のCLIとして、プロンプトとコードが渡ります。リードがワーカーに依頼文を作るので、リードのエージェントの出力が、別の会社のエージェントへの入力になります。
• ワーカーの許可の方式は、「Agent permissions」の設定に従う、と読めますが、Orchestrationのページには明記がありません。

止め方、直し方

• worker-stop、worker-release、worker-retain、worker-show、worker-read（いずれもdispatchのIDを指定）。
• 公式の注意：reset は、ランタイム全体の状態に効きます。ほかのコーディネーターが動いているときは使わない。worker-release が release_pending や release_unknown を返したら、広く terminal close で代えず、返ってきた回復の手順に従う。
• 古い orchestration run、run-stop、coordinator-start、coordinator-stop は、何もしません（引退）。
• 限界：Antigravityの監督は、SSH越しでは使えません。グループ宛て（@all、@idle、@codex など）は、worker_done や heartbeat には使えません。

連携5：自動実行（automations）

• CLI referenceに、orca automations list|create|run <automationId> があり、主なフラグに --name、--trigger、--time、--prompt、--provider、--repo、--extra-agent-args、--disabled が挙がっています（このほかのフラグや、ページ本文の注意は、「Scheduled automations」のページを読んでいないため、載せません）。
• どのエージェント（provider）で、どんな依頼文を、いつ走らせるかを決める連携です。依頼文には、あなたの指示が入ります。外から来た文章を、依頼文にそのまま入れない、という運用が必要になります（見立て）。
• --disabled のフラグがあるので、無効のまま作ってから確かめる、という使い方もできます（この記事の読み取りです）。

連携6：MCPサーバーを登録する

公式に書かれていること

• 「Settings → Integrations」の中に、MCPの項目があります（スキルのページは「Settings → Integrations → MCP」、設定の一覧は「MCP servers」と書き、表記は少し違います）。ここで登録したMCPの接続先のツールは、MCPに対応するエージェントCLIの中に出ます。
• 設定の一覧は、リポジトリごとのMCPの設定は、選んだホスト（ローカル、SSH先など）に残る、と書いています。
• 登録の欄（アドレス、認証の入力など）の項目は、取得したページには書かれていません。そのため、この記事は、設定例を載せません。
• Claudeのアカウントを切り替えても、共有のMCPサーバーのサインインは引き継がれる、とClaude Codeのページにあります。
• Orca自身が、ほかのAIのアプリから呼ばれるMCPサーバーになるかどうかは、読んだページには書かれていません。

渡るデータと外し方

• MCPで登録した先に、エージェントが何を送るかは、その接続先と、そのMCPの仕様次第です。Orcaのページには書かれていません。
• 登録の削除の手順は、読んだページには見つかりませんでした。

気をつけること

• 運営者は Orca を入れていますが、使い心地はこの記事には書いていません。この記事は、公式の資料を読んだ範囲の手順書で、実際に使って確かめた記録ではありません。「この記事の案」「この記事の例」は、動作を確かめていません。
• 連携は、権限を広げるほど、エージェントがOrcaの外に影響を及ぼせる範囲が広がります。 特に、許可の確認を省く設定、SSH先のホストのOrca CLI、computer-use、Orchestrationは、何を許しているかを、設定の画面で確かめてから使ってください。
• 外から来る文章は、命令を含みうる。 別のエージェントの出力、Webページ、issueの本文を、エージェントに渡すと、その文面に書かれた指示に従ってしまうことがあります。公式のページには、この一般的な説明は、読んだ範囲にはありません。許す操作を絞ることを、僕らは見立てとして挙げます。
• スキルを入れるときは、中身を確かめる。 公式のスキルのページには、--dry-run で、実行する内容を先に見られると書かれています。
• 読んでいないページ。 Computer use、Worktree checkpoints、Agent hooks & memory、Scheduled automations、Remote Orca Servers、Ways to run Orcaの本文は、今回は読んでいません。そこに書かれていることは、この記事に載せていません。
• 食い違い。 CLIの登録場所（General／Experimental）、MCPの表記（MCP／MCP servers）、Autoの許可の扱い（設定の一覧とSupported agents）を併記しました。手元の画面と照らしてください。
• beta・Experimental。 Orchestration、Chat UI、Computer useなどは、仕様が変わる可能性があります。
• コミュニティが作ったOrca向けの連携は、この記事の根拠にしていません。
• 法律や契約の解釈は、公式の規約や専門家に確認してください。この記事は助言ではありません。

出典

• Orca skills registry & MCP（Orca Docs、確認日 2026-10-25）
• Orca CLI overview（Orca Docs、確認日 2026-10-25）
• Orca CLI reference（Orca Docs、確認日 2026-10-25）
• Orchestration（Orca Docs、確認日 2026-10-25）
• Settings reference（Orca Docs、確認日 2026-10-25）
• Supported agents（Orca Docs、確認日 2026-10-25）
• Claude Code in Orca（Orca Docs、確認日 2026-10-25）
• Codex in Orca（Orca Docs、確認日 2026-10-25）
• Cursor CLI in Orca（Orca Docs、確認日 2026-10-25）
• Agents & sessions（Orca Docs、確認日 2026-10-25）
• SSH worktrees（Orca Docs、確認日 2026-10-25）
• Troubleshooting & FAQ（Orca Docs、確認日 2026-10-25）
• Privacy & Telemetry（Orca Docs、確認日 2026-10-25）
• Install（Orca Docs、確認日 2026-10-25）