Dokümantasyon

GitHub Copilot CLI

GitHub'un kendi belgelerine göre Copilot CLI'ın BYOK yolu dört ortam değişkeninden oluşur ve hiç GitHub oturumu açmayı gerektirmez. Kunavo'ya yönlendirdiğinizde ajan, AI Credits yerine ön ödemeli bakiyeden çalışır; /delegate, GitHub MCP sunucusu ve GitHub Code Search ise bu oturumun arkasında kalır.

Dört ortam değişkeni — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY ve COPILOT_MODEL — Copilot CLI'yi kendi uç noktanıza taşır; GitHub, BYOK için GitHub girişinin gerekmediğini belgeliyor.

copilot'u başlattığınız kabuk

# 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, Copilot CLI'ın hangi yolu eklediğini belirtmiyor; bu nedenle yukarıdaki /v1, bir kural değil, uygulanmış bir örnektir. BYOK sayfası alanı yalnızca “Model sağlayıcınızın API uç noktasının temel URL'si” olarak tanımlar ve kendi örnekleri her iki olasılığı da gösterir: uzaktaki OpenAI uyumlu örnek https://api.openai.com/v1, Ollama ve Anthropic örnekleri ise yalın kaynak adresleridir. Bu sayfada, Kunavo'nun kullandığı biçim olduğu için uzaktaki OpenAI uyumlu biçim kullanılmıştır. İstekler 404 döndürürse sonek iki kez ekleniyordur; kaldırıp https://api.kunavo.com kullanın. 401 URL değil anahtardır; aşağıdaki curl ise CLI'da hata ayıklamadan önce ikisini ayırt etmenizi sağlar.

Artakalan bir ~/.copilot/providers.json, bu dışa aktarımlara sessizce üstün gelir. GitHub'un yapılandırma dizini başvurusuna göre bu dosya herhangi bir sağlayıcı veya model tanımlıyorsa COPILOT_PROVIDER_* değişkenlerine öncelik kazanır; GitHub bu değişkenleri eski olarak nitelendirir. BYOK kullanım kılavuzunda ise dosyadan hiç söz edilmez. CLI, dışa aktardığınız temel URL'yi kullanmıyorsa önce bu dosyaya bakın. Aynı başvuru dosyayı yalnızca providers ve models anahtarlarına sahip bir JSON nesnesi olarak tanımlar ve şema yayımlamaz; bu nedenle burada dosya örneği verilmemiştir. Daha fazla bilgi için GitHub copilot help providers komutunu işaret eder.

Bu yapılandırma, aşağıda belirtilen tarihte doğrudan GitHub'un kendi belgelerinden alınmıştır. Kunavo, Copilot CLI'ı uç noktasında çalıştırmamıştır — oturum, akışlı tur veya araç gidiş dönüşü gerçekleştirilmemiştir; bu ailedeki diğer tüm istemciler için de durum aynıdır. Yayımlanmış bir kurulum sayfası test değildir. GitHub, BYOK modelinin araç çağırmayı ve akışlı yanıtları desteklemesini zorunlu kılar ve aksi durumda hata döndürür. Bu nedenle ona vereceğiniz ilk görev merhaba demek yerine bir dosyaya dokunmalı.

Kunavo hiçbir gömme, metinden konuşmaya veya konuşmadan metne modeli sunmadığından bu uç nokta yalnızca sohbet turlarını yanıtlar. GitHub Code Search, GitHub MCP sunucusu ve /delegate, BYOK sağlayıcısının yerine geçmediği GitHub tarafı özellikleridir. GitHub, oturum açılmadan kullanılamadıklarını belirtir. Bir sağlayıcı yapılandırmanın yanı sıra oturum açarak bunları kullanmaya devam edebilirsiniz.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli GitHub Copilot CLI kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Eski bir ~/.copilot/providers.json dosyası olup olmadığını kontrol edin (veya COPILOT_PROVIDERS_CONFIG neyi gösteriyorsa). Dosya bir sağlayıcı ya da model tanımlıyorsa 3. adımdaki her şeyden önceliklidir.
Yukarıdaki gibi COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_API_KEY ve COPILOT_MODEL değerlerini dışa aktarın. COPILOT_PROVIDER_TYPE varsayılan olarak openai değerini alır; GitHub bunu “diğer tüm OpenAI Chat Completions API uyumlu uç noktalarını” kapsıyor şeklinde tanımlar.
Aynı kabuktan copilot komutunu başlatın. Bu değerler başlangıçta okunur; daha önce açılmış bir terminalde hâlâ eski değerler bulunur.
Bir dosyayı okuyup düzenleyen bir görev verin. Copilot CLI, modelin araç çağırmayı ve akışlı yanıtları desteklemesini gerektirir; her ikisini de kullanan ilk çalıştırma, bir selamlaşmadan daha fazla bilgi verir. İki kimliği karşılaştırmak isterseniz tek çalıştırma için --model, COPILOT_MODEL'i geçersiz kılar.

GitHub'un “GitHub Copilot CLI'da kendi LLM modellerinizi kullanma” başlıklı belgesi ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Copilot CLI ve Claude Code — BYOK sınırı ve iki fatura içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar GitHub Copilot CLI içinde çalışır.

# 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-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	GitHub Copilot CLI içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	dosyaları düzenleyen oturumlar için varsayılan çalışma modeli
`claude-opus-5`	$3.50 / $17.50	yanlış yapmanın pahalıya mal olacağı bir değişikliği planlama
`claude-haiku-4-5`	$0.70 / $3.50	ucuz turlar — önceliklendirme, özetler, gün boyu çalışan döngü
`gpt-5-6-sol`	$2.00 / $12.00	aynı anahtar ve aynı temel URL ile başka bir aileden ikinci görüş

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Diğer seçenek: `COPILOT_PROVIDER_TYPE=anthropic`

GitHub üç sağlayıcı türünü belgeliyor ve Kunavo bunların arkasındaki iki iletişim biçimini destekliyor: openai için /v1/chat/completions ve anthropic için /v1/messages. GitHub sayfasındaki Anthropic örneği dört dışa aktarım içerir ve temel URL olarak yalnızca https://api.anthropic.com kaynak adresini kullanır:

COPILOT_PROVIDER_TYPE=anthropic
COPILOT_PROVIDER_BASE_URL — GitHub'un örneğinin biçimine göre, son eksiz https://api.kunavo.com; çünkü Anthropic'in kendi rotası bu kök adresin altında /v1/messages yolunda bulunur ve Kunavo da aynı biçimi kullanır. Yukarıdaki uyarı burada da geçerlidir: GitHub bir kural değil, örnek gösterir.
COPILOT_PROVIDER_API_KEY — sk-kn- anahtarınız. Kunavo'nun Messages yüzeyi bunu x-api-key veya Authorization: Bearer olarak kabul eder; CLI burada hangi başlığı seçerse seçsin istek okunur.
COPILOT_MODEL — sağlayıcınızın beklediği kimlik. GitHub'un örneği tireli, Anthropic tarzı bir yazım kullanırken kendi desteklenen modeller listesinde aynı aileler noktayla yazılır. BYOK kapsamında kimlik uç noktanıza gönderilir; bu nedenle yukarıdaki tabloda yer alan yazımı kullanın.

Bu sayfanın neden yine de openai türünü öne çıkardığına gelelim: GitHub belgelerinin hiçbiri Anthropic BYOK yolunun cache_control, anthropic-beta veya belirli bir anthropic-version başlığını iletip iletmediğini söylemiyor. Yinelenen bağlam faturayı etkiler — bkz. istem önbelleğe alma — ve bu sayfa belgelenmemiş bir yanıtı varsaymaya yanaşmıyor. openai türü böyle bir belirsizlik taşımadığından, yapılandırma bloğu doldurulmuş olan tür odur.

Sık sorulan sorular

GitHub Copilot CLI'ı özel bir API uç noktasına nasıl yönlendiririm?

CLI'ı başlatmadan önce ortam değişkenlerini ayarlayın. GitHub'un BYOK sayfası ikisini zorunlu olarak işaretler: COPILOT_PROVIDER_BASE_URL ve COPILOT_MODEL. Kimlik doğrulaması yapan her uç nokta için COPILOT_PROVIDER_API_KEY de gerekir. COPILOT_PROVIDER_TYPE varsayılan olarak openai değerini alır. GitHub bunun OpenAI, Ollama, vLLM, Foundry Local ve OpenAI Chat Completions API'siyle uyumlu diğer tüm uç noktaları kapsadığını belirtir; diğer değerler azure ve anthropic'tir. GitHub'un başka bir yerde belgelediği bir nokta: ~/.copilot/providers.json herhangi bir sağlayıcı veya model tanımlıyorsa bu dosya tüm bu değişkenlere öncelik kazanır.

Copilot CLI temel URL'sinin sonunda /v1 olmalı mı?

GitHub'un belgeleri bu konuyu açıklığa kavuşturmuyor. Alan yalnızca “Model sağlayıcınızın API uç noktasının temel URL'si” olarak tanımlanır ve sayfanın kendi örnekleri her iki biçimi de gösterir: uzaktaki OpenAI uyumlu örnek https://api.openai.com/v1, Ollama ve Anthropic örnekleri ise yalın kaynak adresleridir. OpenAI uyumlu bir uç nokta için GitHub'un bu senaryoda gösterdiği biçimle, yani https://api.kunavo.com/v1 ile başlayın. İstekler 401 yerine 404 ile başarısız olursa sonek iki kez ekleniyordur; kaldırın. 404 URL'nin, 401 ise anahtarın sorunlu olduğunu gösterir. CLI'da hata ayıklamadan önce aynı temel URL'ye düz bir curl isteği göndererek ikisini ayırt edebilirsiniz.

GitHub Copilot CLI BYOK için GitHub hesabı gerekir mi?

Hayır. GitHub'un kimlik doğrulama belgelerine göre Copilot CLI kendi LLM sağlayıcınızın API anahtarıyla yapılandırıldığında GitHub kimlik doğrulaması gerekmez ve CLI doğrudan yapılandırdığınız sağlayıcıya bağlanır. Bu durumda üç özellik kullanılamaz: /delegate, GitHub MCP sunucusu ve GitHub Code Search. Her ikisinden de yararlanmak için aynı anda oturum açıp bir sağlayıcı da yapılandırabilirsiniz. GitHub ayrıca CLI'ın GitHub sunucularıyla hiçbir şekilde iletişim kurmaması gereken ortamlar için COPILOT_OFFLINE=true değerini belgeler. Ancak bu, ağı yalnızca sağlayıcı yerelse yalıtır; çünkü uzak bir temel URL istemlerinizi ve kod bağlamınızı almaya devam eder.

Kunavo, GitHub Copilot CLI'ı uç noktasında test etti mi?

Hayır. Bu sayfadaki yapılandırma, belirtilen tarihte GitHub'un kendi BYOK belgelerinden alınmıştır ve sayfadaki hiçbir bilgi çalışma zamanı sonucuna dayanmamaktadır: oturum, akışlı tur veya araç gidiş dönüşü gerçekleştirilmemiştir; burada belgelenen diğer tüm istemciler için de durum aynıdır. GitHub, BYOK modelinin araç çağırmayı ve akışlı yanıtları desteklemesini zorunlu kılar; desteklemiyorsa hata döndürür. Bu nedenle en dürüst ilk kontrol size düşer: dosya okuyan ve düzenleyen bir görev çalıştırın; kanıt olarak bu sayfaya değil, kaydedilen ücrete ve CLI'ın davranışına bakın.