跳转到主要内容
Zed 通过 settings.json 中的两个独立提供商入口调用自定义模型:language_models.openai_compatible 和 language_models.anthropic_compatible。两者均接受自定义 api_url,因此 Zed 是展示 Tokios 两侧能力的最佳场所——兼容 OpenAI 的端点 https://api.tokios.com/v1 和兼容 Anthropic 的端点 https://api.tokios.com。您可以任选其一,也可以同时配置两者并按助手切换。

前置条件

  • 一个已运行并完成与本地模型配对的 Tokios 连接器——参见连接器安装
  • 一个已注册的模型部署名称——参见注册模型
  • 一个 Tokios API 密钥(sk-tok-…)——参见 API 密钥
  • 已安装 Zed

方案 A:兼容 OpenAI 的提供商

1

打开 Zed 的 settings.json

打开命令面板并运行 zed: open settings,或直接编辑 settings.json。
2

添加一个 openai_compatible 条目

添加一个 language_models.openai_compatible 代码块,填入 Tokios 基础 URL、您的部署名称和您的 API 密钥:
settings.json
将 gemma-tunnel 替换为公共部署名称,即您在 Models 标签页上注册的名称——而非您的 Ollama/llama.cpp/vLLM/LM Studio 本地模型 ID。请注意,此处故意省略了密钥——请参见下一步。
3

在 settings.json 之外设置您的 API 密钥

Zed 不会从 settings.json 中读取 API 密钥。请通过以下任一方式提供您的 sk-tok-… 密钥:
  • 通过界面——从命令面板运行 agent: open settings,在 LLM Providers 下找到 Tokios,然后粘贴密钥。Zed 会将其存储在系统密钥链中。
  • 通过环境变量——Zed 根据 settings.json 中的提供商 ID 生成变量名,规则为转为大写蛇形并添加 _API_KEY 后缀。因此上述 ID Tokios 对应的变量名为 TOKIOS_API_KEY。
非空的环境变量优先于密钥链中的值,因此如果您之后改用界面方式,请取消设置该变量。
4

在助手面板中选择模型

打开 Zed 的助手面板,从模型选择器中选择 Tokios: gemma-tunnel(或您配置的 display_name)。

方案 B:兼容 Anthropic 的提供商

1

添加一个 anthropic_compatible 条目

在同一个 settings.json 中,添加一个指向 Tokios 兼容 Anthropic 端点的 language_models.anthropic_compatible 代码块。请注意,此基础 URL 上没有 /v1:
settings.json
将 gemma-tunnel 替换为公共部署名称,即您在 Models 标签页上注册的名称——而非您的 Ollama/llama.cpp/vLLM/LM Studio 本地模型 ID。
2

在 settings.json 之外设置您的 API 密钥

通过与方案 A 相同的方式提供您的 sk-tok-… 密钥:
  • 通过界面——从命令面板运行 agent: open settings,在兼容 Anthropic 部分的 LLM Providers 下找到 Tokios,然后粘贴密钥。Zed 会将其存储在系统密钥链中。
  • 通过环境变量——方案 A 中的同一个 TOKIOS_API_KEY 变量同时覆盖两个提供商入口,因为两种情况下提供商 ID 均为 Tokios。
3

在助手面板中选择模型

打开 Zed 的助手面板,从模型选择器中选择 Tokios (Anthropic): gemma-tunnel(或您配置的 display_name),与兼容 OpenAI 的条目并存或替代之。
将 gemma-tunnel 替换为您注册的部署名称,将 sk-tok-YOUR_KEY 替换为您自己的密钥。切勿将二者提交到共享或版本控制的 settings.json 中。
您可以同时配置两个提供商并保留各自的条目——一个指向 https://api.tokios.com/v1(兼容 OpenAI),另一个指向 https://api.tokios.com(兼容 Anthropic)——然后通过模型选择器在二者之间切换,以对比同一底层部署的行为差异。

为何无需隧道即可工作

两个 Zed 提供商入口均需要一个可从 Zed 模型请求发起位置访问的 URL。Tokios 的连接器是仅出站的:它从模型所在位置向外拨号,不会开放任何入站端口,因此 https://api.tokios.com(或 /v1)是一个稳定的、经过身份验证的 URL,只需设置一次——无需保持 ngrok 进程运行,您的局域网也不会有未经身份验证的端口暴露在外。

故障排查

Zed 发送的 API 密钥缺失、格式错误或已被撤销。请确认完整的 sk-tok-… 密钥已设置且无多余空格,并在 Keys 标签页检查其状态。
其中 name 的值在 available_models 中不匹配已注册的部署。请确认它与 Models 标签页上的公共名称完全一致。
该部署对应的连接器处于离线状态或已达到并发上限。请检查 Connectors 标签页——其状态需显示为 Online。

后续步骤

快速入门

配对连接器并从头开始注册您的第一个部署。

兼容客户端

查看其他兼容 OpenAI 和 Anthropic 的客户端的基础 URL 和密钥设置。