> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cline & Roo Code

> Konfigurasi provider OpenAI Compatible (atau Anthropic dengan base URL kustom) di Cline dan Roo Code untuk memakai model Hostlinku

[Cline](https://cline.bot) - beserta fork-nya **Roo Code** - menyediakan
provider **OpenAI Compatible** yang menerima base URL, API key, dan model ID bebas. Itu jalur
paling sederhana untuk Hostlinku; jalur alternatif lewat provider **Anthropic** dibahas di bawah.
Memakai **Kilo Code**? Lihat panduan khususnya di [Kilo Code](https://docs.hostlinku.com/integrations/kilo-code.md).

### Buka pengaturan provider

Di panel Cline, klik ikon roda gigi (**Settings**) → **API Configuration**.

Saat Cline pertama kali dibuka, ia menampilkan layar *How will you use Cline?* - pilih **Bring my
own API key**, lalu **Continue**.

![Layar awal Cline: opsi Bring my own API key dipilih](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-setup.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=2aefc2fdbd11d1c601ff8dfd45365b43)

### Pilih OpenAI Compatible dan isi

| Field | Nilai |
| - | - |
| **API Provider** | `OpenAI Compatible` |
| **Base URL** | `https://api.hostlinku.com/v1` |
| **API Key** | `sk-…` (API key Hostlinku) |
| **Model ID** | slug dari [katalog](https://docs.hostlinku.com/models.md), mis. `claude-sonnet-4-6` |

![Cline: API Provider OpenAI Compatible dengan Base URL https://api.hostlinku.com/v1](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-openai.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=2f8890c547b571b9a878fd507635d81a)

### (Disarankan) Lengkapi Model Configuration

Buka bagian **Model Configuration** agar Cline mengelola konteks dan harga dengan benar:

* **Supports Images**: centang untuk model bervisi (`claude-sonnet-4-6`, `gpt-5-5`).
* **Context Window Size**: `context_window` dari katalog (mis. `1000000`).
* **Max Output Tokens**: `64000` adalah nilai aman untuk model besar.
* **Input / Output Price**: salin dari `pricing` katalog bila ingin estimasi biaya Cline akurat;
  tagihan sebenarnya tetap yang tercatat di console.

  ![Panel API Configuration Cline lengkap: Base URL Hostlinku, API key, Model ID, Model Configuration](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-byok-openai.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=9b6e74504d9816cb77ca26c9c98b7467)

### Verifikasi

Klik **Done**, kirim satu tugas kecil (*"ringkas README repo ini"*). Request tampil di console →
**Log Permintaan**.

## Mode Plan / Act dengan model berbeda

Cline bisa memakai model berbeda untuk mode **Plan** dan **Act**. Kombinasi hemat yang umum:
**Plan** = `claude-opus-4-6` atau `gpt-5-5` (penalaran), **Act** = `claude-sonnet-4-6` atau
`deepseek-v4-flash` (eksekusi). Aktifkan *"Use different models for Plan and Act modes"* di
pengaturan, lalu isi profil provider yang sama dengan model ID berbeda.

## Alternatif: provider Anthropic

Cline juga punya provider **Anthropic** dengan opsi *Use custom base URL*. Isi
`https://api.hostlinku.com` (tanpa `/v1`) dan API key Hostlinku. Perbedaannya: daftar model pada
provider ini **terbatas pada ID yang dikenal Cline** - pilih model Claude yang slug-nya identik dengan
katalog Hostlinku (mis. `claude-sonnet-4-6`, `claude-haiku-4-5`). Untuk model non-Claude atau slug
yang tidak ada di daftar, pakai **OpenAI Compatible**.

![Cline: provider Anthropic dengan Use custom base URL berisi https://api.hostlinku.com](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/cline-anthropic.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=aef9e9b6ff4d7f2c37eee35c591c6bc1)

Prompt caching

Lewat jalur Anthropic, Cline mengirim `cache_control` dan Hostlinku meneruskannya - token cache
dilaporkan di `cache_read_input_tokens` dan ditagih dengan harga cache model. Lewat jalur OpenAI
Compatible, cache ditangani otomatis oleh model yang mendukungnya.

## Cline CLI

```bash theme={null}
cline auth -p openai -k "$HOSTLINKU_API_KEY" -b https://api.hostlinku.com/v1
cline --model claude-sonnet-4-6 "tambahkan validasi input di handler login"
```

## Troubleshooting

* **`401`** - key salah/dicabut. Di Roo Code pastikan key diisi pada **profil** provider yang sedang
  aktif, bukan profil lain.
* **`404 model_not_found`** - Model ID salah ketik; salin dari `GET /v1/models`.
* **`404` di semua request** - base URL kurang `/v1` (jalur OpenAI) atau malah memakai `/v1` di
  jalur Anthropic. Bandingkan dengan screenshot di atas.
* **Respons kosong di Act mode** - model tanpa *tool calling*. Gunakan model dari rekomendasi di
  [Ikhtisar](https://docs.hostlinku.com/integrations.md).
* **Konteks cepat habis** - isi *Context Window Size* sesuai katalog agar Cline memangkas riwayat
  dengan benar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.