Zed Agent 接入

Zed 内置原生编码 Agent，无需额外安装扩展就能读取项目、编辑文件并调用工具。它支持自定义 OpenAI-compatible 提供方，很适合作为 Lumoswitch 在 macOS、Linux 和 Windows 上的轻量图形入口。

请先创建输出协议为 OpenAI-compatible 的 Lumoswitch 配置 API。模型需要可靠支持原生工具调用；只有聊天兼容性不足以运行 Agent 模式。

选择接入方式

Lumoswitch 不为 Zed 发布终端自动导入。脚本改写共享 JSONC 可能丢失注释或已有提供方，而终端命令也无法跨平台安全管理 Zed 的系统钥匙串条目。

准备连接值

在 Zed 中接入（推荐）

1. 打开 Agent 面板，再进入 Agent Settings。
2. 在 LLM Providers 中添加 OpenAI Compatible 提供方。
3. 提供方 ID 使用 lumoswitch，API URL 填写 {{api_base_url}}。
4. 添加可用模型 {{model}}，上下文窗口填写所选上游模型的真实限制。
5. Zed 询问提供方 API Key 时填入 {{access_key}}。它会保存到系统钥匙串，而不是 settings.json。
6. 在模型选择器中选中 Lumoswitch · {{model}}，用一个小型文件读取或编辑任务验证。

提供方 ID 会影响凭证名称：Zed 会根据 ID 推导可选的环境变量。使用 lumoswitch 时，对应变量是 LUMOSWITCH_API_KEY。建议通过界面保存 Key，因为图形应用不一定继承终端环境变量。

可选 JSONC 设置

如果当前 Zed 版本没有提供方编辑界面，请在命令面板运行 agent: open settings，将以下属性合并到已有 JSONC 对象：

{
  "language_models": {
    "openai_compatible": {
      "lumoswitch": {
        "api_url": "{{api_base_url}}",
        "available_models": [
          {
            "name": "{{model}}",
            "display_name": "Lumoswitch · {{model}}",
            "max_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
            },
          },
        ],
      },
    },
  },
  "agent": {
    "default_model": {
      "provider": "lumoswitch",
      "model": "{{model}}",
    },
  },
}

请把 128000 和能力标志改为模型的真实限制。不要替换整个设置文件，其中可能还有主题、快捷键、其他提供方和注释。Zed 用户设置在 macOS/Linux 上位于 ~/.config/zed/settings.json，Windows 上位于 %APPDATA%\Zed\settings.json。

如果 Lumoswitch 配置只提供 Responses，请把 chat_completions 改为 false；本页使用 OpenAI-compatible Chat Completions，因此保持 true。

清除接入

1. 打开 Zed Agent 设置，删除 lumoswitch 提供方。
2. 如果 Agent 默认模型仍指向它，请选择其他模型，或只删除对应的 agent.default_model。
3. 通过 Zed 的提供方凭证界面清除保存的 lumoswitch Key。

不要删除整个 Zed 设置文件或应用数据目录。这会误删无关编辑器偏好，而且仍可能在系统钥匙串中留下凭证。

验证与排错

• 401 通常表示 Key 没有保存到完全一致的 lumoswitch 提供方 ID。
• 遇到 404，检查是否重复拼接 /v1，以及 {{model}} 是否为下游模型名称。
• 聊天正常但编辑失败时，检查原生工具调用支持和 tools 能力。
• 远程项目仍使用本机 Zed 初始化的提供方配置与凭证。

参考：Zed API 接入、Zed Agent 和 Zed 设置。最后核验：2026-08-23。