Nanocoder

agents.config.json의 nanocoder.providers 아래 Custom Provider 항목 — name, baseUrl, apiKey, models — 에는 sdkProvider 줄이 필요 없습니다. 기본값이 openai-compatible이기 때문입니다

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

단계별 안내

1. /app/keys에서 키를 만들고 복사하세요. 키는 한 번만 표시됩니다. 파일에 직접 붙여 넣지 말고 KUNAVO_API_KEY로 내보내세요. Nanocoder는 공급자 항목의 모든 문자열을 재귀적으로 처리해 $VAR, ${VAR}, ${VAR:-default}를 치환하고, 작업 디렉터리에서 .env를 읽습니다.
2. Nanocoder에서 /settings providers를 실행하고 Custom Provider를 선택합니다. 마법사에서 Provider name, Base URL, API key (optional), Model names, Request timeout 순서로 묻습니다. 또한 엔드포인트에서 모델 목록을 가져오는 옵션을 제공합니다. Kunavo는 GET /v1/models로 응답하므로 목록을 자동으로 가져올 수 있습니다.
3. 마법사를 건너뛰고 직접 agents.config.json에 위 블록을 작성해도 됩니다. 설정은 파일별로 확인됩니다. 프로젝트 수준 파일에서 nanocoder.providers를 정의하면 해당 블록 전체가 적용되므로 글로벌 구성의 항목이 병합되지 않습니다.
4. 컨텍스트 창을 설정하세요. Nanocoder는 제한값을 /context-max, contextWindows[model], contextWindow, NANOCODER_CONTEXT_LIMIT, models.dev 순서로 확인합니다. Kunavo는 models.dev 공급자가 아니므로 앞의 네 항목 중 하나도 설정하지 않으면 실제 모델의 컨텍스트 창이 아닌 대체값을 기준으로 예산을 계산합니다. 값은 /models에 나와 있습니다.
5. /model를 열고 목록에 입력한 ID 중 하나를 선택하세요. 선택기에는 사용자가 지정한 name 아래에 ID가 표시됩니다. 그런 다음 도구를 호출해야 하는 간단한 작업을 실행하세요. 특정 모델에서 도구 호출 형식이 잘못되어 돌아오면 disableToolModels를 사용해 공급자 전체가 아닌 해당 모델에 대해서만 도구 호출을 비활성화할 수 있습니다.

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

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

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

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