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

Buradan başlayın

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

Kök README AX Code’u kurmanın en hızlı yoluysa, bu sayfa onu anlamanın en hızlı yoludur.

Sürümler ve kullanılabilirlik

Kişisel ve ticari kullanım için ücretsiz açık kaynak sürüm olan AX Code Standard ile başlayın. Yerel veya bulut modelleri kullanın; AX Engine, desteklenen Apple Silicon Mac bilgisayarlarda yerel bir çıkarım yolu sağlar. Mevcut izinler, değişiklik incelemesi ve yerel yürütme kanıtı çekirdek yetenekler olarak kalır.

Business, AX Trust üzerinden kuruluş yönetişimi ve AutomatosX üzerinden iş akışları için planlanan tescilli bir sunumdur. Standard’ı işte kullanmak tek başına bir Business lisansı gerektirmez. Ayrıntılar için Standard ve Business sayfasına bakın.

İmzalı yükleyiciler ve çalışma zamanı arşivleri anonim olarak download.ax-code.com adresinden alınabilir. Kurulum rehberini ve yükseltme ve kurtarma rehberini okuyun. Genel teknik belgeler, kaynak erişiminden bağımsız olarak ax-code.app/tr/docs/ adresinde barındırılır. Zaten kuruldu mu? Projenizde bir terminal açın, ax-code çalıştırın, sonra sağlayıcı seçmek için TUI içinde /connect kullanın. Proje hakkında bir soruyla başlayın, küçük bir değişiklik isteyin ve işleme almadan önce farkı ve proje denetimlerini inceleyin. Kurulu çalışma zamanının tanısı gerekiyorsa ax-code doctor kullanın.

AX Code nedir

AX Code bir yapay zekâ kodlama çalışma zamanıdır. Şunları bir araya getirir:

• farklı kodlama görevleri için ajanlar
• açık araç yürütmesi
• model ve sağlayıcı seçimi
• kalıcı oturum durumu
• yapılandırılabilir yalıtım ve izinler
• TUI, SDK, sunucu modu ve MCP gibi bütünleştirme yüzeyleri

Bu önemlidir çünkü yapay zekâ ile kodlama, gerçek depolarda ancak ajanın ne yapmasına izin verildiğini denetleyebildiğinizde, oturumlar arasında bağlamı koruduğunuzda ve aynı iş akışını tek bir sohbet penceresinin dışında yeniden kullanabildiğinizde yararlıdır.

Değer nereden gelir

AX Code, ajan bittikten sonraki anı iyileştirir: ürettiğini tutup tutmayacağınıza karar vermek.

• Kanıt. Her oturum, yazılmış bir olay günlüğü artı dosya anlık görüntüleri olarak kaydedilir; böylece ax-code graph, compare, replay, risk ve audit konuşma bittikten sonra ne olduğunu yeniden kurabilir.
• Doğrulama. Bir kapı uygulanabildiğinde — arena adayları, kapılı yeniden düzenleme uygulaması — sonucun kabul edilip edilmeyeceğine deponuzun kendi typecheck, lint ve test komutları karar verir.
• Geri alınabilirlik. Anlık görüntüler yalnızca oturum başına değil adım başına kurtarılabilir; deponuzun dışında tutulan bir Git nesne deposundan.
• Sizin kararınız. AX Code sıralar, puanlar ve raporlar. Sizin yerinize birleştirmez.

Bunları destekleyenler: izin kuralları ve yalıtım modlarıyla açık araçlar, kalıcı oturumlar, depo kuralları için AGENTS.md, sağlayıcı taşınabilirliği ve TUI, CLI, VS Code eklentisi, SDK, başsız sunucu ve MCP bütünleştirmelerinin arkasındaki tek çalışma zamanı. Bunlar AX Code’u seçme nedeni değil temellerdir — bkz. Neden AX Code.

Komutların kendisi için Yürütme kanıtı sayfasına bakın.

Zihin modeli

AX Code’u beş katman olarak düşünün:

1. Sağlayıcı katmanı: karşı çalıştırmak istediğiniz model arka ucunu seçin.
2. Ajan katmanı: görev için doğru ajanı seçin veya yönlendirmenin yardım etmesine izin verin.
3. Araç katmanı: ajan, gizli yetenekler yerine açık araçlar üzerinden eylem yapar.
4. Oturum katmanı: konuşma, kararlar ve durum kalır.
5. Denetim katmanı: yalıtım, izinler ve denetim davranışı sınırı tanımlar.

Belgelerin geri kalanı bu katmanlara oturur.

Sonraki yolu seçin

Hızlı denemek istiyorum

• Kurulum ve ilk başlatma için kök README ile başlayın.
• Desteklenen kurulum yolları derlenmiş çalışma zamanını kullanır:
  • macOS Apple Silicon ve Linux için Bash sürüm yükleyicisi: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • macOS CLI için Homebrew alternatifi: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Windows PowerShell için GitHub sürüm yükleyicisi: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Bash yükleyicisi kurallı Windows kurulum yolu değildir.
• npm paketleri artık desteklenen kurulum veya yükseltme kanalları değildir. Platform ilkesi, çalışma zamanı etiketleri ve yerel başlatıcı matrisi için Kurulum ve Çalışma Zamanı Kanalları sayfasına bakın.
• Model ayarlamak için /connect veya ax-code providers login kullanın. Bulut API sağlayıcıları, CLI sağlayıcıları, AX Engine ve model kimlikleri için Desteklenen sağlayıcılar ve modeller sayfasına bakın. Ücretsiz bir değerlendirme yolu için Ücretsiz katman API hızlı başlangıç sayfasını kullanın.
• Gerçek bir proje açtıktan sonra ax-code init çalıştırın; böylece AGENTS.md yerel kuralları yakalar.
• Daha sıkı güvenlik sınırları istiyorsanız daha geniş düzenlemelerden önce Sandbox modunu açın.

Bir ekip veya şirket deposunda güvenle kullanmak istiyorum

• AX Code, otonom mod açık ve sandbox modu kapalı olarak başlar: sınırsız dosya sistemi ve ağ erişimiyle full-access.
• Ekip, şirket, güvenilmeyen veya gözetimsiz iş için göreve başlamadan önce --sandbox workspace-write (veya read-only) açın.
• Yürütme sınırları için Sandbox modunu okuyun.
• Ajan gözetimsiz çalışacaksa Otonom modu okuyun.
• Tehdit modeli ve kimlik bilgisi saklama ayrıntıları için Güvenlik ilkesini okuyun.
• Kaynak ve yeniden oynatma iş akışınız için önemliyse Anlamsal katmanı okuyun.

Gömmek veya otomatikleştirmek istiyorum

• TypeScript uygulama bütünleştirmesi için başsız veya gRPC giriş noktalarını @defai-digital/ax-code-sdk ile kullanın.
• Bir hizmet sınırı, üretilmiş istemciler ve yetkili OpenAPI sözleşmesi için HTTP ve OpenAPI uyumluluğunu kullanın.
• Ajan dış araçlara veya hizmetlere ihtiyaç duyduğunda ax-code mcp add kullanın.

Depoyu anlamak veya geri bildirim vermek istiyorum

• Genel belgelerin geri kalanı için Belge merkezini okuyun.
• Güncel dış katkı ilkesi için CONTRIBUTING.md dosyasını okuyun.

AX Code ne zaman uymayabilir

AX Code bilerek otomatik tamamlama veya barındırılan bir sohbet kutusundan fazlasıdır. Şu durumlarda fazla gelebilir:

• Yalnızca satır içi kod önerilerine ihtiyacınız varsa ve ajanların araç yürütmesini istemiyorsanız.
• Yerel çalışma zamanı olmayan, yalnızca barındırılan bir SaaS deneyimine ihtiyacınız varsa.
• Oturum kalıcılığı, yeniden oynatma, SDK veya sunucu bütünleştirmesi ya da depo düzeyi yönergelere ihtiyacınız yoksa.
• Yerel bir CLI sürecine izin verilmeyen bir ortamda çalışıyorsanız.

Bu durumlarda daha hafif bir düzenleyici yardımcısı daha basit olabilir. AX Code, ajanın denetim, süreklilik ve bütünleştirme sınırlarıyla gerçek geliştirme iş akışları içinde işlemesi gerektiğinde en güçlüdür.

Yaygın ilk komutlar

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok yalnızca Grok Build CLI üzerinden çalışır. grok-build-cli değerini /connect içinde seçin; AX Code yerel grok komutunu çağırır ve CLI oturum açma ile oturumunu yeniden kullanır. Eski doğrudan xai bulut API sağlayıcısı artık desteklenmez.

Belge haritası