opencode

opencode.json에 하나의 제공자 블록 — 채팅 완성에는 @ai-sdk/openai-compatible, /v1/responses 표면이 필요할 때는 @ai-sdk/openai

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": { "context": 200000, "output": 64000 }
        },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
      }
    }
  }
}

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 환경 변수로 내보내세요: export KUNAVO_API_KEY=sk-kn-...
3. 공급자 블록을 opencode.json에 추가하세요. 모든 프로젝트에 적용하려면 전역 구성인 ~/.config/opencode/opencode.json을 사용하고, 이 저장소에만 적용하려면 프로젝트 루트의 파일을 사용합니다.
4. opencode을 시작하고 모델 목록에서 모델을 선택하세요. 공급자는 지정한 name 아래에 표시됩니다.
5. 나중에 모델을 추가하려면 models 아래에 키를 하나 더 추가하세요. ID는 와이어로 전송되고, name은 라벨로만 사용됩니다.

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

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

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

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