Dokumentasi

GitHub Copilot CLI

Jalur BYOK Copilot CLI hanya memerlukan empat variabel lingkungan dan, menurut dokumentasi GitHub sendiri, sama sekali tidak memerlukan login GitHub. Arahkan ke Kunavo agar agen menggunakan saldo prabayar, bukan AI Credits — sementara /delegate, server GitHub MCP, dan GitHub Code Search tetap bergantung pada login tersebut.

Empat variabel lingkungan — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY, dan COPILOT_MODEL — mengalihkan Copilot CLI ke endpoint Anda sendiri, dan GitHub mendokumentasikan bahwa BYOK tidak memerlukan login GitHub.

shell tempat Anda memulai copilot

# Set before you start Copilot CLI. Variable names and order are GitHub's;
# COPILOT_PROVIDER_BASE_URL and COPILOT_MODEL are the two marked Required.
export COPILOT_PROVIDER_BASE_URL=https://api.kunavo.com/v1   # see the note below
export COPILOT_PROVIDER_TYPE=openai                          # the default, shown for clarity
export COPILOT_PROVIDER_API_KEY=sk-kn-...
export COPILOT_MODEL=claude-sonnet-5

copilot

GitHub tidak menyebutkan jalur yang ditambahkan Copilot CLI, jadi /v1 di atas adalah contoh penerapan, bukan aturan. Halaman BYOK hanya mendefinisikan kolom tersebut sebagai “URL dasar endpoint API penyedia model Anda”, dan contoh di halaman itu sendiri mengarah ke kedua kemungkinan: contoh kompatibel dengan OpenAI jarak jauh menggunakan https://api.openai.com/v1, sedangkan contoh Ollama dan Anthropic menggunakan origin dasar. Halaman ini menggunakan format kompatibel dengan OpenAI jarak jauh karena itulah bentuk yang sesuai dengan Kunavo. Jika permintaan menghasilkan 404, akhiran tersebut ditambahkan dua kali — hapus akhiran itu dan gunakan https://api.kunavo.com. 401 adalah kunci, bukan URL, sedangkan curl di bawah membedakan keduanya sebelum Anda menelusuri masalah CLI.

Sisa konfigurasi ~/.copilot/providers.json akan diam-diam mengalahkan ekspor ini. Referensi direktori konfigurasi GitHub menyatakan bahwa jika file tersebut menetapkan penyedia atau model apa pun, isinya akan mengesampingkan variabel COPILOT_PROVIDER_* yang disebut sebagai versi lama — dan panduan BYOK tidak pernah menyebut file ini. Jika CLI mengabaikan base URL yang baru saja Anda ekspor, periksa file tersebut terlebih dahulu. Referensi yang sama hanya menjelaskan file itu sebagai objek JSON dengan kunci providers dan models, tanpa menerbitkan skema, jadi contoh file tersebut tidak ditampilkan di sini; untuk informasi lebih lanjut, GitHub merujuk ke copilot help providers.

Konfigurasi ini disusun berdasarkan dokumentasi GitHub sendiri pada tanggal di bawah. Kunavo belum menguji Copilot CLI saat dijalankan terhadap endpoint-nya — bukan dalam sesi, bukan dalam giliran dengan streaming, bukan dalam pertukaran alat, dan hal yang sama berlaku untuk semua klien lain dalam keluarga ini. Halaman penyiapan yang diterbitkan bukanlah pengujian. GitHub mewajibkan model BYOK mendukung pemanggilan alat dan streaming, serta mengembalikan kesalahan jika tidak mendukungnya. Karena itu, tugas pertama yang Anda berikan sebaiknya menyentuh sebuah file, bukan sekadar menyapa.

Kunavo tidak menyediakan model embedding, text-to-speech, atau speech-to-text, sehingga endpoint ini hanya menjawab giliran chat. GitHub Code Search, server GitHub MCP, dan /delegate adalah fitur di sisi GitHub yang tidak digantikan oleh penyedia BYOK — GitHub menyatakan bahwa fitur tersebut tidak tersedia tanpa login. Anda tetap dapat menggunakannya dengan masuk ke akun sekaligus mengonfigurasi penyedia.

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 GitHub Copilot CLI.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Periksa apakah ada ~/.copilot/providers.json usang (atau lokasi apa pun yang ditunjuk oleh COPILOT_PROVIDERS_CONFIG). Jika file tersebut menetapkan penyedia atau model, isinya akan mengesampingkan semua yang ada di langkah 3.
Ekspor COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_API_KEY, dan COPILOT_MODEL seperti di atas. Nilai default COPILOT_PROVIDER_TYPE adalah openai, yang menurut GitHub mencakup “endpoint lain apa pun yang kompatibel dengan API OpenAI Chat Completions”.
Mulai copilot dari shell yang sama — variabel ini dibaca saat program dimulai, jadi terminal yang dibuka sebelumnya masih menggunakan nilai lama.
Berikan tugas yang membaca dan mengedit file. Copilot CLI memerlukan model yang mendukung pemanggilan alat dan streaming, dan proses pertama yang menggunakan keduanya memberi tahu Anda lebih banyak daripada sekadar sapaan. --model menggantikan COPILOT_MODEL untuk satu kali proses jika Anda ingin membandingkan dua ID.

Diperiksa terhadap “Menggunakan model LLM sendiri di GitHub Copilot CLI” dari GitHub 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 Copilot CLI vs Claude Code — batas BYOK dan dua tagihannya.

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 GitHub Copilot CLI.

# 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 GitHub Copilot CLI
`claude-sonnet-5`	$1.40 / $7.00	model kerja default untuk sesi yang mengedit file
`claude-opus-5`	$3.50 / $17.50	merencanakan perubahan yang akan mahal jika salah
`claude-haiku-4-5`	$0.70 / $3.50	giliran murah — triase, ringkasan, loop yang berjalan sepanjang hari
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model lain, dengan kunci dan base URL yang sama

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.

Rute lainnya: `COPILOT_PROVIDER_TYPE=anthropic`

GitHub mendokumentasikan tiga jenis penyedia, dan Kunavo mendukung dua format wire di antaranya: /v1/chat/completions untuk openai dan /v1/messages untuk anthropic. Contoh Anthropic di halaman GitHub menggunakan empat perintah ekspor, dan base URL-nya berupa origin dasar https://api.anthropic.com:

COPILOT_PROVIDER_TYPE=anthropic
COPILOT_PROVIDER_BASE_URL — berdasarkan bentuk contoh GitHub, gunakan https://api.kunavo.com tanpa akhiran, karena rute milik Anthropic berada di /v1/messages di bawah origin tersebut dan Kunavo menirunya. Peringatan yang sama seperti di atas tetap berlaku: GitHub memberikan contoh, bukan aturan.
COPILOT_PROVIDER_API_KEY — kunci sk-kn- Anda. Endpoint Messages milik Kunavo menerimanya dalam bentuk x-api-key atau Authorization: Bearer, sehingga header mana pun yang dipilih CLI di sini akan terbaca.
COPILOT_MODEL — ID yang diharapkan penyedia Anda. Contoh GitHub menggunakan ejaan bergaya Anthropic dengan tanda hubung, sementara daftar model yang didukung GitHub sendiri menuliskan keluarga yang sama dengan titik. Dalam BYOK, ID tersebut diteruskan ke endpoint Anda, jadi gunakan ejaan yang tercantum dalam tabel di atas.

Mengapa halaman ini tetap mengutamakan jenis openai: dokumentasi GitHub tidak menjelaskan apakah jalur BYOK Anthropic meneruskan cache_control, anthropic-beta, atau anthropic-version tertentu. Hal ini berpengaruh pada tagihan untuk konteks yang digunakan berulang kali — lihat cache prompt — dan halaman ini tidak akan berspekulasi mengenai hal yang tidak didokumentasikan. Jenis openai tidak menyisakan pertanyaan seperti itu, jadi blok konfigurasinya dapat ditampilkan secara lengkap.

Pertanyaan umum

Bagaimana cara mengarahkan GitHub Copilot CLI ke endpoint API khusus?

Atur variabel lingkungan sebelum menjalankan CLI. Halaman BYOK GitHub menandai dua variabel wajib — COPILOT_PROVIDER_BASE_URL dan COPILOT_MODEL — serta menambahkan COPILOT_PROVIDER_API_KEY untuk endpoint yang memerlukan autentikasi. Nilai default COPILOT_PROVIDER_TYPE adalah openai, yang menurut GitHub mencakup OpenAI, Ollama, vLLM, Foundry Local, dan endpoint lain apa pun yang kompatibel dengan API OpenAI Chat Completions; nilai lainnya adalah azure dan anthropic. Ada satu hal yang perlu diperhatikan menurut dokumentasi GitHub di bagian lain: jika ~/.copilot/providers.json menetapkan penyedia atau model apa pun, file itu akan mengesampingkan semua variabel ini.

Apakah URL dasar Copilot CLI harus diakhiri dengan /v1?

Dokumentasi GitHub tidak memberikan kepastian. Kolom tersebut hanya didefinisikan sebagai "URL dasar endpoint API penyedia model Anda", dan contoh di halaman itu sendiri mengarah ke kedua kemungkinan: contoh kompatibel dengan OpenAI jarak jauh menggunakan https://api.openai.com/v1, sementara contoh Ollama dan Anthropic menggunakan origin dasar. Untuk endpoint yang kompatibel dengan OpenAI, mulailah dengan format yang ditunjukkan GitHub untuk kasus tersebut — https://api.kunavo.com/v1 — lalu jika permintaan gagal dengan 404, bukan 401, berarti akhiran tersebut ditambahkan dua kali dan harus dihapus. Respons 404 menunjukkan masalah URL dan respons 401 menunjukkan masalah kunci; permintaan curl biasa ke base URL yang sama dapat membedakan keduanya sebelum Anda menelusuri masalah CLI.

Apakah BYOK GitHub Copilot CLI memerlukan akun GitHub?

Tidak. Dokumentasi autentikasi GitHub menyatakan bahwa jika Copilot CLI dikonfigurasi dengan kunci API penyedia LLM Anda sendiri, autentikasi GitHub tidak diperlukan dan CLI terhubung langsung ke penyedia yang dikonfigurasi. Setelah itu, tiga fitur tidak tersedia: /delegate, server GitHub MCP, dan GitHub Code Search. Anda juga dapat masuk ke akun sekaligus mengonfigurasi penyedia untuk tetap menggunakan keduanya. GitHub juga mendokumentasikan COPILOT_OFFLINE=true untuk lingkungan tempat CLI sama sekali tidak boleh menghubungi server GitHub — meskipun pengaturan itu hanya mengisolasi jaringan jika penyedia bersifat lokal, karena base URL jarak jauh tetap menerima prompt dan konteks kode Anda.

Apakah Kunavo telah menguji GitHub Copilot CLI dengan endpoint-nya?

Belum. Konfigurasi di halaman ini diambil dari dokumentasi BYOK GitHub sendiri pada tanggal yang ditampilkan, dan tidak satu pun bagian di dalamnya merupakan hasil saat dijalankan — bukan sesi, bukan giliran dengan streaming, bukan pertukaran alat; hal yang sama juga berlaku untuk semua klien lain yang didokumentasikan di sini. GitHub mewajibkan model BYOK mendukung pemanggilan alat dan streaming, serta mengembalikan kesalahan jika tidak. Karena itu, pemeriksaan pertama yang jujur harus Anda lakukan sendiri: jalankan satu tugas yang membaca dan mengedit file, lalu jadikan biaya yang tercatat dan perilaku CLI sebagai bukti, bukan halaman ini.