Cline nasıl kullanılır — Plan ve Act için modelleri ayırma ve görev başına maliyeti hesaplama

Cline, VS Code gibi editörlerde çalışan açık kaynaklı bir yapay zekâ kodlama aracısıdır.Kullanım 3 aşamalıdır — eklentiyi kurmak, API sağlayıcısını ve anahtarı ayarlamak (Cline'ın kendisi model içermez), ardından Plan modunda plan yapıp Act modunda uygulamak. Maliyeti belirleyen, Plan ve Act'e atadığınız modellerdir. Ayarlarda “Use different models for Plan and Act” seçeneğini açıp aynı anahtarla Plan'e claude-opus-5, Act'e claude-haiku-4-5 atarsanız 20 adımlık bir görev, tamamen Opus 5 kullanıldığında yaklaşık $2,17 iken yaklaşık $0,69 olur (Kunavo fiyatlarıyla hesaplanmıştır).

Japonca açıklama yazılarının çoğu kurulumu ve ilk isteği anlatıp biter; model de ücretsiz bir modele veya tek bir ücretli modele sabitlenir. Bu sayfa bir sonraki adımı da kapsar: Plan ve Act için farklı modeller ayarlamayı ve tek bir görevin maliyetini hesaplamayı, tüm süreçte tek bir anahtar kullanarak gösterir.

Cline nedir — Plan ve Act olmak üzere 2 mod

Cline, dosyaları okuyan, değişiklik farkları öneren, terminalde komut çalıştıran, sonuçları okuyup yeniden düzeltmeler yapan bir döngü yürüten bir ajandır. İki modu vardır ve Cline'ın resmi belgelerinde bunlar şöyle ayrılır:

• Plan modu: Kod tabanını okur, arar ve yaklaşımı görüşür. Dosyaları değiştiremez veya komut çalıştıramaz.
• Act modu: Plan'deki konuşma bağlamını koruyarak dosyaları değiştirir ve komutları çalıştırır.

Bu ayrım doğrudan maliyet ayrımına dönüşür. Plan'de gidiş geliş daha azdır; buradaki kararların kalitesi, sonraki on küsur adımı etkiler. Act'te gidiş geliş daha fazladır ve görev bağlamı her seferinde yeniden gönderildiği için token fiyatı birikir. Plan'e güçlü, Act'e ucuz bir model — Cline belgeleri de planlama için güçlü akıl yürütmeye sahip, uygulama için hızlı bir model eşleşmesini önerir.

Kurulum ve ilk ayarlar

1. VS Code'da uzantı görünümünü (Ctrl / Cmd + Shift + X) açın, “Cline”ı aratıp yükleyin. Cursor, Windsurf ve JetBrains IDE'lerine de kurulabilir.
2. Kenar çubuğundan Cline'ı açın ve ayarlarda (⚙︎) API Provider olarak “OpenAI Compatible”ı seçin.
3. Base URL, API Key ve Model ID'yi girin; Model Configuration alanlarını (bağlam uzunluğu, maksimum çıktı, görsel desteği, giriş ve çıkış fiyatları) doldurun.

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'yi /v1 dahil olacak şekilde girin.Cline bunun sonuna yalnızca yolu ekler; /v1 olmazsa 404 alırsınız. 401 dönüyorsa URL doğrudur, anahtar yanlıştır. Düzenleme yetkisini hemen vermek yerine önce “bu dosyayı açıkla” gibi küçük bir istekle bağlantıyı denemek daha güvenlidir. Anahtarı /app/keys adresinden oluşturun; yalnızca bir kez görüntülendiği için hemen kaydedin.

Model Configuration içindeki Input Price / Output Price, Cline'ın görev sırasında gösterdiği maliyetin hesaplama temelidir. Bunlar uç noktadan otomatik alınmaz; boş veya varsayılan kalırsa gösterilen maliyet yanlış olur. Kullandığınız modelin 1M token başına fiyatını girin. Ayar alanlarının listesi Cline entegrasyon belgelerinde bulunur.

Plan ve Act için model ayırma

Ayarlarda “Use different models for Plan and Act” seçeneğini işaretlediğinizde Plan ve Act için farklı modeller seçebilirsiniz. Base URL ve anahtar her ikisinde de aynıdır; değişen yalnızca Model ID ve fiyatlardır.

[✓] 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'e Opus 5 koymanın nedeni basit: Plan toplam tokenların çok küçük bir bölümünü kullanır; ancak burada yanlış yönlendirme yapılırsa Act adımları tamamen boşa gidebilir. Act'e Haiku 4.5 koymanın nedeni, plan somutsa geri kalan işin düzenleme ve çalıştırma döngüsünden ibaret olması ve token fiyatının en çok burada etkili olmasıdır.

Plan Sonnet 5 olduğunda bir adım yaklaşık $0,0434, Opus 5 olduğunda ise yaklaşık $0,11 tutar.Claude Sonnet 5'in fiyatı 1 milyon token başına $1,40 / $7,00.

Act takılırsa yalnızca o görev için Act'i Opus 5'e yükseltin. Aynı hatayı iki kez tekrarlamak geçiş işaretidir. Haiku ile zorlamaya çalışıp adım sayısını artırmak sonunda daha pahalıya gelir. Ayarlarda yalnızca Model ID'yi değiştirmeniz yeterlidir; anahtar ve uç nokta aynı kalır.

Tek bir görevin maliyetini hesaplama

Cline her adımda sistem istemini, görev geçmişini ve okunan dosyaları yeniden gönderir; bu nedenle maliyet zamana göre değil, adım sayısına göre belirlenir. Bu sitedeki diğer fiyat sayfalarında olduğu gibi hesaplama, bir adım için 25.000 giriş / 1.200 çıkış tokenı ve bir görev için 20 adım (Plan 3 + Act 17) varsayar.

Plan ve Act'i ayırdığınızda, her şeyi Opus 5 ile çalıştırmanın maliyetine göre yaklaşık %32 oranında bir maliyetle planlama kalitesini Opus 5 düzeyinde koruyabilirsiniz. Her şeyi Haiku ile çalıştırmak daha da ucuz olur; ancak planlama hatalarının işi yeniden yapmayı gerektirebileceğini düşündüğünüzde, aradaki $0,26 fark Plan için bir sigorta primi olarak oldukça düşük sayılır. Hesaplamayı kontrol etmek için gereken kodun tamamı budur.

# 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

Model seçimi

GPT-5.6 Sol, istem 272K tokenı aşarsa tüm isteği 2 kat giriş ve 1,5 kat çıkış fiyatıyla ücretlendirir. Plan için kullanacaksanız Context Window'u 272K'nın altında tutmak güvenlidir. Opus ile Sonnet arasındaki farkı daha ayrıntılı öğrenmek için Claude Opus ile Sonnet arasındaki fark sayfasına, tüm Claude modellerinin fiyatları için Claude fiyatları sayfasına bakın.

Maliyeti azaltan 5 alışkanlık

1. Görevi uzatmayın; bölüp yeni bir görev başlatın. Her adımda tüm geçmiş yeniden gönderildiği için uzun görevlerde tek bir adım daha pahalı olur. En etkili alışkanlık budur.
2. Prompt önbelleğini kullanacaksanız Anthropic sağlayıcısı üzerinden bağlanın. API Provider'ı “Anthropic” yapın, “Use custom base URL” seçeneğini işaretleyin ve https://api.kunavo.com adresini belirtin (/v1 eklemeyin; istemci /v1/messages ekler). Claude önbellek okumaları giriş fiyatının %10'u, yazmaları ise giriş fiyatının 1,25 katıdır. Mekanizma önbellek belgelerinde açıklanır. OpenAI Compatible'da kalsanız bile istem önbelleği çalışır. İstem uzunsa Kunavo, sistem istemine ve araç tanımlarına, konuşmada bir asistan turu varsa son mesaja da önbellek kesme noktalarını kendisi ayarlar. Bir ajan döngüsünde bu, ikinci adımdan itibaren her adımdır. Cline'ın eklediği cache_control de olduğu gibi kalır. Anthropic sağlayıcısı üzerinden istek, Cline'ın gönderdiği gibi iletilir ve kesme noktası eklenmez; bu nedenle neyin önbelleğe alınacağı, Cline'ın ayarladığı kesme noktalarına bağlıdır.
3. Kuralları .clinerules/ içine yazın.Proje köküne yerleştirilen bu Markdown dosyası tüm konuşmalar için geçerli talimatlar sağlar. Her isteğe eklendiğinden kısa tutun ve yalnızca kuralları yazın (Cline kuralları belgeleri).
4. Otomatik onayı yalnızca okuma işlemleriyle sınırlayın.Auto Approve ile dosya okuma gibi işlemlere izin vermek onay sayısını azaltır. Cline belgelerinin de tehlikeli olduğunu açıkça belirttiği tüm işlemleri otomatik onaylayan YOLO modu yalnızca geçici ortamlarda kullanılmalıdır. Değişiklikler Checkpoints ile geri alınabilir.
5. Cline'a özel bir anahtar oluşturun ve aylık üst sınır belirleyin./app/keys bölümünde anahtar başına aylık kullanım üst sınırı (ulaşıldığında 402 döner) ve IP izin listesi ayarlanabilir. Editörü durdurmak istediğinizde yalnızca bu anahtarı devre dışı bırakmanız yeterlidir.

Açık konuşalım — abonelik veya doğrudan sözleşme ne zaman uygundur?

Claude Pro / Max aboneniz varsa Cline'ın “Claude Code” sağlayıcısını seçmek de mümkündür.Yüklü Claude Code CLI üzerinden token başına ücret yerine abonelik kullanım kotasını kullanırsınız. Cline belgelerine göre bu yöntemde görsel yükleme ve prompt önbelleğe alma sınırlıdır ve yanıtlar token bazında akış olarak iletilmeyebilir. Kullanım kotası sohbet ve Claude Code ile ortaktır; ayrıntılar için Claude Pro sınırlamalarına bakın.

API anahtarıyla kullanırken Kunavo paylaşılan kapasite üzerinde çalışır; özel kota veya sözleşmeye bağlı SLA yoktur. Garantiye ihtiyaç duyan ekipler Anthropic ile doğrudan sözleşme yapmalıdır. Bireyler veya küçük ekipler Cline çalıştıracaksa, Plan ve Act'i tek anahtarla ayıran kullandıkça ödeme modeli uygundur.

Roo Code kullanımıyla farklar

Roo Code, Cline'dan türetilmiş bir eklentidir ve OpenAI Compatible ayarlarını (Base URL, anahtar, model) aynen kullanır. Fark, mod yapısındadır: Plan / Act yerine Architect, Code, Ask ve Debug gibi modlar bulunur ve her moda ayrı API ayar profili atanır. Architect'e Opus 5, Code'a ucuz bir model atama yaklaşımı aynen geçerlidir. Adımlar Roo Code ayarları belgelerinde ve Roo Code + Claude API (İngilizce) sayfasında bulunur.

İngilizce daha ayrıntılı açıklama için Cline + Claude API kılavuzuna, terminal tabanlı aracılarla karşılaştırma için Cline ve Claude Code karşılaştırmasına ve Claude Code kullanımına, tüm modellerin fiyatları için de fiyatlandırma sayfasına bakın.

Sık sorulan sorular