​
1. 安装并打开模型设置

从 Zed 官网下载适合 Intel 或 Apple Silicon 的 macOS 安装包并安装。打开编辑器后按 Cmd + Shift + P 呼出命令面板。
三种系统都在命令面板执行 agent: open settings，找到 LLM Providers → Add Provider，选择 OpenAI-compatible。该命令输入到编辑器命令面板，不是系统终端。

​
2. 添加 ABCRelay

保存配置。API URL 要带 /v1，末尾不再加 /；Zed 会追加 /chat/completions。仅支持 Responses 的模型需按下方 FAQ 调整协议。需要 Key 或模型信息，见接入前必备。

​
3. 在 Zed Agent 中试用

打开 Agent 面板，选择 ABCRelay 的模型并新建对话，发送“只回复 OK”。收到回复后到 ABCRelay调用记录核对，再尝试读取项目里的一个文件。

​
FAQ 与详细说明

不同客户端的字段与地址写法，见 Base URL 对照表。
本页选择 OpenAI-compatible，API URL 填写 https://www.abcrelay.com/v1，对应用户设置里的 language_models.openai_compatible 服务商条目的 api_url。Zed 直接追加端点，不会自动补版本前缀：默认得到 /v1/chat/completions；切换 Responses 后得到 /v1/responses，API URL 不变。不要只填根域名，不要填完整端点，也不要在 /v1 后多加一个 /。即使模型来自 Anthropic，只要选择的是这里的 OpenAI-compatible 入口，地址规则仍相同。
按官方安装要求核对操作系统版本和 CPU 架构。Windows 原生支持 x64 / ARM64；macOS 支持 Intel / Apple Silicon，旧系统部分协作功能有限。Linux 需要 Vulkan 1.3 驱动，以及 FileChooser、OpenURI 和 Secret/Secrets 桌面服务。出现图形或 Key 保存问题时先检查这些依赖；纯命令行服务器可改用 Codex CLI或 Claude Code CLI。
本页配置的是 Zed 自带 Agent、Inline Assistant 等使用 LLM Provider 的功能。External Agents、Terminal Threads 通常由对应 CLI 管理鉴权；请分别参考 Codex CLI和 Claude Code CLI。Edit Prediction 也有独立配置，不由这份接入自动覆盖。
打开命令面板（macOS：Cmd + Shift + P；Windows / Linux：Ctrl + Shift + P），复制并执行下面的编辑器命令，直接打开当前用户配置：
默认完整路径如下；这是文件位置，不是终端命令：
在 Finder 按 Cmd + Shift + G，粘贴 ~/.config/zed 可打开所在文件夹。
文件不存在时请在对应路径新建此文件，文件名保持 settings.json。自定义数据目录或沙盒安装包可能使用不同位置，以命令面板实际打开的文件为准。这是用户配置，不要在项目目录另建同名文件。在其中找到 language_models.openai_compatible 下刚添加的服务商及 available_models 中的模型，为它合并以下字段（保留已有的模型 ID、上下文等字段）：
默认 chat_completions: true 使用 Chat Completions；设为 false 使用 Responses。不要仅凭模型名称切换，先确认本站模型的协议与工具能力。
设置界面保存的 Key 放在本地系统钥匙串，不要写入上面列出的用户设置文件。Zed 的 LLM Provider 读取本地 Zed 进程环境；即使项目在 SSH 或容器中，远程 shell 的变量也不会自动传到本地应用。非空环境变量优先于钥匙串；服务商 ID 为 abcrelay 时对应 ABCRELAY_API_KEY。
核对实际模型 ID、Key 权限和所需协议；模型条目出现不代表请求成功。上下文上限必须填真实规格。工具与图片能力应按模型实际支持配置，更多错误见统一排错。
端点核对源码：Chat Completions、Responses。资料核对：2026-09-10。依据三系统安装要求、命令面板快捷键、Zed API Access、LLM Providers与用户配置路径。已核对安装入口、添加服务商、协议切换及 Key 存储规则；未完成三系统客户端使用本站真实 Key 的端到端联调。