Zcode (Z 智能工作区) 配置指南

Zcode（具备 Agent 技能、子智能体与系统级控制能力的 AI 工作区）内置了灵活的自定义模型供应商扩展机制。通过接入 BBToken（https://bbtoken.boywe.cn），可以一键接入高并发的 deepSeek-V4-flash、bbqwen3.8-flash-next 等模型底座。

📸 配置界面参考

⚡ 核心参数速查

📖 详细图文操作步骤

第一步：进入模型设置面板

1. 打开 Zcode 桌面客户端。
2. 在左侧功能导航栏中，找到 「基础设置」 分组。
3. 点击 「模型设置」 进入模型管理主界面。

第二步：添加自定义供应商

1. 在「模型设置」主界面右上角，点击 「+ 添加供应商」 按钮。
2. 此时左侧「自定义供应商」下方会出现一个名为 「新供应商」 的条目，点击选中它。
3. 在右侧顶部将供应商名称修改为便于识别的名称，例如 BBToken。
4. 确保名称右侧的激活开关已处于开启状态。

第三步：填写连接与鉴权信息

在右侧的配置表单中依次完成以下设置：

1. Base URL：

   text 复制

   https://bbtoken.boywe.cn/v1

   [!IMPORTANT] 请务必包含末尾的 /v1。Zcode 请求时会自动拼接 /chat/completions 路径，若漏掉 /v1 会导致 404 错误。

2. API 格式：

   • 点击下拉选择框，保持默认的 Chat Completions (/chat/completions)。

3. API Key：

   • 填入在 BBToken 控制台 生成的有效 API Key（以 sk- 开头）。
   • 可点击输入框右侧的眼睛图标确认没有包含前后空格或换行符。

第四步：添加模型列表

1. 在下方的 「模型列表」 区域，点击右侧的 「+ 添加模型」。
2. 逐一输入平台支持的模型名称（建议直接复制，防止拼写错误）：
   • deepSeek-V4-flash (推荐编程与深度推理主力)
   • bbqwen3.8-flash-next (超低延迟极速响应)
   • glm-4.7-flash (智谱高并发轻量模型)
   • nanbeige4.2 (通用高性价比模型)
   • (亦可添加别名如 bbtoken-DeepSeek-V4-Flash、cctoken-deepseek-v4-flash)
3. 添加完成后，已配置的模型会列在下方列表中。

第五步：返回工作区开始使用

1. 点击左上角 「< 返回工作区」。
2. 新建或进入对话会话，在输入框上方的模型切换下拉菜单中，展开刚刚添加的 BBToken 供应商。
3. 选中所需模型（如 deepSeek-V4-flash），输入测试内容（如「你好，写一个快速排序算法」），验证能够正常流式生成代码。

🛑 常见避坑排错