Orca(ADE)の使い方完全ガイド|AIコーディングエージェント基盤のインストール・設定・並列運用【2026年版】

AI

「Claude CodeとCodexを同時に動かしたいのに、ブランチの切り替えで作業がぶつかってしまう」「エージェントを増やすほどターミナルが散らかって管理しきれない」。そんな悩みを抱えている方に注目されているのが、Orca(オルカ)です。

なお「Orca」という名前は、医療機関向けレセプトソフトや量子化学計算ソフトなど別分野でも使われています。本記事で解説するのは、Stably AI社が開発したAIコーディングエージェントのオーケストレーションツール(ADE)のOrcaです。他の「Orca」をお探しの方向けの違いは、記事後半のFAQでも触れています。

本記事では、Orcaの使い方を、インストール前に確認すべきシステム要件、OS別のインストール方法、初期設定、インストール時によくあるエラーの対処法、動作確認、基本的な使い方、複数エージェントを並列で動かす応用テクニック、モバイルアプリでの進捗確認、アンインストール方法まで順を追って解説します。メリット・デメリットや競合ツールとの比較もまとめていますので、導入を検討中の方も、インストール直後で迷っている方も参考にしてください。

  1. Orcaとは?使い方の前に押さえたい基本
    1. 読み方は「オルカ」、開発元はStably AI
    2. IDEとADEの違い
  2. Orcaの料金・メリット・デメリットと競合ツール比較
    1. 料金:本体は無料、課金はエージェント側
    2. メリット・デメリット
    3. 競合ツール比較の考え方
  3. インストール前に確認すべきシステム要件
    1. 対応OSの目安
    2. 事前に必要なツール・前提条件
  4. Orcaのインストール方法【OS別】
    1. macOS(Homebrew)
    2. Windows(インストーラー)
    3. Linux(AppImage/deb/rpm)
  5. インストール時によくあるエラーと対処法
    1. macOSで「開発元を確認できないため開けません」と出る場合
    2. Windowsで「WindowsによってPCが保護されました」と表示される場合
    3. Homebrewインストール時にエラーが出る場合
    4. Linuxでorca-ideコマンドが見つからない場合
  6. インストール後の動作確認(動くか確認する)
  7. Orcaの初期設定とトラブル対処
    1. 初回起動とエージェントの検出
    2. 権限モードは「Yolo」から「Manual」へ
    3. よくある設定トラブルと対処法
  8. Orcaの基本的な使い方【実践ステップ】
    1. ①プロジェクトを追加してworktreeを作る
  9. 複数エージェントを並列で動かす応用テクニック
  10. モバイルアプリでOrcaの進捗を確認する
  11. Orcaのアンインストール方法
  12. バージョンアップ・更新履歴の確認方法
    1. 自動更新と手動更新
    2. 変更内容はchangelogで確認するのが確実
  13. よくある質問(FAQ)
    1. 「Orca」という名前の別のソフトとの違いは?
    2. 社内ネットワーク・プロキシ環境下でもインストールできる?
    3. オフライン環境でのインストール・利用は可能?
  14. まとめ
  15. 参考にしたサイト

Orcaとは?使い方の前に押さえたい基本

読み方は「オルカ」、開発元はStably AI

Orcaは「オルカ」と読みます。開発元はStably AIで、GitHub上で「stablyai/orca」としてオープンソース公開されています。ライセンスはMITライセンスです(一部の解説記事にApache 2.0とあるのは誤りで、GitHubのLICENSEファイルではMITと確認できます)。

2026年3月17日にリポジトリが作成されたばかりのツールですが、2026年9月5日時点でGitHubスターは62,051、フォークは4,146に達しており、非常に速いペースで注目を集めています。安定版のリリースも1日あたり約2件という高頻度です。公式README自身が「機能一覧は常に追いついていない。本当の機能一覧はchangelogだ」と書いているほどなので、最新機能は公式サイト(onorca.dev)のchangelogで確認するのが確実です。

IDEとADEの違い

OrcaはAIコーディングエージェントを並列で動かすためのデスクトップアプリで、公式サイト(onorca.dev)では自らをADE(Agent Development Environment)と呼んでいます。一方、GitHubのREADMEでは「The AI Orchestrator for 100x builders.」と名乗っています。

項目 従来のIDE ADE(Orca)
コードを書く主体 人間 AIエージェント
人間の主な役割 実装・デバッグ 指示・レビュー・採用判断
作業の単位 ファイル・ブランチ タスク(1タスク=1 worktree)
並列作業 基本的に1つずつ 複数エージェントを同時実行

flat illustration comparing traditional IDE workflow where a developer manually codes with ADE workflow showing multiple AI agents working in parallel on separate worktrees

また、公式ドキュメントには「What Orca is not」という節があり、Orcaは①AIモデルではない、②gitの置き換えではない、③ホスティング型のVPS製品ではない、と明記されています。つまり、手元のエージェントとgitを「まとめて指揮する司令塔」と理解するとわかりやすいです。

Orcaの料金・メリット・デメリットと競合ツール比較

料金:本体は無料、課金はエージェント側

Orca本体はオープンソースで無料です。公式の料金ページ(onorca.dev/pricing)は存在せず、有料プランは用意されていません。

ただし、Orcaは独自のAIモデルを持っていません。実際にコードを書くのはClaude CodeやCodexなどのエージェントなので、それぞれのサブスクリプション費用やAPI利用料は別途かかります。「Orcaが無料=タダでAI開発ができる」わけではない点に注意してください。複数エージェントを並列で動かすと、その分だけ利用量も増えます。

メリット・デメリット

メリット

  • タスクごとに環境が完全に分かれる:1タスクごとにGit worktreeが自動生成されるため、複数エージェントが同じファイルを同時に書き換えて衝突する事態を防げます
  • エージェントを自由に選べる:Claude Code、Codex、Gemini、Grok、Antigravity、Cursor、GitHub Copilot、Continue、OpenCode、Amp、Cline、Goose、Qwen Codeなど、25以上のCLIエージェントに対応しています
  • 普段のgit操作がそのまま使える:各worktreeは本物のgit worktreeなので、cdして通常のgitコマンドを実行できます
  • マルチプラットフォーム:macOS、Windows、Linuxに加え、iOS/Androidのコンパニオンアプリもあります

デメリット

  • 単発作業にはオーバースペック:エージェント1本で小さな修正をするだけなら、ターミナルで直接エージェントを使うほうが手軽です
  • アップデートが非常に速い:画面や設定項目が短期間で変わるため、解説記事と見た目が異なることがあります
  • エージェント側のコスト管理が必要:並列数を増やすほど利用料がかさみやすくなります

競合ツール比較の考え方

並列開発の分野では、cmuxなどの類似ツールも話題にのぼります。ただし、競合ツールの仕様や料金は変化が速く、本記事では検証済みの情報がそろっていないため、数値による比較は控えます。選ぶ際は次の観点で比較するのがおすすめです。

比較の観点 単体CLIエージェント(Claude Codeなどを直接使用) Orca
並列実行 自分でターミナルやブランチを管理 worktreeを自動生成して並列実行
複数エージェントの比較 手作業で比較 同じ仕様を振って差分比較する流れが標準
導入の手軽さ エージェントのみで完結 Orcaの追加インストールが必要
向いている作業 単発の修正・調査 並列開発・案の比較検討

cmuxなど他ツールを検討する場合も、「worktreeの自動管理」「対応エージェント数」「差分レビュー機能」「料金体系」の4点を公式情報で確認すると判断しやすくなります。

インストール前に確認すべきシステム要件

対応OSの目安

公式に案内されている対応OSは次の通りです。細かな最小バージョン番号までは公式サイトでも明記が変わりやすいため、インストール前に公式サイトの最新情報を確認することをおすすめします。

  • macOS:Apple Silicon・Intelの両方に対応
  • Windows:10/11の64bit版に対応
  • Linux:AppImage/deb/rpmの3形式を提供

事前に必要なツール・前提条件

  • git:worktree機能はgitの標準機能を利用するため、gitがインストールされ、PATHから実行できる状態である必要があります
  • 使いたいCLIエージェント本体:Claude Code、Codexなど、実際にコードを書かせたいエージェントは別途インストール・認証(ログイン)を済ませておく必要があります。Orcaはこれらのエージェントを検出して呼び出す仕組みなので、エージェント自体が単体で動かない状態では検出もできません
  • ディスク容量:並列実行するタスクの数だけworktree(作業用フォルダのコピー)が増えるため、リポジトリのサイズ×同時タスク数程度の空き容量を見込んでおくと安心です

Orcaのインストール方法【OS別】

OS 主なインストール方法 コマンド/入手先 実行ファイル名
macOS Homebrew/インストーラー brew install --cask stablyai/orca/orca Orca
Windows インストーラー 公式サイトからダウンロード Orca
Linux AppImage/deb/rpm 公式サイトからダウンロード orca-ide(CLI)/orca serve(ヘッドレス)

macOS(Homebrew)

macOSはApple Silicon・Intelの両方に対応しています。Homebrewを使う場合は、ターミナルで次のコマンドを実行します。

brew install --cask stablyai/orca/orca

Homebrewを使わない場合は、公式サイトからインストーラーをダウンロードしてください。

Windows(インストーラー)

Windowsは10/11の64bit版に対応しています。公式サイトからインストーラーをダウンロードし、画面の案内に従ってインストールします。

Linux(AppImage/deb/rpm)

LinuxはAppImage、deb、rpmの3形式が用意されています。お使いのディストリビューションに合った形式を公式サイトから取得してください。

Linux版のコマンド名はorca-ideです。これはGNOMEの画面読み上げソフト「Orca」と名前が衝突しないようにするためです。また、画面のないヘッドレスLinuxサーバーではorca serveで起動できます。

インストール時によくあるエラーと対処法

macOSで「開発元を確認できないため開けません」と出る場合

未署名・未確認のアプリに対するmacOSのGatekeeperによるブロックです。アプリを一度右クリック(またはControlキーを押しながらクリック)して「開く」を選ぶか、システム設定の「プライバシーとセキュリティ」から該当アプリの実行を許可すると起動できます。Homebrew経由でインストールした場合もこの確認が出ることがあります。

Windowsで「WindowsによってPCが保護されました」と表示される場合

Microsoft Defender SmartScreenによる未知の発行元アプリへの警告です。表示されたダイアログの「詳細情報」をクリックすると「実行」ボタンが現れるので、インストーラーの入手元(公式サイト)に間違いがないことを確認した上で実行してください。

Homebrewインストール時にエラーが出る場合

キャッシュの不整合やパスの競合が原因になることが多いです。brew updateでHomebrew自体を最新化し、brew cleanupでキャッシュを掃除してから再度インストールコマンドを実行すると解決することがあります。

Linuxでorca-ideコマンドが見つからない場合

インストール先のディレクトリがPATHに含まれていないことが原因です。配置されたバイナリの場所を確認し、/usr/local/binなどPATHが通ったディレクトリにシンボリックリンクを作成するか、シェルの設定ファイル(.bashrcや.zshrcなど)に該当ディレクトリを追加してください。

インストール後の動作確認(動くか確認する)

インストールが完了したら、次の点を確認すると「本当に正しく動いているか」を判断しやすくなります。

  • アプリが起動し、バージョンが表示されるか:Settings → General → Updates画面に現在のバージョン情報が表示されます。ここが表示されればアプリ自体のインストールは成功しています
  • ヘッドレスLinuxの場合:orca serveを実行し、エラーなくプロセスが起動していれば成功です
  • エージェントが検出されているかのチェックリスト:
  • 設定画面の「エージェント」セクションに、インストール済みのCLIエージェント(Claude Code、Codexなど)が一覧表示されているか
  • 各エージェントのステータスが「検出済み」になっているか
  • 検出されていない場合は、そのエージェントCLIが単体のターミナルで起動するかを先に確認する

Orcaの初期設定とトラブル対処

初回起動とエージェントの検出

初回起動時、Orcaはホームフォルダへのアクセス許可を求めます。許可すると、~/.claude(Claude Code)や~/.codex(Codex)といった設定・認証情報フォルダがあれば取り込むかどうかを確認されます。ターミナルアプリGhosttyの設定も取り込み対象です。

取り込みが終わると、リポジトリが1つもない状態の画面が表示されます。設定画面ではエージェントの検出状況や既定で使うエージェント、表示言語、通知などを確認できます。設定画面は32セクションもあるため(2026年9月14日時点、Orca 1.4.198・macOSで確認)、最初は「エージェント」「権限」「通知」の3点だけ見れば十分です。

権限モードは「Yolo」から「Manual」へ

最も重要な初期設定が権限モードです。 既定値は「Yolo」、つまりエージェントが確認なしでコマンドを実行するモードになっています。個人の実験用リポジトリなら便利ですが、業務で使う場合は「手動(Manual)」への切り替えが推奨されています。

Yoloのままだと、エージェントが意図しないファイル削除やパッケージのインストールを行っても気づきにくくなります。特に本番環境の認証情報を扱うリポジトリでは、必ずManualに変更してから使い始めましょう。

よくある設定トラブルと対処法

  • エージェントが検出されない:まずターミナルで各エージェントのCLI(例:Claude Code)が単体で起動するかを確認してください。単体で動かない場合はOrca側ではなくエージェントのインストールや認証に原因があります。初回起動時に~/.claudeなどの取り込みを見送った場合も、設定を見直しましょう
  • Windowsでシェルがうまく動かない/WSLで使いたい:Windows版では既定シェルをPowerShell・コマンドプロンプト・WSLから選べます。Linux前提のプロジェクトならWSLを選ぶと動作が安定しやすくなります。なお、CodexはWindows側とWSL内のどちらでも起動対象にできるため、どちらの環境で動かしているかを意識してください
  • 新機能を早く試したい:更新は既定で安定版チャンネルです。Settings→General→Updatesにある「Check for Updates」をShiftキーを押しながらクリックすると、先行機能を含むRC版を取得できます
  • 社内プロキシ環境で使いたい:公式ドキュメントに専用の企業プロキシ設定手順は明記されていません。OrcaはClaude CodeやCodexなど各エージェントのAPI通信を仲介するわけではなく、エージェント自身が通信を行うため、プロキシ設定はエージェント側(各CLIの環境変数や設定ファイル)で行う必要があります
  • 完全にオフラインの環境で使いたい:Orca本体はローカルで動作しますが、呼び出すエージェント(Claude CodeやCodexなど)の多くはクラウドAPIへの通信を必要とします。完全にオフラインの環境では、Orcaを導入してもエージェントそのものが動作しない点に注意してください

Orcaの基本的な使い方【実践ステップ】

①プロジェクトを追加してworktreeを作る

まず、作業したいGitリポジトリをOrcaに追加し、そのリポジトリから作業用のworktreeを作ります。Orcaでいう「タスクを作る」とは、このworktreeを作ることです。worktreeを作ると専用のブランチと作業フォルダが自動で用意され、選んだエージェントがその中で起動するので、メインの作業ブランチを汚す心配はありません。

  1. 1リポジトリを追加サイドバーの「プロジェクトを追加」から
  2. 2worktreeを作成名前とエージェントを選ぶだけ。これが「タスクの作成」
  3. 3AIに指示を出す自動で起動したエージェントのターミナルで
Orcaで作業を始める流れ

手順1:リポジトリを追加する

サイドバーの「プロジェクト」見出しの右にあるフォルダアイコン(プロジェクトを追加)をクリックします。

Orcaのサイドバーにある「プロジェクトを追加」ボタン

「プロジェクトを追加する」画面が開きます。手元にあるリポジトリなら「フォルダーを参照」を選んでフォルダを指定します。GitHubなどにあるリポジトリは「URLからクローン」、ゼロから始めるなら「新規プロジェクトを作成」を選びます。

Orcaの「プロジェクトを追加する」画面。フォルダーを参照・URLからクローン・新規プロジェクトを作成を選べる

手順2:タスク(worktree)を作成しエージェントを選ぶ

プロジェクトを追加すると、そのリポジトリ用のビューが開きます。「新規タスク」のような操作から、取り組みたい作業内容(指示文)を入力し、使用するエージェント(Claude Code、Codexなど、検出済みのものから選択)を指定します。実行すると、専用のworktreeとブランチが自動生成され、指定したエージェントがその中で作業を開始します。

手順3:進捗を確認し、差分をレビューする

エージェントが作業を進めている間も、ターミナル出力やエージェントの発言をOrca上で確認できます。作業が完了したら、そのタスクのdiff(変更差分)を画面上でレビューし、問題なければ通常のgit操作(コミット・プッシュ・プルリクエスト作成など)に進みます。各worktreeは本物のgit worktreeなので、cdして普段使っているgitコマンドをそのまま使っても構いません。

複数エージェントを並列で動かす応用テクニック

Orcaの強みが最も発揮されるのは、同じタスクに複数のエージェントを同時に走らせて成果を比較する使い方です。

例えば「この関数をリファクタリングしてほしい」という同じ指示文を、Claude CodeとCodexの両方に与えて並列実行します。それぞれ独立したworktreeで作業するため、互いのコードが干渉することはありません。両方の作業が終わったら、diffを並べて見比べ、

  • テストが通っているか
  • コードの読みやすさ
  • 想定外の変更が入っていないか

といった観点で採用する側を選び、不要なworktreeは削除します。1本のエージェントにすべてを委ねるより「複数案を出させて選ぶ」運用に切り替えることで、AIコーディングの再現性のばらつきをカバーしやすくなります。並列数を増やすほどエージェント側の利用料も増えるため、重要な実装判断が絡むタスクに絞って並列運用するのが現実的です。

モバイルアプリでOrcaの進捗を確認する

OrcaはmacOS/Windows/Linuxのデスクトップアプリに加えて、iOS/Androidのコンパニオンアプリも提供しています。デスクトップで並列実行中のタスクが完了したかどうかを、外出先からスマートフォンで確認できるのが主な用途です。

長時間かかるタスクをいくつも走らせておき、完了したものから優先的にレビューする、といった使い方をすると、PCに張り付かずに複数エージェントの運用を進められます。ただし、コードの実行や権限モードの変更など、込み入った操作はデスクトップ版で行うのが基本です。モバイル側は進捗確認と軽い通知対応に留めておくと安全です。

Orcaのアンインストール方法

Orcaは一般的なデスクトップアプリと同じ考え方でアンインストールできます。ただし手順の詳細はバージョンによって変わる可能性があるため、迷った場合は公式サイトの最新情報も確認してください。

  • macOS(Homebrewでインストールした場合):brew uninstall --cask stablyai/orca/orcaを実行します
  • Windows:「アプリと機能」(コントロールパネルまたは設定アプリ)からOrcaを選び、アンインストールします
  • Linux:導入時の形式に応じて、deb版はsudo dpkg -r、rpm版はsudo rpm -eで該当パッケージを削除します。AppImage版はダウンロードしたファイル自体を削除するだけで完了です

いずれの場合も、アンインストール自体はOrca本体のみが対象です。~/.claudeや~/.codexなど各エージェントの設定・認証情報は別物なので、それらを消したい場合は個別に削除する必要があります。

バージョンアップ・更新履歴の確認方法

自動更新と手動更新

Orcaは既定で安定版チャンネルの自動更新がかかります。手動でチェックしたい場合はSettings→General→Updatesの「Check for Updates」をクリックします。先行機能を試したい場合は、同じボタンをShiftキーを押しながらクリックするとRC版を取得できます。Homebrewでインストールした場合は、brew upgrade --cask stablyai/orca/orcaでも更新できます。

変更内容はchangelogで確認するのが確実

前述の通り、公式README自体が「本当の機能一覧はchangelogだ」と明言しているほど更新ペースが速く(1日あたり約2件の安定版リリース)、個々のリリースで何が変わったかを本記事で要約しても、すぐに古くなってしまいます。アップデート後に挙動が変わったと感じたら、まずは公式サイト(onorca.dev)のchangelogで該当バージョンの変更内容を確認する習慣をつけておくと安心です。

よくある質問(FAQ)

「Orca」という名前の別のソフトとの違いは?

「Orca」という名称は分野によって複数の製品を指します。本記事のOrcaはStably AI社のAIコーディングエージェント基盤(ADE)で、以下のような別分野の「Orca」とは無関係です。

検索で別の「Orca」の情報をお探しだった場合は、上記のリンク先を参照してください。

社内ネットワーク・プロキシ環境下でもインストールできる?

Orca本体のダウンロード・インストール自体は通常のアプリと同様に行えますが、実行後にClaude CodeやCodexなど各エージェントがAPI通信を行うため、社内プロキシでその通信がブロックされていないかを別途確認する必要があります。プロキシ設定はOrca側ではなく、各エージェントCLIの設定(環境変数など)で行います。

オフライン環境でのインストール・利用は可能?

Orca本体のインストーラー自体はオフラインでも実行できますが、実際にコードを書くのはクラウドAPIを利用するエージェントです。インターネット接続が一切ない環境では、Orcaを起動してもエージェントがタスクを実行できない点に注意してください。

まとめ

Orca(ADE)は、Claude CodeやCodexなど手元のAIコーディングエージェントを、worktreeで環境を分けながら並列に動かすための司令塔です。本体は無料のオープンソースですが、実際のコーディングを担うエージェント側の利用料は別途かかること、既定の権限モードが「Yolo」になっていること、アップデートが非常に速いことの3点は特に押さえておきたいポイントです。

インストール時にmacOSのGatekeeperやWindowsのSmartScreenで止まった場合も、発行元を確認した上で許可すれば先に進めます。インストール後は設定画面でエージェントが検出されているかを確認し、権限モードをManualに切り替えてから、まずは1つのタスクでworktreeの作成からレビューまでの流れを体験してみてください。使い方がつかめたら、同じ指示を複数のエージェントに並列で与えて成果を比較する運用に広げていくと、Orcaの強みを最大限に活かせます。

参考にしたサイト

コメント

タイトルとURLをコピーしました