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) 콘솔에 로그인한 후, 「API 키」 메뉴에서 sk-xxxxxx 형식의 키를 생성합니다(한 번만 표시되므로 반드시 저장하세요).
2. 사용할 모델 슬러그(예: claude-sonnet-5, gpt-5.4, 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.4

③ 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. 자주 묻는 문제 해결

현상	조치
401 / 403	키가 유효하지 않거나, 활성화되지 않았거나 잔액이 부족한 경우입니다. sk- 키가 정확한지 확인하고 충전하세요.
404 / 모델 이용 불가	모델명이 플랫폼 슬러그와 일치하지 않거나 해당 모델이 활성화되지 않은 경우입니다. 모델 ID를 확인하세요.
Unknown model	입력한 모델 ID가 정확해야 합니다(대소문자 구분). 모델 리스트에서 다시 확인하세요.

보안 권장사항: 키를 공개 저장소에 올리지 마십시오. .env 파일이나 환경 변수를 사용하시고, 각 도구별로 별도의 키를 생성하여 통계 확인 및 사용량 제한을 설정하는 것을 권장합니다.