ZCode 設定教學：連接 NextHub API

ZCode 是智譜推出的 AI 代理開發環境（ADE），支援新增任何相容 Anthropic / OpenAI 協定的模型服務作為自訂供應商。設定好 NextHub 後，可以在 ZCode 裡直接使用 Claude 與 GPT 模型。

連線步驟

1. 安裝 ZCode

前往 ZCode 官網 下載 Windows / macOS / Linux 安裝包並完成安裝。首次啟動的歡迎頁可以跳過帳號連線，直接進入主介面。

2. 進入模型設定

點擊輸入框的模型名稱 → 管理模型（或從設定進入 模型設定 面板），在左側供應商清單底部點擊 新增供應商。

3. 填寫供應商資訊（Claude 通道）

欄位	填寫內容
名稱	NextHub
介面協定	Anthropic
介面位址（Base URL）	https://api.nexthub.cc
API Key	你的 NextHub ApiKey（Claude 系分組）

Base URL 不要帶 /v1

Anthropic 協定的介面位址與 Claude Code 的 ANTHROPIC_BASE_URL 同口徑：請填裸網域 https://api.nexthub.cc，結尾不要加 /v1，Messages 介面路徑由 ZCode 自動拼接。

4. 新增模型並啟用

點擊 新增模型，手動填寫該服務支援的模型 ID，例如 claude-opus-5-5、claude-fable-5（完整清單見通道與模型，以模型廣場即時資料為準）。儲存後開啟供應商的啟用開關。

5. 驗證

回到對話視窗，在模型選擇器裡選取剛剛新增的模型，傳送一則訊息，能收到回覆即連線成功。

也可以連接 GPT 通道

再新增一個供應商：介面協定選 OpenAI，介面位址填 https://api.nexthub.cc/v1（帶 /v1），API Key 使用 GPT-Azure（0.47x）或 GPT-Pro（0.11x）分組的金鑰，模型 ID 填 gpt-5.6、gpt-6-astra 等。兩個供應商可以並存，隨時在模型選擇器裡切換。

常見問題

ZCode 的供應商設定與終端機環境變數是兩套獨立入口，互不同步。若連線一直轉圈，請優先檢查介面位址是否多寫了路徑——OpenAI 協定下 ZCode 會自動拼接 /chat/completions，位址裡帶有多餘路徑會 404；模型 ID 需與模型清單完全一致。