Zoo Code是什么？
Zoo Code 是一款适用于 VS Code 的 AI 编码套件，具有可配置的提供程序、模型、模式和代理工具。
此 Zoo Code 设置使用其 OpenAI Compatible 提供程序控件。模型必须返回本机 OpenAI 风格的工具调用以进行 Zoo Code 代理工作；普通的文字聊天是不够的。 Zoo Code 代理工作流程要求模型返回结构化 OpenAI 风格的工具调用，而不是作为普通助理文本编写的工具指令。配置 API 根和确切模型 ID，保持审批控制保守，并在测试文件编辑或终端执行之前验证只读分析。
Zoo Code 官方“首个 LLM Provider”教程只覆盖欢迎页的通用流程：打开 VS Code Activity Bar 中的 Zoo Code、选择 Provider、粘贴 Key、选择模型并完成初始化。TokenHub 不在官方预设列表中，因此下面使用 Zoo Code 当前扩展的 OpenAI Compatible Provider 字段，不把它描述成官方 TokenHub 集成。
首次启动时从 Welcome Screen 进入
- 点击 VS Code Activity Bar 中的 Zoo Code 图标。
- 在 Welcome Screen 选择 LLM Provider。
- 选择 OpenAI Compatible，不要选择要求 OpenAI 官方账号的登录项。
- 按下方字段填写 TokenHub，然后完成初始化。
已经使用过 Zoo Code 时从齿轮进入
- 打开 Zoo Code 侧栏。
- 点击齿轮进入 Settings。
- 在 API Provider 下拉框选择 OpenAI Compatible。
- 填写：
- Base URL：
https://us-api.tokenhub.com/v1 - API Key：TokenHub API Key
- Model ID：模型广场中的完整 ID
- Context Window Size：只有确认模型规格后再填写
- Base URL：
- 保存，并确认任务底部实际选中的是这份 Provider Profile。
Zoo Code 当前的 OpenAI Compatible 实现会调用 Chat Completions。Base URL 应只到 /v1，不要填写完整 /chat/completions。
按 Zoo Code 的 Agent 行为验证
- 新建任务，输入“解释当前文件，不要修改”。
- 在 TokenHub 日志确认请求到
/v1/chat/completions，且 Model ID 与 Profile 一致。 - 再让它进行一次小型文件修改，确认模型返回结构化工具调用。
官方选型建议强调：编码 Agent 需要能遵循工具指令、解析格式并在多步骤任务中保持上下文。模型能回答普通问题但不能编辑文件时，应更换工具调用更稳定的模型，而不是反复修改 Base URL。
针对当前 Provider 字段排错
- 404：检查 Base URL 是否到
/v1，是否重复带了/chat/completions。 - 401：重新粘贴 API Key，并确认当前任务选中的是 TokenHub Profile。
- 模型错误：Model ID 必须是 TokenHub 实际接受的完整 ID。
- 能聊天但不执行工具：所选模型不适合 Zoo Code 的 Agent harness。
- 保存后仍走旧 Provider：新建任务并重新确认底部的 Provider/模型选择。
官方资料
推荐模型怎么选？
Zoo Code API 提供商 FAQ
我应该在 Zoo Code 中选择哪个提供商？
选择 OpenAI Compatible，然后输入 TokenHub、Base URL、API 密钥和准确的型号 ID。
如果模型可以聊天但不能编辑文件怎么办？
使用支持本机 OpenAI-compatible 工具调用的模型，并验证提供程序返回结构化工具调用。
Base URL 是否应该包含 /chat/completions？
否。输入以 /v1 结尾的 TokenHub API 根，除非 Zoo Code 的当前 UI 明确请求不同的值。
如何安全测试 Zoo Code？
从具有只读说明的测试存储库开始，确认请求日志，然后才批准文件写入或终端命令。
为什么 Zoo Code 设置标签与本指南不同？
扩展版本可以重命名控件。在当前官方 UI 中查找 OpenAI-compatible 提供程序、Base URL、API 密钥和 Model ID 字段。
配置资料
本页配置以 TokenHub 教程和官方资料为依据，最后核验于 2026-09-08。