Roo Code dengan Claude API—pengaturan penyedia dan model untuk setiap mode

Roo Code adalah agen coding otonom sumber terbuka untuk VS Code — sebuah fork dalam keluarga Cline, yang dibedakan oleh sistem mode dan perutean model per mode. Roo Code tidak menyediakan model sendiri, sehingga memerlukan kunci API. Panduan ini menjelaskan konfigurasi persis untuk menjalankan Claude di Roo Code dengan satu kunci sk-kn- dengan harga sekitar 30% di bawah harga daftar Anthropic untuk model utama, cara menggunakan profil konfigurasi agar biaya model kuat hanya digunakan saat benar-benar memberi manfaat, biaya sebuah sesi, serta perbandingan yang jujur dengan pemanggilan langsung ke Anthropic.

Mengapa Roo Code memerlukan kunci API

Setiap langkah yang dilakukan Roo Code — membaca file, menulis diff, menjalankan perintah, membaca hasil — merupakan panggilan model yang ditagihkan per token. Langganan claude.ai Pro atau Max tidak mencakupnya: paket chat dan akses API adalah produk terpisah, dan Roo Code berbicara dengan API. Karena loop agen mengirim ulang konteks tugas yang terus bertambah pada setiap langkah, tarif per token adalah tuas terbesar biaya sesi — begitulah cara kerja gateway: pay-as-you-go mulai dari top-up $10, satu kunci yang juga dapat mengakses GPT, dan saldo yang tidak pernah kedaluwarsa.

Konfigurasi — tiga kolom

Buka Settings → Providers dan atur provider API ke OpenAI Compatible. Tiga nilai:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...              # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Buat kunci di dasbor setelah mendaftar dan melakukan top-up — kunci hanya ditampilkan sekali, jadi segera simpan; dokumen kunci Claude API membahas rotasi dan batas pengeluaran. Jika Roo Code meminta metadata model seperti context window atau batas output, ambil nilainya dari halaman model — context window yang terlalu rendah membuatnya terpotong lebih awal dari yang diperlukan.

Uji dengan sesuatu yang kecil sebelum membiarkannya mengedit kode. 401 di sini hampir selalu berarti masalah kunci; 404 hampir selalu berarti base URL atau slug model yang tidak ada — Kunavo mencocokkan slug secara persis dan tidak membuat alias untuk nama dengan akhiran tanggal, sehingga claude-sonnet-4-5-20250929 mengembalikan 404 sedangkan claude-sonnet-4-6 berhasil diproses.

Mode dan profil konfigurasi — tuas biaya

Roo Code menyediakan beberapa mode bawaan — Code, Architect, Ask dan Debug — serta mode khusus yang Anda definisikan sendiri. Hal yang penting terkait biaya adalah Roo Code menyimpan profil konfigurasi API bernama dan mengingat profil terakhir yang Anda gunakan pada setiap mode. Jadi model menjadi properti mode, bukan sesuatu yang harus Anda ingat untuk diubah:

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

Alasan ini berhasil adalah karena mode memiliki profil token yang sangat berbeda. Architect terdiri dari sejumlah kecil giliran yang berat dalam penalaran, di mana kualitas model menentukan apakah dua puluh langkah berikutnya akan produktif — hanya sebagian kecil dari total token, sehingga model kuat hanya menimbulkan sedikit biaya absolut. Code terdiri dari banyak langkah mekanis, yang masing-masing mengirim ulang konteks, sehingga tarif per token terakumulasi di sini. Ask biasanya sekali jalan dan sama sekali tidak memerlukan model frontier.

Perhitungan lengkapnya ada di bawah: tiga langkah Architect dengan Opus 5 ditambah tujuh belas langkah Code dengan Sonnet 5 berjumlah sekitar $1,06 dibandingkan $0,87 untuk proses yang seluruhnya menggunakan Sonnet — kira-kira 23% lebih mahal untuk perencanaan yang jauh lebih baik, dan jauh lebih murah daripada menjalankan semuanya dengan Opus.

Rute Anthropic native (dan alasan Anda mungkin menginginkannya)

Roo Code juga menyediakan provider native Anthropic dengan kolom base URL khusus. Arahkan ke https://api.kunavo.com — hanya origin, tanpa /v1, karena klien tersebut menambahkan /v1/messages sendiri — untuk menggunakan Messages API native. Menempelkan bentuk /v1 di sini menghasilkan 404 yang tampak seperti model hilang.

Manfaat rute tersebut adalah caching prompt: cache_control diteruskan tanpa diterjemahkan dan input yang di-cache ditagihkan sebesar 10% dari tarif input (cara kerjanya). Pada loop yang mengirim ulang awalan stabil di setiap langkah, ini adalah penghematan terbesar yang tersedia — lebih besar daripada pertukaran model apa pun. Kedua rute dapat digunakan; OpenAI Compatible lebih sederhana untuk memulai, dan berpindah di antara keduanya hanya memerlukan perubahan pengaturan.

Meski begitu, caching prompt itu sendiri tidak memerlukan rute native. Pada prompt yang panjang, Kunavo menetapkan sendiri breakpoint cache pada rute OpenAI Compatible: pada system prompt, pada definisi alat, dan pada pesan terakhir begitu percakapan berisi giliran asisten, yang dalam loop agen berarti setiap langkah setelah langkah pertama. cache_control yang ditetapkan Roo Code di rute itu tetap dipertahankan. Pada rute native, permintaan diteruskan persis seperti yang dikirim Roo Code dan tidak ada breakpoint yang ditambahkan, sehingga apa yang di-cache bergantung pada breakpoint yang ditetapkan Roo Code.

Model Claude mana yang harus diikat ke setiap mode

Semua konfigurasi ini menggunakan kunci dan endpoint yang sama — hanya slug model yang berbeda, sehingga profil dapat diubah dengan satu kata. Tarif lengkap per model dibandingkan harga daftar resmi Anthropic tersedia di daftar harga Anthropic Claude API, dan katalog langsung tersedia di halaman harga.

Roo Code di Kunavo versus pemanggilan langsung ke Anthropic

Perbandingan yang jujur, termasuk kondisi ketika pemanggilan langsung merupakan pilihan yang lebih baik:

Baris kapasitas tersebut adalah tradeoff yang sebenarnya, dinyatakan secara terus terang. Jika Anda memerlukan kuota yang dijamin, SLA kontraktual, atau hubungan pengadaan dengan vendor model, gunakan akses langsung — itulah yang dibeli oleh selisih harga. Untuk pengembang individu atau tim kecil yang menjalankan Roo Code, tradeoff biasanya justru mengarah sebaliknya.

Biaya sebenarnya sebuah sesi Roo Code

Alat agentik memang haus token: setiap langkah mengirim ulang system prompt, riwayat tugas, dan konteks file terbaru. Angka realistis dengan tarif Kunavo:

Perhitungannya, siap dijalankan:

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One Code-mode step: Roo resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Menekan biaya

1. Mulai tugas baru daripada memperpanjang satu tugas selamanya. Roo Code mengirim ulang seluruh percakapan pada setiap langkah, sehingga satu tugas panjang meningkatkan biaya secara kuadratik. Tugas baru berarti konteks baru yang kecil — kebiasaan dengan dampak terbesar di sini.
2. Ikat profil per mode. Seperti dibahas di atas: ini mengubah perutean model menjadi konfigurasi, bukan sesuatu yang harus Anda ingat di tengah tugas.
3. Gunakan rute Anthropic native untuk caching. Input yang di-cache dengan tarif 10% dari tarif input merupakan penghematan struktural terbesar pada loop yang mengirim ulang awalan stabil.
4. Berikan kunci dengan batas pengeluaran khusus untuk editor. Buat kunci terpisah di dasbor dan periksa penggunaan setelah satu minggu penggunaan nyata — itulah satu-satunya perkiraan jujur tentang biaya yang Anda keluarkan.

Pertanyaan umum