Qoder

Qoder Settings → Models → + Add → Provider → Custom에서 OpenAI 호환 Base URL, API Key, 직접 입력하는 Model IDs를 설정하면 독립형 Qoder 데스크톱 앱에서 Claude와 GPT를 사용할 수 있습니다. 둘 다 자체 카탈로그에는 없습니다

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. Qoder Settings를 열고 왼쪽 탐색에서 Models를 선택한 다음 + Add를 클릭합니다.
3. Provider를 열고 Custom 아래에서 OpenAI Compatible를 선택합니다. 위쪽의 사전 설정 공급자 중 하나를 선택하면 안 됩니다. 그런 다음 API 유형으로 Chat Completions API를 선택합니다.
4. Base URL, API Key, 최소 하나의 Model ID를 입력합니다. Qoder 문서에는 이 필드에서 모델 목록을 검색하는 기능이 나와 있지 않으므로 ID를 직접 입력하세요. 같은 엔드포인트에 모델을 추가할 때마다 Add Model ID를 클릭합니다.
5. Next를 클릭하고 Qoder가 자동으로 추론할 수 없는 기능을 설정합니다. Display name, Supported Context Windows, 해당 값 중 하나를 Default Context Window로 설정하고, 모델이 지원하는 경우 Vision과 Thinking Mode를 켭니다.
6. Validate and Add Model을 클릭합니다. Qoder의 모델 선택기 페이지에 따르면 모델을 추가하면 “작업, Agent, 자동화의 모델 선택기에서 사용할 수 있습니다.”

독립 실행형 Qoder 앱의 사용자 지정 모델 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

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

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

# 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 기준이며 입력 / 출력 순서입니다.

Qoder에 Base URL 필드가 없는 이유

Qoder 제품군의 세 가지 환경에서 자체 키 사용(BYOK)을 지원한다고 문서화했지만, 직접 선택한 엔드포인트를 설정할 수 있다고 문서화한 환경은 하나뿐입니다. 이 차이에 따라 현재 사용 중인 제품에서 위 설정을 할 수 있는지가 결정되므로, 구성 파일을 수정하기 전에 확인해야 합니다. CLI 페이지에서는 구성 파일을 건드리지 말라고 명시합니다.

CLI는 자체 릴리스 노트와 공식 문서의 설명이 일치하지 않아 혼동을 주는 제품입니다. 2026년 9월 11일자 릴리스 노트 1.1.50에는 “Personal 에디션 사용자는 이제 Custom 페이지에서 사용자 지정 URL 엔드포인트를 사용하는 BYOK 모델을 중앙에서 구성하고 관리할 수 있습니다”라고 되어 있습니다. 하지만 그 이후에도 남아 있는 사용자 지정 모델 페이지에서는 대신 카탈로그를 설명합니다. “사용 가능한 공급자, 모델, 인증 정보 필드는 현재 계정에서 이용할 수 있는 BYOK 카탈로그에 따라 결정됩니다.” 이 두 자료와 IDE 페이지 모두 Individual 플랜을 기능 사용 조건으로 둡니다. 따라서 Custom 탭이 없거나 엔드포인트 필드가 보이지 않는다면, 확인할 것은 구성 파일이 아니라 계정의 플랜과 해당 계정의 카탈로그에서 제공하는 항목입니다. CLI 페이지에서는 구성 파일을 직접 편집하지 말라고 안내하며, 어차피 이 파일은 카탈로그에서 다시 생성됩니다.