設定

サイドバーのギアアイコンをクリックして設定を開きます。設定モーダルは3つのタブで構成されています：一般、外観、エージェント。

​

一般

​

アカウント

ワークスペースプロファイルと認証ステータスを管理します。

• 設定済みのすべてのプロファイルとそのワークスペース名を表示
• プロファイルを切り替える
• プロファイルを追加または削除する
• 接続ステータスを確認（緑/赤インジケーター）
• 現在のプロファイルからログアウト

プロファイルの設定の詳細については認証を参照してください。

​

プロバイダー

各AIモデルプロバイダーのAPIキーを設定します。アプリがサポートするプロバイダー： チャット中は、認証情報が設定されているプロバイダーのみがモデルセレクターに表示されます。

​

Anthropic

Anthropicプロバイダーは2つの認証方式をサポートします：

• APIキー — Anthropicアカウントに対するトークン従量課金です。プロバイダーカードに sk-ant-... キーを入力します。
• Claudeでログイン — Claude ProまたはMaxサブスクリプションのクレジットを消費するクレジットベースの利用方式です。Claudeでログインをクリックすると、ブラウザでOAuthフローが開き、CTORはローカルコールバックでトークンを受け取ります。ログイン中はプロバイダー行にOAuthバッジが表示されます。

両方の認証情報を同じ行に共存させることができ、両方ある場合はOAuthが優先されます。実行中のログインは、同じボタン、ブラウザタブを閉じる、または設定ウィンドウを閉じることでキャンセルできます。現在のデバイスでブラウザを開けない場合は、表示された認可URLを別のデバイスにコピーしてください。

​

Google Agent Platform (Vertex AI)

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 モード — Chat Completions（デフォルト）または Responses。推論モデルには Responses を選択してください
• APIキー — オプション、プロバイダーによって異なります
• モデル — このエンドポイントで利用可能なモデル識別子を1つ以上

設定済みエンドポイントのモデルは、エンドポイント名でグループ化されてモデルセレクターとデフォルトモデルのドロップダウンに表示されます。 各モデルには、独自の画像、推論、XHigh のトグルと、オプションのコンテキストウィンドウがあります。推論は Responses API モードでのみ利用でき、XHigh は推論が有効な場合のみ利用できます。詳しくはサポートされているモデルを参照してください。

​

デフォルトモデル

新しいセッションに使用するデフォルトモデルを選択します。入力バーのモデルセレクターを使用して、セッションごとにモデルを上書きできます。

​

アップデート

アプリのアップデートを確認してインストールします：

• アップデートを確認 — アップデートサーバーに最新バージョンを問い合わせます
• ダウンロードしてインストール — アップデートをダウンロードしてアプリを再起動します

現在のバージョンと最新の利用可能バージョンが表示されます。

​

外観

​

テーマ

アプリのテーマを選択します：

• システム — OSのテーマに従います
• ライト — ライトモード
• ダーク — ダークモード

各オプションには、そのテーマでのチャットセッションと差分ビューのミニチュアプレビューが表示されます。テーマはすぐに適用されます。

​

アクセント

UI 全体で使用するアクセントカラーを選択します。ボタン、フォーカスリング、リンク、チャットのユーザーメッセージバブルに適用されます。変更はすぐに反映され、テーマプレビューのスウォッチも連動して更新されます。

​

モーションを減らす

アプリ全体のアニメーションと画面遷移を最小限にします。デフォルトは システム。

• システム — OS のモーション低減設定に従います
• オン — OS の設定に関係なく、常にモーションを最小限にします
• オフ — OS の設定を上書きして、常にモーションを有効にします

変更はすぐに反映されます。

​

ウィンドウ

macOS のみで利用可能。macOS のネイティブ Vibrancy を使って、デスクトップをウィンドウ越しに透けさせます。

• 背景ぼかし — テーマに合わせた半透明サーフェスを macOS Vibrancy で有効にします。デフォルトで無効。
• サーフェスの不透明度 — アプリのサーフェスがどれだけ不透明に見えるかを調整するスライダー。値を下げるとデスクトップのぼかしが強く表示され（ぼかしを強く）、値を上げるとパネルがより不透明になります（より不透明）。範囲は 25–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 を開いてサンドボックスのネットワークとファイルシステムの権限をカスタマイズします。詳細についてはサンドボックスを参照してください。
• フック設定 — hooks.json を開いてエージェントイベント時にカスタムコマンドを実行します。プロジェクト単位のフックは .bricks/hooks.json に配置できます。詳細についてはフックを参照してください。

​

デフォルトの思考レベル

新しいセッションのデフォルトの思考レベルを選択します。利用可能なレベル：off、minimal、low、medium、high、xhigh。空のままにすると高が使用されます。

​

サブエージェントのデフォルトモデル

サブエージェント生成のデフォルトモデルを選択します。これがモデル解決にどう組み込まれるかについてはサブエージェントを参照してください。

​

サブエージェントのデフォルト思考レベル

サブエージェントのデフォルト思考レベルを選択します。利用可能なレベル：off、minimal、low、medium、high、xhigh。空のままにするとモデル固有のデフォルトが使用されます。完全な解決順序についてはサブエージェントを参照してください。

​

フォールバック画像認識モデル

使用中のモデルが画像を処理できないときに代わりに説明する画像認識モデルを選びます。画像に対応していないモデルもあり、そうしたモデルを選んでいる場合、CTOR は各画像をこのフォールバックモデルに送り、使用中のモデルが読めるテキスト説明を受け取ります。空欄（無効、デフォルト）にするとこの機能はオフになります。 セレクターには画像入力に対応したモデルのみが表示されます。フォールバックは、エージェントが本来見落とす画像 — 添付ファイル、read_file で開いた画像、シミュレータのスクリーンショット、MCP ツールが返す画像 — をすべてカバーします。元の画像は会話にそのまま残り、生成された説明が併せて保存されるため、同じ画像が後続のターンで再び説明されることはありません。説明はメッセージ詳細パネルの各画像の下にも表示されます。フォールバックを設定すると、画像非対応のモデルでも画像の添付と描画モードが引き続き使えます。

​

メインチャットの作業ディレクトリ

メインチャットがプロジェクトや生成物を書き込む場所を選択します。デフォルトは ~/bricks-ctor で、フィールドが空のときはプレースホルダーとして表示されます。

• 参照… — ディレクトリピッカーを開きます。選択したパスはテキストボックスに反映されますが、保存 をクリックするまで保存はされません。
• 保存 — 入力したパスを書き込みます。書き込み前にバリデーションが走ります：
  • 絶対パスである必要があります（./work のような相対パスは拒否されます）。
  • ファイルシステムのルート（/、C:\）は使えません。
  • 親ディレクトリが既に存在している必要があります — CTOR は末端のディレクトリは作成しますが、途中の階層は作成しません。
• リセット — 保存済みの値をクリアして ~/bricks-ctor に戻します。カスタムパスが保存されている場合のみ表示されます。

変更はアプリを再起動せずに即時に反映されます — メインエージェントのツール、サンドボックススコープ、ファイルメンションはすぐに新しいディレクトリに切り替わります。保存済みパスの親ディレクトリがあとで失われた場合（外部ディスクのアンマウント、フォルダー削除など）、フィールドにインラインエラーが表示され、新しい場所を選択するかリセットするまでメインチャットは起動しません。

​

詳細設定

• 思考コンテンツを表示 — チャットメッセージにモデルの思考コンテンツを表示します。デフォルトで無効。
• メッセージボタンを表示 — 入力バーにメッセージボタンを表示します。クリックすると、モデルに送信されるメッセージを確認・エクスポートできるメッセージ詳細パネルが開きます。メッセージを確認するを参照してください。デフォルトで無効。
• 環境スイッチを表示 — ログイン画面に環境セレクターを表示します。デフォルトで無効。
• バックグラウンドプロセスを有効にする — エージェントがバックグラウンド子プロセスを生成できるようにします。デーモン（持続）とlong-run（完了コールバック）モードをサポートします。デフォルトで有効。

​

実験的機能

• Language Server Tools — 編集のたびに TypeScript のエラーをエージェントに確認させ、型や関数の定義箇所や使用箇所を素早く見つけられるようにします。AI エージェントの使用を参照してください。デフォルトで無効。
• 音声入力 — Apple Speech を使って入力バーにメッセージを音声入力します。macOS 26 以降とマイクへのアクセスが必要なため、トグルは対応している Mac でのみ表示されます。デフォルトで無効。有効にすると、入力バーにマイクボタンが追加されます——音声入力を参照してください。
  • 音声言語 — 音声入力の認識言語：英語、繁体字中国語、または日本語。変更しない場合はアプリの言語を使用します。

​

データストレージ

アプリは次の場所にデータを保存します：