문서

문서

Zed

Zed는 settings.json에서 OpenAI 호환 공급자를 선언하고 Agent Panel을 통해 키를 별도로 입력합니다. models 배열은 편의를 위한 항목이 아닙니다. Zed가 알 수 있는 전체 모델 목록입니다.

settings.json의 language_models.openai_compatible 블록에서 엔드포인트와 모델을 선언하고, 키는 Agent Panel UI에 입력하며 파일에는 저장하지 않습니다

~/.config/zed/settings.json
{
  "language_models": {
    "openai_compatible": {
      "kunavo": {
        "api_url": "https://api.kunavo.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true }
          },
          {
            "name": "claude-haiku-4-5",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}
API 키는 이 파일에 넣지 않습니다. Zed 문서에 명시된 대로 Agent Panel 공급자 설정에 입력하거나 공급자 이름에 따라 Zed가 생성하는 환경 변수를 설정하세요. settings.json는 동기화되어 공유되므로 여기에 키를 넣으면 파일과 함께 키도 공유됩니다.
Zed에서 available_models는 전체 카탈로그입니다. OpenAI 호환 공급자에는 검색 호출이 없으므로 목록에 없는 모델은 선택기에 표시되지 않습니다. 사용하려는 ID마다 항목을 추가하고, max_tokens를 해당 모델의 실제 컨텍스트 윈도우로 설정하세요.
아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Zed 설정 화면에서 열립니다.

단계별 안내

  1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
  2. 명령 팔레트에서 zed: open settings를 실행해 settings.json를 열고 위 블록을 추가합니다.
  3. Agent Panel 설정을 열고 키로 사용한 이름(kunavo의 경우) 아래에서 공급자를 찾아 API 키를 붙여 넣습니다.
  4. Agent Panel의 모델 선택기에서 모델을 선택합니다. 선택기에는 display_name가 표시되고 name를 전송합니다.
  5. Zed의 기본값과 다른 capabilities만 재정의하세요. 기본값은 tools: true이며 이미지와 병렬 도구 호출은 꺼져 있습니다.

Zed API 액세스 문서에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Zed에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 IDKunavo 입력/출력Zed에서의 위치
claude-sonnet-5$1.40 / $7.00에이전트 기본 설정 — 도구 및 이미지 사용
claude-opus-5$3.50 / $17.50계획이 속도보다 중요한 대규모 리팩터링
claude-haiku-4-5$0.70 / $3.50인라인 지원 및 빠른 편집
gpt-5-6-terra$0.70 / $4.20같은 공급자 항목을 통해 사용하는 두 번째 모델 계열
월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Zed에 OpenAI 호환 공급자를 추가하려면 어떻게 하나요?

settings.json에 language_models.openai_compatible 블록을 추가하고, 공급자 이름을 키로 사용하며, api_url은 엔드포인트의 /v1 루트를 가리키도록 설정하고, 사용할 각 모델 ID를 나열한 available_models 배열을 지정합니다. 그런 다음 Agent Panel 공급자 설정을 열고 API 키를 입력합니다. Zed 문서에는 키를 settings.json에 넣지 말라고 명시되어 있습니다.

Zed의 모델 선택기에 모델이 표시되지 않는 이유는 무엇인가요?

available_models에 해당 모델이 없기 때문입니다. Zed는 OpenAI 호환 엔드포인트에 카탈로그를 조회하지 않으므로 settings.json의 배열이 해당 공급자가 제공하는 전체 모델 목록입니다. 모델의 id를 name으로, 선택기에 표시할 이름을 display_name으로 지정하고 max_tokens를 실제 컨텍스트 윈도우로 설정한 항목을 추가하세요.

Zed는 사용자 지정 공급자의 API 키를 어디에 저장하나요?

Agent Panel의 공급자 설정 UI 또는 공급자 이름을 바탕으로 Zed가 생성하는 환경 변수에 저장합니다. settings.json에는 저장하지 않습니다. 키는 이식하거나 공유할 수 없지만 설정 파일은 이식 및 공유를 위한 것이므로, Zed는 의도적으로 자격 증명을 설정 파일 밖에 보관합니다.

사용자 지정 엔드포인트를 통해 Zed에서 Claude 모델을 사용할 수 있나요?

네. openai_compatible 공급자는 모델 이름을 api_url에 그대로 전달하므로 Claude ID는 Zed가 아니라 엔드포인트에서 확인됩니다. 도구 호출을 지원하는 모델은 capabilities.tools를 true로 설정하세요. 이 공급자 유형에서 Zed의 기본값이며, 에이전트는 퍼스트파티 공급자와 동일하게 작동합니다.