一般
アカウント
ワークスペースプロファイルと認証ステータスを管理します。- 設定済みのすべてのプロファイルとそのワークスペース名を表示
- プロファイルを切り替える
- プロファイルを追加または削除する
- 接続ステータスを確認（緑/赤インジケーター）
- 現在のプロファイルからログアウト
プロバイダー
各AIモデルプロバイダーのAPIキーを設定します。アプリがサポートするプロバイダー：
チャット中は、認証情報が設定されているプロバイダーのみがモデルセレクターに表示されます。
Anthropic
Anthropicプロバイダーは2つの認証方式をサポートします：- APIキー — Anthropicアカウントに対するトークン従量課金です。プロバイダーカードに
sk-ant-...キーを入力します。 - Claudeでログイン — Claude ProまたはMaxサブスクリプションのクレジットを消費するクレジットベースの利用方式です。Claudeでログインをクリックすると、ブラウザでOAuthフローが開き、CTORはローカルコールバックでトークンを受け取ります。ログイン中はプロバイダー行にOAuthバッジが表示されます。
xAI
xAIプロバイダーは2つの認証方式をサポートします：- APIキー — xAIアカウントに対するトークン従量課金です。プロバイダーカードに
xai-...キーを入力します。 - SuperGrokでログイン — SuperGrokサブスクリプションに基づくOAuthログイン方式です。SuperGrokでログインをクリックすると、ブラウザで認可ページが開き、CTORはローカルコールバックでトークンを受け取ります。ログイン中はプロバイダー行にOAuthバッジが表示されます。
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を必要とします。
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つ以上
デフォルトモデル
新しいセッションに使用するデフォルトモデルを選択します。入力バーのモデルセレクターを使用して、セッションごとにモデルを上書きできます。ターミナルシェル
ターミナルタブが使用するシェルを、プロファイルのドロップダウンから選択します：
Windows のプロファイルは設定を開いたときに検出されるため、新しくインストールした PowerShell 7 や WSL ディストリビューションはパネルを開き直すと表示されます。以前保存したカスタムシェルは Custom command プロファイルに移行されます。
Custom command の場合：
- 保存 — 欄の値が保存済みの値と異なる場合にのみ有効になります。
- リセット — カスタムシェルをクリアしてシステムのデフォルトに戻します。カスタムシェルが保存されている場合のみ表示されます。
Windows では、このプロファイルはエージェントのコマンドツールが使うシェルも決定します——サンドボックスを参照してください。
アップデート
アプリのアップデートを確認してインストールします：- アップデートを確認 — アップデートサーバーに最新バージョンを問い合わせます
- ダウンロードしてインストール — アップデートをダウンロードしてアプリを再起動します
外観
テーマ
アプリのテーマを選択します：- システム — OSのテーマに従います
- ライト — ライトモード
- ダーク — ダークモード
アクセント
UI 全体で使用するアクセントカラーを選択します。ボタン、フォーカスリング、リンク、チャットのユーザーメッセージバブルに適用されます。変更はすぐに反映され、テーマプレビューのスウォッチも連動して更新されます。モーションを減らす
アプリ全体のアニメーションと画面遷移を最小限にします。デフォルトは システム。- システム — OS のモーション低減設定に従います
- オン — OS の設定に関係なく、常にモーションを最小限にします
- オフ — OS の設定を上書きして、常にモーションを有効にします
ウィンドウ
macOS のみで利用可能。macOS のネイティブ Vibrancy を使って、デスクトップをウィンドウ越しに透けさせます。- 背景ぼかし — テーマに合わせた半透明サーフェスを macOS Vibrancy で有効にします。デフォルトで無効。
- サーフェスの不透明度 — アプリのサーフェスがどれだけ不透明に見えるかを調整するスライダー。値を下げるとデスクトップのぼかしが強く表示され（ぼかしを強く）、値を上げるとパネルがより不透明になります（より不透明）。範囲は 25–95%、デフォルトは 78%。背景ぼかし が有効なときのみ調整できます。
フォント
アプリ全体で使用するフォントをカスタマイズします：- UIフォント — インターフェース（メニュー、ラベル、メッセージ）に使用するフォント。CSSフォントファミリー値を入力します。
- コードフォント — コードブロック、ターミナル出力、差分セクションに使用するフォント。CSSフォントファミリー値を入力します。
言語
アプリの言語を選択します：- English (US)
- Traditional Chinese（繁體中文）
- Japanese（日本語）
エージェント
エージェントの動作を設定します：- bashコマンドを自動承認する — 有効にすると、フルアクセスのbashコマンドと信頼された
bricks devtoolsコマンドが確認プロンプトなしで実行されます。無効（デフォルト）の場合、各コマンドの実行前に承認が必要です。この設定に関わらず、サンドボックス化されたコマンドは常にサンドボックス内で実行されます。sudo、rm -rf、履歴を書き換えるgitなどの危険なコマンドは、この設定が有効でも常にプロンプトが表示されます。 - システム通知 — 有効（デフォルト）にすると、エージェントがターンを完了したとき、失敗したとき、ツール承認のために一時停止したときに、どの CTOR ウィンドウもアクティブでなければ OS のサウンド付きでシステム通知を表示します。通知をクリックすると CTOR を前面に表示します。無効にするとバックグラウンドからの通知は一切発生しなくなります。
- スケジュールタスク — スケジュール機能のオン・オフを切り替えます。デフォルトで有効。オフにしても既存のスケジュールは残りますが、実行されなくなります。
- ACPを有効にする — ローカルソケットサーバーを起動し、外部ツール（acpx、OpenClaw）が Agent Client Protocol を介してエージェントと対話できるようにします。デフォルトで無効。トグルはアプリを再起動せずにすぐに有効になります。
- サンドボックス設定 —
sandbox.jsonを開いてサンドボックスのネットワークとファイルシステムの権限をカスタマイズします。詳細についてはサンドボックスを参照してください。 - フック設定 —
hooks.jsonを開いてエージェントイベント時にカスタムコマンドを実行します。プロジェクト単位のフックは.bricks/hooks.jsonに配置できます。詳細についてはフックを参照してください。
CLI エージェント (Preview)
- CLI エージェント — CTOR 自身の組み込みエージェントの代わりに、ローカルの CLI コーディングエージェント（Claude Code、Codex、Pi、Cursor Agent）でチャットを動かせるようにします。デフォルトで有効。CLI エージェントを参照してください。
- 各エンジン用のパスオーバーライド（
claude、codex、pi、cursor-agent） — 自動検出されるバイナリの代わりに、CTOR に特定のバイナリを指定します。各行には、検出されたバージョンと、それがシステムインストールか CTOR にバンドルされたものかも表示されます。
デフォルトの思考レベル
新しいセッションのデフォルトの思考レベルを選択します。利用可能なレベル：off、minimal、low、medium、high、xhigh、max。空のままにすると高が使用されます。
サブエージェントのデフォルトモデル
サブエージェント生成のデフォルトモデルを選択します。これがモデル解決にどう組み込まれるかについてはサブエージェントを参照してください。サブエージェントのデフォルト思考レベル
サブエージェントのデフォルト思考レベルを選択します。利用可能なレベル：off、minimal、low、medium、high、xhigh、max。空のままにするとモデル固有のデフォルトが使用されます。完全な解決順序についてはサブエージェントを参照してください。
フォールバック画像認識モデル
使用中のモデルが画像を処理できないときに代わりに説明する画像認識モデルを選びます。画像に対応していないモデルもあり、そうしたモデルを選んでいる場合、CTOR は各画像をこのフォールバックモデルに送り、使用中のモデルが読めるテキスト説明を受け取ります。空欄（無効、デフォルト）にするとこの機能はオフになります。 セレクターには画像入力に対応したモデルのみが表示されます。フォールバックは、エージェントが本来見落とす画像 — 添付ファイル、read_file で開いた画像、シミュレータのスクリーンショット、MCP ツールが返す画像 — をすべてカバーします。元の画像は会話にそのまま残り、生成された説明が併せて保存されるため、同じ画像が後続のターンで再び説明されることはありません。説明はメッセージ詳細パネルの各画像の下にも表示されます。フォールバックを設定すると、画像非対応のモデルでも画像の添付と描画モードが引き続き使えます。
メインチャットの作業ディレクトリ
メインチャットがプロジェクトや生成物を書き込む場所を選択します。デフォルトは~/bricks-ctor で、フィールドが空のときはプレースホルダーとして表示されます。
- 参照… — ディレクトリピッカーを開きます。選択したパスはテキストボックスに反映されますが、保存 をクリックするまで保存はされません。
- 保存 — 入力したパスを書き込みます。書き込み前にバリデーションが走ります：
- 絶対パスである必要があります（
./workのような相対パスは拒否されます）。 - ファイルシステムのルート（
/、C:\）は使えません。 - 親ディレクトリが既に存在している必要があります — CTOR は末端のディレクトリは作成しますが、途中の階層は作成しません。
- 絶対パスである必要があります（
- リセット — 保存済みの値をクリアして
~/bricks-ctorに戻します。カスタムパスが保存されている場合のみ表示されます。
詳細設定
- 思考コンテンツを表示 — チャットメッセージにモデルの思考コンテンツを表示します。デフォルトで無効。
- メッセージボタンを表示 — 入力バーにメッセージボタンを表示します。クリックすると、モデルに送信されるメッセージを確認・エクスポートできるメッセージ詳細パネルが開きます。メッセージを確認するを参照してください。デフォルトで無効。
- 環境スイッチを表示 — ログイン画面に環境セレクターを表示します。デフォルトで無効。
- バックグラウンドプロセスを有効にする — エージェントがバックグラウンド子プロセスを生成できるようにします。デーモン（持続）とlong-run（完了コールバック）モードをサポートします。デフォルトで有効。
実験的機能
- Language Server Tools — 編集のたびに TypeScript のエラーをエージェントに確認させ、型や関数の定義箇所や使用箇所を素早く見つけられるようにします。AI エージェントの使用を参照してください。デフォルトで無効。
- 自動メモリを有効化 — エージェントがプロジェクトごとにセッションをまたいで自分のメモを保存・想起できるようにします。詳細は自動メモリを参照してください。デフォルトで無効。
- Ultra 思考レベル — チャットの思考レベルピッカーで Ultra ティアを提供します。エージェントが自発的に並列サブエージェントへ作業を振り分け、トークン使用量はすべてのティアの中で最大になります。Ultra を参照してください。デフォルトで無効。
- Ultra 並列エージェント数 — Ultra チャットが同時に実行できる並列サブエージェント数（1〜8）。デフォルトは 3。Ultra 思考レベルが有効な場合のみ表示されます。
- 音声入力 — Apple Speech を使って入力バーにメッセージを音声入力します。macOS 26 以降とマイクへのアクセスが必要なため、トグルは対応している Mac でのみ表示されます。デフォルトで無効。有効にすると、入力バーにマイクボタンが追加されます——音声入力を参照してください。
- 音声言語 — 音声入力の認識言語：英語、繁体字中国語、または日本語。変更しない場合はアプリの言語を使用します。