跳转到内容
NoviaHub 文档

编辑器与插件

Zed

在 Zed 编辑器里把 NoviaHub 添加为 OpenAI 兼容服务商，让 Agent 面板等 AI 功能使用 NoviaHub 的模型。

Zed 是一款代码编辑器，内置 Agent 面板（Agent Panel）。官方的说法是：Agent 面板是你和 AI Agent 交互的地方，这些 Agent 可以读取、修改和运行你项目里的代码。

在 Zed 里把 NoviaHub 添加为「OpenAI 兼容」服务商后，Zed Agent、行内助手（Inline Assistant）、Git 提交信息生成、对话摘要等 Zed 自带的 AI 功能都可以使用 NoviaHub 的模型。在 Zed 里运行的外部 Agent 和终端线程，一般要在那个 Agent 或命令行工具自己的设置里配置模型，不使用这里的配置。

前提条件

Section titled “前提条件”
  • 有一个 NoviaHub 账户，并且已经创建了 API 密钥，见 API 密钥。
  • 账户里有余额，见 钱包与充值。
  • 不需要登录 Zed 账户。Zed 官方说明：用自己的 API 密钥使用 AI 功能时，不需要登录。

安装 Zed

Section titled “安装 Zed”

从 下载页 下载安装，或者用 Homebrew：

终端窗口
brew install --cask zed

配置 NoviaHub

Section titled “配置 NoviaHub”

下面以 deepseek-v4-flash 为例。Zed 要求为每个模型填写上下文窗口（context window）大小：在 模型&价格 打开模型详情，看「上下文」一栏。deepseek-v4-flash 在 2026-09-28 标注的上下文为 1,000,000 tokens。

两种方式任选其一：图形界面更简单；settings.json 适合一次添加多个模型。

方式一：在设置界面添加

Section titled “方式一：在设置界面添加”

  1. 打开命令面板，运行 agent: open settings，进入 Agent 设置（也可以在 Settings → AI → LLM Providers 找到）。

  2. 在「LLM Providers」区域点击「Add Provider」，在弹出菜单的「Compatible APIs」下选择「OpenAI」，进入「Add OpenAI-Compatible Provider」页面。

  3. 填写服务商信息：

    项目 填写内容
    Provider Name noviahub（服务商 ID，它还决定了下面环境变量的名字）
    API URL https://noviahub.com/v1（要带 /v1）
    API Key 你的 NoviaHub 密钥（以 sk- 开头）。它保存在系统钥匙串（keychain）里，不会写进 settings.json

  4. 在「Models」下填写模型：

    项目 填写内容
    Model Name deepseek-v4-flash（必须和 NoviaHub 上的模型 ID 完全一致）
    Max Tokens 1000000（模型的上下文窗口）
    Max Output Tokens 单次回复的长度上限，界面预填 32000，可以保持不变

    其他项保留界面预填的值即可。要添加更多模型，点击「Add Model」。

  5. 点击「Save Provider」保存。

方式二：编辑 settings.json

Section titled “方式二：编辑 settings.json”

  1. 打开 Zed 的 settings.json，在 language_models 下加入 openai_compatible 配置：

    settings.json
    {
      "language_models": {
        "openai_compatible": {
          "noviahub": {
            "api_url": "https://noviahub.com/v1",
            "available_models": [
              {
                "name": "deepseek-v4-flash",
                "display_name": "DeepSeek V4 Flash (NoviaHub)",
                "max_tokens": 1000000
              }
            ]
          }
        }
      }
    }
    配置项 作用
    noviahub 服务商 ID，可以自己起名。它还决定了下面环境变量的名字。
    api_url 接口地址，要带 /v1：https://noviahub.com/v1。
    name 模型 ID，必须和 NoviaHub 上的模型 ID 完全一致。
    display_name 在 Zed 模型选择器里显示的名字，可以自己起。
    max_tokens 必填。这里指模型的上下文窗口大小，不是单次输出长度。

  2. 提供密钥。不要把密钥写进 settings.json，这是 Zed 官方的明确要求。任选一种方式：

    • 在 Agent 设置的服务商界面里填写密钥（保存到系统钥匙串）；

    • 或者设置环境变量。Zed 会把服务商 ID 转成「大写 + 下划线」的形式，再加上 _API_KEY 作为变量名。服务商 ID 为 noviahub 时，变量名正好是 NOVIAHUB_API_KEY：

      终端窗口
      export NOVIAHUB_API_KEY="sk-..."

      这个变量必须存在于 Zed 进程的环境里。环境变量非空时，它优先于钥匙串里保存的密钥。

用 Anthropic 兼容服务商调用 Claude 模型（可选）

Section titled “用 Anthropic 兼容服务商调用 Claude 模型（可选）”

OpenAI 兼容服务商也能调用 Claude 模型，但请求会经过协议转换，部分特性会丢失，见 协议转换。想让 Claude 模型走 Anthropic Messages 协议，可以再添加一个 Anthropic 兼容服务商。只有模型详情里带「Anthropic」端点标签的模型才能这样调用。

  • 设置界面：点击「Add Provider」，在「Compatible APIs」下选择「Anthropic」。Provider Name 填 noviahub-claude，API URL 填 https://noviahub.com（不带 /v1），API Key 填同一把 NoviaHub 密钥；Model Name 填 claude-sonnet-5，Max Tokens 填 1000000，Max Output Tokens 填 64000，然后点击「Save Provider」。

  • settings.json：在 language_models 下加入 anthropic_compatible，和 openai_compatible 并列：

    settings.json
    {
      "language_models": {
        "anthropic_compatible": {
          "noviahub-claude": {
            "api_url": "https://noviahub.com",
            "available_models": [
              {
                "name": "claude-sonnet-5",
                "display_name": "Claude Sonnet 5 (NoviaHub)",
                "max_tokens": 1000000,
                "max_output_tokens": 64000
              }
            ]
          }
        }
      }
    }
    配置项 作用
    api_url https://noviahub.com，不带 /v1。Zed 会在后面拼接 /v1/messages；填成 https://noviahub.com/v1 会变成 /v1/v1/messages。
    max_tokens 必填，模型的上下文窗口。claude-sonnet-5 在 2026-09-29 标注的上下文为 1,000,000 tokens。
    max_output_tokens 单次回复的长度上限。不填时 Zed 按 4,096 处理；claude-sonnet-5 在 2026-09-29 标注的最大输出为 64,000 tokens。

    密钥的提供方式和上面相同：在界面里填写，或者设置环境变量。服务商 ID 为 noviahub-claude 时，变量名是 NOVIAHUB_CLAUDE_API_KEY，值是同一把 NoviaHub 密钥。

验证

Section titled “验证”

  1. 打开 Agent 面板：在命令面板运行 agent: new thread，或点击状态栏上的 ✨ 图标。

  2. 点击消息输入框上的模型选择器（快捷键：macOS 为 cmd-alt-/，Windows / Linux 为 ctrl-alt-/），选中 noviahub 下的模型。模型左边的图标表示它属于哪个服务商。

  3. 发送一句简单的话，例如「用一句话介绍你自己」。收到回复，说明配置成功。

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

切换和添加模型

Section titled “切换和添加模型”
  • 在模型选择器里切换已添加的模型。
  • 添加更多模型：在 available_models 里再加一项（name 和 max_tokens 必填），或者在设置界面里再添加一个模型。
  • OpenAI 兼容服务商默认通过 Chat Completions 接口调用模型，请选择在 模型&价格 上带有「Chat」标签的模型。2026-09-28 线上的全部模型都带有这个标签。
  • 如果某个模型只能用 Responses 接口，可以在该模型的 capabilities 里把 chat_completions 设为 false，Zed 会改用 Responses 接口。只有模型详情里带「Response」标签的模型才能这样用。

注意事项

Section titled “注意事项”
  • 图片输入默认关闭。 OpenAI 兼容和 Anthropic 兼容模型的 capabilities.images 默认都是 false。模型支持图片输入（看模型详情的「输入类型」）并且你要发图片时，在这个模型下加上 "capabilities": { "images": true }，或者在设置界面添加模型时打开「Supports images」。
  • 工具调用。 如果选中的模型不支持工具调用，界面上会显示「No tools」标签，这时 Agent 不能读写文件或运行命令。
  • 上下文太小时不会自动压缩。 模型上下文窗口小于 80,000 tokens 时，Zed 不会自动压缩对话，只会在接近上限时提示你开一个新对话。
  • 远程项目。 在 SSH、开发容器等远程项目里，Zed 仍然从本机的钥匙串和本机 Zed 进程的环境变量里读取密钥。

参考资料

Section titled “参考资料”

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