Source: https://wiki.niceai.dev/guide/clients/zed

# Zed 编辑器接入自定义 API

在 Zed 中添加一个自定义供应商即可：走 OpenAI 兼容协议时 `api_url` 填 `https://api.niceai.dev/v1`；走 Anthropic 协议（Claude 模型）时 `api_url` 填 `https://api.niceai.dev`。配置后 Zed Agent、Inline Assistant 等功能都可以选用这些模型。

## 准备工作

在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥：用 Claude 模型选 **Claude** 分组，用 GPT 等模型选对应分组。

## 配置步骤

1. 在 Zed 中打开命令面板，运行 `agent: open settings`。
2. 在 LLM Providers 区域点击 **Add Provider**：
   - 用 OpenAI 兼容协议：选 OpenAI 兼容类型，API URL 填 `https://api.niceai.dev/v1`。
   - 用 Claude 原生协议：选 **Anthropic**，API URL 填 `https://api.niceai.dev`。
3. 填写供应商名称、模型名（以 [模型广场](https://niceai.dev/model-plaza) 为准）、上下文长度和 API 密钥，保存。
4. 在 Agent 面板的模型选择器中选中刚添加的模型。

## 用 settings.json 配置

也可以直接写进 Zed 的设置文件：

**-group**

```json [OpenAI 兼容]
{
  "language_models": {
    "openai_compatible": {
      "niceai": {
        "api_url": "https://api.niceai.dev/v1",
        "available_models": [
          { "name": "<模型名>", "display_name": "<显示名称>", "max_tokens": 128000 }
        ]
      }
    }
  }
}
```

```json [Anthropic 兼容]
{
  "language_models": {
    "anthropic_compatible": {
      "NiceAI Claude": {
        "api_url": "https://api.niceai.dev",
        "available_models": [
          { "name": "<模型名>", "display_name": "<显示名称>", "max_tokens": 200000 }
        ]
      }
    }
  }
}
```



`max_tokens` 是模型的上下文长度，按模型实际情况填写，上面只是示意。

密钥可以在 Add Provider 界面填写（保存在系统钥匙串），也可以用环境变量：OpenAI 兼容供应商的变量名由供应商 ID 转成大写下划线再加 `_API_KEY`，例如 ID 为 `niceai` 时是 `NICEAI_API_KEY`。

## 常见问题

### 模型只支持 Responses 接口怎么办？

在模型的 `capabilities` 里把 `chat_completions` 设为 `false`，Zed 会改用 Responses 接口。

### 返回 404？

OpenAI 兼容要带 `/v1`，Anthropic 兼容不带。见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 配置后外部 Agent（如 Claude Code）没变化？

Zed 的 LLM 供应商只作用于 Zed 自己的 AI 功能。在 Zed 里运行的 Claude Code、Codex 等外部 Agent 使用各自的配置，参考 [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)。

## 下一步

- [VS Code Copilot 自定义模型](https://wiki.niceai.dev/guide/clients/vscode-copilot)
- [客户端一览](https://wiki.niceai.dev/guide/clients/)
