管理配接器與模型

本指南說明如何連接模型供應商，以及如何選擇代理的執行方式。

這裡的一切都在同一個頁面：設定 → 伺服器 → 模型供應商。子側邊欄的條目名為「模型供應商」；頁面標題為「配接器」。

配接器是甚麼

配接器是執行代理回合的_運行器_。共有兩個，而這份清單是固定的——你無法加入第三個。

配接器	CLI	傳輸方式
Control Center (built-in)	無	行程內代理迴圈，透過 HTTP 與供應商通訊
Claude Code	claude	claude -p --output-format stream-json

Cursor、Codex、Anthropic、OpenAI 以及其他都是內建配接器上的供應商，而不是各自獨立的 CLI。你_可以_加入的是另一個供應商——任何與 OpenAI 或 Anthropic 相容的端點。那就是下一節的內容。

偵測所探測的是伺服器，而不是你的機器

偵測到的運行器卡片列出 cc_server 在_伺服器主機的_ PATH 上找到的內容。在精簡型或網頁用戶端上，那是另一台機器，而不是你正在查看的這台。請把 CLI 安裝到執行 cc_server 的機器上。

連接模型供應商

內建配接器至少需要一個已連接的供應商才能執行。目錄中隨附十四個。

1. 前往 設定 → 伺服器 → 模型供應商
2. 捲動到供應商與模型
3. 找到你的供應商並連接它：

供應商	連接方式
Anthropic	API 金鑰。Claude Pro/Max 訂閱不是 Anthropic API 登入——該計劃請使用 Claude Code 配接器
OpenAI、Codex、Cursor	瀏覽器 OAuth 登入，或 API 金鑰。Codex 是透過 Codex Responses 後端提供的 ChatGPT Plus/Pro，而不是衍生的 CLI
Kimi Code	只支援瀏覽器 OAuth——一種裝置碼流程。它是劃一收費計劃，因此沒有按 token 計價的價格
OpenRouter、Google Gemini、DeepSeek、Mistral、xAI、z.ai、z.ai GLM Coding Plan、Moonshot (Kimi API)	API 金鑰

檢查點：該行的徽章會變成已連接，展開後會列出該供應商所提供的模型，每個都附有每百萬 token 的價格與上下文視窗。

OAuth 憑證會存入伺服器自己的憑證儲存庫，並在到期前更新。供應商憑證是主機全域的——由該安裝上的每一個工作區共用，而不是只屬於某一個工作區。

新增自訂供應商

適用於 Ollama、LM Studio、vLLM 或私人部署。

1. 在供應商與模型中，於自訂供應商下方，按新增供應商
2. 填寫名稱，選擇 API 類型（與 OpenAI 相容或與 Anthropic 相容），並提供基礎 URL（例如 http://localhost:11434/v1）
3. 如果端點需要，加入 API 金鑰，然後按新增供應商

自訂供應商會出現在同一份清單中，並帶有一個其內建同類沒有的刪除按鈕。

為代理選擇模型

1. 前往 設定 → 工作區 → 代理 並選擇該代理
2. 在設定分頁上，選擇配接器
3. 從旁邊的下拉選單中選擇模型

對於內建配接器，這個下拉選單是根據每個已連接供應商自己的目錄即時組裝的。沒有儲存憑證的供應商會貢獻零個模型，這就是為甚麼空的下拉選單幾乎總是意味着「尚未連接任何項目」，而不是「沒有可用項目」。

models.dev 只是補充資料，絕不是 id 的來源

隨附的 models.dev 目錄會為已在即時清單中的模型提供價格與上下文視窗。它絕不會加入模型 id。如果你預期出現的模型缺失了，那就是供應商的端點沒有回傳它。

內建配接器的模型 id 是帶限定符的 provider/model，並可能帶有一條以 | 分隔的回退鏈。在回退的情況下，費用會按實際服務該回合的模型計價，而不是按你要求的模型計價。

沒有配接器的代理會在內建迴圈上執行

每個工作區都會預置五個代理——一位 CEO 加上 qa、architect、engineer 與 librarian——它們都沒有配接器，也沒有模型。派發會回退到 Control Center (built-in)，而不是本頁上的預設運行器設定；後者是用戶端偏好，派發路徑從不讀取它。執行日誌會為這些執行記錄 cc-harness，因此轉錄會寫明實際執行的是甚麼。

同樣沒有模型的話，內建迴圈會向 Anthropic 索取它的預設模型。因此，完全未設定的代理，只有在你已連接 Anthropic 帳戶時才會執行，否則會以 No credential for provider "anthropic" 失敗。

完成入門流程的配接器步驟，會用你挑選的那一組回填每一個仍然缺少配接器或模型的代理——CEO 與各專家，涵蓋當時已存在的每一個工作區。之後建立的工作區仍然會把五個代理全部預置為未設定。請在你打算使用的每個代理上明確設定配接器與模型。

安裝運行器 CLI

內建配接器不需要安裝。若使用 Claude Code，請用該工具自己的套件管理員，在伺服器主機上安裝它的 CLI，例如：

npm install -g @anthropic-ai/claude-code

然後按頁面頂部的重新整理。每個偵測到的資料列都會顯示解析出的版本與路徑，並附有標明它是否支援 JSON 模式與模型選擇的標籤。

外部 CLI 會在伺服器主機上、以自己的設定保存自己的憑證。Control Center 不管理它們。

配接器參數與環境變數只保留在本裝置上

每個配接器資料列都提供一個參數欄位與一個環境變數對話框。這些值會儲存在你的裝置上。伺服器會從它自己的設定儲存庫讀取啟動 argv 與環境變數。請把供應商金鑰放在伺服器上（用 OAuth，或模型供應商頁面上的金鑰欄位），而不是放在這兩個欄位裡。

限制工作區可使用的供應商

供應商管治是按工作區進行，並以最後匹配勝出的方式評估。

1. 在供應商與模型中，把供應商資料列上的允許開關關掉

這會為該供應商在作用中工作區寫入一條 deny 語句，它的模型也會從該工作區的目錄中消失。把開關重新打開即會移除這條語句。

疑難排解

運行器顯示為找不到

• 檢查 CLI 是否位於伺服器主機的 PATH 上，而不只是你自己的 PATH
• 由 GUI 啟動的桌面應用程式會以最小化的 PATH 啟動它的伺服器；安裝在僅 shell 可見路徑下的 CLI 可能對它不可見
• 安裝後按重新整理

模型下拉選單是空的

• 配接器是內建的那個，而且沒有連接任何供應商——請在供應商與模型中連接一個
• 或者供應商已連接，但被該工作區的管治開關拒絕

模型可以執行，但價格顯示為未知

即時模型清單帶有 id；價格與上下文來自 models.dev。一個全新的模型，或來自自訂供應商的模型，還沒有目錄條目。

相關指南

• 建立並設定代理
• 管理 API 金鑰
• 診斷代理
• 管理成本

相關概念

• 代理模型
• 代理派發生命週期