Zcode

先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置和填写说明。

添加连接

打开 ZCode 的模型设置，添加自定义服务商；本文对应 Z.ai 的 ZCode。

选择协议时，确保所用模型支持对应接口。自定义服务商入口和选项以安装版本为准。ZCode 官方模型配置

保存后启用服务商，添加或获取可用模型，再在新会话中选择该模型。先验证普通对话，再测试编辑和工具调用。

连接成功但任务失败时，检查模型是否支持工具调用，以及思考强度、图片输入等参数是否超出模型能力。不要只因客户端提供某个选项，就假定模型支持该选项。

为 Zcode 创建单独的 Toodoo AI API 密钥，选择 OpenAI 兼容的分组，并从 GET /v1/models 复制完整模型 ID。

在 Zcode 的自定义服务商中填写显示名称、https://toodooai.com/v1、API Key 和完整模型 ID。若界面要求完整请求 URL，再改填 https://toodooai.com/v1/chat/completions。

先验证普通对话，再验证代码编辑、文件读取和工具调用。每增加一种能力，都在日志中核对一次实际请求。

上下文窗口、图片输入、思考强度、工具调用和流式输出由模型与渠道共同决定。第一次配置时保留 Zcode 默认参数，基础对话成功后再一次只修改一个参数，便于定位 400 错误。

如果 Zcode 提供“测试连接”但没有显示完整 URL，请在 Toodoo AI 日志功能中确认请求是否到达。连接测试成功只代表一次基础请求成功，不代表所有任务类型都兼容。

问题	处理方式
找不到自定义服务商入口	检查 Zcode 版本、账号类型和组织策略，以官方配置说明为准。
401 / 403	检查密钥是否启用、分组是否允许模型、IP 白名单是否包含当前网络。
404	区分 Base URL 与完整请求 URL，不要同时让两处设置补齐 `/v1`。
400	暂时关闭图片、思考或其他高级参数，确认目标模型是否支持后再逐项开启。