Cline 사용법 — Plan과 Act에 모델을 나누고 작업 하나의 비용까지 계산하기

Cline은 VS Code 등의 편집기에서 실행되는 오픈 소스 AI 코딩 에이전트입니다.사용법은 3단계입니다. 확장 기능 설치, API 제공업체와 키 설정(Cline 자체에는 모델이 없음), Plan 모드에서 계획을 세운 후 Act 모드에서 실행입니다. 비용은 Plan과 Act에 할당하는 모델이 결정합니다. 설정에서 „Use different models for Plan and Act“를 켜고 같은 키로 Plan에 claude-opus-5, Act에 claude-haiku-4-5를 할당하면 20단계 작업의 비용이 전부 Opus 5를 사용할 때의 약 $2.17에서 약 $0.69로 내려갑니다(Kunavo 요율 기준).

일본어 설명 글 대부분은 설치와 첫 요청에서 끝나며, 모델은 무료 모델이나 하나의 유료 모델로 고정되어 있습니다. 이 페이지는 그다음 단계인 Plan과 Act에 모델을 나누는 설정과 작업 하나의 비용 계산까지 하나의 키로 다룹니다.

Cline이란 — Plan과 Act의 두 모드

Cline은 파일을 읽고, 차이를 제안하고, 터미널에서 명령을 실행하고, 그 결과를 읽은 다음 다시 수정하는 루프를 실행하는 에이전트입니다. 모드는 두 가지이며, Cline 공식 문서에서는 다음과 같이 구분합니다.

• Plan 모드: 코드베이스를 읽고 검색하며 방향을 논의합니다. 파일을 변경하거나 명령을 실행할 수 없습니다.
• Act 모드: Plan 대화의 컨텍스트를 이어받아 파일을 변경하고 명령을 실행합니다.

이 구분은 그대로 비용의 구분이 됩니다. Plan은 왕복이 적지만 여기서 판단의 품질이 이후 수십 단계에 영향을 줍니다. Act는 왕복이 많고 매번 작업 컨텍스트를 다시 보내므로 토큰 단가가 누적됩니다. Plan에는 강력한 모델을, Act에는 저렴한 모델을 배정하세요. Cline 문서 자체도 계획에는 추론 능력이 강한 모델, 구현에는 빠른 모델을 조합하는 방식을 제시합니다.

설치 및 초기 설정

1. VS Code에서 확장 기능 보기(Ctrl / Cmd + Shift + X)를 열고 „Cline“을 검색해 설치하세요. Cursor, Windsurf, JetBrains IDE 등에도 설치할 수 있습니다.
2. 사이드바에서 Cline을 열고 설정(⚙︎)의 API Provider에서 „OpenAI Compatible“을 선택하세요.
3. Base URL, API Key, Model ID를 입력하고 Model Configuration의 항목(컨텍스트 길이, 최대 출력, 이미지 지원, 입력 및 출력 단가)을 채우세요.

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

Base URL은 /v1까지 입력하세요.Cline은 그 뒤에 경로만 덧붙이므로 /v1가 없으면 404가 발생합니다. 401이 반환되면 URL은 맞고 키가 잘못된 것입니다. 바로 편집을 맡기지 말고 먼저 „이 파일을 설명해 줘“와 같은 작은 요청으로 연결을 확인하는 것이 안전합니다. 키는 /app/keys에서 발급하며 한 번만 표시되므로 즉시 저장하세요.

Model Configuration의 Input Price / Output Price는 Cline이 작업 중 표시하는 비용의 계산 기준입니다. 엔드포인트에서 자동으로 가져오지 않으므로 비워 두거나 기본값으로 두면 표시 비용이 실제와 달라집니다. 사용할 모델의 토큰 1M개당 단가를 입력하세요. 설정 항목 목록은 Cline 연동 문서에 있습니다.

Plan과 Act에 모델 나누기

설정에서 „Use different models for Plan and Act“를 선택하면 Plan과 Act에서 서로 다른 모델을 선택할 수 있습니다. Base URL과 키는 양쪽에서 동일하고 Model ID와 단가만 변경합니다.

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

Plan에 Opus 5를 두는 이유는 간단합니다. Plan은 전체 토큰의 극히 일부만 사용하지만, 여기서 방향을 잘못 잡으면 Act 단계 전체가 낭비됩니다. Act에 Haiku 4.5를 두는 이유는 계획이 구체적이면 나머지는 편집과 실행의 반복이고, 이 부분에서 토큰 단가가 가장 크게 영향을 미치기 때문입니다.

Plan을 Sonnet 5로 설정한 경우 1단계는 약 $0.0434이며, Opus 5의 경우 약 $0.11입니다.Claude Sonnet 5는 토큰 1M개당 $1.40 / $7.00입니다.

Act가 막히면 해당 작업에서만 Act를 Opus 5로 올리세요.같은 오류를 두 번 반복하면 전환 신호입니다. Haiku로 억지로 진행하다 단계 수가 늘어나는 편이 결국 더 비쌉니다. 설정에서 Model ID 하나만 변경하면 되며 키와 엔드포인트는 그대로입니다.

작업 하나의 비용 계산

Cline은 각 단계마다 시스템 프롬프트, 작업 기록, 읽은 파일을 다시 보내므로 비용은 시간이 아니라 단계 수로 결정됩니다. 이 사이트의 다른 요금 페이지와 마찬가지로 한 단계는 입력 25,000 / 출력 1,200토큰, 작업 하나는 20단계(Plan 3 + Act 17)로 계산합니다.

Plan과 Act를 나누면 전부 Opus 5로 실행할 때의 약 32% 비용으로 계획의 품질은 Opus 5로 유지할 수 있습니다. 전부 Haiku를 사용하면 더 저렴하지만, 계획 오류로 다시 작업해야 할 수 있다는 점을 고려하면 차액 $0.26는 Plan 보험료로서 더 저렴한 편입니다. 검산용 코드는 다음뿐입니다.

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

모델 선택 방법

GPT-5.6 Sol은 프롬프트가 272K 토큰을 초과하면 전체 요청에 입력 2배·출력 1.5배 요금을 적용합니다. Plan에 사용한다면 Context Window를 272K 미만으로 설정하는 것이 안전합니다. Opus와 Sonnet의 차이를 더 자세히 알고 싶다면 Claude Opus와 Sonnet의 차이, Claude 전체 모델의 단가는 Claude 요금에 정리되어 있습니다.

비용을 줄이는 5가지 습관

1. 작업을 늘이지 말고 나누어 새 작업으로 시작하세요.매 단계마다 전체 기록을 다시 보내므로 작업이 길수록 단계 하나의 비용이 높아집니다. 가장 효과적인 습관입니다.
2. 프롬프트 캐시를 사용하려면 Anthropic 제공업체를 통해 사용하세요.API Provider를 „Anthropic“으로 설정하고 „Use custom base URL“을 선택한 뒤 https://api.kunavo.com를 지정하세요(/v1는 붙이지 않습니다. 클라이언트가 /v1/messages를 덧붙입니다). Claude 캐시 읽기는 입력 단가의 10%, 쓰기는 입력 단가의 1.25배입니다. 작동 방식은 캐시 문서에서 확인하세요.
3. 규칙은 .clinerules/에 작성하세요.프로젝트 루트에 두는 Markdown 파일로 모든 대화에 적용되는 지침이 됩니다. 모든 요청에 포함되므로 짧게, 규칙만 작성하세요(Cline 규칙 문서).
4. 자동 승인은 읽기 작업에만 사용하세요.Auto Approve로 파일 읽기 등을 허용하면 확인이 줄어듭니다. 모든 작업을 자동 승인하는 YOLO 모드는 Cline 문서 자체에서도 위험하다고 명시하므로 일회용 환경에서만 사용하세요. 변경 사항은 Checkpoints로 되돌릴 수 있습니다.
5. Cline 전용 키를 만들고 월 한도를 정하세요./app/keys에서는 키별 월간 사용 한도(도달하면 402 반환)와 IP 허용 목록을 설정할 수 있습니다. 편집기를 중지하고 싶을 때도 해당 키만 비활성화하면 됩니다.

솔직하게 말하면 — 구독이나 직접 계약이 적합한 경우

Claude Pro / Max를 구독 중이라면 Cline의 „Claude Code“ 제공업체를 선택할 수도 있습니다.설치된 Claude Code CLI를 통해 토큰 과금이 아니라 구독 사용량을 사용하는 방식입니다. Cline 문서에 따르면 이 방식에서는 이미지 업로드와 프롬프트 캐시가 제한되고 응답이 토큰 단위로 스트리밍되지 않을 수 있습니다. 사용량 한도는 채팅 및 Claude Code와 공유되므로 자세한 구조는 Claude Pro 제한을 참조하세요.

API 키를 사용하는 경우 Kunavo 경유는 공유 용량으로 운영되며 전용 할당량이나 계약상 SLA가 없습니다.보장이 필요한 팀은 Anthropic과 직접 계약하세요. 개인이나 소규모 팀이 Cline을 실행하는 용도라면 하나의 키로 Plan과 Act를 나눌 수 있는 종량제가 적합합니다.

Roo Code 사용법과의 차이

Roo Code는 Cline에서 파생된 확장 기능으로, OpenAI Compatible 설정(Base URL, 키, 모델)을 그대로 사용할 수 있습니다. 차이는 모드 구성입니다. Plan / Act 대신 Architect, Code, Ask, Debug 등의 모드가 있으며 모드별로 API 설정 프로필을 할당합니다. Architect에는 Opus 5, Code에는 저렴한 모델을 배정하는 동일한 방식을 그대로 사용할 수 있습니다. 절차는 Roo Code 설정 문서와 Roo Code + Claude API(영문)에 나와 있습니다.

영문으로 된 더 자세한 설명은 Cline + Claude API 가이드, 터미널형 에이전트와 비교하려면 Cline과 Claude Code 비교 및 Claude Code 사용법을, 전체 모델의 단가는 요금 페이지를 확인하세요.

자주 묻는 질문