홈 → 가이드 → Cline에서 커스텀 API 쓰기: Provider 선택, Base URL, 도구를 잘 다루는 모델

Cline에서 커스텀 API 쓰기: Provider 선택, Base URL, 도구를 잘 다루는 모델

Cline이 API에 요구하는 것은 Base URL, 키, 모델 ID 세 가지뿐입니다. 에이전트가 제대로 돌아가는지를 결정하는 건 따로 있습니다. 모델이 Cline이 정의한 인자 그대로 도구를 호출하느냐입니다. 이 글을 쓰기 전에 6개 모델로 먼저 시험했습니다.

4단계로 연결하기

VS Code에서 Cline 패널을 열고 톱니바퀴 아이콘을 누른 뒤:

1. API Provider에서 OpenAI Compatible(모든 모델 가능)을 고릅니다. Claude라면 Anthropic도 됩니다.
2. 아래 표의 Base URL을 입력합니다. Anthropic은 먼저 Use custom base URL을 체크합니다.
3. 콘솔에서 받은 API 키를 붙여 넣습니다.
4. 표에 적힌 그대로 모델 ID를 입력하고 Done을 누른 뒤 짧은 작업으로 확인합니다.

API Provider	Base URL	Model ID
OpenAI Compatible	https://apiclan.us/v1	gpt-6.1-sol, deepseek-v4-pro, claude-opus-5-5
Anthropic (커스텀 Base URL)	https://apiclan.us	claude-opus-5-5, claude-fable-5-1

두 Base URL은 일부러 다릅니다. OpenAI Compatible은 /chat/completions를 스스로 붙이므로 /v1이 필요하고, Anthropic은 /v1/messages를 스스로 붙이므로 넣으면 안 됩니다. /v1을 잘못 넣는 것이 404의 가장 흔한 원인입니다.

맞는 그룹의 키 쓰기

이 게이트웨이의 API 키는 각각 하나의 모델 그룹에 속하며 그 그룹의 모델만 호출할 수 있습니다. Cline에서 Claude를 쓰려면 Claude 그룹에서, GPT는 GPT 그룹에서, DeepSeek는 DeepSeek 그룹에서 키를 만드세요. Cline에서 모델 계열을 바꿀 때는 키도 함께 바꿉니다.

OpenAI Compatible의 모델 설정

OpenAI Compatible에서는 Cline이 모델 정보를 조회할 수 없어 Model Configuration 항목(컨텍스트 윈도, 최대 출력 토큰, 이미지 지원)이 나타납니다. 컨텍스트 윈도에는 모델의 실제 한도를 넣으세요. 너무 작으면 대화를 일찍 잘라내고, 너무 크면 긴 작업이 압축되지 않고 컨텍스트 길이 오류로 멈춥니다.

실측: 모델이 Cline 방식의 도구를 정확히 호출할까

Cline 에이전트는 read_file 같은 도구로 일합니다. 각 모델에 인자가 path 하나뿐인 read_file 도구를 주고 src/app.ts를 열라고 한 뒤 두 가지를 봤습니다. 스키마에 정의된 인자 이름 그대로 호출했는지, 그리고 첫 응답까지 걸린 시간(스트리밍, 중앙값)입니다. 인자 이름이 바뀌는 것은 에이전트의 한 단계가 뚜렷한 오류 없이 실패하는 흔한 원인입니다.

모델	정확한 도구 호출	첫 응답
claude-opus-5-5	13 / 13	3.3 s
claude-fable-5-1	13 / 13	2.8 s
gpt-6.1-sol	3 / 3	2.6 s
gpt-5.6-sol	3 / 3	3.3 s
deepseek-v4-pro	3 / 3	2.6 s
deepseek-v4.1-flash	3 / 3	1.5 s

모든 모델이 매번 도구를 정확히 호출했습니다. 표본은 작습니다. Claude 두 모델은 각 13회, 나머지는 각 3회이고, gpt-5.6-sol은 한 번 콜드 스타트로 40초가 걸렸으며 표는 중앙값입니다. 2026년 10월 12일 측정.

어떤 모델을 고를까

• 실제 코드베이스에서 긴 에이전트 실행: Anthropic Provider로 claude-opus-5-5. Claude의 기본 프로토콜이며, Cline은 이 경로에서 프롬프트 캐시 표시를 보냅니다.
• 대부분의 작업을 더 싸게: gpt-6.1-sol 또는 claude-fable-5-1.
• 빠르고 싼 작은 수정과 잦은 짧은 단계: 이번 측정에서 가장 빨랐던 deepseek-v4.1-flash.

자주 만나는 오류 4가지

• 401 Unauthorized → 키가 틀렸거나 앞뒤에 공백이 있습니다. 다시 붙여 넣으세요.
• 404 → Provider와 Base URL이 맞지 않습니다. OpenAI Compatible은 /v1을 붙이고, Anthropic은 붙이지 않습니다.
• model_not_found (is not supported by any configured account in this group) → 모델 ID 오타이거나, 키가 속한 그룹에 그 모델이 없습니다.
• 긴 단계에서 타임아웃 → https://api.apiclan.us/v1(Anthropic은 https://api.apiclan.us)를 쓰면 프록시의 100초 제한을 피할 수 있습니다.

다른 도구도 설정하나요? Claude Code의 Base URL, Codex에서 커스텀 API 쓰기를 보세요.

사용 시작하기

구독 없음, 월 최소 사용액 없음, 영업 통화 없음. USDT로 충전하고 쓴 만큼만 지불하세요 — 1 USDT는 2 크레딧의 API 잔액이 됩니다.

30초 빠른 시작 읽기

언어: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

이 페이지의 가격은 실제 과금 데이터에서 자동으로 채워집니다. 제3자 조건은 해당 업체의 공개 문서에서 인용했습니다.