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后缀。因此上述 IDTokios对应的变量名为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 中。为何无需隧道即可工作
两个 Zed 提供商入口均需要一个可从 Zed 模型请求发起位置访问的 URL。Tokios 的连接器是仅出站的:它从模型所在位置向外拨号,不会开放任何入站端口,因此https://api.tokios.com(或 /v1)是一个稳定的、经过身份验证的 URL,只需设置一次——无需保持 ngrok 进程运行,您的局域网也不会有未经身份验证的端口暴露在外。
故障排查
401 错误
401 错误
Zed 发送的 API 密钥缺失、格式错误或已被撤销。请确认完整的
sk-tok-… 密钥已设置且无多余空格,并在 Keys 标签页检查其状态。404 错误
404 错误
其中
name 的值在 available_models 中不匹配已注册的部署。请确认它与 Models 标签页上的公共名称完全一致。503 错误
503 错误
该部署对应的连接器处于离线状态或已达到并发上限。请检查 Connectors 标签页——其状态需显示为 Online。
后续步骤
快速入门
配对连接器并从头开始注册您的第一个部署。
兼容客户端
查看其他兼容 OpenAI 和 Anthropic 的客户端的基础 URL 和密钥设置。