1. Cline이란 무엇인가
Cline은 VS Code에서 널리 사용되는 오픈 소스 AI 프로그래밍 에이전트로, 코드 베이스를 읽고, 파일을 수정하며, 터미널 명령어를 실행할 수 있습니다. Anthropic, OpenAI, Google(Gemini) 등 다양한 공급자(Provider)를 기본적으로 지원합니다. API Provider를 중계 게이트웨이로 설정하고 sk- 키를 입력하면, 플랫폼 크레딧을 사용하여 Claude/GPT/Gemini를 토큰 기반으로 이용할 수 있습니다.
2. 준비 작업
- 극지 API(极智API) 콘솔에 로그인한 후, 「API 키」 메뉴에서
sk-xxxxxx형식의 키를 생성합니다(한 번만 표시되므로 반드시 저장하세요). - 사용할 모델 슬러그(예:
claude-sonnet-5,gpt-5.4,gemini-3.7-flash)를 확인합니다. - 게이트웨이 주소:
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 파일이나 환경 변수를 사용하시고, 각 도구별로 별도의 키를 생성하여 통계 확인 및 사용량 제한을 설정하는 것을 권장합니다.