ZCode、Z Code 和 ZCode AI 在這裡指的是同一個產品嗎？

是的。本頁面涵蓋 Z.ai 編碼產品及其自訂提供者控件，而不是體育預測器或其他具有類似名稱的產品。

如何將 TokenHub 新增為 ZCode 自訂提供者？

打开自定义提供程序，添加兼容 OpenAI 的提供程序，输入 TokenHub 基本 URL、API 密钥和确切的模型 ID，然后保存并启用它。

ZCode 可以使用 Anthropic 相容模型嗎？

僅當安裝的 ZCode 版本公開對應的提供者類型且所選的 TokenHub 模型支援該協定時。將協定配置分開。

為什麼登入後自訂 ZCode 模型遺失？

确认帐户和版本公开自定义提供程序，然后检查提供程序是否已启用以及确切的模型 ID 和密钥是否保存在活动范围中。

如何驗證 ZCode 自訂 API？

讓 ZCode 解釋一個小專案檔案而不對其進行編輯，然後在測試工具之前檢查 TokenHub 日誌中的模型和狀態。

ZCode AI（Z 碼）自訂提供者和 API 設定指南 |代幣中心

ZCode 可以新增實作 Anthropic 或 OpenAI 協定的服務作為自訂提供者。本指南遵循ZCode官方**Connect Models → Custom Providers (Anthropic / OpenAI Compatible)**流程中的實際順序，並將TokenHub配置為https://us-api.tokenhub.com/v1的OpenAI-compatible提供者。

開啟模型設定

首次啟動時，如果沒有可用型號，請選擇 Use API Key。如果ZCode已經打開，點選提示框中的型號名稱，選擇Manage Models，開啟Settings → Model Settings。

新增 TokenHub 自訂提供者

請遵循 ZCode 的自訂提供者流程中的七個步驟：

開啟Settings → Model Settings。
在提供者清單底部，按一下「Add Provider」。
將提供者命名為 TokenHub。
選擇OpenAI-compatible。在 Base URL 選單中，選擇自訂位址或手動輸入 https://us-api.tokenhub.com/v1。
在 API Key 中輸入您的 TokenHub API 金鑰。
點選 Add Model 並輸入 TokenHub 模型目錄中的準確模型 ID。單獨新增每個附加模型。
儲存設定並開啟提供者的Enable開關。確認您打算使用的每個模型也已啟用。

ZCode 不會為您推斷第三方型號 ID。如果提供者未傳回型號列表，請使用 Add Model 手動新增每個準確的 ID。

不要在一個提供者中混合 Anthropic 和 OpenAI 協定設定。為 Anthropic Messages 建立一個單獨的提供程序，並使用該協議所需的根 URL。

為一種型號配置進階設定

在Settings → Model Providers下，開啟您新增的模型並展開Advanced：

Max output tokens: 通常將其留空並讓模型服務報告支援的值。確認目標型號的限制後，才可手動設定。
Context window: 這對於自訂提供者模型是可編輯的，並且保存的值僅適用於新對話。使用 TokenHub 型號規格，而不是其他型號的值。
Thinking effort: 可見等級取決於型號和協定。 OpenAI-compatible要求使用reasoning_effort；第三方部署可能會拒絕 ZCode 顯示的某些等級。出現 400 參數錯誤後降低等級或停用此選項。
Custom request parameters: ZCode 不會自動將手動新增至本機提供者 options 的任意值注入到請求內文中。不要依賴編輯 ~/.zcode/v2/config.json 來新增額外的推理或影像參數。

ZCode如何判斷是否可以輸入影像

ZCode 在處理影像時結合了提供者、模型 ID、模型目錄功能和活動協定：

當支援已知時，ZCode 保留映像並將其傳送至模型服務。
當模型被標記為不支援時，ZCode 會刪除圖像並替換為文字通知。
當能力未知時，ZCode不提前遮擋影像； TokenHub 做出最終決定並可能拒絕該要求。

相同的模型可以透過另一個提供者或協議進行不同的處理。首先測試文本，僅當 TokenHub 模型頁面明確列出圖像輸入時才發送圖像。

選擇型號並驗證

返回提示框中的模型選擇器。
選擇 TokenHub 提供者和您新增的型號。
發送簡短的指令，例如“解釋當前文件而不修改它”。
在TokenHub請求日誌中，確認該請求使用/v1/chat/completions，並驗證模型ID、狀態碼和使用量。
文字回應穩定後，分別測試編輯、工具呼叫、長上下文和圖像輸入。

這遵循ZCode官方Verify The Setup指導：選擇新通道，發送簡短的測試指令，並在實際工作之前確認穩定的回應。

ZCode內建HTTP代理程式的範圍

ZCode Settings 中配置的 HTTP 代理程式涵蓋模型 API、MCP、WebFetch、終端子進程、擴充市場和應用程式內頁載入。它不包括桌面帳戶登入、Wiki 產生、Web 遠端控制 WebSocket 或 SSH 遠端連線。預設情況下，ZCode 也不會透過系統 HTTP_PROXY / HTTPS_PROXY 變數路由每個請求。更改應用程式內代理後重新啟動ZCode。

故障排除

模型缺失：確保提供者和模型均已啟用。
404：確認端點不重複/chat/completions。
請求格式不符：檢查提供者是否為OpenAI-compatible或Anthropic。
文字有效，但程式碼編輯無效：所選模型可能沒有可靠的本機工具呼叫。
思考工作返回 400：降低或停用該級別，因為部署可能不接受它。
影像請求失敗：使用規範模型 ID 並確認提供者、協定和 TokenHub 模型均支援影像。
代理變更無效：重新啟動 ZCode 並確認流量類型被 ZCode 內建代理覆蓋。

官方參考

ZCode：連接型號

ZCode AI 自訂 API 設定

什麼是 ZCode AI？