Zed에서 무료 AI 모델 사용하기
Zed는 에이전트 패널이 있는 오픈소스 코드 편집기입니다. OpenAI 호환 제공업체 또는 Ollama 서버를 사용할 수 있습니다. 이 가이드는 두 방법 중 하나로 Zed를 FreeLLMAPI를 통해 무료 모델에 연결합니다. 끝부분의 짧은 섹션은 JetBrains AI Assistant를 다룹니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
Zed를 연결하는 두 가지 방법
| 방법 | Zed 설정 | FreeLLMAPI 엔드포인트 | 키 |
|---|---|---|---|
| OpenAI 호환 제공업체 (권장) | language_models.openai_compatible | http://localhost:3001/v1 | Zed 설정 UI 또는 환경 변수에 넣는 통합 키 |
| Ollama 제공업체 | language_models.ollama | http://localhost:3001 (Ollama 에뮬레이션) | 루프백에서는 없음, 또는 통합 키 |
두 방법 모두 같은 라우터와 같은 무료 모델 풀을 사용합니다. OpenAI 호환 방법은 FreeLLMAPI 쪽에서 변경할 것이 없습니다. Ollama 방법에는 Ollama 에뮬레이션이 필요하며, 이 설정은 기본적으로 꺼져 있습니다.
먼저 FreeLLMAPI를 설치하세요. http://localhost:3001을 열고, Keys 페이지에서 무료 제공업체 키를 두 개 이상 추가한 다음 통합 키를 복사하세요.
macOS 또는 Linux에 설치
curl -fsSL https://freellmapi.co/install.sh | bash방법 1: OpenAI 호환 제공업체
Zed의 settings.json을 열고 이 블록을 추가하세요. 제공업체 ID는 freellmapi입니다. max_tokens는 모델의 컨텍스트 창입니다.
Zed settings.json
{
"language_models": {
"openai_compatible": {
"freellmapi": {
"api_url": "http://localhost:3001/v1",
"available_models": [
{
"name": "auto",
"display_name": "FreeLLMAPI Auto",
"max_tokens": 128000,
"max_output_tokens": 8192,
"capabilities": {
"tools": true,
"images": false,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true
}
}
]
}
}
}
}키를 settings.json에 넣지 마세요. 다음 두 방법 중 하나를 사용하세요:
- 명령 팔레트에서
agent: open settings를 실행하세요. LLM providers로 이동하여 제공업체를 찾고 키를 입력하세요. Zed는 키를 시스템 키체인에 보관합니다. - 환경 변수를 설정하세요. Zed는 제공업체 ID를 대문자 스네이크 케이스로 바꾸고
_API_KEY를 붙여 이름을 만듭니다. ID가freellmapi이면 이름은FREELLMAPI_API_KEY입니다. 이 변수는 키체인보다 우선합니다.
환경 변수로 설정한 키
export FREELLMAPI_API_KEY=<unified-key>
zed모델 메뉴에 넣고 싶은 모델마다 available_models에 항목을 하나씩 추가하세요. auto:smart와 auto:fast도 유효한 이름입니다.
방법 2: Ollama 에뮬레이션
FreeLLMAPI는 Ollama 서버처럼 동작할 수 있습니다. /api/tags, /api/chat, /api/generate, /api/show, /api/version, /api/embed를 제공합니다. 스트리밍은 Ollama와 같이 줄바꿈으로 구분된 JSON을 사용합니다.
- FreeLLMAPI 대시보드에서 Keys, Agents를 여세요.
- Ollama 에뮬레이션을
open-loopback또는key-required로 설정하세요. - 아래 블록을 Zed의
settings.json에 추가하세요. - 에이전트 패널을 열고 모델을 선택하세요.
Zed settings.json
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopback은 키가 필요 없지만, 이 컴퓨터에서 오는 요청에만 해당합니다.- FreeLLMAPI가 Docker에서 실행되면,
open-loopback은 게시된 포트를 통한 요청을 거부합니다.key-required를 사용하고OLLAMA_API_KEY를 통합 키로 설정하거나, 제공업체 UI에 입력하세요. - Zed는 컨텍스트 크기를
num_ctx로 보냅니다. 기본값은 4096 토큰이며 에이전트 작업에는 너무 작습니다.context_window를 설정하세요.
에이전트 패널용 모델 선택
Zed 문서에 따르면 모든 모델과 제공업체는 도구 호출을 지원해야 합니다. 도구를 지원하지 않는 모델은 에이전트 패널에 "No tools" 표시가 나타납니다. 도구 호출을 지원하고 컨텍스트 창이 큰 모델을 사용하세요.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 요청/분 1 req/min per model | 예 | 아니요 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 요청/분 50 요청/일 Shared rate limit | 예 | 아니요 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
일치하는 무료 모델 109개 중 10개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
무료 티어에는 분당 및 일일 한도가 있습니다. 제공업체가 429 오류를 반환하면 FreeLLMAPI는 체인의 다음 모델을 시도합니다. 긴 에이전트 세션을 위해 제공업체 네 곳 이상에서 키를 추가하세요.
/v1/completions 엔드포인트로 보낼 수 있습니다. FreeLLMAPI는 둘 다 제공합니다. Zed 편집 예측 문서에는 이 두 제공업체에 대한 API 키 필드가 없습니다. 이 조합은 FreeLLMAPI로 확인하지 않았으므로, 의존하기 전에 테스트하세요.JetBrains AI Assistant
JetBrains AI Assistant는 OpenAI 호환 제공업체 또는 로컬 Ollama 서버를 사용할 수 있습니다. Settings, Tools, AI Assistant, Providers & API keys를 여세요. 옵션은 두 가지입니다:
- 직접 키 사용, OpenAI 호환: Base URL
http://localhost:3001/v1, 통합 키,auto같은 모델 ID를 입력하세요. JetBrains 문서에 따르면 BYOK는 JetBrains AI 구독 없이도 에이전트에서 작동합니다. - Ollama: Third-party AI providers에서 Ollama를 선택하세요. URL 필드에
http://localhost:3001을 입력하고 Test Connection을 클릭하세요. 그다음 Models Assignment에서 모델을 할당하세요. 먼저 FreeLLMAPI에서 Ollama 에뮬레이션을 켜세요.
JetBrains 문서는 로컬 모델의 제한을 설명합니다. 에이전트는 로컬 모델을 사용할 수 없고, AI Assistant는 로컬 모델로 MCP 도구를 호출할 수 없습니다. 인라인 완성과 다음 편집 제안은 기본적으로 JetBrains 모델을 사용합니다. 에이전트 작업에는 BYOK 옵션을 사용하세요.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
401 "Invalid API key" 오류 | Zed에 제공업체의 키가 없거나 잘못된 키가 있음 | FREELLMAPI_API_KEY를 설정하거나, 에이전트 설정에 키를 입력하세요 |
| 모델에 표시된 "No tools" 라벨 | 모델의 도구가 꺼져 있거나 모델이 도구 호출을 지원하지 않음 | "tools": true를 설정하고 표의 모델을 사용하세요 |
| Ollama 제공업체에 모델이 표시되지 않음 | FreeLLMAPI에서 Ollama 에뮬레이션이 꺼져 있음 | Keys, Agents에서 켜세요 |
| Docker에서 보낸 Ollama 요청이 거부됨 | open-loopback은 루프백 피어만 허용함 | 통합 키와 함께 key-required를 사용하세요 |
| 긴 프롬프트에서 컨텍스트가 손실됨 | num_ctx가 4096 토큰임 | Ollama 설정에서 context_window를 설정하세요 |
| N회 시도 후 "모든 모델의 요청 한도 초과" 오류 | 모든 키가 한도에 도달함 | 더 많은 제공업체의 키를 추가하거나 쿨다운이 끝날 때까지 기다리세요 |
자주 묻는 질문
Zed에서 사용자 지정 LLM을 사용할 수 있나요?
네. settings.json의 language_models에 api_url과 available_models가 있는 openai_compatible 제공업체를 추가하세요. Zed는 사용자 지정 api_url을 가진 Ollama 제공업체도 지원합니다.
Zed에서 무료 AI 모델은 어떻게 사용하나요?
OpenAI 호환 제공업체가 http://localhost:3001/v1의 FreeLLMAPI를 가리키게 하세요. 게이트웨이는 각 요청을 무료 제공업체 티어로 보내므로 추론 비용은 $0입니다.
Zed는 사용자 지정 제공업체의 API 키를 어디에 저장하나요?
Zed는 에이전트 설정에 입력한 키를 시스템 키체인에 보관합니다. 제공업체 ID를 따서 이름을 붙인 환경 변수(예: FREELLMAPI_API_KEY)를 설정할 수도 있습니다.
JetBrains AI Assistant는 무료 모델에서 작동하나요?
네. OpenAI 호환 Base URL로 직접 키 사용(Bring your own key)을 쓰거나 Ollama 제공업체를 사용하세요. JetBrains 문서에 따르면 에이전트는 로컬 모델을 사용할 수 없으므로, 에이전트 작업에는 BYOK를 사용하세요.
관련 가이드
- VS Code의 무료 AI 모델
- 무료 LLM API로 Continue 사용하기
- 무료 API로 쓰는 Cline, Roo Code, Kilo Code
- 최고의 무료 코딩 모델 API
- 무료 OpenAI 호환 API Base URL
출처
- Zed docs: use API access (OpenAI-compatible providers) (20 November 2026 확인)
- Zed docs: use a local model (Ollama) (20 November 2026 확인)
- Zed docs: agent panel (20 November 2026 확인)
- Zed docs: edit prediction (20 November 2026 확인)
- JetBrains AI Assistant: use custom models (20 November 2026 확인)
- JetBrains AI Assistant: bring your own key (20 November 2026 확인)
- FreeLLMAPI docs: Ollama clients (20 November 2026 확인)