環境

環境ペインは、ワークスペースの VM 内のすべてのシェルにエクスポートされるシンプルな環境変数を設定します。これらはシークレットではない設定用のつまみ(ログレベル、機能フラグ、ビルドトグルなど)で、スワップや認証情報の仕組みを一切組み込むことなく、エージェントの環境に存在させたいものです。

「ワークスペースを編集」ウィンドウの「環境」ペイン。環境変数が設定されていないという空状態のメッセージと「変数を追加」ボタンが表示されている

このペインのキャプションは、その役割と、何のためのものではないかの両方を示しています。proxy.env(.bashrc から読み込まれる)を介して、VM 内のすべてのシェルにエクスポートされるシンプルな KEY=VALUE ペアです。プロキシによる置換はありません。値はそのまま VM に届くため、ここにシークレットを入れないでください。ログレベル、機能フラグ、ビルドトグルに適しています。 何も設定されていない場合は環境変数が設定されていませんと表示されます。

変数がエクスポートされる仕組み

追加した各変数は、ワークスペースのメタデータ共有上のファイルである proxy.env に書き込まれ、管理された .bashrc がすべてのシェルでこれを読み込みます。つまり、その値はすべてのターミナルタブ、エージェントが実行するすべてのコマンド、およびすべてのログインシェルと非ログインシェルに、入力したとおりそのまま存在します。brm_… の偽値もワイヤ上のスワップもありません。このペインは単純なパススルーであり、まさにそれがシークレットをここに置くべきでない理由です。

VM にトークンやパスワードを保持させる必要がある場合は、代わりに認証情報ペインを使用してください。そこで定義したものは偽値として注入され、ワイヤ上で実際の値にスワップされます。一方、環境ペインに入力したシークレットは、平文のままサンドボックス内に届いてしまいます。

変数の追加と編集

変数を追加をクリックすると行が追加されます。各行は名前フィールドとフィールドで構成され、削除用のマイナスボタンが付いています。

名前は、シェル識別子ルール [A-Za-z_][A-Za-z0-9_]* に対して検証されます。文字またはアンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。一致しない名前にはインラインのオレンジ色の警告が表示され、エクスポートされません。値には制約がなく、記述したとおりに使用されます。

ヒント: 関連するトグルは 1 つのワークスペースにまとめ、スクラッチ用のワークスペースは空のままにしておきましょう。これらの変数はワークスペースごとに設定されるため、詳細なデバッグ用に調整されたワークスペース(RUST_LOG=debugNODE_ENV=development)は、クリーンな本番相当のビルド用に構成されたワークスペースとは分離されたままになります。

実行中のセッションでのライブ更新

このペインを編集して保存する際に、VM の再起動は不要です。Bromure Agentic Coding は内部の env.generation カウンターをインクリメントし、proxy.env を書き直します。保存後に開かれた新しいシェルはこれを再読み込みし、更新された値をただちに認識します。すでに実行中のフォアグラウンドエージェントは、終了するまで起動時の環境を保持します。新しいプロンプト(または新しいタブ)が変更を反映します。

これらの値は意図的にシークレットではないものの、保存時にはペインの他のデータと並んで、平文の profile.json ではなくワークスペースの暗号化された secrets.enc ブロブに保存されます。

設定リファレンス

設定デフォルト説明
変数リストName = Value 行のリスト各行は proxy.env を介して、すべての VM シェルに 1 つの変数をエクスポートします。名前は [A-Za-z_][A-Za-z0-9_]* に一致する必要があり、一致しない場合は警告が表示されスキップされます。値はそのまま使用され、置換はありません。
変数を追加ボタン新しい空の行を追加します。

関連する章

  • 認証情報 — シークレットが属する場所。偽値として注入され、ワイヤ上でスワップされます。
  • MCP — ツールサーバーの設定。一部は環境変数を読み取ります。
  • 設定リファレンス — すべてのペインを一覧で確認できます。