クイックスタート

この章では、Bromure Agentic Coding での最初の完全なセッションを順を追って説明します。ワークスペースを作成し、エージェントとその認証方法を選び、プロジェクトフォルダをサンドボックスに共有し、最初のタスクを実行し、エージェントがネットワーク越しに送信した内容を確認し、後で再開できるようにセッションを閉じるまでです。約10分を見込んでください。

このウォークスルーは、可能な限りどこでも意図的にデフォルトを使用します。ここで触れるすべての設定には、マニュアルの後半で完全なリファレンスがあります — リンクは道中で提供され、次に読むべきものにまとめられています。

始める前に

必要なもの:

  • Bromure Agentic Coding がインストールされ、少なくとも一度は起動されており、ベース OS イメージが準備できていること — インストールを参照してください。（Apple Silicon 搭載で macOS 14 以降を実行している Mac が必要です。）
  • コーディングエージェントを認証する手段。デフォルトのエージェントである Claude Code の場合、それは Anthropic API キー、またはサインインできる Claude サブスクリプションのいずれかです。どちらの方法も以下のステップ4で説明します。
  • 任意で、エージェントに作業させたい Mac 上のプロジェクトフォルダ。小さな git リポジトリが最初のテストには最適ですが、どんなフォルダでも動作します。

始める前に心に留めておくべき考え方が一つあります。エージェントは使い捨ての Ubuntu VM 内で実行され、実際の認証情報はその VM に一切入りません。VM が保持するのは偽のプレースホルダートークンだけで、リクエストが Mac から出る瞬間にホスト側のプロキシがそれらを実際の値に入れ替えます。これがワイヤ境界であり、このウォークスルーがターミナルではなくアプリに API キーを貼り付けるよう求める理由です。

最初のワークスペースを作成する

ワークスペースは分離の単位です。独自のシステムディスク、独自の永続的なホームフォルダ、独自のエージェント、認証情報、セキュリティポリシーを持つ1つの Ubuntu VM です。好きなだけ作成できますが、このウォークスルーでは1つ作成します。

  1. メインウィンドウを開きます。左のサイドバーには WORKSPACES という見出しがあり、その一番下に黒い円形の + ボタン（ツールチップ: 新しいワークスペース）があります。それをクリックします。

  2. 設定エディタが 新しいワークスペース というタイトルのウィンドウで開きます。これは環境設定テンプレートから事前入力され、「Default workspace」という名前が付けられます（その名前が使用済みの場合は自動的に番号が振られます）。一般ペインが表示されています。自分の名前を入力してください — たとえば My First Project です。名前は唯一の必須フィールドで、このウォークスルーの他のすべては任意の仕上げです。よろしければ カラー を選んでください — サイドバーのワークスペースのタイルに色が付きます。

まだ 作成 をクリックしないでください — 先に2つのペインを訪れる価値があります。

エージェントと認証を選ぶ

  1. エディタのカテゴリサイドバーで エージェント をクリックします。ペインには、サポートされている各エージェント — Claude Code、Codex、Grok Build — ごとに1枚のカードが表示され、それぞれに有効化スイッチがあります。Claude Code は有効になっており、初期状態でオレンジ色の プライマリ ピルが付いています。プライマリエージェントは、セッションの最初のタブで自動起動するものです。有効化された他のエージェントもインストールされ認証されますが、それらは新しいタブから自分で起動します。
ワークスペースエディタのエージェントペイン。Claude Code カードとそのプライマリピル、4つの認証モード、Anthropic API キーフィールド、および無効化された Codex と Grok Build のカードを表示

Claude Code カードの中には、4つの認証モードが表示されます。API トークン、Register… リンク付きの サブスクリプション（対話型ログイン）、Bedrock (AWS)、および ローカルモデル（ローカルモデルがインストールされるまで「— ローカルモデルでモデルをダウンロード」とグレーアウト表示）です。最初の2つのうち1つを選んでください:

  1. Anthropic API キーをお持ちの場合: API トークン を選択し、Anthropic API キー フィールドにキーを貼り付けます。キーはホスト上で暗号化されて保存されます。VM は構造を保持した偽物だけを受け取り、プロキシは Anthropic へのリクエスト時に実際のキーに置換します — 他のどこでもありません。今のところ 使用に承認を要求 チェックボックスはオフのままにしてください。オンにすると、各セッションが初めてキーを使用する際にアプリが同意を求めるようになります（認証情報を参照）。

  2. Claude サブスクリプションをお持ちの場合: サブスクリプション（対話型ログイン） を選択し — これが工場出荷時のデフォルトです — Register… をクリックします。Bromure は、フォルダや認証情報へのアクセスを持たない一時的な使い捨ての VM を起動し、その中で本物の Claude ログインを実行し、Mac のデフォルトブラウザでプロバイダのサインインページを開きます。そこでサインインしてください。フローがタイムアウトするまで数分あります。成功すると、取得したトークンがホスト上で暗号化されて保存され、使い捨て VM は破棄され、アプリは登録を すべてのワークスペース と共有するか このワークスペースのみ と共有するかを尋ねます。登録されると、カードには緑色のシールと Re-register… および Forget のコントロールが表示されます。ワークスペースの VM 自体が OAuth を実行することは決してなく、実際のトークンを保持することもありません — ホストがワイヤ上でそれらを注入し、更新を処理します。

  3. エージェントペインで最初のセッションに必要なのはそれだけです。（Codex や Grok Build を併せて有効化する場合も同じように機能します — 各カードが独自の認証モードを持ちます — が、今日は1つのエージェントで十分です。）

プロジェクトフォルダを共有する

  1. カテゴリサイドバーで フォルダ をクリックします。このペインには、VM にマウントされるホストフォルダが一覧表示されます。キャプションにあるように、各フォルダはその実際の名前でマウントされ — たとえば Mac 上の ~/Documents は VM 内で ~ubuntu/Documents として表示されます — ワークスペースは8フォルダに制限されています。真新しいワークスペースには「共有フォルダなし」と表示されます。
ワークスペースエディタのフォルダペイン。空の状態で、フォルダを追加… ボタンが表示されている
  1. フォルダを追加… をクリックし、ディレクトリピッカーでプロジェクトフォルダを選びます。それがフルホストパスとともにリストに表示されます（考えを変えた場合は後でマイナスボタンで削除できます）。VM 内では /home/ubuntu/<basename> でライブになります — コピーではなく同じファイルなので、エージェントが加えた変更は即座に Mac 上に反映されます。

メモ: フォルダの共有は任意です。VM の /home/ubuntu 以下のすべてはワークスペースごとに永続化されるため、VM 内でリポジトリをクローンし、サンドボックスを Mac のファイルシステムから完全に分離しておくこともできます。ワークスペースを削除しても共有ホストフォルダには決して触れません。

  1. 作成 をクリックします。エディタが閉じ、ワークスペースが状態ラベル オフ とともにサイドバーに表示されます。

セッションを開始する

  1. サイドバーでワークスペースの行をクリックします。右側のステージにワークスペースのダッシュボードが表示されます。名前の下の オフ ピル、CPU、メモリ、vCPU、ディスク、稼働時間 のカード（最初の起動前はほとんどダッシュとゼロ — ディスクは初回起動時に作成されます）、エージェントと認証モードを一覧する CONFIGURATION の概要、ガードレールとプロンプトインジェクションスキャンの状態、そして共有フォルダです。右上の 開始 ボタンをクリックします。
メインウィンドウ。2つのワークスペースと + ボタンを持つ WORKSPACES サイドバー、および停止中のワークスペースのダッシュボード。CPU、メモリ、vCPU、ディスク、稼働時間のカード、CONFIGURATION の概要、開始ボタンを表示

  1. 初回起動時、Bromure はワークスペースのプライベートなシステムディスクを共有ベースイメージのコピーオンライトクローンとして作成し — これは瞬時に行われ、ディスク容量をほとんど消費しません — 4 vCPU とダッシュボードに表示された RAM（デフォルトでは Mac に合わせたサイズ: 4、6、または 8 GB）で VM を起動します。VM が起動する間、ワークスペース名と進行状況バーのアニメーション付きオーバーレイがペインを覆います。ゲストの最初のターミナルが立ち上がった瞬間にそれはフェードアウトし、通常は数秒以内です。30秒以内にターミナルが表示されない場合、オーバーレイは DIVE FAILED パネルに切り替わり、Keep Waiting と Reset Base Image… のボタンが表示されます — その場合はトラブルシューティングを参照してください。

  2. 起動が完了すると、ステージ上のターミナルが表示され、プライマリエージェントである Claude Code がその中で既に実行されており、プロンプトの入力待ちになっています。VM 内で claude login を実行することは決してありません。認証はワイヤ境界で処理されました。サイドバーでは、ワークスペースのステータスドットが緑色になり、状態ラベルは Running と表示され、その最初のタブ（フォアグラウンドのプログラム、たとえば claude のラベルが付く）が Docker ノードとともにワークスペース行の下にネストされます。ウィンドウのツールバーには、この VM のためのコントロール群が表示されます。クリックでコピーできるピルとしての IP アドレス、そしてファイルを閲覧する、再起動する、トレースを確認する、ワークスペースを編集する、セッションを独自のウィンドウに切り出す、ブラウザペインとリポジトリファイルペインを切り替えるためのボタンです。

最初のタスクを実行する

  1. Claude Code のプロンプトにタスクを入力し、共有フォルダをその VM 内パスで参照します。たとえば:

    Read the code in ~/my-project and summarize what it does.
Then add a README.md with build instructions.

    サイドバーのタブのアイコン上のステータスドットに注目してください。エージェントが作業している間はオレンジ色に脈打ち、エージェントが完了すると緑色になり、エージェントがあなたの入力を必要とすると赤色になります。

  2. 共有フォルダはライブマウントなので、エージェントが書き込む README.md は即座に Mac 上にあります — よろしければ Finder で確認してください。フォルダが git リポジトリの場合、アクティブなタブの作業ディレクトリがリポジトリに入るとリポジトリファイルエクスプローラーペインが自動的に開き、git ステータスとファイルごとの差分を備えた IDE スタイルのツリーが表示されます。⌃⌘E でいつでも切り替えることもできます。⌘T を押すと、エージェントの隣に追加のプレーンなシェルタブが表示されます — すべてのタブは同じ VM 内 tmux セッションのウィンドウです。

  3. エージェントが行うその他のこと — apt install、npm install、VM のホームに使い捨てファイルを書き込むこと — はサンドボックス内にとどまります。システムディスクとホームフォルダはセッション間で永続化され、どちらも後で独立してリセットできます（ワークスペース）。

トレースを確認する

  1. ⇧⌘I を押す（または トレースを確認 ツールバーボタンをクリックする）と、トレースインスペクタが開きます。新しいワークスペースは AI リクエストの詳細 レベルで記録します。エージェントが行ったすべてのネットワークリクエストが、ホスト、ステータス、レイテンシとともに一覧表示され、既知の LLM ホストについては完全なリクエストとレスポンスのボディも取得されます。Anthropic へのリクエストの1つを選択すると、インスペクタはそれを会話としてレンダリングします — トークン数付きのプロバイダとモデルのヘッダー、システムプロンプト、そしてユーザー、アシスタント、ツールのメッセージがチャットの吹き出しとして表示されます。

  2. 最初のトレースで注目すべき点が2つあります。第一に、スワップレポートです。VM が保持していた偽の API トークンは、ワイヤ上で実際の認証情報と交換され、リクエストごとに正確に1回、プロバイダのホストにスコープが限定されます。第二に、取得されたすべてのものは Mac 上にとどまり、保存時に暗号化されます。トレースレベル、保持上限、リーク警告についてはトレースで説明します。

閉じて再開する

  1. セッションを閉じます。サイドバーのワークスペース行にカーソルを合わせ、その × ボタンをクリックします（または最後のタブで ⌘W を押します）。新しいワークスペースは閉じるアクションが 確認 に設定されているため、プロンプトが表示されます — 「“My First Project” を閉じますか?」 — バックグラウンドで実行、一時停止、シャットダウン、キャンセル のボタンとともに、次の説明が表示されます: 「バックグラウンドで実行すると VM が実行され続け、後で再アタッチできます。一時停止するとその状態がディスクに保存されます。シャットダウンすると電源が切れます。」

  2. 一時停止 をクリックします。VM の RAM がディスクにスナップショットされ、サイドバー行の状態ラベルが 一時停止中 に変わります。何も失われません — エージェントの会話も、シェルの履歴も、タブのレイアウトもです。

  3. 再開: ワークスペースをクリックし、ダッシュボードで 再開 を押します（または行の ⋯ メニュー → 再開 を使います）。セッションはほぼ瞬時に復元され、まさに離れた場所から再開されます — 同じターミナルで、Claude Code は会話の途中です。

  4. 閉じる際に常に同じ動作を望む場合は、行の ⋯ メニュー → 編集… を開き、一般ペインの ウィンドウを閉じるとき を 一時停止（または バックグラウンドで実行 / シャットダウン）に設定すると、プロンプトが表示されなくなります。設定 — 一般を参照してください。

ヒント: 一時停止またはシャットダウンされたワークスペースは、そのシステムディスクとホームフォルダを保持します。データの破棄は常に明示的な操作です — ディスクをリセット、ホームを消去…、または ワークスペースを削除 — そしてワークスペースを削除しても、そこに共有したホストフォルダには決して触れません。

次に読むべきもの

  • 概念 — たった今行ったことの背後にあるメンタルモデル: ワークスペース、VM のライフサイクル、ワイヤ境界、そして各部品がどう組み合わさるか。
  • ワークスペース — ワークスペースの複製、リセット、削除、ストレージレイヤー、チェックポイント、そしてすべての新しいワークスペースの分岐元となる環境設定テンプレート。
  • セッション — タブと git worktree、ターミナルグリッド、エージェント型ブラウザペイン、VM 内外へのファイル転送、そしてすべてのキーボードショートカット。
  • 設定リファレンス — すべての設定ペインを1ページずつ、このウォークスルーのエージェントとフォルダを含みます。
  • 認証情報 — 完全な認証情報カタログ（git トークン、SSH キー、AWS、Kubernetes、コンテナレジストリ、データベースなど）、承認プロンプト、そして偽物から本物へのスワップがどのように機能するかの詳細。
  • トレース — トレースレベル、トレースインスペクタ、リーク検出。
  • サプライチェーンとプロンプトインジェクション — 信頼できないコードにエージェントを向ける前にワークスペースに重ねられる保護。
  • Fusionとローカルモデル — 複数のモデルで同時にプロンプトに応答すること、そしてクラウドの代わりに Mac 上でモデルを実行すること。
  • 自動化と CLI — スクリプト、HTTP API、そして bromure-cli mcp サーバーからワークスペースを駆動すること。