홈 / 가이드 / Zed에서 무료 AI 모델 사용하기

Zed에서 무료 AI 모델 사용하기

Zed는 에이전트 패널이 있는 오픈소스 코드 편집기입니다. OpenAI 호환 제공업체 또는 Ollama 서버를 사용할 수 있습니다. 이 가이드는 두 방법 중 하나로 Zed를 FreeLLMAPI를 통해 무료 모델에 연결합니다. 끝부분의 짧은 섹션은 JetBrains AI Assistant를 다룹니다.

코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.

Zed를 연결하는 두 가지 방법

방법Zed 설정FreeLLMAPI 엔드포인트키
OpenAI 호환 제공업체 (권장)language_models.openai_compatiblehttp://localhost:3001/v1Zed 설정 UI 또는 환경 변수에 넣는 통합 키
Ollama 제공업체language_models.ollamahttp://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을 사용합니다.

  1. FreeLLMAPI 대시보드에서 Keys, Agents를 여세요.
  2. Ollama 에뮬레이션을 open-loopback 또는 key-required로 설정하세요.
  3. 아래 블록을 Zed의 settings.json에 추가하세요.
  4. 에이전트 패널을 열고 모델을 선택하세요.

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" 표시가 나타납니다. 도구 호출을 지원하고 컨텍스트 창이 큰 모델을 사용하세요.

Zed 에이전트 패널용 무료 모델: 도구 호출 및 128K 이상 컨텍스트
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
GLM 5.3UnoRouter1M1 요청/분
1 req/min per model
예아니요
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 요청/분
40 RPM
예예
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota예예
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance예아니요
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit예예
Gemini 3.7 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit예예
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예예
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 요청/분
50 요청/일
Shared rate limit
예아니요
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 요청/분
250 요청/일
70,000 토큰/분
~6M
예예

일치하는 무료 모델 109개 중 10개를 표시합니다. 모든 모델 보기.

FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.

무료 티어에는 분당 및 일일 한도가 있습니다. 제공업체가 429 오류를 반환하면 FreeLLMAPI는 체인의 다음 모델을 시도합니다. 긴 에이전트 세션을 위해 제공업체 네 곳 이상에서 키를 추가하세요.

편집 예측: Zed는 편집 예측을 Ollama 서버 또는 OpenAI 호환 /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회 시도 후 "모든 모델의 요청 한도 초과" 오류모든 키가 한도에 도달함더 많은 제공업체의 키를 추가하거나 쿨다운이 끝날 때까지 기다리세요
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

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를 사용하세요.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기