Zed는 에이전트가 내장된 오픈 소스 코드 에디터입니다. openai_compatible 제공자 유형으로 OpenAI 호환 API를 갖춘 서버라면 어디든 연결할 수 있습니다. BroadNet Inference는 https://inference.broadnet.ai/v1 주소에서 표준 chat completions를 제공하므로 그대로 맞습니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 단계는 Zed 1.28 기준 Zed API 액세스 문서를 따릅니다.
설정
- 키 발급. BroadNet 콘솔에서 종량제 키를 만들거나 무제한 플랜 키를 쓰세요.
- 제공자 추가.
agent: open settings명령으로 Agent Settings를 열고 LLM Providers 섹션에서 Add Provider를 클릭하거나,settings.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
}
}
]
}
}
}
}
- Zed에 키 전달. Zed를 시작하기 전에 키를 export하거나, Agent Settings의 제공자 항목에 붙여 넣으세요. 붙여 넣은 키는
settings.json이 아니라 시스템 키체인에 저장됩니다.
export BROADNET_API_KEY='your-broadnet-key'
- 테스트. 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로 설정하세요. 답변이 비어서 오는 이유를 참고하세요. - 429. 종량제 키는 분당 요청 30개, 동시 처리 4개까지 허용합니다. 플랜 세션은 한 번에 요청 1개를 처리합니다. 오류와 재시도를 참고하세요.
- 원격 프로젝트. Zed는 로컬 앱에서 제공자를 초기화하므로, SSH로 작업할 때 키는 원격 머신이 아니라 로컬 키체인이나 로컬 환경 변수에서 가져옵니다.
