Zed Agent 接入指南：API Provider 与远程项目凭证边界

先确认使用 Zed 自有 Agent

官方 API Access 文档适用于 Zed Agent、Inline Assistant、提交信息生成等 Zed 自有功能。外部 Agent 与 Terminal Threads 通常在对应 Agent 或 CLI 内管理模型访问。 本篇不把外部进程的认证规则混入 Zed 的 Provider 设置。

同一家供应商的聊天订阅和 API 凭证也不应混为一谈。先确认手里的授权是 API Key、独立调用额度，还是需要其他登录路径的订阅，再选择接入方式。

添加 OpenAI 兼容 Provider

执行 agent: open settings，在 LLM Providers 中选择 Add Provider，填写服务名称、API URL、模型 ID 和上下文窗口。官方也允许在 settings 的 openai_compatible 中声明端点和模型。 首次优先使用界面，减少字段拼写错误。

以下是原创占位示意。地址、Key 和模型均非真实配置，并无真实接口，不代表本站提供 API：

配置项目	示例或填写原则
api_url	https://80321.cn/v1
available_models 中的 name	YOUR_MODEL_ID
Provider 的 Key 输入	YOUR_API_KEY
模型上下文窗口	以服务商确认规格为准

不要把 API Key 写入 settings.json；官方说明通过界面保存的 Key 位于系统钥匙串。

协议与工具能力不要靠猜

OpenAI 兼容模型默认使用 Chat Completions；如果服务只支持 Responses，官方通过 capabilities.chat_completions: false 切换请求方式。Anthropic-compatible 是独立的 Messages 入口。 模型名字包含某个品牌，不足以决定协议。

官方列出的默认能力也不是服务端能力证明。先核对工具调用、图片和参数格式；若后端要求不同的输出限制字段，再按当前文档调整对应能力设置。 未确认时先做文本测试，不启用复杂工具任务。

远程项目的 Key 仍可能在本机

对 Zed 自有 AI 功能，官方说明 Provider 在本地应用初始化；远程 SSH 或容器项目读取的是本地钥匙串与本地 Zed 进程环境。外部 Agent 可能另有远程环境，不能套用这一结论。

因此，远程项目无法调用时，先检查本地 Zed 进程所继承的环境。非空的 Provider 环境变量会优先于钥匙串值，仅在界面换 Key 可能仍使用旧值。 修改后重新启动应用并检查脱敏错误，别在远端重复粘贴凭证。

排错与数据权限验收

模型没有出现时，核对 Provider 名称、实际模型 ID 与配置加载位置；请求失败时再比较基础地址、协议和最终接口路径。工具调用异常则缩小任务，确认模型确实能返回该客户端需要的结构，不用自动审批绕过失败。

在无生产凭证的工作区测试，只提交允许外发的代码片段。分别核对客户端和模型服务的数据保存政策，清理日志中的鉴权头、个人信息与源代码。本文只核验官方文档，未配置真实账号，也未完成本站端点连通性测试。