문서

문서

Cline

Cline의 OpenAI Compatible 제공자에는 기본 URL, 키, 모델 ID가 필요합니다. 아래의 가격 필드 값으로 실행 중 작업별 비용을 표시하므로 정확히 입력하는 것이 좋습니다.

Cline의 OpenAI Compatible 제공자는 기본 URL, 키, 모델 ID와 함께 세션 비용을 표시하는 데 사용하는 모델별 가격을 입력받습니다

Cline 설정 ⚙︎
API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model ID       claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        (from the table below)
  Output Price       (from the table below)
Cline은 작업 실행 중 비용을 표시하며, 모델 구성 블록의 Input Price와 Output Price를 사용해 해당 금액을 계산합니다. 엔드포인트에서 요금을 가져오지는 않습니다. 기본값을 그대로 두면 해당 기본값이 가리키는 방향에 따라 표시 금액이 실제 비용보다 높거나 낮게 나옵니다.
기본 URL에 /v1를 포함하세요. Cline은 경로만 덧붙이므로 https://api.kunavo.com는 404를 반환하지만 https://api.kunavo.com/v1는 정상적으로 연결됩니다. 401이 반환되면 URL은 올바르고 키가 잘못된 것입니다.
아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Cline 설정 화면에서 열립니다.

단계별 안내

  1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
  2. Cline 설정 패널(⚙︎ 아이콘)을 열고 API Provider로 OpenAI Compatible를 선택하세요.
  3. Base URL, API Key, Model ID를 입력하세요.
  4. Model Configuration을 펼쳐 컨텍스트 창, 최대 출력 토큰 수, 이미지 지원 여부, 입력 및 출력 가격을 설정하세요.
  5. 작업을 시작하세요. Plan과 Act에서 서로 다른 모델을 사용할 수 있으므로, 모든 편집에 계획 수립 요금을 적용하지 않도록 계획용 모델과 더 저렴한 실행용 모델을 함께 설정하세요.

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

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Cline + Claude 사용 안내에 있습니다.

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

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

# 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 입력/출력Cline에서의 위치
claude-sonnet-5$1.40 / $7.00Act 모드 — 기본 작업 모델
claude-opus-5$3.50 / $17.50Plan 모드 — 나머지 작업의 비용이 계획에 따라 달라지는 모드
claude-haiku-4-5$0.70 / $3.50저렴한 파일 읽기 및 반복적인 파일 검사
gpt-5-6-terra$0.70 / $4.20같은 키를 사용하면서 두 번째 의견을 구할 다른 모델 계열
월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

사용자 지정 OpenAI 호환 API로 Cline을 사용하려면 어떻게 해야 하나요?

Cline 설정 패널에서 API Provider로 "OpenAI Compatible"을 선택한 다음 엔드포인트의 Base URL, API Key, 사용할 Model ID를 입력하세요. Cline이 URL에 경로만 덧붙이므로 기본 URL은 /v1 경로를 포함해야 합니다. 실제 모델 제공업체와 관계없이 Cline은 해당 엔드포인트와 OpenAI 와이어 형식으로 통신합니다.

Anthropic API 키 없이 Cline에서 Claude 모델을 사용할 수 있나요?

예. 모델이 OpenAI 호환 엔드포인트를 통해 제공되는 경우 사용할 수 있습니다. Cline은 Model ID를 변경 없이 전송하므로 Claude ID의 해석은 확장 프로그램이 아니라 엔드포인트에서 처리하며, Cline이 보유하는 자격 증명은 엔드포인트의 자격 증명뿐입니다. 하나의 제공자 항목에서 같은 키로 Claude ID와 GPT ID를 사용할 수 있는 것도 이 때문입니다.

Cline의 비용 추정이 잘못된 이유는 무엇인가요?

Cline은 모델 구성 블록의 Input Price 및 Output Price 필드에 직접 입력한 값을 사용해 비용을 계산하며, 이 값은 엔드포인트에서 가져오지 않습니다. 기본값으로 두거나 다른 제공업체의 값을 복사했다면 모든 비용 표시가 그 오류를 그대로 반영합니다. 선택한 모델 ID에 대해 엔드포인트가 실제로 청구하는 요율을 입력하세요.

Cline의 기본 URL은 /v1로 끝나야 하나요?

OpenAI 호환 엔드포인트라면 그렇습니다. Cline은 입력한 기본 URL 뒤에 경로인 /chat/completions를 붙이므로, https://api.example.com/v1은 정상적으로 해석되지만 https://api.example.com을 사용하면 존재하지 않는 경로로 요청을 보냅니다. 404는 기본 URL에 문제가 있음을, 401은 키에 문제가 있음을 나타냅니다.