Junie CLI

Junie CLI는 $JUNIE_HOME/models/의 JSON 프로필로 사용자 지정 엔드포인트를 받으며, baseUrl은 완전한 엔드포인트 URL이고 fasterModel은 보조 트래픽의 목적지를 결정합니다

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

단계별 안내

1. /app/keys에서 키를 만들고 복사하세요. 키는 한 번만 표시됩니다. Junie를 시작할 셸에서 KUNAVO_API_KEY로 내보내거나 파일에 키를 직접 입력할 수 있습니다. JetBrains는 “$${...} 참조가 없는 값은 그대로 사용됩니다”라고 안내합니다.
2. 위 JSON을 계정용 $JUNIE_HOME/models/kunavo.json 또는 저장소와 공유할 .junie/models/kunavo.json로 저장하세요. .json를 제외한 파일 이름이 프로필 ID가 되며, 이 ID가 아래 선택기에 custom:kunavo가 표시되게 합니다.
3. id를 실제로 사용할 모델 ID로 설정하세요. 이는 “API 엔드포인트에서 기대하는 모델 식별자”로 설명되어 있으므로 아래 표의 Kunavo 슬러그를 그대로 입력하면 됩니다. ID는 Junie 내부가 아니라 엔드포인트에서 확인됩니다.
4. Junie를 시작하고 프로필을 선택하세요. junie --model custom:kunavo 또는 대화형 세션의 /model 명령을 사용하면 됩니다. 사용자 지정 모델은 “기본 제공 공급자 다음에 모델 선택 목록에 표시됩니다.”
5. 인사말 대신 파일을 수정하는 작업을 맡겨 보세요. Junie는 에이전트형 클라이언트이며 거의 모든 작업에서 도구 호출을 활용하므로, 파일을 읽고 쓰는 첫 실행으로 한 번의 답변보다 훨씬 많은 점을 확인할 수 있습니다.

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

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

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

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

Kunavo가 응답하는 나머지 두 apiType 값

apiType는 벤더가 아니라 요청 형식을 지정하며, Junie가 허용하는 값은 OpenAICompletion, OpenAIResponses, Google, Anthropic 네 가지입니다. Kunavo는 세 가지 경로를 제공하므로 나머지 세 값 중 두 가지에 대응하는 baseUrl가 있습니다. Junie는 경로를 추가하지 않으므로 형식을 바꾸면 같은 편집에서 URL도 변경해야 합니다.

1. "apiType": "OpenAICompletion"와 https://api.kunavo.com/v1/chat/completions 조합 — 위 프로필에 사용된 설정이며, 세 경로 중 가장 널리 사용되는 경로이므로 이 페이지에서 권장합니다.
2. "apiType": "Anthropic"와 https://api.kunavo.com/v1/messages 조합 — Kunavo는 이 경로에서 Messages 형식에 응답합니다.
3. "apiType": "OpenAIResponses"와 https://api.kunavo.com/v1/responses 조합.

세 가지 중 어떤 것이 주어진 모델을 가장 잘 처리하는지는 런타임 테스트로 답할 수 있는 질문이며 문서를 읽는 것만으로는 알 수 없습니다. 따라서 이 페이지는 첫 번째 항목 외에는 순위를 매기지 않습니다. 하나를 선택하고 URL과 apiType를 일치시키세요. 키가 설정된 프로필에서 401이 반환되면 Junie의 헤더를 추측하는 대신 인증 정보를 명시하세요. JetBrains는 apiKey가 “생략되면 요청에 Authorization 헤더가 포함되지 않는다”고만 부정형으로 문서화했으며, 값을 설정했을 때 사용되는 인증 방식을 밝히지 않았습니다. extraHeaders는 “모든 요청에 포함할 추가 HTTP 헤더”로 설명되고 같은 $${VAR} 참조를 지원하므로, "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"}가 명확한 설정 방식입니다.