> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Cline에서 BeatAPI 사용하기

> VS Code용 Cline 확장 프로그램이 OpenAI Compatible 제공자를 통해 BeatAPI로 동작하도록 설정합니다.

# Cline에서 BeatAPI 사용하기

Cline은 편집기 안에서 프로젝트 전반의 코드를 작성하고, 명령을 실행하고, 파일을 편집하는 VS Code 확장 프로그램입니다. **OpenAI Compatible** 제공자로 BeatAPI에 연결하며, 필드 세 개만 입력하면 되고 플러그인은 필요 없습니다.

## 사전 준비

1. **Visual Studio Code 설치.**
2. **Cline 확장 프로그램 설치** — Extensions 마켓플레이스(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 "Cline"을 검색하세요.
3. **BeatAPI API 키** — [대시보드 → API Keys](https://beatapi.io/dashboard/apikeys)에서 만드세요.

## 1단계: API 설정 열기

새로 설치하면 Cline에 환영 패널이 표시됩니다. **Use your own API key**를 클릭하세요.

이전에 설정한 적이 있다면 Cline 사이드바 위쪽의 톱니바퀴 아이콘을 클릭하세요.

## 2단계: BeatAPI 설정

**API Configuration**을 펼치고 다음을 입력하세요.

| 설정           | 값                            |
| ------------ | ---------------------------- |
| API Provider | `OpenAI Compatible`          |
| Base URL     | `https://api.beatapi.io/v1`  |
| API Key      | BeatAPI API 키                |
| 모델 ID        | 모델 ID(예: `claude-fable-5-1`) |

**Done**을 클릭하세요. 설정은 자동으로 저장되며 다시 불러오지 않아도 바로 적용됩니다.

> **Note**
>
> **OpenAI**가 아니라 **OpenAI Compatible**을 선택하세요. 일부 Cline 버전은 일반 OpenAI 제공자에서 Base URL 필드를 숨기므로 사용자 지정 기본 URL을 입력할 수 없습니다. OpenAI Compatible 제공자에는 항상 이 필드가 있습니다.

> **Note**
>
> Model ID는 직접 입력하므로 오타가 있으면 검증 오류가 아니라 `not_found`로 나타납니다. [가격 페이지](https://beatapi.io/pricing)나 `GET /v1/models`에서 복사하세요. ID는 대소문자를 구분하며 제조사 접두사가 붙지 않습니다. `anthropic/claude-fable-5-1`이 아니라 `claude-fable-5-1`입니다.

Cline에는 **Verify** 버튼이 있습니다. 작업을 시작하기 전에 사용하세요.

## 3단계: 작업하기

Cline 패널 아래쪽 입력란에 작업을 입력하세요.

```
Create a JavaScript function that validates an email address, with unit tests
```

Cline이 작업을 계획하고 파일을 작성하며, 터미널 명령을 실행하기 전에는 먼저 묻습니다. 편집기에서 코드를 선택하고 마우스 오른쪽 버튼을 클릭하면 **Explain with Cline**과 **Improve with Cline**이 나타납니다.

입력란 아래 버튼이나 설정의 Model ID를 바꿔 모델을 전환하세요. 변경 사항은 바로 적용됩니다.

## 모델

| 모델 ID                       | 추천 용도                    |
| --------------------------- | ------------------------ |
| `claude-fable-5-1`          | 최신 세대. 에이전트 코딩의 기본값      |
| `claude-opus-5`             | 복잡한 아키텍처와 어려운 디버깅        |
| `claude-sonnet-5`           | 더 낮은 비용의 일상 개발           |
| `gpt-5.6-sol`               | OpenAI 계열에서 가장 강력한 코딩 등급 |
| `claude-haiku-4-5-20251001` | 빠르고 저렴한 단계와 간단한 수정       |

계정의 모든 텍스트 모델을 사용할 수 있습니다. 전체 목록은 [텍스트 API](/text-api)를 참고하세요.

## 자주 묻는 질문

### API 키가 유효하지 않다고 표시됨

1. 키를 불필요한 공백 없이 전부 복사했는지 확인하세요.
2. Base URL이 `/v1`을 포함하고 끝에 슬래시가 없는 정확히 `https://api.beatapi.io/v1`인지 확인하세요.
3. [대시보드 → API Keys](https://beatapi.io/dashboard/apikeys)에서 키가 활성 상태인지 확인하세요.

### "Model Not Found"

Model ID가 이 계정에서 유효하지 않습니다. [가격 페이지](https://beatapi.io/pricing)와 철자, 대소문자를 비교하세요.

### 응답이 느림

더 빠른 등급(`claude-haiku-4-5-20251001` 또는 `claude-sonnet-5`)으로 바꾸고 작업 범위를 좁히세요. Cline은 열린 파일과 선택 영역을 컨텍스트로 보내므로, 선택 영역이 작을수록 더 빠르고 저렴합니다.

### 402 insufficient_credits

잔액 부족: 잔액이 0이거나 요청 가격보다 적습니다. 대시보드에서 충전하세요.

### 429 rate_limit_exceeded

키의 요청 속도 한도를 넘었습니다. Cline이 재시도하며, 계속 실패하면 속도를 늦추거나 한도를 높이세요. 분당 한도는 누적 충전액에 따라 올라가며 대시보드에 표시됩니다.

### 비용 관리

* 파일 전체를 보내지 말고 작업이 필요한 코드만 선택하세요.
* 일상적인 수정에는 저렴한 모델을, 어려운 문제에는 상위 모델을 사용하세요.
* [`GET /v1/usage`](/quick-guide)의 `by_api_key` 아래에서, 또는 대시보드에서 키별 내역을 확인하세요.

## 지원

[대시보드](https://beatapi.io/dashboard)에서 지원 티켓을 열고 실패한 응답의 `request_id`를 함께 보내 주세요.