AX Code’u edinin · ÜcretsizBelgeler

Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Desteklenen sağlayıcılar ve modeller

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-09-19 Sahip: ax-code runtime

Bu sayfa, AX Code’un varsayılan kurulum akışlarında sunduğu sağlayıcı hazır ayarlarını listeler. Doğruluk kaynağı packages/ax-code/src/provider/default-setup-providers.ts içindeki çalışma zamanı sağlayıcı izin listesi, packages/ax-code/src/provider/models-snapshot.json içindeki paketli model anlık görüntüsü, packages/ax-code/src/provider/local-runtime.ts içindeki yerel çalışma zamanı hazır ayarları ve packages/ax-code/src/provider/ax-engine/constants.ts içindeki AX Engine tanımlarıdır.

Terminal arayüzünde /connect veya etkileşimli kurulum için ax-code providers login <provider-id> kullanın. Başsız ve CI ortamları listelenen ortam değişkenlerini de sağlayabilir.

Bağlı sağlayıcıları yönetme

Oturum görünümü üstte oturum kimliği (kopyalamak için tıklayın), başlık ve canlı durum olan bir çubuk tutar; ardından bağlı sayıyı gösteren bir Sağlayıcılar girdisi gelir. Yöneticiyi açmak için ona veya yönet öğesine tıklayın; bu, /providers komutu olarak da vardır. Oradan bir model seçebilir, her sağlayıcıyı devre dışı bırakabilir veya bağlantısını kesebilir ya da tam /connect akışına atlayabilirsiniz.

  • Bir anahtarı değiştirme: sağlayıcıyı /connect içinde seçin ve Anahtarı değiştir seçin ya da ax-code providers login <provider-id> yeniden çalıştırın.
  • Geçici olarak devre dışı bırakma: /providers veya /connect içinde Devre dışı bırak seçin ya da ax-code providers disable <provider-id> çalıştırın. Bu, sağlayıcıyı genel yapılandırmadaki disabled_providers listesine ekler ve kaydedilmiş kimlik bilgilerini tutar. Devre dışı sağlayıcılar /providers içinde ve /connect altında Devre dışı olarak görünür kalır ve Etkinleştir veya ax-code providers enable <provider-id> ile yeniden açılabilir.
  • Kalıcı olarak bağlantıyı kesme: /providers veya /connect içinde Bağlantıyı kes seçin ya da ax-code providers logout <provider-id> çalıştırın — bu, saklanan kimlik bilgisini auth.json içinden siler.

Barındırılan model katalogları her AX Code sürümüyle paketlenir ve kullanılabilir kodlama ajanı yetenekleri için süzülür. Kurulu sürümünüzdeki yetkili model kimlikleri için ax-code models <provider-id> çalıştırın; ham kayıt ve kopyalanmış web listeleri, metin çıktısı veya araç çağırma olmadığı için AX Code’un gizlediği modelleri içerebilir. Bir sağlayıcı hazır ayarı, her modelin ücretsiz veya her hesapta kullanılabilir olduğu anlamına gelmez.

Çalışma zamanı seçimleri

Sürüm olmadan model seçme

Hem TUI hem ax-code run bu büyük/küçük harf duyarsız --model aile adlarını kabul eder:

Aile Model
deepseek deepseek-flash
glm glm-5.3-flash
qwen qwen3.8-flash

Örneğin ax-code --model glm TUI’yi GLM Flash ile açar ve ax-code run --model qwen -- "Review this change" Qwen Flash ister. İstemi -- sonrasına koyun (veya --prompt / --prompt-file geçirin); --file dosya ekler ve bir istem dosyası değildir. ax-code models kullanılabilir provider/model kimliklerini listeler. Aile adları yerel sağlayıcı veya aynı modeli sunan bağlı bir ağ geçidi üzerinden çözülür. Sağlayıcıyı da adlandırabilirsiniz: --model my-gateway/glm. Belirli bir sürüm veya katman istemek için my-gateway/glm-5.3 gibi tam bir kimlik kullanın.

--model atlamak yapılandırılmış, ajan, oturum ve son model seçimlerini korur. Kullanılabilir bir seçim yoksa paylaşılan yedek sırası bağlı sağlayıcılar arasında DeepSeek Flash, GLM Flash, sonra Qwen Flash ile başlar. Sağlayıcı kurulumunun kendi varsayılanları vardır: Alibaba Coding Plan qwen3-coder-plus kullanır; Alibaba Token Plan qwen3.8-flash kullanır.

Bir çalışma zamanı bağlama

/connect içindeki seçimler sırasıyla API bulut sağlayıcısı, CLI sağlayıcısı, AX-Engine çalışma zamanı, Yerel LLM çalışma zamanı, Özel GPU bulutu ve AX Trust şeklindedir. AX-Engine çalışma zamanı yerel model seçimini ve çalışma zamanı yönetimini doğrudan açar. Yerel LLM çalışma zamanı bu seçimleri sırayla listeler:

Menü seçeneği Sağlayıcı kimliği Varsayılan uç nokta Ana makine ortam değişkeni
Ollama ollama http://localhost:11434/v1 OLLAMA_HOST
LMStudio lmstudio http://localhost:1234/v1 LMSTUDIO_HOST
MTPLX mtplx http://localhost:8000/v1 MTPLX_HOST
oMLX omlx http://localhost:8000/v1 OMLX_HOST
AX-Studio ax-studio http://localhost:18080/v1 AX_STUDIO_HOST
Diğerleri local-llm OpenAI uyumlu uç noktanızı girin LOCAL_LLM_HOST

MTPLX ve oMLX hazır ayarları kaynak kopyasında vardır; v7.19.3 paketli ikililer onları içermez. Araç yeteneği yapılandırması, isteğe bağlı kimlik doğrulama ve paylaşılan varsayılan bağlantı noktası uyarısı için MTPLX ve oMLX kurulumu sayfasına bakın.

Yerel sunucunuzu başlatın, menü girdisini seçin ve uç noktayı onaylayın veya düzenleyin. AX Code atlanırsa /v1 ekler. Diğerleri, yapılandırılabilir bir uç noktayı local-llm altında kaydeder; uç noktayı değiştirmek için onu yeniden seçin. LMStudio ve Diğerleri, API belirteci istemi olmadan mevcut yerel kurulum akışını kullanır. LM Studio model listesi uç noktasını belgeler.

Kurulum seçimleri enabled_providers ve disabled_providers değerlerine uyar. Seçiciyi yalnızca açmak bu yerel sunucuları etkinleştirmez veya yoklamaz. Keşfedilen dış yerel modeller tutucu yetenek varsayılanlarını korur; modellerin kodlama ajanı iş akışları için seçilebilir olması için araç çağırmayı desteklemesi gerekir.

Bulut API sağlayıcıları

Bu sağlayıcılar barındırılan API’leri veya barındırılan hesap planı uç noktalarını çağırır.

Sağlayıcı kimliği Görünen ad Kimlik bilgisi ortam değişkenleri
google Google sağlayıcısı GOOGLE_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, GEMINI_API_KEY
deepseek DeepSeek sağlayıcısı DEEPSEEK_API_KEY
meta Meta (Muse Spark) sağlayıcısı MODEL_API_KEY, META_MODEL_API_KEY
groq GroqCloud sağlayıcısı GROQ_API_KEY
openrouter OpenRouter sağlayıcısı OPENROUTER_API_KEY
huggingface Hugging Face sağlayıcısı HF_TOKEN
unorouter UnoRouter sağlayıcısı UNOROUTER_API_KEY
alibaba-coding-plan Alibaba Coding Plan sağlayıcısı ALIBABA_CODING_PLAN_INTL_API_KEY, ALIBABA_CODING_PLAN_API_KEY
alibaba-coding-plan-cn Alibaba Coding Plan (Çin) sağlayıcısı ALIBABA_CODING_PLAN_CN_API_KEY, ALIBABA_CODING_PLAN_API_KEY
alibaba-token-plan Alibaba Token Plan sağlayıcısı ALIBABA_TOKEN_PLAN_INTL_API_KEY, ALIBABA_TOKEN_PLAN_API_KEY
alibaba-token-plan-cn Alibaba Token Plan (Çin) sağlayıcısı ALIBABA_TOKEN_PLAN_CN_API_KEY, ALIBABA_TOKEN_PLAN_API_KEY
github-copilot GitHub Copilot sağlayıcısı GITHUB_TOKEN
zai Z.AI sağlayıcısı ZHIPU_API_KEY
zai-coding-plan Z.AI Coding Plan sağlayıcısı ZHIPU_API_KEY
minimax-coding-plan MiniMax Token Plan sağlayıcısı MINIMAX_TOKEN_PLAN_API_KEY, MINIMAX_API_KEY
minimax-cn-coding-plan MiniMax Token Plan (Çin) sağlayıcısı MINIMAX_TOKEN_PLAN_CN_API_KEY, MINIMAX_API_KEY

MiniMax, Coding Plan adını Token Plan olarak değiştirdi. Sağlayıcı kimlikleri models.dev ve OpenCode ile eşleşmek için minimax-coding-plan / minimax-cn-coding-plan olarak kalır. Bir Token Plan anahtarı (sk-cp-…) kullanın; kaynak platform.minimax.io (uluslararası) veya platform.minimaxi.com (China).

huggingface, barındırılan Serverless Inference Providers yönlendiricisidir (https://router.huggingface.co/v1). AX Engine’in indirilen yerel modelleri saklamak için kullandığı yerel Hugging Face anlık görüntü önbelleğiyle ilgisi yoktur — huggingface bağlamak yerel motoru asla başlatmaz veya gerektirmez.

Ücretsiz bir ilk çalıştırma için Ücretsiz katman API hızlı başlangıç sayfasına bakın. Bir sağlayıcının ücretsiz sunumunu AX Code uyumluluğundan ayırır ve dış bir ücretsiz API kataloğunun kendisinin bir destek matrisi olmadığını açıklar.

Grok yalnızca aşağıda listelenen grok-build-cli sağlayıcısı üzerinden desteklenir. AX Code artık doğrudan bir xai bulut API sağlayıcısı içermez; mevcut Grok API kimlik bilgileri bir bağlantı oluşturmaz.

github-copilot, GitHub Copilot hesap köprüsüdür. Bazı ücretsiz API dizinlerinin listelediği ayrı github-models API’si değildir.

OpenAI uyumlu ve Anthropic uyumlu ağ geçitleri özel sağlayıcı yapılandırması üzerinden de desteklenir. Bkz. Özel ve ağ geçidi sağlayıcıları.

Özel GPU bulutu

Bu sağlayıcılar, Yerel LLM çalışma zamanından sonra Özel GPU bulutu altında /connect içinde görünür.

Kendi OpenAI uyumlu GPU uç noktanızı bağlamak için Özel sağlayıcı seçin. URL ve API anahtarını girin; AX Code modelleri /v1/models üzerinden keşfeder ve anahtarı şifreli kimlik doğrulama deposunda saklar. Kaydedilen bağlantı Özel GPU bulutunda kalır. Model seçmek, uç noktayı değiştirmek veya bağlantıyı kesmek için onu yeniden seçin. Bu girdi, yapılandırılabilir bir uç noktayı custom-private-gpu altında saklar.

Katalog (API anahtarı)

OpenCode tarzı barındırılan GPU katalogları. Modeller paketli models.dev anlık görüntüsünden gelir. Bir API anahtarıyla bağlanın.

Sağlayıcı kimliği Görünen ad Kimlik bilgisi ortam değişkenleri
nebius Nebius Token Factory sağlayıcısı NEBIUS_API_KEY
fireworks-ai Fireworks AI sağlayıcısı FIREWORKS_API_KEY
togetherai Together AI sağlayıcısı TOGETHER_API_KEY
baseten Baseten sağlayıcısı BASETEN_API_KEY
nvidia NVIDIA NIM sağlayıcısı NVIDIA_API_KEY
deepinfra Deep Infra sağlayıcısı DEEPINFRA_API_KEY

Barındırılan Hugging Face yönlendiricisi (huggingface / HF_TOKEN) Bulut API sağlayıcılarında kalır. Adanmış Hugging Face Inference Endpoints aşağıda listelenir.

Adanmış (URL + belirteç)

PAI tarzı adanmış GPU uç noktaları. OpenAI uyumlu URL ve belirteci yapıştırın; AX Code GET …/models çağırır ve dağıtılan model kimliklerini kullanır. Bunlar Alibaba Coding Plan / Token Plan (DashScope) sağlayıcıları değildir.

Sağlayıcı kimliği Görünen ad Kimlik bilgisi ortam değişkenleri
alibaba-pai Alibaba PAI-EAS sağlayıcısı ALIBABA_PAI_API_KEY, ALIBABA_PAI_BASE_URL
runpod RunPod sağlayıcısı RUNPOD_API_KEY, RUNPOD_BASE_URL
huggingface-endpoints Hugging Face Endpoints sağlayıcısı HF_ENDPOINTS_TOKEN, HF_ENDPOINTS_BASE_URL
sagemaker Amazon SageMaker sağlayıcısı SAGEMAKER_API_KEY, SAGEMAKER_BASE_URL
volcengine-ark Volcengine Ark sağlayıcısı ARK_API_KEY, ARK_BASE_URL
modelarts Huawei ModelArts sağlayıcısı MODELARTS_API_KEY, MODELARTS_BASE_URL
tencent-ti Tencent TI sağlayıcısı TENCENT_TI_API_KEY, TENCENT_TI_BASE_URL
custom-private-gpu Özel sağlayıcı CUSTOM_PRIVATE_GPU_API_KEY, CUSTOM_PRIVATE_GPU_BASE_URL

sagemaker, SageMaker önündeki OpenAI uyumlu bir URL içindir (vLLM / TGI / API Gateway). AWS SigV4 imzalamaz.

AX Trust

AX Trust, Özel GPU bulutundan sonra /connect içindeki son kategoridir. AX Trust bağla seçin, /v1 dahil ağ geçidi taban URL’sini girin ve istemci API anahtarını sağlayın. AX Code ağ geçidinin modellerini keşfeder ve anahtarı şifreli kimlik doğrulama deposunda saklar. Kaydedilen bağlantılar model seçimi, uç nokta güncellemeleri, model yenileme ve silme sunar.

Mevcut bir URL’yi yeniden bağlamak, belirteç boş bırakıldığında sağlayıcı kimliğini, modelleri ve kaydedilmiş anahtarı korur. Sağlayıcı, özel bir adla bile AX Trust içinde kalır. Eski ax-trust ve ax-trust-* kimlikleri de bu kategoride görünür. AX Trust ağ geçidi ilkesine, onaylara ve denetime sahip olmaya devam eder. AX Code bu bağlantılarda varsayılan olarak bir oturum yakınlığı başlığı gönderir.

CLI sağlayıcıları

CLI sağlayıcıları, AX Code içinde barındırılan bir API anahtarı saklamak yerine yerel bir satıcı CLI’sini ve oturum açmasını yeniden kullanır.

Sağlayıcı kimliği Görünen ad Gerekli yerel komut Desteklenen model kimliği
claude-code Anthropic (Claude Code) sağlayıcısı claude claude-code
codex-cli OpenAI (Codex CLI) sağlayıcısı codex codex-cli
grok-build-cli Grok Build CLI sağlayıcısı grok grok-build-cli
muse-cli Muse Code CLI sağlayıcısı muse muse-cli

Gerektiğinde önce satıcı CLI oturum açmasını çalıştırın, sonra ax-code providers login <provider-id> çalıştırın. AX Code CLI komutunu yoklar ve yoklama başarılı olduktan sonra yerel bir işaret kimlik bilgisi saklar.

Muse Code için yerel muse ikilisini kurun, muse login çalıştırın (veya META_API_KEY ayarlayın), sonra ax-code providers login muse-cli. AX Code barındırılan bir Meta API anahtarı saklamak yerine Muse CLI oturumunu (~/.config/muse) yeniden kullanır. Barındırılan meta API sağlayıcısı ayrı bir bağlantı olarak kalır.

Barındırılan MiniMax Token Plan minimax-coding-plan / minimax-cn-coding-plan olarak kullanılabilir kalır. Paketli bir MiniMax Code CLI veya Kimi Code CLI sağlayıcısı yoktur.

AX Engine yerel sağlayıcı

ax-engine yerleşik yerel çıkarım sağlayıcısıdır. Yalnızca uygun Apple Silicon Mac bilgisayarlarda vardır ve yalnızca AutomatosX Tiel Coder ile Cyber-Tiel Coder 35B A3B MXFP4 MTP geliştirme paketlerini sunar. Yerel yetenekler model başladığında denetlenir.

Sağlayıcı kimliği Model kimliği Seçim Bağlam Çıktı
ax-engine tiel-coder-35b-axq-mxfp4 Tiel Coder 35B A3B MXFP4 MTP (varsayılan) 65,536 8,192
ax-engine cyber-tiel-coder-35b-axq-mxfp4 Cyber-Tiel Coder 35B A3B MXFP4 MTP 65,536 8,192

Qwen3.8 27B, Ornith, Qwen3-Coder-Next ve diğer tüm depolar yönetilen seçimden dışlanır. Tarihsel kayıtlar durum ve temizlik için okunabilir kalır.

Varsayılan yerel model tiel-coder-35b-axq-mxfp4 değeridir. Tam seçilen depolar, bellek ve disk rehberi için AX Engine model seçimi sayfasına bakın.

Ayrı yapılandırılmış mevcut geri döngü bağlanma arayüzü için /v1/models yetkilidir: AX Code canlı model kimliklerini, bağlam ve çıktı sınırlarını, kiplikleri ve yapılandırılmış araç çağırma desteğini keşfeder. Yapılandırılmış araç çağırmayı duyurmayan bir model kodlama ajanı istekleri için kullanılmaz.

AX Engine varsayılan olarak sıkı core araç profilini kullanır (bash, dosya keşfi, okuma, düzenleme, yazma ve beceriler). provider.ax-engine.options.toolProfile değerini full olarak yalnızca tam araç kaydı için yeterli bağlamı olan özel bir dağıtımda ayarlayın.

Motoru kurma

Yerel çıkarım AX Engine 7.5.7 veya üzerini gerektirir. Apple Silicon Mac yükleyicileri zaten kendi içinde bir AX Engine sidecar içerir (CLI çalışma zamanının yanında engine/<version>/), bu yüzden temiz bir Mac Homebrew gerektirmez.

AX Code sonra ikiliyi şu sırayla çözer:

  1. provider.ax-engine.options.binaryPath, ax-code.json içindedir (en az 7.5.7 doğrulanmış sürüm gerektirir)
  2. AX_ENGINE_BIN ortam değişkeni (en az 7.5.7 doğrulanmış sürüm gerektirir)
  3. ax-engine, sizin PATH üzerindedir (en az 7.5.7 doğrulanmış sürüm gerektirir)
  4. AX Code yönetimli bir katman kurulumu (ax-code providers ax-engine install; en az 7.5.7 de gerektirir)
  5. güncel Mac çalışma zamanında paketli sidecar

Önce --version denetler ve install.version değerine düşer; kaynak ax-engine doctor --json olur. Doctor çıkış kodu ana makine hazırlığını raporlar (Metal araç zinciri, MLX dosyaları), bu yüzden o JSON bir sürüm içerdiğinde sıfır olmayan bir çıkış hâlâ sayılır. AX Code sunucu başlangıcına sahiptir ve normalde ax-engine serve sürecini 127.0.0.1:31418 üzerinde başlatır. İsteğe bağlı Homebrew formülü, brew sahipliğinde bir motor isteyen kullanıcılar için alternatif olarak kalır; gerekli değildir.

Yönetilen Tiel başlatmaları katalog penceresini kullanır (65,536 bağlam belirteci ve 8,192 çıktı belirteci); bu, ajan istemi sığsın diye ax-engine serve yerleşik 16,384 belirteç varsayılanından büyüktür. Her iki bütçeyi provider.ax-engine.options.contextTokens ve provider.ax-engine.options.maxOutputTokens ile küçültün (outputTokens aynı çıktı düğmesidir). Ortam adları AX_ENGINE_CONTEXT_TOKENS ve AX_ENGINE_MAX_OUTPUT_TOKENS değerleridir (AX_ENGINE_OUTPUT_TOKENS bir takma addır). Bir geçersiz kılma yalnızca katalog tavanını daraltabilir: daha büyük veya geçersiz bir değer bildirilir ve yok sayılır ve 1,024’ün katı olmayan bir Tiel veya Qwen3.8 penceresi, önek önbellek blokları 1,024 belirteç kalsın diye aşağı yuvarlanır. Aynı sayılar çalışan sunucunun ve model sınırının kullandığı sayılardır. Canlı bir /v1/models kartı bu pencereyi daha da küçültebilir ve yükseltemez. Yapılandırılmış seçenekler kazanır ve bir ortam değeri yok sayıldığında AX Code uyarır. Aynı uyarı binaryPath, AX_ENGINE_BIN değerini yok saydığında veya connectionMode / baseURL, AX_ENGINE_HOST değerini yok saydığında da yayılır. Daha küçük bir pencere tam ajan istemi için fazla küçük olabilir; AX Code o zaman sunucunun tutamayacağı bir istem göndermek yerine modeli reddeder.

Tiel ve Cyber-Tiel yapılandırılmış araç çağırmayı duyurur. Sunucu çalıştıktan sonra canlı bir /v1/models kartı bu duyuruyu hâlâ geçersiz kılar. mtpPolicy: disabled, ikili sürümü okunamasa bile MTP’yi kapatır; auto ve required hâlâ AX Engine 7.4.0 veya daha yenisini gerektirir.

libmlx.dylib / mlx.metallib eksik bir PATH veya katman kurulumu reddedilir. Paketli ve katman arşivleri kendi içinde 7.5.7 macOS yüküdür.

Motoru kurmak bir model indirmez. Ardından Desktop Modeller sayfasından veya ax-code providers ax-engine prepare ile bir model seçip indirin. Hugging Face önbelleğinde hâlihazırda bulunan tam uyumlu bir taban anlık görüntüsü doğrudan çözme için kabul edilir; prepare --download kullanılabilirse kataloğun yeğlediği MTP paketini kullanır.

/connect kullanın, sonra AX-Engine çalışma zamanı, sonra Bir model seçin. AX Code, seçilen model gerektiğinde yerel çalışma zamanını otomatik yapılandırır ve başlatır; URL veya API anahtarı gerekmez. Durumu görüntüle, Yerel çalışma zamanını durdur ve Devre dışı bırak yerel çalışma zamanını yönetir. Bir model seçmek eski elle bağlanma ayarlarını da yönetilen yerel kurulumla değiştirir.

Motor yalnızca Apple Silicon macOS için gönderilir. Diğer ana makinelerde barındırılan bir sağlayıcı veya OpenAI uyumlu bir sağlayıcı ağ geçidi kullanın; AX Code sunucuları yalnızca yereldir.