什麼是動物園代碼？
Zoo Code 是 VS Code 的 AI 編碼套件，具有可設定的提供者、模型、模式和代理工具。
此 Zoo Code 設定使用其 OpenAI Compatible 提供者控制項。模型必須傳回本機 OpenAI 風格的工具呼叫以進行 Zoo Code 代理程式工作；普通的文字聊天是不夠的。 Zoo Code 代理程式工作流程要求模型傳回結構化的 OpenAI 風格的工具調用，而不是作為普通助理文字編寫的工具指令。配置 API 根和確切的模型 ID，保持審批控制保守，並在測試文件編輯或終端執行之前驗證唯讀分析。
Zoo Code 的官方第一個提供程序教程涵蓋了歡迎屏幕流程：從 VS Code 活動欄打開 Zoo Code，選擇提供程序，輸入密鑰，選擇模型，然後完成初始化。 TokenHub 不是官方预设，因此本指南使用当前的 OpenAI Compatible 字段，而不声明第一方 TokenHub 集成。
從首次啟動時的歡迎畫面開始
- 单击 VS Code 活动栏中的 Zoo Code 图标。
- 在欢迎屏幕上选择 LLM 提供商。
- 选择OpenAI Compatible，而不是需要官方OpenAI帐户的选项。
- 用 TokenHub 值填充下面的字段并完成初始化。
初始設定後從齒輪開始
- 打开Zoo Code侧边栏。
- 點擊齒輪打開 Settings。
- 從API Provider中選擇OpenAI Compatible。
- 輸入：
- Base URL:
https://us-api.tokenhub.com/v1 - API Key: 您的 TokenHub API 金鑰
- Model ID: TokenHub 型號目錄中的完整 ID
- Context Window Size: 確認型號規格後才可設定
- Base URL:
- 儲存，然後確認任務頁腳實際使用此提供者設定檔。
Zoo Code 目前的 OpenAI 相容供應商呼叫聊天完成。底座 URL 應停止在 /v1；不要輸入完整的 /chat/completions 路徑。
验证 Zoo Code 代理行为
- 創建一個任務並詢問“解釋當前文件而不修改它。”
- 在 TokenHub 日誌中確認
/v1/chat/completions和設定檔的型號 ID。 - 請求一個小檔案編輯以驗證模型是否傳回結構化工具呼叫。
Zoo Code 的模型選擇指南強調跨工具步驟的指令遵循、格式遵守和上下文保留。如果模型回答正常問題但無法編輯文件，請切換到更強的工具呼叫模型，而不是重複更改 Base URL。
對實際的 Provider 欄位進行故障排除
- 404：確認Base URL以
/v1結束且尚未包含/chat/completions。 - 401：再次貼上API金鑰並確保目前任務選擇了TokenHub設定檔。
- 模型錯誤：Model ID 必須是 TokenHub 接受的完整 ID。
- 聊天可以工作，但工具不行：模型可能不適合 Zoo Code 的代理工具。
- 儲存的變更使用舊的提供者：建立新任務並重新檢查其頁腳中顯示的提供者/模型。
官方參考資料
如何選擇推薦模型？
Zoo Code API 提供者常見問題解答
我應該在 Zoo Code 中選擇哪個提供者？
選擇 OpenAI Compatible，然後輸入 TokenHub Base URL、API 金鑰和確切的模型 ID。
如果模型可以聊天但不能編輯文件怎麼辦？
使用支援本機 OpenAI 相容工具呼叫的模型，並驗證提供者返回結構化工具呼叫。
基本 URL 是否應該包含 /chat/completions？
否。輸入以 /v1 結尾的 TokenHub API 根目錄，除非 Zoo Code 的目前 UI 明確要求不同的值。
如何安全地測試 Zoo 程式碼？
從具有唯讀說明的測試儲存庫開始，確認請求日誌，然後才批准檔案寫入或終端命令。
為什麼動物園代碼設定標籤與本指南不同？
擴充版本可以重命名控制項。在目前官方 UI 中尋找相容 OpenAI 的提供者、基本 URL、API 金鑰和模型 ID 欄位。
參考資料
本頁設定依據 TokenHub 教學與官方資料，最後驗證日期為 2026-09-08。