Cline에서 BeatAPI 사용하기
Cline에서 BeatAPI 사용하기
Cline은 편집기 안에서 프로젝트 전반의 코드를 작성하고, 명령을 실행하고, 파일을 편집하는 VS Code 확장 프로그램입니다. OpenAI Compatible 제공자로 BeatAPI에 연결하며, 필드 세 개만 입력하면 되고 플러그인은 필요 없습니다.
사전 준비
- Visual Studio Code 설치.
- Cline 확장 프로그램 설치 — Extensions 마켓플레이스(
Ctrl+Shift+X/Cmd+Shift+X)에서 “Cline”을 검색하세요. - BeatAPI API 키 — 대시보드 → API Keys에서 만드세요.
1단계: API 설정 열기
새로 설치하면 Cline에 환영 패널이 표시됩니다. Use your own API key를 클릭하세요.
이전에 설정한 적이 있다면 Cline 사이드바 위쪽의 톱니바퀴 아이콘을 클릭하세요.
2단계: BeatAPI 설정
API Configuration을 펼치고 다음을 입력하세요.
Done을 클릭하세요. 설정은 자동으로 저장되며 다시 불러오지 않아도 바로 적용됩니다.
OpenAI가 아니라 OpenAI Compatible을 선택하세요. 일부 Cline 버전은 일반 OpenAI 제공자에서 Base URL 필드를 숨기므로 사용자 지정 기본 URL을 입력할 수 없습니다. OpenAI Compatible 제공자에는 항상 이 필드가 있습니다.
Model ID는 직접 입력하므로 오타가 있으면 검증 오류가 아니라 not_found로 나타납니다. 가격 페이지나 GET /v1/models에서 복사하세요. ID는 대소문자를 구분하며 제조사 접두사가 붙지 않습니다. anthropic/claude-fable-5-1이 아니라 claude-fable-5-1입니다.
Cline에는 Verify 버튼이 있습니다. 작업을 시작하기 전에 사용하세요.
3단계: 작업하기
Cline 패널 아래쪽 입력란에 작업을 입력하세요.
Cline이 작업을 계획하고 파일을 작성하며, 터미널 명령을 실행하기 전에는 먼저 묻습니다. 편집기에서 코드를 선택하고 마우스 오른쪽 버튼을 클릭하면 Explain with Cline과 Improve with Cline이 나타납니다.
입력란 아래 버튼이나 설정의 Model ID를 바꿔 모델을 전환하세요. 변경 사항은 바로 적용됩니다.
모델
계정의 모든 텍스트 모델을 사용할 수 있습니다. 전체 목록은 텍스트 API를 참고하세요.
자주 묻는 질문
API 키가 유효하지 않다고 표시됨
- 키를 불필요한 공백 없이 전부 복사했는지 확인하세요.
- Base URL이
/v1을 포함하고 끝에 슬래시가 없는 정확히https://api.beatapi.io/v1인지 확인하세요. - 대시보드 → API Keys에서 키가 활성 상태인지 확인하세요.
”Model Not Found”
Model ID가 이 계정에서 유효하지 않습니다. 가격 페이지와 철자, 대소문자를 비교하세요.
응답이 느림
더 빠른 등급(claude-haiku-4-5-20251001 또는 claude-sonnet-5)으로 바꾸고 작업 범위를 좁히세요. Cline은 열린 파일과 선택 영역을 컨텍스트로 보내므로, 선택 영역이 작을수록 더 빠르고 저렴합니다.
402 insufficient_credits
잔액 부족: 잔액이 0이거나 요청 가격보다 적습니다. 대시보드에서 충전하세요.
429 rate_limit_exceeded
키의 요청 속도 한도를 넘었습니다. Cline이 재시도하며, 계속 실패하면 속도를 늦추거나 한도를 높이세요. 분당 한도는 누적 충전액에 따라 올라가며 대시보드에 표시됩니다.
비용 관리
- 파일 전체를 보내지 말고 작업이 필요한 코드만 선택하세요.
- 일상적인 수정에는 저렴한 모델을, 어려운 문제에는 상위 모델을 사용하세요.
GET /v1/usage의by_api_key아래에서, 또는 대시보드에서 키별 내역을 확인하세요.
지원
대시보드에서 지원 티켓을 열고 실패한 응답의 request_id를 함께 보내 주세요.