Cline 중계 API 연동 가이드: VS Code 프로그래밍 에이전트 설정

1. Cline이란 무엇인가

Cline은 VS Code에서 널리 사용되는 오픈소스 AI 프로그래밍 에이전트로, 코드 베이스 읽기, 파일 수정, 터미널 명령 실행 등이 가능하며 Anthropic / OpenAI / Google(Gemini) 등 여러 Provider를 기본적으로 지원합니다. API Provider를 중계 게이트웨이로 설정하고 sk- 키를 입력하면 플랫폼 크레딧을 사용하여 토큰 기반으로 Claude / GPT / Gemini를 호출할 수 있습니다.

2. 준비 작업

1. 극지(极智) API 콘솔에 로그인한 뒤, 'API 키' 메뉴에서 sk-xxxxxx 키를 생성합니다(한 번만 표시되므로 반드시 저장하세요).
2. 사용할 모델 슬러그(예: claude-sonnet-5, gpt-5.5, gemini-3.7-flash)를 확인합니다.
3. 게이트웨이 주소를 확인합니다: https://www.relay-api.com

3. Cline 설정 방법

Cline → 톱니바퀴 아이콘(Settings) → API Provider에서 모델 유형에 따라 선택하세요:

① Anthropic (Claude 호출 시)

Base URL : https://www.relay-api.com
API Key  : sk-본인의 키
Model ID : claude-sonnet-5

② OpenAI Compatible (GPT 호출 시)

Base URL : https://www.relay-api.com/v1
API Key  : sk-본인의 키
Model ID : gpt-5.5

③ Gemini 호출 시: Google Gemini(또는 OpenAI-compatible) Provider를 선택하고, Base URL은 https://www.relay-api.com/v1beta를, Model ID는 gemini-3.7-flash(모델명은 URL 경로를 따름)를 입력합니다.

입력을 마친 후 Connect / Continue를 눌러 검증합니다. Base URL은 위 표의 주소를 사용하세요.

4. 인터페이스 주소 대조표

모델 그룹	본 사이트 주소 (Base URL)	프로토콜
Claude / Anthropic	https://www.relay-api.com	Anthropic Messages
GPT / OpenAI	https://www.relay-api.com/v1	OpenAI Chat Completions
Gemini	https://www.relay-api.com/v1beta	Google generateContent

5. 자주 묻는 질문(FAQ) 및 문제 해결

현상	조치 방법
401 / 403	키가 유효하지 않거나 활성화되지 않음, 또는 잔액 부족. sk- 키가 정확한지 확인하고 충전하세요.
404 / 모델 사용 불가	모델명과 플랫폼 슬러그가 일치하지 않거나 해당 모델이 비활성화됨. 모델 ID를 재확인하세요.
Unknown model	입력한 모델 ID가 정확해야 합니다(대소문자 구분). 모델 목록에서 확인하세요.

보안 권장사항: API 키를 공개 리포지토리에 올리지 말고 .env 파일이나 환경 변수를 사용하세요. 각 도구별로 별도의 키를 생성하면 사용 통계 확인 및 제한 설정이 용이합니다.

Base URL 설명: 본 사이트는 /v1beta/models/...와 /v1beta/v1beta/models/...(및 /v1/...와 /v1/v1/...)를 모두 허용하므로, 클라이언트가 자동으로 /v1이나 /v1beta 경로를 추가하더라도 문제없이 작동합니다. Base URL에 도메인 루트만 입력하거나 전체 경로를 입력해도 모두 사용 가능합니다. 모델 ID는 콘솔의 '토큰' 페이지 우측 상단 '모델 ID'에서 확인 및 복사할 수 있습니다.