---
title: "Zed OpenAI 호환 제공자 설정(GLM, Qwen) | BroadRouter"
description: "Zed 에디터의 settings.json에 BroadNet Inference를 OpenAI 호환 제공자로 추가하는 방법입니다. 모델 ID, 토큰 한도, capabilities, 키 환경 변수를 정리했습니다."
url: https://broadrouter.com/ko/guides/zed-openai-compatible-provider/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/zed-openai-compatible-provider/) (2026-11-16 업데이트).

# Zed에서 BroadNet Inference를 OpenAI 호환 제공자로 쓰기

업데이트 2026-11-16

Zed의 settings.json에서 language\_models.openai\_compatible 아래에 broadnet 같은 제공자를 추가하세요. api\_url은 https://inference.broadnet.ai/v1로 설정하고, available\_models에는 broadnet/glm-5.3 같은 BroadNet ID를 넣은 뒤 max\_tokens를 컨텍스트 크기로 지정합니다. Zed는 BROADNET\_API\_KEY에서 키를 읽으며, Agent Settings에 키를 저장해도 됩니다.

Zed는 에이전트가 내장된 오픈 소스 코드 에디터입니다. `openai_compatible` 제공자 유형으로 OpenAI 호환 API를 갖춘 서버라면 어디든 연결할 수 있습니다. BroadNet Inference는 `https://inference.broadnet.ai/v1` 주소에서 표준 chat completions를 제공하므로 그대로 맞습니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 단계는 Zed 1.28 기준 [Zed API 액세스 문서](https://zed.dev/docs/ai/use-api-access#openai-compatible)를 따릅니다.

## 설정

1.  **키 발급.** BroadNet 콘솔에서 종량제 키를 만들거나 [무제한 플랜](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/) 키를 쓰세요.
2.  **제공자 추가.** `agent: open settings` 명령으로 Agent Settings를 열고 LLM Providers 섹션에서 **Add Provider**를 클릭하거나, `settings.json`을 직접 편집하세요.

```json
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
```

3.  **Zed에 키 전달.** Zed를 시작하기 전에 키를 export하거나, Agent Settings의 제공자 항목에 붙여 넣으세요. 붙여 넣은 키는 `settings.json`이 아니라 시스템 키체인에 저장됩니다.

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

4.  **테스트.** Agent Panel을 열고 모델 선택기에서 **GLM 5.3 (BroadNet)** 모델을 고른 뒤, 열려 있는 파일에 대해 간단한 질문을 해 보세요. 답이 오면 연결된 것입니다.

## 설정 항목의 의미

-   **`name`**: Zed가 보내는 모델 ID입니다. BroadNet ID를 `broadnet/` 접두사까지 정확히 쓰세요.
-   **`max_tokens`**: Zed 스키마에서는 출력 한도가 아니라 컨텍스트 윈도우입니다. GLM 5.3과 DeepSeek V4.1 Flash는 1,048,576, Qwen3.8 27B는 262,144를 쓰세요.
-   **`max_output_tokens`**: 답변 길이의 상한입니다. 위의 16,000은 저희 권장값일 뿐 BroadNet의 제한이 아닙니다. 추론도 여기에 포함되므로 낮게 잡지 마세요.
-   **`max_tokens_parameter: true`**: Zed가 출력 한도를 `max_completion_tokens` 대신 `max_tokens`로 보내게 합니다. BroadNet API 레퍼런스는 `max_tokens` 필드를 설명합니다.
-   **`images`**: OpenAI 호환 모델에서는 기본값이 false입니다. 이미지를 받는 모델에만 켜세요. Qwen3.8 27B, DeepSeek V4.1 Flash, BroadNet Gemma 4 VL 26B가 해당됩니다.
-   **`reasoning_effort`**: 선택 사항입니다. 추론을 짧게 하려면 BroadNet 문서는 `low`를 권합니다.

## 어떤 모델을 고를까

| 용도 | 모델 | 이유 |
| --- | --- | --- |
| 도구를 쓰는 에이전트 편집 | `broadnet/glm-5.3` | BroadNet이 도구와 구조화된 출력을 지원으로 표기, 100만 컨텍스트 |
| 스크린샷과 아랍어 텍스트 | `broadnet/qwen3.8-27b` | 도구와 이미지 입력, 262K 컨텍스트 |
| 정액 플랜으로 긴 대화 | `broadnet/deepseek-v4.1-flash` | 무제한 플랜 모델, 이미지 입력 가능, BroadNet 표기상 도구 지원 없음 |

Zed는 OpenAI 호환 모델에 `tools: true`를 가정합니다. BroadNet 문서에는 DeepSeek V4.1 Flash의 도구 호출이 나와 있지 않으므로, 의존하기 전에 실제 에이전트 작업으로 테스트하세요. Full Moon 한 달($60)을 결제하기 전에 Meteor 1시간($1)으로 저렴하게 시험해 볼 수 있습니다.

## 문제 해결

-   **401.** 키가 틀렸거나 만료되었거나 사용 한도를 다 썼습니다. `BROADNET_API_KEY`를 설정했다면 그 값이 키체인보다 우선합니다. 저장된 키를 쓰려면 변수를 unset하고 Zed를 다시 시작하세요.
-   **모든 요청에서 404.** `api_url`이 `/v1`로 끝나는지 확인하세요. 그다음 `name`이 BroadNet ID와 정확히 같은지 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는 `broadnet/gemma-4-26b-a4b` 모델과 Transcribe 모델 두 개만 쓸 수 있습니다.
-   **빈 답변.** 모델이 출력 예산을 추론에 다 썼습니다. `max_output_tokens`를 올리거나 `reasoning_effort`를 `low`로 설정하세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **429.** 종량제 키는 분당 요청 30개, 동시 처리 4개까지 허용합니다. 플랜 세션은 한 번에 요청 1개를 처리합니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **원격 프로젝트.** Zed는 로컬 앱에서 제공자를 초기화하므로, SSH로 작업할 때 키는 원격 머신이 아니라 로컬 키체인이나 로컬 환경 변수에서 가져옵니다.

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/)

OpenAI 호환 API는 POST /v1/chat/completions처럼 OpenAI API와 같은 요청 및 응답 형식을 받는 HTTP API입니다. 그래서 OpenAI SDK와 도구는 base URL, API 키, 모델 이름만 바꾸면 이 API를 그대로 사용할 수 있습니다.

[AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/)

AI 에이전트는 언어 모델이 목표를 향해 스스로 단계를 정하는 시스템입니다. 어떤 도구를 호출할지 결정하고, 결과를 읽고, 최종 답변을 내거나 한도에 닿을 때까지 이를 반복합니다. 정해진 지점에서 모델을 호출하는 고정된 스크립트는 보통 워크플로라고 부릅니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

## 자주 묻는 질문

### Zed는 커스텀 제공자 키를 어떤 환경 변수에서 읽나요?

Zed는 제공자 ID를 대문자 스네이크 케이스로 바꾸고 \_API\_KEY를 붙여 이름을 만듭니다. broadnet이라는 제공자는 BROADNET\_API\_KEY를 읽습니다. 이 변수가 비어 있지 않으면 키체인에 저장된 키보다 우선합니다.

### Zed의 Agent Panel에서 BroadNet 모델이 작동하나요?

네. Zed의 API 액세스는 Zed Agent, Inline Assistant, 커밋 메시지, 스레드 요약에 적용됩니다. Zed는 OpenAI 호환 모델이 도구를 지원한다고 가정하므로, BroadNet이 도구 지원으로 표기한 GLM 5.3이나 Qwen3.8 27B를 고르세요.

### 이 설정이 Zed의 편집 예측(edit predictions)도 바꾸나요?

아니요. Zed 문서에 따르면 편집 예측은 edit\_predictions 아래에서 제공자를 따로 설정합니다. 이 가이드의 제공자는 에이전트와 그 밖의 Zed AI 기능용입니다.

### Zed에 모델이 Responses API에서만 작동한다는 메시지가 뜨는 이유는 무엇인가요?

BroadNet에서는 그런 메시지가 뜨지 않아야 합니다. capabilities.chat\_completions는 기본값인 true로 두세요. BroadNet은 /v1/chat/completions를 제공하며 Responses API는 목록에 없습니다.

## 관련 가이드

-   [Kilo Code에서 BroadNet Inference 쓰기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/kilo-code-openai-compatible/)
-   [BroadNet Inference에서 Cline 사용하기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/cline-openai-compatible/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
-   [BroadNet Inference와 함께 쓸 수 있는 모든 도구 (영어)](https://broadrouter.com/integrations/): SDK, 코딩 에이전트, 채팅 UI, 자동화 도구와 각 도구의 정확한 설정

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-zed-openai-compatible-provider&utm_content=page-cta) ·

**출처**

-   [Zed 문서, Use API Access, OpenAI 호환 엔드포인트(2026-11-15 확인)](https://zed.dev/docs/ai/use-api-access#openai-compatible)
-   [GitHub의 Zed 릴리스, 최신 v1.28.1(2026-11-15 확인)](https://github.com/zed-industries/zed/releases)
-   [BroadNet Inference API 레퍼런스(2026-11-15 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-zed-openai-compatible-provider&utm_content=sources)
