settings.json。
重点信息
准备工作
- 安装当前版本的 Zed
- 创建 BetterToken API Key
- 从模型广场复制
YOUR_MODEL_ID
安装
从 Zed 官网安装或更新到当前版本。启动 Zed 后，再按下方步骤打开 Agent 设置。手动配置
1
添加 OpenAI-compatible provider
点击 Add Provider，选择 OpenAI Compatible，Provider Name 填写
BetterToken。2
填写连接信息
API URL 只填写 Base URL。Zed 会自行请求 Chat Completions endpoint。
3
保存 API Key
在 Zed 设置页中保存 provider。Zed 会把 API Key 存入本机系统 Keychain，不会把它写入
settings.json。4
选择模型
打开 Agent Panel 的模型选择器，选择
BetterToken 下的 YOUR_MODEL_ID。可选：使用 settings.json 声明 provider 和模型
如果你需要用文件管理模型声明，请打开 zed: open settings file，只写 provider、api_url 和模型信息：
max_tokens 是 Zed 要求的模型上下文窗口声明。请按你选择的模型能力调整该数值。API Key 仍应在 Agent Settings 中输入，由系统 Keychain 保存。
验证连接
- 在 Agent Panel 选择
BetterToken / YOUR_MODEL_ID。 - 发送一条简短测试消息。
- Zed 正常返回内容且没有认证或模型错误，即表示配置成功。
切换模型
在 Agent Panel 的模型选择器中选择另一个 BetterToken 模型。新增 Model ID 时，先从模型广场复制当前值，再更新 provider 设置或available_models。
常见错误
进阶配置
支持的提供商
状态仅针对本页介绍的 BetterToken 接入方式。
配置方式说明
配置方式说明
- 手动配置：填写 API Key、Base URL 和 Model。
- 不支持：当前没有经过验证的直接配置方式。
技术说明
Keychain、配置文件与 endpoint
Keychain、配置文件与 endpoint
Zed 通过 OpenAI-compatible provider 请求 BetterToken。设置页保存的 Key 位于系统 Keychain；
settings.json 只声明 provider、api_url 和模型。Base URL 使用 https://bettertoken.ai/v1，Zed 会自行拼接 Chat Completions 路径。