Zed Editor 配置
Zed 是一款高性能代码编辑器。通过其原生 LLM Providers 功能添加 OpenAI 兼容服务后，即可在 Zed Agent 中选择并使用 LAYSO AI 模型。
一个 Key，访问全平台模型
同一个 LAYSO AI API Key 可以访问平台内的模型。成功请求会按所选模型的当前价格产生逐笔扣费明细；失败任务不会产生扣费。
前提条件
- 已安装或升级到最新版 Zed ↗。
- 已在 LAYSO AI API Key 页面 ↗ 创建 API Key。
- 已从 LAYSO AI 模型与价格页面 ↗ 复制需要使用的完整模型 ID。
配置步骤
第 1 步：打开 Agent 设置
按 ⌘ + Shift + P（macOS）或 Ctrl + Shift + P（Windows / Linux）打开命令面板，搜索并运行：
agent: open settings第 2 步：进入 LLM Providers
在设置页左侧搜索 LLM Providers，找到 AI → General → LLM Providers，然后点击右侧的 Configure。
第 3 步：添加 OpenAI 兼容 Provider
进入 LLM Providers 页面后，点击右上角 + Add Provider，然后在 Compatible APIs 中选择 OpenAI。
第 4 步：填写 LAYSO AI 和模型信息
在 Add OpenAI-Compatible Provider 页面填写：
| 字段 | 填写内容 |
|---|---|
| Provider Name | LAYSO AI |
| API URL | https://api.layso.ai/v1 |
| API Key | 从 LAYSO AI API Key 页面复制的完整密钥 |
| Model Name | 从模型与价格页面复制的完整模型 ID |
| Max Completion Tokens | 按模型页面展示的上下文长度填写 |
| Max Output Tokens | 按模型允许的最大输出长度填写 |
如需添加更多模型，点击 + Add Model。填写完成后点击右下角 Save Provider。
API URL 只填写到 /v1，不要追加 /chat/completions、/responses 或模型名称。不要照抄截图中的示例模型和 Token 数值，应以模型与价格页面的当前信息为准。
第 5 步：选择 LAYSO AI 模型
返回 Zed Agent，新建一个 Thread。点击输入框右下方的模型名称，在模型选择器中展开 LAYSO AI，选择刚刚添加的模型。
第 6 步：发送消息验证
确认输入框右下方显示的是刚刚选择的模型，然后发送一条简短消息，例如：
请用一句话介绍自己。收到正常回复后，到 LAYSO AI 用户端核对请求使用的模型、Token 和扣费明细。
使用范围
本教程配置的是 Zed 原生 Agent。它不会自动修改 Zed 中通过 ACP 运行的 Claude Code、Codex CLI、Gemini CLI 或 OpenCode；这些 External Agents 仍需按照各自教程配置 Provider 和认证信息。
常见问题
| 现象 | 排查方法 |
|---|---|
| 找不到 LLM Providers | 升级 Zed，并通过 agent: open settings 进入 Agent 设置后搜索 LLM Providers |
| Provider 或模型没有显示 | 确认已点击 Save Provider，然后重新打开 Agent Thread；仍未刷新时重启 Zed |
401 / 403 | 重新复制 API Key，确认没有空格、换行或缺失字符 |
404 | API URL 必须为 https://api.layso.ai/v1，不要重复添加 /v1 或完整请求路径 |
| 模型不存在 | 从模型与价格页面复制完整模型 ID，不要使用展示名称或猜测别名 |
| 对话输出被截断 | 检查 Max Completion Tokens 和 Max Output Tokens 是否符合模型当前限制 |
安全与计费
- 通过 Zed 设置界面保存的 API Key 会存储在系统钥匙串中，而不是项目文件中。
- 不要在截图、日志、聊天记录或 Git 仓库中暴露完整 API Key。
- LAYSO AI 只对实际到达平台并成功完成的请求计费，失败任务不会产生扣费。