Skip to main content
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
Replace gemma-tunnel with the public deployment name you registered on the Models tab — not your Ollama/llama.cpp/vLLM/LM Studio local model id. Note that the key is deliberately absent here — see the next step.
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
Zed 在 anthropic_compatible.available_models 项下所要求的字段名称可能与 openai_compatible 定义的格式略有出入，且会因版本不同而有所变化，因此请依据您当前安装的版本进行确认。
2

设置您的 API 密钥

输入您的 sk-tok-… 令牌的方式与选项 A 相同，即通过 custom_headers 界面或 Zed 的密钥提示框完成。请确认 Zed 在调用兼容 Anthropic 协议的接口时所使用的确切请求头名称——通常 Anthropic 客户端会使用 x-api-key 而非 Authorization: Bearer。
3

在助手面板中选择所需模型

从 Zed 的模型选择器中挑选您已配置好的兼容 Anthropic 协议的模型，该模型可与兼容 OpenAI 协议的模型并存或替代后者使用。
将 gemma-tunnel 替换为您所注册的部署名称，并将 sk-tok-YOUR_KEY 替换为您自己的 API 密钥。切勿将这两项内容提交至共享代码库或版本控制下的 settings.json 文件中。
您可同时配置两种协议类型的服务并分别设置独立条目：一个指向 https://api.tokios.com/v1（兼容 OpenAI 协议），另一个指向 https://api.tokios.com（兼容 Anthropic 协议）。随后即可通过模型选择器在二者间切换，从而对比它们在同一部署环境下的实际表现。

​
为何无需隧道即可实现连接

Zed 调用模型时所用的两个协议接口均须具备可从请求发起端访问的 URL。由于 Tokios 的连接器仅具备出站功能：它仅从模型所在位置向外发起连接且不会开放任何入站端口，因此 https://api.tokios.com（或 /v1）即为您只需设置一次且经过身份验证的稳定访问地址——无需运行任何 ngrok 进程来维持连接，您的局域网内也不会出现任何未受保护的开放端口。

​
故障排查

Zed 发送的 API 密钥可能缺失、格式有误或已被撤销。请确保 sk-tok-… 令牌内容完整且不含多余空格，同时请在 Keys 选项卡中确认该密钥的状态。
The name value in available_models doesn’t match a registered deployment. Confirm it exactly matches the public name on the Models tab.
对应部署所使用的连接器当前处于离线状态，或者已达到并发处理上限。请查看 Connectors 选项卡，其中状态应显示为 Online。

​
后续步骤

快速入门

首先配对连接器，随后从头开始注册首个部署项。

兼容的客户端

此处列出了其他兼容 OpenAI 与 Anthropic 协议的客户端所需设置的基准 URL 及 API 密钥信息。