跳转到内容
NoviaHub 文档

桌面应用

ZCode

在 Z.ai 的 ZCode 桌面应用里把 NoviaHub 添加为自定义供应商。

ZCode 是 Z.ai 推出的桌面应用，官方称它为面向长时程任务的「智能体开发环境」（Agentic Development Environment，ADE）。它支持把任何兼容 Anthropic / OpenAI 协议的模型服务添加为自定义供应商，NoviaHub 就按这种方式接入。

前提条件

Section titled “前提条件”
  • 有一个 NoviaHub 账户，并且已经创建了 API 密钥，见 API 密钥。
  • 账户里有余额，见 钱包与充值。

安装 ZCode

Section titled “安装 ZCode”

在官方 安装页 下载对应系统的安装包。支持 macOS（Apple Silicon / Intel）、Windows（x64 / ARM64）和 Linux（x64、ARM64，提供 AppImage、DEB、RPM）。

  • macOS：打开下载的 ZCode.dmg，把 ZCode 拖进「应用程序」文件夹。
  • Windows：运行下载的安装程序，按向导完成安装。
  • Linux：AppImage 需要先加上可执行权限：chmod +x ZCode-*.AppImage；.deb 或 .rpm 用发行版的包管理器安装。

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 打开「模型设置」面板。 进入 ZCode 后，点击对话框里的模型名称，打开模型选择器，在列表底部点击「管理模型」，就会进入 设置 → 模型设置 面板。

  2. 在左侧供应商列表底部点击「添加供应商」。

  3. 按下表填写：

    项目 填写内容
    名称 NoviaHub（可以自己起名）
    Base URL https://noviahub.com/v1
    API 格式 Chat Completions (/chat/completions)
    API Key 你的 NoviaHub 密钥（以 sk- 开头）

  4. 点击「添加模型」，填写要用的模型 ID，例如 deepseek-v4-flash。模型 ID 必须和 NoviaHub 上的完全一致，可以添加多个。ZCode 要求至少添加一个模型，才能添加供应商（界面提示「添加供应商前，请至少添加一个模型。」）。

  5. 打开该供应商的启用开关，就可以使用了。

用 Anthropic Messages 调用 Claude 模型（可选）

Section titled “用 Anthropic Messages 调用 Claude 模型（可选）”

Chat Completions 格式也能调用 Claude 模型，但会经过协议转换，部分特性会丢失，见 协议转换。想让 Claude 模型走 Anthropic Messages 协议，可以再添加一个供应商：

项目 填写内容
名称 NoviaHub Claude（可以自己起名）
Base URL https://noviahub.com（不带 /v1，ZCode 会自己补上）
API 格式 Anthropic Messages (/v1/messages)
API Key 同一把 NoviaHub 密钥
模型 例如 claude-sonnet-5

只有模型详情里带 Anthropic 端点标签的模型才能这样调用。同样的道理，带 Response 标签的模型也可以选 Responses (/responses) 格式，Base URL 仍填 https://noviahub.com/v1。

验证

Section titled “验证”

  1. 在对话框的模型选择器里选中 NoviaHub 下的模型。

  2. 发送一句简单的指令，例如「用一句话介绍你自己」。模型能稳定回复，就说明配置完成。

  3. 到 NoviaHub 控制台的 使用日志 查看这次调用和费用。

切换和添加模型

Section titled “切换和添加模型”
  • 在对话框的模型选择器里切换模型。
  • 回到 设置 → 模型设置，在 NoviaHub 供应商下点击「添加模型」可以添加更多模型。
  • Chat Completions 格式的供应商，请选择在 模型&价格 上带有「Chat」标签的模型，2026-09-28 线上的全部模型都带有这个标签；Anthropic Messages 格式的供应商，只能添加带「Anthropic」标签的模型。

注意事项

Section titled “注意事项”
  • 上下文窗口可以修改。 在 设置 → 模型供应商 里点开某个模型，展开「高级」，可以修改自定义供应商模型的上下文窗口，保存后对新会话生效；同一处还可以设置「最大输出 Token」（单次回复的长度上限），官方建议一般留空。
  • 暂不支持自定义请求参数。 目前不能为第三方模型额外添加请求参数。
  • 图片输入。 对自定义模型，ZCode 判断能否发送图片的结果可能是「能力未知」，这时它不会拦截图片，由模型服务决定是否接受，请求可能失败。确认模型支持图片输入（看模型详情的「输入类型」）后再发送图片。
  • 代理设置。 ZCode 默认不读取系统的 HTTP_PROXY / HTTPS_PROXY 环境变量，以设置里配置的 HTTP 代理为准；修改代理后需要重启 ZCode。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28 至 2026-09-29：