> ## 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つのタブで構成されています：**一般**、**外観**、**エージェント**。

## 一般

### アカウント

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

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

プロファイルの設定の詳細については[認証](/ja/ctor/guide/authentication)を参照してください。

### プロバイダー

各AIモデルプロバイダーのAPIキーを設定します。アプリがサポートするプロバイダー：

| プロバイダー                                | 設定                                                   |
| ------------------------------------- | ---------------------------------------------------- |
| **Anthropic**                         | APIキーまたはOAuth（Claude Pro／Max）                        |
| **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キー                                                |

チャット中は、認証情報が設定されているプロバイダーのみがモデルセレクターに表示されます。

### 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キーページ](https://console.cloud.google.com/agent-platform/studio/settings/api-keys) から生成できます。組織によってはAPIキーアクセスが無効化されており、その場合はADCのみ利用可能です。

### OpenAI互換エンドポイント

組み込みプロバイダーの下にカスタムのOpenAI互換APIエンドポイントを追加します。各エンドポイントには独自の名前、ベースURL、APIキー、モデルリストがあります。**+ エンドポイントを追加**をクリックして作成し、設定します：

* **エンドポイント名** — モデルセレクターに表示される名前（例："Ollama"）
* **ベースURL** — APIエンドポイントURL
* **API モード** — **Chat Completions**（デフォルト）または **Responses**。推論モデルには **Responses** を選択してください
* **APIキー** — オプション、プロバイダーによって異なります
* **モデル** — このエンドポイントで利用可能なモデル識別子を1つ以上

設定済みエンドポイントのモデルは、エンドポイント名でグループ化されてモデルセレクターとデフォルトモデルのドロップダウンに表示されます。

各モデルには、独自の**画像**、**推論**、**XHigh** のトグルと、オプションの**コンテキスト**ウィンドウがあります。**推論**は **Responses** API モードでのみ利用でき、**XHigh** は**推論**が有効な場合のみ利用できます。詳しくは[サポートされているモデル](/ja/ctor/reference/models#モデルごとのオプション)を参照してください。

<Tip>
  アプリにAPIキーが設定されていない場合、エージェントは `ANTHROPIC_API_KEY` または `OPENAI_API_KEY` 環境変数にフォールバックします。
</Tip>

### デフォルトモデル

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

### アップデート

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

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

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

## 外観

### テーマ

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

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

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

### アクセント

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

| オプション            | スウォッチ               |
| ---------------- | ------------------- |
| **テラコッタ**（デフォルト） | ウォームオレンジ `#e2924b`  |
| **スカイ**          | クールブルー `#4b8ae2`    |
| **モス**           | 落ち着いたグリーン `#6aad6c` |
| **グラファイト**       | ニュートラルグレー `#86909b` |

### モーションを減らす

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

* **システム** — 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` コマンドが確認プロンプトなしで実行されます。無効（デフォルト）の場合、各コマンドの実行前に承認が必要です。この設定に関わらず、サンドボックス化されたコマンドは常に[サンドボックス](/ja/ctor/reference/sandbox)内で実行されます。`sudo`、`rm -rf`、履歴を書き換える `git` などの[危険なコマンド](/ja/ctor/reference/sandbox#危険なコマンドの検出)は、この設定が有効でも常にプロンプトが表示されます。
* **システム通知** — 有効（デフォルト）にすると、エージェントがターンを完了したとき、失敗したとき、ツール承認のために一時停止したときに、どの CTOR ウィンドウもアクティブでなければ OS のサウンド付きでシステム通知を表示します。通知をクリックすると CTOR を前面に表示します。無効にするとバックグラウンドからの通知は一切発生しなくなります。
* **ACPを有効にする** — ローカルソケットサーバーを起動し、外部ツール（acpx、OpenClaw）が [Agent Client Protocol](/ja/ctor/reference/acp) を介してエージェントと対話できるようにします。デフォルトで無効。トグルはアプリを再起動せずにすぐに有効になります。
* **サンドボックス設定** — `sandbox.json` を開いてサンドボックスのネットワークとファイルシステムの権限をカスタマイズします。詳細については[サンドボックス](/ja/ctor/reference/sandbox)を参照してください。
* **フック設定** — `hooks.json` を開いてエージェントイベント時にカスタムコマンドを実行します。プロジェクト単位のフックは `.bricks/hooks.json` に配置できます。詳細については[フック](/ja/ctor/reference/hooks)を参照してください。

### デフォルトの思考レベル

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

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

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

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

サブエージェントのデフォルト思考レベルを選択します。利用可能なレベル：`off`、`minimal`、`low`、`medium`、`high`、`xhigh`。空のままにするとモデル固有のデフォルトが使用されます。完全な解決順序については[サブエージェント](/ja/ctor/reference/sub-agents#thinking-level-resolution)を参照してください。

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

使用中のモデルが画像を処理できないときに代わりに説明する画像認識モデルを選びます。画像に対応していないモデルもあり、そうしたモデルを選んでいる場合、CTOR は各画像をこのフォールバックモデルに送り、使用中のモデルが読めるテキスト説明を受け取ります。空欄（**無効**、デフォルト）にするとこの機能はオフになります。

セレクターには画像入力に対応したモデルのみが表示されます。フォールバックは、エージェントが本来見落とす画像 — 添付ファイル、`read_file` で開いた画像、[シミュレータ](/ja/ctor/reference/preview#エージェント駆動のプレビュー)のスクリーンショット、MCP ツールが返す画像 — をすべてカバーします。元の画像は会話にそのまま残り、生成された説明が併せて保存されるため、同じ画像が後続のターンで再び説明されることはありません。説明は[メッセージ詳細](/ja/ctor/guide/agent-usage#メッセージを確認する)パネルの各画像の下にも表示されます。フォールバックを設定すると、画像非対応のモデルでも画像の添付と[描画モード](/ja/ctor/reference/preview#描画モード)が引き続き使えます。

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

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

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

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

## 詳細設定

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

### 実験的機能

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

## データストレージ

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

| データ                 | 場所                                               |
| ------------------- | ------------------------------------------------ |
| 認証設定                | `~/.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/hooks.json`           |

<Tip>
  `BRICKS_PROJECT_DESKTOP_DATA_DIR` 環境変数を設定すると、デフォルトのデータディレクトリ（`~/.bricks-project-desktop/`）を上書きできます。
</Tip>