Ikhtisar Integrasi

Pakai Hostlinku di Claude Code, Codex CLI, Cursor, Zed, Cline, Continue, OpenCode, Aider, dan OpenAI Agents SDK — cukup ganti base URL, tanpa mengubah cara kerja tool

Hampir semua coding agent dan IDE AI modern bisa diarahkan ke provider lain lewat base URL kustom. Karena Hostlinku berbicara tiga protokol sekaligus — OpenAI Chat Completions, OpenAI Responses, dan Anthropic Messages — kamu bisa memakai satu API key dan satu saldo untuk semua tool di bawah ini, lalu memantau seluruh pemakaiannya dari satu Request Logs di console.

Pilih tool kamu

Tool	Format API yang dipakai	Base URL	Panduan
Claude Code (CLI & ekstensi VS Code/JetBrains)	Anthropic Messages	`https://api.hostlinku.com`	Claude Code
Codex CLI	OpenAI Responses	`https://api.hostlinku.com/v1`	Codex CLI
Cursor	OpenAI Chat Completions	`https://api.hostlinku.com/v1`	Cursor
Zed (Agent Panel)	OpenAI Chat Completions	`https://api.hostlinku.com/v1`	Zed
Cline, Roo Code, Kilo Code	OpenAI Chat Completions (atau Anthropic)	`https://api.hostlinku.com/v1`	Cline
Continue (VS Code & JetBrains)	OpenAI Chat Completions	`https://api.hostlinku.com/v1`	Continue
OpenCode	OpenAI Chat Completions	`https://api.hostlinku.com/v1`	OpenCode
Aider	OpenAI Chat Completions	`https://api.hostlinku.com/v1`	Aider
OpenAI Agents SDK (Python & TypeScript)	OpenAI Responses	`https://api.hostlinku.com/v1`	Agents SDK

Tool lain yang menyediakan opsi "OpenAI-compatible" atau "custom base URL" (mis. Open WebUI, LibreChat, LangChain, Vercel AI SDK, n8n, Dify) mengikuti pola yang sama: base URL https://api.hostlinku.com/v1, API key sk-…, dan slug model dari katalog.

Tiga hal yang selalu sama

Base URL — https://api.hostlinku.com/v1 untuk tool berformat OpenAI; https://api.hostlinku.com (tanpa /v1) untuk tool berformat Anthropic karena SDK Anthropic menambahkan /v1/messages sendiri.
API key — secret sk-… dari console.hostlinku.com → API Keys. Dipakai sebagai Authorization: Bearer sk-… (OpenAI) atau x-api-key (Anthropic); gateway menerima keduanya di semua endpoint /v1/*.
Slug model — persis seperti di katalog model, mis. claude-sonnet-4-6, gpt-5-5, deepseek-v4-flash. Setiap format API bisa memanggil model apa pun — mis. Claude lewat Codex CLI, atau GPT lewat Claude Code — karena gateway yang menerjemahkan protokolnya.

Rekomendasi model untuk coding

Daftar slug yang aktif untuk akun kamu selalu ada di console (menu Model) atau GET /v1/models. Sebagai titik awal:

Kebutuhan	Slug	Catatan
Agentic coding harian (default yang aman)	`claude-sonnet-4-6`	Tool calling kuat, konteks besar.
Tugas sulit / refactor lintas file	`claude-opus-4-6`, `gpt-5-5`	Lebih mahal; pakai saat Sonnet kurang.
Codex CLI	`gpt-5-3-codex`, `gpt-5-5`	Dioptimalkan untuk alur Codex (apply_patch, shell).
Model cepat & murah untuk sub-agent / commit message / ringkasan	`claude-haiku-4-5`, `deepseek-v4-flash`	Cocok untuk alias haiku / weak model.
Alternatif open-weight berkonteks besar	`kimi-k2-7-code`, `glm-5`, `qwen3-6-plus`	Semua mendukung tool calling.

Praktik aman

Satu API key per tool

Buat API key terpisah untuk setiap tool (mis. claude-code-laptop, cursor-kantor) dengan limit kredit harian/bulanan. Kalau satu key bocor dari file konfigurasi, cukup revoke key itu tanpa mengganggu tool lain. Lihat Autentikasi.

API key hanya berlaku untuk gateway /v1/*. Key sk-… tidak bisa dipakai untuk login console, mengubah saldo, atau membuat key baru — jadi key yang tersimpan di konfigurasi IDE tidak bisa mengambil alih akun kamu.
Jangan commit API key. Simpan di environment variable (HOSTLINKU_API_KEY) atau secret store tool masing-masing; semua panduan di sini memakai pola itu.
Pantau pemakaian. Menu Log Permintaan di console menampilkan setiap request dari setiap tool — model, token, biaya, latensi, dan API key yang dipakai. Lihat Pemakaian & Limit.

Masalah umum

Gejala	Penyebab & solusi
`401` / authentication error	API key salah, dicabut, atau kedaluwarsa. Pastikan tidak ada spasi/baris baru ikut tersalin. Di Claude Code, jalankan `/logout` dulu bila sebelumnya login dengan akun Anthropic.
`402` / insufficient quota	Saldo habis atau limit kredit API key tercapai. Isi saldo atau naikkan limit di console.
`404` / model not found	Slug model salah ketik atau tidak ada di katalog. Salin apa adanya dari `GET /v1/models`.
`400` not available in Service Mode	Model tidak tersedia pada Service Mode API key tersebut. Ganti model atau buat key dengan Service Mode lain.
`429` / rate limit	Tool mengirim banyak request paralel (sub-agent). Tunggu sesuai header `Retry-After`, atau kurangi paralelisme. Lihat Pemakaian & Limit.
Tool menolak base URL `localhost`	Beberapa tool (mis. Cursor) memanggil API dari server mereka, bukan dari komputer kamu. `https://api.hostlinku.com` adalah endpoint publik, jadi aman.
Fitur autocomplete / Tab tidak jalan	Autocomplete inline biasanya memakai endpoint `/v1/completions` (FIM) atau infrastruktur khusus tool. Hostlinku melayani chat, Responses, dan Messages — bukan FIM. Pakai Hostlinku untuk chat/agent/edit; biarkan autocomplete di provider bawaan tool.

Butuh tool lain yang belum ada di sini? Kirim ke [email protected] atau lihat Dukungan.

Ikhtisar Integrasi

Pilih tool kamu

Tiga hal yang selalu sama

Rekomendasi model untuk coding

Praktik aman

Masalah umum

PRODUK

DOKUMENTASI

BANTUAN