Belge anlık görüntüsü · CLI 7.30.1 · SDK 2.6.53. Desktop, kendi sürümüyle gelen çalışma zamanını kullanır. Komutlar ve örnekler İngilizce kaynakta olduğu gibi korunur. İngilizce kaynak

İlk model sağlayıcınızı bağlayın

Bağlantı seçin

Sağlayıcı, model hizmetine bağlantıdır; model ise bu bağlantı üzerinden seçilen belirli modeldir. Sağlayıcı bağlamak tüm modelleri seçmez veya hesaba erişim hakkı vermez.

Terminal arayüzünde /connect yazıp aşağıdaki yollardan birini seçin. Desktop’ın kendi sağlayıcı ayarları ve paketlenmiş çalışma ortamı vardır; bu eğik çizgi komutları terminal içindir.

Bulut API’si: API Cloud Provider seçeneğinden hizmetinizi seçip kimlik bilgisi adımlarını izleyin. Sohbet aboneliği mutlaka API erişimi veya API kredisi içermez.
Kodlama CLI’si: önce desteklenen CLI’yi kurup oturum açın, ardından CLI Provider seçin. AX Code bu yerel oturumu kullanır; yetenekler bağdaştırıcıya bağlıdır.
Yerel model: Ollama veya LM Studio’yu başlatıp araç çağrısı destekleyen bir model yükleyin, sonra Local LLM runtime seçip uç noktayı onaylayın. AX-Engine runtime, desteklenen Mac’lerde kendi kurulum ve model indirme akışını sunar.
Ağ geçidi: AX Trust uç noktası için AX Trust, başka bir ağ geçidi için API Cloud Provider → Custom API provider, özel uyumlu dağıtım için Private GPU cloud seçin. Hizmet URL’sini, belirteci ve hizmetin bildirdiği tam model kimliklerini girin.

Bağlantıyı kontrol edin

Bu komutları etkileşimli terminalde çalıştırın. Giriş komutu sağlayıcı ve kimlik bilgilerini sorar; gerçek anahtarı paylaşılan komutlara veya depo dosyalarına yapıştırmayın.

ax-code providers login
ax-code providers list
ax-code models

Sağlayıcıyı ve kullanılabilir model kimliklerini görmelisiniz. Kimlik bilgisi kaydetmek veya liste almak tek başına çıkarım iznini kanıtlamaz. Model seçimine devam edip küçük bir deneme isteği gönderin.

Kimlik bilgilerini ve yapılandırmayı yönetin

Bağlantılar için /providers, anahtar değiştirmek için /connect kullanın. Devre dışı bırakmak kayıtlı bilgileri korur; bağlantıyı kesmek bunları siler. Ortam değişkenleri ve yapılandırılmış anahtarlar erişim sağlamaya devam edebilir.

Paylaşılan gizli olmayan ayarlar için proje ax-code.json dosyasını, kişisel varsayılanlar için genel ~/.config/ax-code/ax-code.json dosyasını kullanın. Sırları sürüm kontrolüne koymayın; kimlik bilgisi istemini veya ağ geçidi kılavuzundaki ortam başvurularını kullanın. Elle düzenleme sonrası yeniden başlatın.

Kurulum başarısız olursa

Kimlik doğrulama hatası: anahtarın seçilen hizmet, uç nokta ve API planına ait olduğunu doğrulayın. Kodlama CLI’sinde önce kendi oturumunu kontrol edin.
Boş liste veya bağlantı reddi: yerel sunucunun çalıştığını, modelin yüklendiğini, URL ve bağlantı noktasının doğru olduğunu doğrulayın. Ollama genellikle http://localhost:11434/v1, LM Studio http://localhost:1234/v1 kullanır.
Model reddi: uç noktanın tam kimliğini kullanıp hesap izinlerini kontrol edin. Ağ geçidindeki görünen ad, üst hizmete gönderilen kimlikten farklı olabilir.
Sağlayıcı yok: enabled_providers ve disabled_providers ayarlarını kontrol edin. Kurulum tanısı için ax-code doctor çalıştırın; bu, sağlayıcı hesabını doğrulamaz.

Sonraki adımlar

Sağlayıcı kataloğu ve giriş yöntemleri · Özel ağ geçitleri ve GPU uç noktaları · Model seçimi · AX Wiki oluşturma · Belge merkezi