OrcaでClaude CodeとCodexを並列・自律で動かす(Orca Bots対応)

公開 更新 13 分で読了
OrcaでClaude CodeとCodexを並列・自律で動かす(Orca Bots対応)

無料のOrcaでClaude CodeとCodexを別々のworktreeに並べる手順を実画面で解説します。GitHubのPR・Issue・Actionsとの連携、Orca Botsの定期実行とイベント起動、Yoloモードの初期設定と権限の絞り方も紹介します。

Orcaは、Claude CodeやCodexなど複数のAIコーディングエージェントを、契約済みのアカウントで並列に動かす無料のデスクトップアプリです。公式ダウンロードページから入手でき、エージェントごとにコードの作業場所を分けて、結果を一画面で確認できます。Orca Botsを使うと、毎日の定期レビューやGitHubでCIが失敗したときの調査など、起動のきっかけも設定できます。

Orcaとは何か

Orcaは、エージェントの起動、作業場所の切り替え、差分レビューをまとめた、MITライセンスのオープンソースアプリです。Claude Codeで実装しながら別の作業場所でCodexにテストを書かせる、といった使い方ができます。公式リポジトリ

一つのリポジトリから二つの作業フォルダへ分けて最後に確認する概念図

作業場所を分ける仕組みが、Gitのworktree(ワークツリー)です。同じリポジトリから別々の作業フォルダとブランチを用意できるので、二つのエージェントに同じファイルを変更させても、作業中の変更が互いのフォルダに混ざりません。

エージェントはそれぞれの認証と利用枠で動きます。この方式はBYO(Bring Your Own)と呼ばれ、Orcaにモデル利用料を追加で払わずに、手元で使っている契約を持ち込めます。Orca Bots公式ページ

手順①:Orcaを入手してエージェントを並べる

1. Orcaをインストールする

MacでHomebrewを使う場合は、以下を実行します。別の同名パッケージとの取り違えを避けるため、公式が案内しているフルネームを指定します。

brew install --cask stablyai/orca/orca

DMGで入れる場合は公式ダウンロードでApple Silicon用かIntel用を選びます。Claude CodeとCodexは、エージェントを起動する端末で準備し、それぞれ既存の契約で使える状態にしておきます。

2. 二つのworktreeにClaude CodeとCodexを起動する

  1. サイドバーの「Add Repo」で、試用に使うリポジトリのローカルフォルダを指定します。初回にフォルダの信頼確認が出たら、表示されたパスを確認します。
  2. リポジトリ名の横の「+」でworktreeを作ります。ダミーのToDoリポジトリなら、出発点に同じ基準ブランチを選び、まず add-remove を作ってClaude Codeを起動します。
  3. 同じ手順で add-tests を作り、Codexを選びます。両方のworktreeがサイドバーに並び、それぞれのセッションが意図した作業フォルダにいることを確認します。

最初の依頼は「実装だけ」「テスト項目の洗い出しだけ」のように、変更範囲を一つに絞ると確認しやすくなります。二つのタブを並べたい場合は、公式ガイドのようにタブをペインの端へドラッグして画面を分けます。公式の初回セッション手順

Claude Codeの実装とCodexによるレビューを二つのペインに並べたOrcaの実画面

Orca v1.4.267の実画面。上でClaude Codeが remove(index) を実装し、下でCodexが同じ実装をレビューしています。左には add-remove と add-tests の二つのworktreeが表示されています。

同じ差分をすぐに見てほしい場合は、画面例のように実装側のworktree内で別ペインを開き、Codexには読み取り専用のレビューを頼めます。二つの案を独立して作らせる場合は、ペインの数に加えて、実際の作業フォルダが別かを確認します。

手順②:GitHub 連携で PR / Issue / Actions を worktree に紐づける

GitHub連携を使うと、Issueの依頼内容、PR(プルリクエスト)の差分、Actionsのチェック結果を、同じ作業の流れで見られます。まずテスト用のリポジトリで、Issueがworktreeに付き、PRのチェックまでたどれることを確かめます。

  1. Orcaの設定で「Integrations」を開き、GitHubを接続します。対象のリポジトリがGitHub上の正しいリモートを参照していることも確認します。
  2. Issue一覧から対象を開き、worktreeの作成に進みます。作成画面でIssueに由来する作業名と起点のブランチを確認し、作成後にサイドバーから元のIssueを開けるかを見ます。
  3. 対応するブランチにPRができたら、worktree側で同じPR番号を開けるか確認します。失敗したActionsチェックがあれば、表示を開き、失敗したジョブのログを確認します。

Actionsの結果は、対応するPRのチェックとして追えます。連携の表示が揃ったら「どのIssueに対し、どのファイルを変え、どのチェックで止まったか」を作業中の画面からたどれます。公式のGitHub連携手順

todo.jsの追加行と変更ファイル一覧を表示したOrcaのローカル差分画面

撮影時のローカル差分です。中央の緑色は src/todo.js の追加行で、右側に変更ファイルが2件表示されています。この画面はGitHub未接続の状態です。

差分を開いたら、依頼範囲の外に変更が広がっていないかを先に確認します。ToDoの削除機能なら、削除の実装と使い方の説明を見て、テストが別worktreeにある場合は、どの実装と組み合わせて確認するかを決めます。

手順③:Orca Bots(Automations / Orchestrate)でイベント駆動の自律実行

Automationsは「いつ始めるか」を設定する機能です。オーケストレーションは「誰に何を渡し、どこで結果を受け取るか」を管理する仕組みで、たとえばコーディネーターが作業を分け、複数のworkerの結果を取りまとめます。公式のオーケストレーション解説

1. 定期レビューを1件作る

Orcaの「自動化」から作成画面を開き、「毎日の変化のレビュー」を選びます。最初は「対象ブランチの変更と要確認のテストを要約する」という依頼にし、使うAgent、権限、ホスト、プロジェクト、worktree、時刻を選びます。

毎日の変化のレビューを設定するOrcaの自動化作成画面

実際の「オートメーションの作成」画面。Claude、このMac、todo-demo、毎日16時30分を選んだテンプレートの設定例です。

設定後は自動化一覧でホストとスケジュールを確認し、予定時刻を過ぎたら最終実行の結果を開きます。Macで実行する場合は、時刻に起動しているか、休止中に時刻を逃した場合に何時間まで実行を許すかも確認します。定期実行の公式資料

2. Botの役割と起点を選ぶ

サイドバーの「Bots」の「+」から「New bot」を選び、たとえば「CI確認係」と名前を付け、使うエージェントと実行ホストを確認します。外部サービスから起動する場合はBotの「Connectors」から必要なサービスを一つだけ追加し、テスト用のイベントで期待した実行が1件記録されることを確かめます。Botsクイックスタート

きっかけ 最初に任せる仕事 確認する結果
毎日のスケジュール 前回以降の変更を要約 対象ブランチと要確認項目
GitHubのCI失敗 失敗ジョブ名とログの該当箇所を整理 対象PRと参照したジョブのURL
SlackでBotをメンション 指定した社内テスト課題の状況を要約 意図したテスト用チャンネルでの応答
Gmailの対象メール受信 テストメールの要点を整理 受信条件に一致した実行履歴

GitHubやSlackからBotに依頼する接続にはOrcaへのサインインが必要で、Orca Cloudを経由します。Gmail起点の設定は別経路で、Googleの接続が必要です。Botが動くコンピューターは起動・オンラインである必要もあります。公式コネクタ資料

【重要】権限とセキュリティ

新しいBotは、Orcaの公式文書によると、既定のチャット権限である「Full access」を引き継ぎます。撮影したv1.4.267では、初回セットアップの「Yoloモード」もオンで、確認なしのコマンド実行とファイル編集、一部のサンドボックス回避について説明が表示されました。公式のBotセキュリティ資料

Yoloモードが有効になったOrcaの初回エージェント設定画面

初回設定の「デフォルトの Agent を選択」。画面右側でYoloモードがオンになっています。

外部から届く文章を、実行指示として扱わせない

GitHub Issue、Slack、メールには、ログを送信するよう求める文章や、別のURLを開かせる文章も入り得ます。エージェントがそれを作業指示として扱うのが、プロンプトインジェクションの危険です。最初のBotは、対象の情報を読んで要約するところまでに絞ります。

  • 初回設定でYoloモードを見直し、Botやセッションに「Ask for approval」など確認を求める権限がある場合は選びます。セッションを起動したら、そのエージェントで実際に設定された権限も確認します。
  • GitHub Appの対象リポジトリやSlackの接続先を絞ります。ホスト側のGitHub CLIや環境変数に別の認証がある場合は、Botがその認証で触れられる範囲も確かめます。
  • PRのマージ、Slackへの送信、本番データの変更は、担当者の承認が必要になるようサービス側でも制御します。依頼文で禁止するだけでは、実行そのものを止める仕組みにはなりません。

worktreeで分けられるのはコードの作業場所です。ホームフォルダのファイルや認証情報へのアクセスは、エージェントや実行ユーザーの権限で制御します。初回にClaude Codeがホームフォルダの信頼確認を表示した場合は、専用リポジトリのパスを確認してから作業を始めます。Claude CodeとCodexのセキュリティ設定

どんな業務に効くか

実装方法に迷う小さな変更は、同じ依頼をClaude CodeとCodexへ同時に渡し、差分とテストで比較できます。比較条件を揃えるには、同じ出発点の別worktreeを作り、対象ファイル、期待する動作、報告の形式を共通にします。

同じ依頼を二つに渡して差分とテスト結果を比較する概念図

ToDoの削除処理で試すなら、次の依頼文を両方に渡します。戻り値と既存仕様、境界条件のテスト結果を見比べれば、差分の短さだけで選ばずに済みます。

todo-demo の src/todo.js に remove(index) を追加してください。
有効な整数ならその位置の項目を削除し、削除した項目を返してください。
負数・小数・配列の範囲外は undefined を返し、配列を変更しないでください。
既存の add と list の振る舞いは維持してください。
作業は現在のworktreeに限定し、コミット・pushは行わないでください。
変更ファイル、試した境界条件、未確認事項を報告してください。

要件やレビュー範囲が大きいときは、同じ仕事を競わせるより、役割を分けると引き継ぎが明確になります。各担当の受け渡しには、ブランチ名と対象のコミット、または参照する差分を添えます。

役割 渡すもの 受け取るもの
参謀 Issueと完了条件 分割した作業、依存関係、保留事項
実装 対象ファイルと完了条件 差分、実装上の判断
テスト 仕様と実装の参照先 テスト結果、未確認の境界条件
レビュー 差分とテスト結果 修正が必要な箇所、承認前の確認事項

セキュリティ監視チーム(SOC)の一次分析に応用するなら、機密情報を除いたアラートを外部の連携処理から受け取り、優先度の案と根拠を担当者に返す設計が考えられます。これは外部連携を用意する設計例です。遮断やアカウント停止などの操作は人の判断に残します。

Notionなどに複数のエージェントの記憶や指示を共有する構成を探す場合は、Meta Museを司令塔にしてClaude CodeとCodexを動かす手順で扱っています。

FAQ

デスクトップのエージェントとクラウド、モバイル端末の関係を表す概念図

GPUは必要ですか?

この手順でClaude CodeやCodexの既存契約を使う場合、専用GPUを買う必要はありません。Orcaは手元の端末でエージェントのセッションを管理し、モデルの処理はそれぞれの提供元のサービスが担います。Orca公式ドキュメント

Orcaとエージェントにいくらかかりますか?

Orca本体は無料です。Claude CodeやCodexの利用は各サービスの契約と利用枠に従い、並列で起動しても利用枠は増えません。Codexの料金と利用制限

どのエージェントに対応していますか?

Claude Code、Codex、Cursor CLI、Grok、GitHub Copilot、OpenCodeなどに対応します。セッション履歴や利用量表示などの統合はエージェントによって異なります。公式の対応エージェント一覧

Mac以外でも使えますか?

デスクトップ版はmacOS、Windows、Linuxに対応しています。iOSとAndroidにはコンパニオンアプリがあり、実行ホストと組み合わせてエージェントの状態確認や追加指示に使えます。公式ダウンロード

社外秘のコードやメールを扱えますか?

社内規程でモデル提供元への送信が認められたデータと、承認済みの接続先に限ります。Botが読み取った内容はモデル提供元に送られる場合があるため、作業を始める前に利用契約、連携先への出力、実行ホストの認証範囲を確認します。公式のBotセキュリティ資料

よくある質問

Q. GPUは必要ですか?
この手順でClaude CodeやCodexの既存契約を使う場合、専用GPUを買う必要はありません。Orcaは手元の端末でエージェントのセッションを管理し、モデルの処理はそれぞれの提供元のサービスが担います。
Q. Orcaとエージェントにいくらかかりますか?
Orca本体は無料です。Claude CodeやCodexの利用は各サービスの契約と利用枠に従い、並列で起動しても利用枠は増えません。
Q. どのエージェントに対応していますか?
Claude Code、Codex、Cursor CLI、Grok、GitHub Copilot、OpenCodeなどに対応します。セッション履歴や利用量表示などの統合はエージェントによって異なります。
Q. Mac以外でも使えますか?
デスクトップ版はmacOS、Windows、Linuxに対応しています。iOSとAndroidにはコンパニオンアプリがあり、実行ホストと組み合わせてエージェントの状態確認や追加指示に使えます。
Q. 社外秘のコードやメールを扱えますか?
社内規程でモデル提供元への送信が認められたデータと、承認済みの接続先に限ります。Botが読み取った内容はモデル提供元に送られる場合があるため、作業を始める前に利用契約、連携先への出力、実行ホストの認証範囲を確認します。

出典・参考データ

  1. [1] Orca 公式リポジトリ
  2. [2] Orca ダウンロード
  3. [3] 初回セッション
  4. [4] GitHub連携
  5. [5] Orca Bots
  6. [6] Botsクイックスタート
  7. [7] Botコネクタ
  8. [8] Botセキュリティ
  9. [9] 定期実行
  10. [10] オーケストレーション

この記事を書いた人

水島 翔吾

株式会社kairos 代表取締役 / AgentSignal 開発者

AI クローラー・AI 流入計測と AIO 診断ツール AgentSignal を開発。実測データを元に AI 検索時代の計測と対策を書いています。

関連記事