WorkBuddy 自訂模型：Claude 與 GPT

WorkBuddy 是騰訊雲的桌面 AI Agent；把它的自訂模型端點指向 Code By AI，就能用一把金鑰跑 Claude 與 GPT 模型。

WorkBuddy 內建多個模型，也接受自訂的 OpenAI 相容端點。自訂項目要填的是完整的 Chat Completions URL，正好對得上 Code By AI 閘道。設定與 API Key 都留在本機。

一條命令配置（macOS / Linux）

先完全退出 WorkBuddy，再執行：

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --workbuddy

腳本會以隱藏輸入索要 API Key，把 gpt-5.6-terra 與 claude-sonnet-5 加進 ~/.workbuddy/models.json，備份原檔並設為僅本人可讀寫。重跑可輪換金鑰；| sh -s -- --uninstall 會還原原檔。完成後重新開啟 WorkBuddy，再從模型選擇器挑選自訂模型。下面的手動步驟做的是同一件事。

1. 建立 Code By AI API Key

登入 Code By AI，打開 API Keys 頁面建立金鑰。金鑰形如 sk-proj-...。

2. 打開自訂模型設定

兩個入口都可以：

• 設定 → 模型 → 自訂模型
• 對話介面底部的模型切換入口 → + 設定自訂模型

3. 加入 GPT 模型

在 新增模型 頁面選 自訂 / Custom，填入：

• 接口地址／Endpoint： https://www.codebyai.net/api/agent/v1/chat/completions
• API Key： Code By AI 金鑰
• 模型名稱／Model name： gpt-5.6-terra
• 能力標記： 只有模型真的支援時才打開工具呼叫、圖片輸入或推理模式。自訂模型要用在 Agent 任務上，必須開啟工具呼叫。

儲存後等設定生效。WorkBuddy 會把每個模型存成獨立記錄，所以 Claude 是第二筆，而不是同一張表單裡多填一個模型 ID。

4. 加入 Claude 模型

再新增一個自訂模型，端點與金鑰都相同，模型名稱填 claude-sonnet-5。Code By AI 的 Chat Completions 端點同時接受兩個家族：GPT ID 走 Codex 通道，claude-* ID 會轉往 Claude 通道並依 Claude 價格計費。

5. 選模型

回到對話，打開模型選擇器，選取自訂模型。送出一句簡短請求即可確認端點、金鑰與模型 ID。GPT 與 Claude 兩個項目都在同一個選擇器切換。

端點細節

WorkBuddy 要的是完整的 Chat Completions URL，不是 base URL，所以 /api/agent/v1/chat/completions 要完整保留。預設協定下，WorkBuddy 會校驗地址，並在缺少時自動補上標準的 /chat/completions 路徑。若地址被拒絕，或它又接了一次 /chat/completions，請到進階設定打開 自訂協議／Custom Protocol。這個開關會讓 WorkBuddy 完全照填寫的 URL 發請求，跳過路徑校驗與自動補全。

計費與隱私

自訂模型的用量由 Code By AI 計費，不消耗 WorkBuddy 積分。端點、金鑰與模型清單只存在本機的 models.json，不會上傳雲端。WorkBuddy 會把對話轉送到你設定的端點，因此這段流量適用 Code By AI 的服務條款與隱私政策。

疑難排解

• 404 — 端點少了 /v1/chat/completions、有錯字，或 WorkBuddy 又補了一次路徑。照抄本頁 URL；若路徑仍被改寫，打開 自訂協議。
• 401／金鑰無效 — 金鑰前後有空白、已被刪除或已過期。到 API Keys 頁面重新建立。
• 餘額不足 — 到 Wallet 頁面儲值。
• Agent 不能改檔案或執行命令 — 該自訂模型沒有開啟工具呼叫。重新打開該筆設定並啟用。
• 模型會回答，但不進入 Agent 迴圈 — 模型 ID 可能不屬於對應家族。到 模型廣場 核對完整 ID。