> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Zed

> 了解如何在 Zed 编辑器中添加 OpenAI-compatible provider，接入 siflow endpoint，让内置 AI assistant 使用算秩模型完成 chat 和 edits。

[Zed](https://zed.dev) 是一款高性能多人协作代码编辑器，内置 AI assistant。它支持 OpenAI-compatible providers，因此可以将 assistant 接入 siflow endpoint，在编辑器内完成 chat 和 edits。

支持的模型包括 `glm-5.2` 和 `DeepSeek-V4-Flash`。完整模型列表和价格请查看 [模型广场](https://console.siflow.cn/model-inference/models)。

## 配置

先在 [API 密钥](https://console.siflow.cn/model-inference/api_keys) 页面创建 API Key。

### 1. 添加 provider

打开 Zed 的 `settings.json`（command palette → **zed: open settings**），在 `language_models` 下添加 OpenAI-compatible provider：

```json theme={null}
{
  "language_models": {
    "openai_compatible": {
      "siflow": {
        "api_url": "https://api.siflow.cn/model-api/v1",
        "available_models": [
          {
            "name": "glm-5.2",
            "display_name": "siflow glm-5.2",
            "max_tokens": 131072
          }
        ]
      }
    }
  }
}
```

| 字段                              | 说明                                                                        |
| ------------------------------- | ------------------------------------------------------------------------- |
| `openai_compatible.<id>`        | Provider ID，例如 `siflow`。API-key 环境变量名会由它派生                                |
| `api_url`                       | siflow OpenAI-compatible endpoint：`https://api.siflow.cn/model-api/v1`    |
| `available_models[].name`       | 模型 ID，例如 `glm-5.2`。如果依赖 assistant 的 tool/edit 功能，请选择原生支持 tool calling 的模型 |
| `available_models[].max_tokens` | 模型的 context window                                                        |

Models 默认 `tools: true`，因此 tool calls 无需额外 capability flags。请将 `max_tokens` 设置为模型真实 context window。

### 2. 提供 API Key

**不要把 API Key 写入 `settings.json`。** Zed 支持两种方式：

* **Settings UI**：打开 **Settings → User → AI → General → LLM Providers**，在列表中找到 **siflow**，单击 **Configure** 输入 key。Zed 会将其存入系统 keychain。
* **Environment variable**：Zed 会根据 provider ID 生成大写 snake case + `_API_KEY` 的变量名。对于上面的 `siflow` provider，设置 `SIFLOW_API_KEY`，然后从已导出该变量的 shell 启动 Zed。

同一个 provider 也可以从 UI 添加（**Settings → AI → LLM Providers → Add Provider → OpenAI**），key 会存储到系统 keychain：

<img src="https://mintcdn.com/siflow/CfO6jliU08Hhf849/model-inference/media/zed-provider-config.png?fit=max&auto=format&n=CfO6jliU08Hhf849&q=85&s=396650edca60b1382c3227908e98eb65" alt="Zed 中配置 OpenAI-Compatible provider 接入 siflow endpoint" width="1800" height="1500" data-path="model-inference/media/zed-provider-config.png" />

## 验证

打开 Agent Panel，在 model picker 中选择模型（按照上面的示例会显示为 **siflow glm-5.2**），并发送消息。如果返回正常回复，即表示连接成功。

<img src="https://mintcdn.com/siflow/CfO6jliU08Hhf849/model-inference/media/zed-agent-reply.png?fit=max&auto=format&n=CfO6jliU08Hhf849&q=85&s=c3aca6253a7863c674c3cf04157aa6bb" alt="Zed Agent Panel 使用算秩 glm-5.2 模型辅助编码" width="3024" height="1694" data-path="model-inference/media/zed-agent-reply.png" />

如果模型没有列出，请确认存在 `available_models` 条目，且 `api_url` 以 `/v1` 结尾。

Zed 的 AI settings layout 可能随版本变化，请以实际版本为准。