跳转到内容
简体中文
РусскийEnglish简体中文HindiEspañolPortuguês (BR)日本語FrançaisDeutsch한국어
免费注册
在 Coding Agent 接入

Zed 安装、API Key、Base URL 与自定义模型配置

在 Zed 中添加 BetterToken OpenAI-compatible provider，配置 Base URL、API Key 和自定义模型，并将 Key 安全保存在系统 Keychain。

在 Zed 的 Agent Settings 中添加 OpenAI-compatible provider，填写 BetterToken API Key、Base URL 和 Model ID。通过设置页保存的 API Key 会存入系统 Keychain，不会写入 settings.json。

重点信息

字段填写内容
ProviderBetterToken
API KeyYOUR_API_KEY
Base URLhttps://bettertoken.ai/v1
ModelYOUR_MODEL_ID

准备工作

安装

从 Zed 官网安装或更新到当前版本。启动 Zed 后，再按下方步骤打开 Agent 设置。

手动配置

添加 OpenAI-compatible provider

点击 Add Provider，选择 OpenAI Compatible，Provider Name 填写 BetterToken。

填写连接信息

配置项值
API URLhttps://bettertoken.ai/v1
API KeyYOUR_API_KEY
Model IDYOUR_MODEL_ID

API URL 只填写 Base URL。本指南使用 Zed 默认的 Chat Completions 模式，Zed 会自行追加该接口路径。

保存 API Key

在 Zed 设置页中保存 provider。Zed 会把 API Key 存入本机系统 Keychain，不会把它写入 settings.json。

选择模型

打开 Agent Panel 的模型选择器，选择 BetterToken 下的 YOUR_MODEL_ID。

可选：使用 settings.json 声明 provider 和模型

如果你需要用文件管理模型声明，请打开 zed: open settings file，只写 provider、api_url 和模型信息：

{
  "language_models": {
    "openai_compatible": {
      "BetterToken": {
        "api_url": "https://bettertoken.ai/v1",
        "available_models": [
          {
            "name": "YOUR_MODEL_ID",
            "display_name": "YOUR_MODEL_ID",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

max_tokens 是 Zed 要求的模型上下文窗口声明。请按你选择的模型能力调整该数值。API Key 仍应在 Agent Settings 中输入，由系统 Keychain 保存。

验证连接

  1. 在 Agent Panel 选择 BetterToken / YOUR_MODEL_ID。
  2. 发送一条简短测试消息。
  3. Zed 正常返回内容且没有认证或模型错误，即表示配置成功。

修改 provider 或模型配置后，请完全退出并重新启动 Zed。

切换模型

在 Agent Panel 的模型选择器中选择另一个 BetterToken 模型。新增 Model ID 时，先从模型广场复制当前值，再更新 provider 设置或 available_models。

常见错误

错误排查方式
401 或 Unauthorized在 Agent Settings 中重新输入 BetterToken API Key，确认没有首尾空格。
404API URL 应为 https://bettertoken.ai/v1，不要追加 /chat/completions。
model not found从模型广场重新复制 YOUR_MODEL_ID。
配置未生效保存 provider，完全退出并重新启动 Zed。
使用了旧 Key检查根据 provider ID 生成的环境变量：转为大写下划线格式并添加 _API_KEY，例如 BetterToken 对应 BETTERTOKEN_API_KEY。非空值会覆盖 Keychain。取消该变量并重启 Zed，即可使用已保存的 Key。参阅 Zed Key 优先级。

技术说明

Keychain、配置文件与 endpoint

Zed 通过 OpenAI-compatible provider 请求 BetterToken。设置页保存的 Key 位于系统 Keychain；settings.json 只声明 provider、api_url 和模型。使用本指南默认的 Chat Completions 设置时，Base URL 填写 https://bettertoken.ai/v1，Zed 会自行拼接接口路径。

相关 FAQ