Dokumentasi

Nanocoder

Nanocoder memperlakukan endpoint jarak jauh sama seperti Ollama: satu entri di nanocoder.providers yang mencakup nama, URL dasar, kunci, dan daftar model. sdkProvider secara default bernilai openai-compatible, jadi tidak ada hal lain yang perlu dideklarasikan.

Entri Custom Provider di bawah nanocoder.providers dalam agents.config.json — name, baseUrl, apiKey, models — tanpa perlu baris sdkProvider karena default-nya openai-compatible.

agents.config.json

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

Kunavo belum menjalankan Nanocoder terhadap endpoint ini. Setiap kolom di atas disalin dari halaman Custom Provider milik Nanocoder sendiri, bukan dari sesi yang pernah diselesaikan oleh siapa pun di sini — ini adalah referensi konfigurasi, bukan uji kompatibilitas. Jalankan satu tugas kecil dengan batasan yang jelas terlebih dahulu, dan sediakan jalur lain selama pengujian.

URL dasar menyertakan sufiks /v1. Dokumentasi Nanocoder memastikan hal ini melalui contoh, bukan aturan: tabel kolom hanya menjelaskan baseUrl sebagai “API endpoint URL”, tetapi contoh pada halaman Custom Provider sendiri menggunakan "baseUrl": "https://my-api.example.com/v1", dan semua halaman penyedia yang kompatibel dengan OpenAI di situs tersebut juga menggunakan sufiks ini — https://openrouter.ai/api/v1, http://localhost:11434/v1. Jika sufiks dihilangkan, kegagalannya berupa 404 pada jalur, bukan 401 pada kunci.

sdkProvider sengaja tidak dicantumkan di atas — tabel kolom menyatakan nilai default-nya adalah openai-compatible, yaitu format yang digunakan Kunavo di sini. Nilai terdokumentasi lainnya (google, anthropic, github-copilot) mengganti SDK yang digunakan, dan tidak satu pun diperlukan untuk mengakses endpoint chat-completions.

Ada tiga lokasi pencarian yang menentukan konfigurasi mana yang berlaku, menurut urutan berikut: NANOCODER_PROVIDERS (atau NANOCODER_PROVIDERS_FILE), lalu agents.config.json di direktori kerja, kemudian konfigurasi per pengguna — ~/Library/Preferences/nanocoder/ di macOS, ~/.config/nanocoder/ di Linux, %APPDATA%\nanocoder\ di Windows. Lokasi pertama yang ditemukan akan berlaku, dan dengan menetapkan NANOCODER_CONFIG_DIR pencarian di proyek dan direktori home dilewati sepenuhnya. Jika kunci yang Anda ubah bukan kunci yang dikirim, periksa urutan prioritas tersebut.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Nanocoder.

Langkah demi langkah

Buat kunci di /app/keys dan salin — kunci hanya ditampilkan sekali. Ekspor sebagai KUNAVO_API_KEY alih-alih menempelkannya ke berkas: Nanocoder mengganti $VAR, ${VAR}, dan ${VAR:-default} secara rekursif pada setiap string dalam entri penyedia, serta membaca .env dari direktori kerja.
Jalankan /settings providers di Nanocoder, lalu pilih Custom Provider. Panduan tersebut meminta informasi dengan urutan berikut: Provider name, Base URL, API key (optional), Model names, dan Request timeout. Panduan juga menawarkan untuk mengambil daftar model dari endpoint — Kunavo merespons dengan GET /v1/models, sehingga daftar tersebut terisi otomatis.
Atau lewati panduan tersebut dan tulis sendiri agents.config.json menggunakan blok di atas. Perhatikan bahwa pengaturan diselesaikan per berkas: berkas tingkat proyek yang mendefinisikan nanocoder.providers menyediakan seluruh blok itu, sehingga entri dalam konfigurasi global Anda tidak digabungkan dengannya.
Tetapkan jendela konteks. Nanocoder menentukan batasnya dari /context-max, lalu contextWindows[model], contextWindow, NANOCODER_CONTEXT_LIMIT, dan terakhir models.dev. Kunavo bukan penyedia models.dev, sehingga tanpa salah satu dari empat sumber pertama, anggarannya akan menggunakan nilai cadangan yang bukan milik model Anda. Angka-angkanya tercantum di /models.
Buka /model, pilih salah satu ID yang Anda cantumkan — pemilih menampilkannya di bawah name yang Anda berikan — lalu jalankan tugas kecil yang harus memanggil alat. Jika panggilan alat menghasilkan format yang salah pada model tertentu, disableToolModels dapat menonaktifkannya untuk model tersebut, bukan untuk seluruh penyedia.

Diperiksa terhadap Halaman Custom Provider Nanocoder pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di Nanocoder vs OpenCode — biaya tambahan masing-masing di luar blok penyedia.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Nanocoder.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Nanocoder
`claude-sonnet-5`	$1.40 / $7.00	model kerja default untuk siklus penyuntingan dan eksekusi agen terminal
`claude-haiku-4-5`	$0.70 / $3.50	sesi panjang yang sarat penggunaan alat dan triase berkas cepat, yang biayanya terutama ditentukan oleh jumlah giliran
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model lain dengan kunci yang sama
`claude-opus-5`	$3.50 / $17.50	satu pemfaktoran ulang besar dalam satu sesi, saat rencana yang keliru menimbulkan biaya tinggi

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Apakah Nanocoder mendukung endpoint API khusus?

Ya, dan ini adalah fitur resmi yang terdokumentasi, bukan kolom tanpa dokumentasi. Halaman "Custom Provider" milik Nanocoder menyatakan bahwa layanan apa pun yang menyediakan API kompatibel dengan OpenAI dapat ditambahkan sebagai penyedia khusus, dan mencantumkan objek yang perlu ditulis: name, baseUrl, apiKey, dan models. Anda dapat menambahkannya secara interaktif melalui panduan /settings providers atau dengan mengedit agents.config.json. Informasi tersebut sesuai dokumentasi per 21 September 2026.

Di mana saya memasukkan kunci API Nanocoder?

Di kolom apiKey pada entri penyedia di dalam agents.config.json. Nanocoder menerapkan substitusi variabel lingkungan secara rekursif pada kolom string dalam konfigurasi penyedia. Karena itu, cara yang lebih aman adalah menggunakan "apiKey": "${KUNAVO_API_KEY}" dan mengekspor nilainya di shell atau dalam berkas .env di direktori kerja. Penggantian melalui NANOCODER_PROVIDERS memiliki prioritas tertinggi, kemudian agents.config.json tingkat proyek, lalu konfigurasi per pengguna. Jadi, jika perubahan tampaknya tidak berpengaruh, kemungkinan nilainya ditimpa oleh konfigurasi yang lebih tinggi dalam urutan tersebut.

Apakah baseUrl Nanocoder harus diakhiri dengan /v1?

Untuk endpoint yang kompatibel dengan OpenAI, ya — misalnya https://api.kunavo.com/v1. Dokumentasi Nanocoder tidak menyatakan aturan tentang sufiks ini dalam uraian; tabel kolomnya hanya menjelaskan baseUrl sebagai URL endpoint API. Contoh yang menjawabnya: contoh pada halaman Custom Provider menggunakan https://my-api.example.com/v1, dan semua halaman penyedia yang kompatibel dengan OpenAI di situs tersebut menggunakan sufiks yang sama. Jika /v1 tidak disertakan, akan muncul 404 pada jalur, bukan kesalahan autentikasi.

Mengapa Nanocoder tidak menampilkan biaya atau ukuran konteks yang benar untuk model-model ini?

Karena Nanocoder membaca metadata model dari models.dev, sedangkan gateway pihak ketiga yang tidak tercantum di sana tidak memiliki entri. Urutan batas konteks terdokumentasi adalah /context-max atau --context-max, lalu contextWindows[model], kemudian contextWindow, lalu NANOCODER_CONTEXT_LIMIT, dan terakhir models.dev. Jadi, tetapkan salah satu dari empat sumber pertama di entri penyedia agar pengukur kembali akurat. Angka biaya per respons dihitung sendiri oleh klien berdasarkan token yang dilaporkan. Bagaimanapun, cocokkan dengan catatan transaksi milik penyedia Anda, bukan angka di bagian bawah aplikasi.