Marblo

スタートガイド

Marbloを始める

インストールから最初のミッション実行まで、新規ユーザーが順番に進められるステップバイステップガイドです。左側の目次から各ステップに直接ジャンプできます。

1ステップ 1 / 6

アプリのダウンロード・インストール・初回起動

まずMarbloデスクトップアプリをダウンロードしてインストールします。macOSとWindowsに対応し、初回起動時に必要なエージェントCLIが自動でインストールされます。

ダウンロードページからアプリを入手

ダウンロードページで、お使いのOS（macOSまたはWindows）向けの最新ビルドを入手してください。Apple Silicon・Intel Mac、Windows 10/11に対応しています。

ダウンロードページを開く
MarbloのダウンロードページでmacOS・Windowsビルドを選ぶ画面
スクリーンショット準備中

インストールして初回起動

ダウンロードしたインストーラーを実行します。macOSでは.dmgを開いてMarbloをアプリケーションフォルダにドラッグし、Windowsではインストーラーの案内に従ってください。

初回起動時にmacOSのGatekeeperまたはWindowsのSmartScreen警告が表示される場合があります。macOSは「システム設定 > プライバシーとセキュリティ」で「このまま開く」を、Windowsは「詳細情報 > 実行」を選んで進めてください。正規に署名されたビルドです。

Marblo初回起動時に表示されるウェルカム画面
スクリーンショット準備中

必須CLI・Marblo MCPが自動インストール

初回起動時に、Marbloが必要なエージェントCLI（Claude Code・Codex・Antigravity）とMarblo MCPを自動でインストールします。ハーネスタブから手動でインストールする必要はなく、少し待てば完了します。

自分でインストールするものはありません。次のステップで各CLIにログイン（認証）するだけで、すぐに使い始められます。

Marblo初回起動時に必須CLIとMCPが自動インストールされる進行画面
スクリーンショット準備中
2ステップ 2 / 6

CLIの認証（ログイン）

必須CLIは自動でインストールされるため、ユーザーが行うのは各CLIへのログイン（認証）だけです。

Claude Codeにログイン

ターミナルで下のコマンドを実行し、案内に従ってブラウザでAnthropicアカウントにサインインしてください。

shell
claude login

Codexにログイン

Codexも同様にログインします。OpenAIアカウントで認証してください。

shell
codex login

Antigravityの認証

Antigravityもログインして認証します。初めて使うときに表示される案内に従ってアカウントでログインしてください。

実際に使うCLIだけ認証すればOKです。複数のエージェントを同時に運用するには、すべて認証しておきましょう。

認証の確認

ログインが完了すると、各CLIが認証済みの状態に切り替わります。状態が更新されない場合はアプリを再起動してみてください。

認証情報は各CLIがローカルに保存し、MarbloはアカウントのパスワードやAPIキーを保存しません。すべての実行はご自身のPC上で行われます。

3ステップ 3 / 6

フォルダ選択・プロジェクト自動登録

作業するコードフォルダを選ぶだけで、確認の操作なしにプロジェクトが自動登録され、オーケストレーターも一緒に起動します。

フォルダ選択＝ノークリック自動登録

作業するローカルフォルダを選ぶと、Marbloがすぐにプロジェクトとして登録します。「登録しますか？」のような確認クリックはありません — フォルダを選ぶだけで完了です。登録したプロジェクトはサイドバーで切り替えられます。

gitリポジトリのフォルダを推奨します。Marbloは隔離されたgit worktreeで複数のエージェントを安全に並列実行し、変更をdiffで追跡します。

Marbloでフォルダを選ぶとノークリックでプロジェクトが登録される画面
スクリーンショット準備中

オーケストレーターが自動起動

プロジェクトが登録されると、オーケストレーターが自動的に起動し専用のターミナルセッションが開きます。オーケストレーターはリクエストを分析してタスクをチケットに分割し、役割（フロントエンド・バックエンドなど）とモデル（Claude・GPT/Codex・Antigravity）を割り当てて各エージェントをスポーンします。

まず1つのエージェントで小さな作業を試して流れに慣れてから、複数のエージェントを同時に運用することをおすすめします。

プロジェクト登録と同時にオーケストレーターが自動起動した画面
スクリーンショット準備中
4ステップ 4 / 6

最初のミッション・フローを実行

いよいよ実際の作業を指示します。最初のミッションをオーケストレーターに任せてみましょう。

ミッションを書く

作りたい機能や直したいバグを自然言語でオーケストレーターに説明します。オーケストレーターがそれをチケットに分解してカンバンボードに登録します。

ミッションがチケットに分解されてカンバンボードに並んだ画面
スクリーンショット準備中

実行・進捗の追跡

エージェントが各チケットを並列で処理する間、カンバンボードで進捗をリアルタイムに追跡できます。各エージェントのターミナル出力もタブで確認できます。

レビューゲート

完了したチケットはREVIEW状態に移動します。人が変更内容を確認して承認してからマージされます。

エージェントの変更をマージする前に必ずdiffを確認してください。Marbloはマージ前に人によるREVIEWゲートを設け、意図しない変更がそのまま反映されるのを防ぎます。

5ステップ 5 / 6

決済・プラン

Marbloは無料で始められ、さらに多くの機能が必要になったらProにアップグレードできます。

プランを見る

Freeプランでコア機能を無料で利用できます。Proは月額サブスクリプションで追加機能を提供します。料金ページでプランごとの違いを確認してください。

エージェントCLI（Claude・Codex・Antigravity）の利用料金は各提供元のアカウントに別途請求され、Marbloのサブスクリプションとは別です。

料金を見る

サブスクリプションの管理

ログイン後、マイアカウントでサブスクリプションの状態と請求履歴を確認・管理できます。

マイアカウントへ
6ステップ 6 / 6

よくある質問・ヘルプ

詰まったときは、以下の資料が役立ちます。