Documentation Index
Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
Use this file to discover all available pages before exploring further.
サイドバーのギアアイコンをクリックして設定を開きます。設定モーダルは3つのタブで構成されています:一般、外観、エージェント。
アカウント
ワークスペースプロファイルと認証ステータスを管理します。
- 設定済みのすべてのプロファイルとそのワークスペース名を表示
- プロファイルを切り替える
- プロファイルを追加または削除する
- 接続ステータスを確認(緑/赤インジケーター)
- 現在のプロファイルからログアウト
プロファイルの設定の詳細については認証を参照してください。
プロバイダー
各AIモデルプロバイダーのAPIキーを設定します。アプリがサポートするプロバイダー:
| プロバイダー | 設定 |
|---|
| Anthropic | APIキー |
| OpenAI | APIキー、オプションのベースURL |
| OpenAI Codex | OAuth認証 |
| Google | APIキー |
| Google Agent Platform (Vertex AI) | ADC/サービスアカウントキー/APIキー(Geminiのみ)+ Project ID + Region |
| GitHub Copilot | OAuth認証 |
| OpenCode Zen | APIキー |
| OpenCode Go | APIキー |
チャット中は、APIキーが設定されているプロバイダーのみがモデルセレクターに表示されます。
GoogleはVertex AIをAgent Platformに名称変更しました。CTORは両方の名称を表示するため、どちらの呼称でもプロバイダーを見つけられます。プロバイダーカードを展開すると、次の項目を設定できます:
- Use default ADC —
~/.config/gcloud/application_default_credentials.json から認証情報を読み取ります。ClaudeとGeminiの両方で推奨されており、Claudeパートナーモデルでは必須です。
- Service Account Key File — サービスアカウントJSONファイルのパス。Browse… ボタンでファイルピッカーが開きます。デフォルトADCの代替として使用します。Use default ADC が有効なときは無効化されます。
- Project ID — Google CloudプロジェクトID。ClaudeがADCを使用する場合は任意(認証情報の
quota_project_id から自動解決)、GeminiとAPIキー使用時は必須です。
- Region —
global、us、eu、us-east5、europe-west1 などのVertexリージョン。空欄の場合は global がデフォルトになります。
- API Key — Geminiのみ。ClaudeパートナーモデルはAPIキーを拒否し、ADCまたはサービスアカウント経由のOAuth2/IAMを必要とします。
ADCをセットアップするには、ターミナルで bash <(curl -sSL https://storage.googleapis.com/cloud-samples-data/adc/setup_adc.sh) を実行します。APIキーは Agent Platform StudioのAPIキーページ から生成できます。組織によってはAPIキーアクセスが無効化されており、その場合はADCのみ利用可能です。
OpenAI互換エンドポイント
組み込みプロバイダーの下にカスタムのOpenAI互換APIエンドポイントを追加します。各エンドポイントには独自の名前、ベースURL、APIキー、モデルリストがあります。+ エンドポイントを追加をクリックして作成し、設定します:
- エンドポイント名 — モデルセレクターに表示される名前(例:“Ollama”)
- ベースURL — APIエンドポイントURL
- APIキー — オプション、プロバイダーによって異なります
- モデル — このエンドポイントで利用可能なモデル識別子を1つ以上
設定済みエンドポイントのモデルは、エンドポイント名でグループ化されてモデルセレクターとデフォルトモデルのドロップダウンに表示されます。
アプリにAPIキーが設定されていない場合、エージェントは ANTHROPIC_API_KEY または OPENAI_API_KEY 環境変数にフォールバックします。
デフォルトモデル
新しいセッションに使用するデフォルトモデルを選択します。入力バーのモデルセレクターを使用して、セッションごとにモデルを上書きできます。
アップデート
アプリのアップデートを確認してインストールします:
- アップデートを確認 — アップデートサーバーに最新バージョンを問い合わせます
- ダウンロードしてインストール — アップデートをダウンロードしてアプリを再起動します
現在のバージョンと最新の利用可能バージョンが表示されます。
テーマ
アプリのテーマを選択します:
- システム — OSのテーマに従います
- ライト — ライトモード
- ダーク — ダークモード
各オプションには、そのテーマでのチャットセッションと差分ビューのミニチュアプレビューが表示されます。テーマはすぐに適用されます。
アクセント
UI 全体で使用するアクセントカラーを選択します。ボタン、フォーカスリング、リンク、チャットのユーザーメッセージバブルに適用されます。変更はすぐに反映され、テーマプレビューのスウォッチも連動して更新されます。
| オプション | スウォッチ |
|---|
| テラコッタ(デフォルト) | ウォームオレンジ #e2924b |
| スカイ | クールブルー #4b8ae2 |
| モス | 落ち着いたグリーン #6aad6c |
| グラファイト | ニュートラルグレー #86909b |
ウィンドウ
macOS のみで利用可能。macOS のネイティブ Vibrancy を使って、デスクトップをウィンドウ越しに透けさせます。
- 背景ぼかし — テーマに合わせた半透明サーフェスを macOS Vibrancy で有効にします。デフォルトで無効。
- 背景アルファ — ぼかしたデスクトップがアプリのサーフェス越しに見える量を調整するスライダー。範囲は 45–95%、デフォルトは 78%。背景ぼかし が有効なときのみ調整できます。
フォント
アプリ全体で使用するフォントをカスタマイズします:
- UIフォント — インターフェース(メニュー、ラベル、メッセージ)に使用するフォント。CSSフォントファミリー値を入力します。
- コードフォント — コードブロック、ターミナル出力、差分セクションに使用するフォント。CSSフォントファミリー値を入力します。
UIフォントはデフォルトでプラットフォームネイティブのサンセリフ(macOSのSF Pro、LinuxのUbuntu/Noto Sans)です。コードフォントはデフォルトでクロスプラットフォームの等幅スタックです。入力フィールドには選択したフォントが入力中にプレビューされます。
アプリの言語を選択します:
- English (US)
- Traditional Chinese(繁體中文)
- Japanese(日本語)
システムオプションはOSのロケールに従います。
エージェント
エージェントの動作を設定します:
- bashコマンドを自動承認する — 有効にすると、フルアクセスのbashコマンドと信頼された
bricks devtools コマンドが確認プロンプトなしで実行されます。無効(デフォルト)の場合、各コマンドの実行前に承認が必要です。この設定に関わらず、サンドボックス化されたコマンドは常にサンドボックス内で実行されます。sudo、rm -rf、履歴を書き換える git などの危険なコマンドは、この設定が有効でも常にプロンプトが表示されます。
- システム通知 — 有効(デフォルト)にすると、エージェントがターンを完了したとき、失敗したとき、ツール承認のために一時停止したときに、どの CTOR ウィンドウもアクティブでなければ OS のサウンド付きでシステム通知を表示します。通知をクリックすると CTOR を前面に表示します。無効にするとバックグラウンドからの通知は一切発生しなくなります。
- ACPを有効にする — ローカルソケットサーバーを起動し、外部ツール(acpx、OpenClaw)が Agent Client Protocol を介してエージェントと対話できるようにします。デフォルトで無効。トグルはアプリを再起動せずにすぐに有効になります。
- サンドボックス設定 —
sandbox.json を開いてサンドボックスのネットワークとファイルシステムの権限をカスタマイズします。詳細についてはサンドボックスを参照してください。
デフォルトの思考レベル
新しいセッションのデフォルトの思考レベルを選択します。利用可能なレベル:off、minimal、low、medium、high、xhigh。空のままにすると高が使用されます。
サブエージェントのデフォルトモデル
サブエージェント生成のデフォルトモデルを選択します。これがモデル解決にどう組み込まれるかについてはサブエージェントを参照してください。
サブエージェントのデフォルト思考レベル
サブエージェントのデフォルト思考レベルを選択します。利用可能なレベル:off、minimal、low、medium、high、xhigh。空のままにするとモデル固有のデフォルトが使用されます。完全な解決順序についてはサブエージェントを参照してください。
詳細設定
- 思考コンテンツを表示 — チャットメッセージにモデルの思考コンテンツを表示します。デフォルトで無効。
- プロンプトボタンを表示 — 入力バーにプロンプトボタンを表示します。デフォルトで無効。
- 環境スイッチを表示 — ログイン画面に環境セレクターを表示します。デフォルトで無効。
- バックグラウンドプロセスを有効にする — エージェントがバックグラウンド子プロセスを生成できるようにします。デーモン(持続)とlong-run(完了コールバック)モードをサポートします。デフォルトで無効。
データストレージ
アプリは次の場所にデータを保存します:
| データ | 場所 |
|---|
| 認証設定 | ~/.bricks-cli/config.json |
| アプリ設定 | ~/.bricks-project-desktop/settings.json |
| チャットセッション | ~/.bricks-project-desktop/sessions/ |
| グローバルスキル | ~/.bricks-project-desktop/skills/ |
| プロジェクトスキル | <project>/.bricks/skills/ |
| MCP設定 | <project>/.mcp.json |
| サンドボックス設定 | ~/.bricks-project-desktop/sandbox.json |
| プロジェクトごとのサンドボックスモード | ~/.bricks-project-desktop/project-sandbox.json |
BRICKS_PROJECT_DESKTOP_DATA_DIR 環境変数を設定すると、デフォルトのデータディレクトリ(~/.bricks-project-desktop/)を上書きできます。