設定

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.

點擊側邊欄中的齒輪圖示開啟設定。設定視窗分為三個標籤頁：一般、外觀和代理。

​

一般

​

帳號

管理您的工作區設定檔和驗證狀態。

• 檢視所有已設定的設定檔及其工作區名稱
• 在設定檔之間切換
• 新增或移除設定檔
• 檢視連線狀態（綠色/紅色指示符）
• 登出目前設定檔

請參閱驗證以了解設定設定檔的詳細資訊。

​

服務商

為每個 AI 模型服務商設定 API 金鑰。應用程式支援： 在聊天期間，只有已設定 API 金鑰的服務商才會出現在模型選擇器中。

​

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 —Vertex 區域，例如 global、us、eu、us-east5 或 europe-west1。留空時預設為 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 keys 頁面產生；部分組織會停用 API 金鑰存取，此時只能使用 ADC。

​

OpenAI 相容端點

在內建服務商下方新增自訂 OpenAI 相容 API 端點。每個端點有自己的名稱、基礎 URL、API 金鑰和模型清單。點擊 + 新增端點來建立一個，然後設定：

• 端點名稱 —顯示於模型選擇器中的顯示名稱（例如「Ollama」）
• 基礎 URL —API 端點 URL
• API 金鑰 —選填，視服務商而定
• 模型 —在此端點可用的一個或多個模型識別碼

已設定端點的模型會出現在模型選擇器和預設模型下拉選單中，並以端點名稱分組。

​

預設模型

選擇用於新工作階段的預設模型。您可以使用輸入列中的模型選擇器，按工作階段覆蓋模型設定。

​

更新

檢查並安裝應用程式更新：

• 檢查更新 —查詢更新伺服器以取得最新版本
• 下載並安裝 —下載更新並重新啟動應用程式

顯示您目前的版本和最新可用版本。

​

外觀

​

佈景主題

選擇應用程式佈景主題：

• 系統 —追蹤您的作業系統佈景主題
• 淺色 —淺色模式
• 深色 —深色模式

每個選項都顯示該佈景主題下聊天工作階段和差異檢視的縮圖預覽。佈景主題立即套用。

​

強調色

選擇整個介面使用的強調色，包含按鈕、焦點外框、連結，以及聊天中的使用者訊息泡。變更會立即套用，佈景主題預覽縮圖也會同步更新。

​

視窗

僅 macOS 可用。讓桌面透過應用程式視窗呈現，使用 macOS 原生 Vibrancy。

• 背景模糊 —啟用搭配符合主題的半透明介面，由 macOS Vibrancy 支援。預設停用。
• 背景透明度 —滑桿用於調整模糊桌面透過介面顯示的程度。範圍 45–95%，預設 78%。需先啟用 背景模糊 才能調整。

​

字型

自訂應用程式中使用的字型：

• 介面字型 —介面使用的字型（選單、標籤、訊息）。輸入 CSS 字型系列值。
• 程式碼字型 —程式碼區塊、終端機輸出和差異區段使用的字型。輸入 CSS 字型系列值。

介面字型預設為平台原生無襯線字型（macOS 上的 SF Pro，Linux 上的 Ubuntu/Noto Sans）。程式碼字型預設為跨平台等寬字型組合。輸入欄位會在您輸入時預覽您選擇的字型。

​

語言

選擇應用程式語言：

• English (US)
• Traditional Chinese（繁體中文）
• Japanese（日本語）

系統選項追蹤您的作業系統地區設定。

​

代理

設定代理行為：

• 自動核准 bash 指令 —啟用後，完整存取 bash 指令和受信任的 bricks devtools 指令無需確認即可執行。停用（預設）時，每個指令執行前需要您核准。無論此設定為何，沙箱化指令始終在沙箱中執行。危險指令（如 sudo、rm -rf 或改寫歷史的 git）即使啟用此設定也一律會顯示提示。
• 系統通知 —啟用（預設）後，當代理完成回合、失敗，或暫停等待工具核准，且沒有任何 CTOR 視窗取得焦點時，CTOR 會發出附帶作業系統提示音的系統通知。點選通知即可將 CTOR 帶到前景。停用後將不再發出任何背景提示。
• 啟用 ACP —啟動本機通訊端伺服器，讓外部工具（acpx、OpenClaw）可以透過 Agent Client Protocol 與代理互動。預設停用。切換立即生效，無需重新啟動應用程式。
• 沙箱設定 —開啟 sandbox.json 以自訂沙箱的網路和檔案系統許可權。請參閱沙箱以了解詳細資訊。

​

預設思考層級

選擇新工作階段的預設思考層級。可用層級：off、minimal、low、medium、high、xhigh。留空則使用高。

​

子代理預設模型

選擇子代理生成的預設模型。請參閱子代理，了解此設定如何融入模型解析。

​

子代理預設思考層級

選擇子代理的預設思考層級。可用層級：off、minimal、low、medium、high、xhigh。留空則使用模型特定的預設值。請參閱子代理以了解完整的解析順序。

​

進階

• 顯示思考內容 —在聊天訊息中顯示模型思考內容。預設停用。
• 顯示提示按鈕 —在輸入列中顯示提示按鈕。預設停用。
• 顯示環境切換 —在登入畫面上顯示環境選擇器。預設停用。
• 啟用背景程序 —允許代理生成背景子程序。支援 daemon（持續）和 long-run（完成回呼）模式。預設停用。

​

資料儲存

應用程式將其資料儲存於以下位置：