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

AX Code Belgeleri

Durum: Etkin Kapsam: genel, güncel durum Son inceleme: 2026-10-09 Sahip: AX Code bakımcıları

AX Code, incelenebilir ve geri alınabilir iş için bir kodlama ajanı çalışma zamanıdır: her oturum dosya anlık görüntüleriyle yapılandırılmış bir olay günlüğü olarak kaydedilir, aday uygulamalar deponuzun kendi denetimlerine karşı doğrulanabilir ve hiçbir şey otomatik birleşmez. Neden AX Code, bunun neyi iyileştirdiğini, kim için olduğunu ve bilerek neyi iddia etmediğini açıklar.

Kök README, kurmak ve AX Code’u başlatmak için en kısa yoldur. Bir iş akışını yapılandırmanız, bir çalışma zamanı sınırını anlamanız veya AX Code’u başka bir sistemle bütünleştirmeniz gerektiğinde bu merkezi kullanın.

İç süreç kayıtları (PRD, ADR, belirtimler, yol haritaları, uygulama planları, rekabet incelemeleri ve denetim çalışma dosyaları) bu genel ağaçta değil .internal/ altında yaşar — aşağıdaki «Belge sınırları» bölümüne bakın. Genel sayfalar burada bağlananlardır.

Genel web sitesi: ax-code.app/tr/docs/. Mevcut kurulumlar için Yükseltme ve kurtarma ile başlayın. Kaynak erişimi ve genel indirmeler ayrıdır; bkz. Kaynak erişimi.

Göreve göre seçin

Dış bir MCP istemcisi üzerinden isteğe bağlı paylaşılan terminal gezintisi için Canlı bir TUI oturumunu MCP ile paylaşma sayfasına bakın.

Deneysel tarayıcı köprüsü (sayfaları okuma, isteğe bağlı tıklama ve doldurma) için WebMCP tarayıcı köprüsü sayfasına bakın.

AX Trust önbelleği üzerinden seçili dosyalar hakkında bağımsız sorular için Sabit bağlam soruları sayfasına bakın.

Şunu istiyorum…	Buradan başlayın
AX Code’un işime uyup uymadığına karar vermek	Neden AX Code
Kurmadan önce AX Code’u anlamak	Buradan başlayın
Bir ajanın ne yaptığını incelemek, karşılaştırmak veya geri almak	Yürütme kanıtı
Birden çok modelin aynı değişikliği denemesini sağlamak	Doğrulanmış çok modelli değişiklikler
Bir kurulum veya çalışma zamanı kanalı seçmek	Kurulum ve çalışma zamanı kanalları
Barındırılan, CLI, özel veya yerel bir sağlayıcı bağlamak	Desteklenen sağlayıcılar ve modeller
Apple Silicon üzerinde yönetilen yerel çıkarımı açmak	AX Engine model seçimi
Güncel Tiel ile MTPLX hız sayılarını okumak	Tiel eş özeti (20 Eylül 2026)
AX Code’u ücretsiz katman model API yolu ile denemek	Ücretsiz katman API hızlı başlangıç
Güvenli dosya sistemi ve ağ sınırlarıyla bir ajan çalıştırmak	Sandbox modu
Bulut veya ağ altyapısını güvenle yönetmek	Bulut işlemleri modu
Gözetimsiz veya CI içinde çalıştırmak	Otonom mod
Betiklerden veya CI içinden tek seferlik `ax-code run` CLI çağırmak	Başsız CLI
Yinelenen istemler çalıştırmak veya kalıcı görevler zamanlamak	Döngü modu ve zamanlanmış görevler
Bir çalıştırma dikkat istediğinde ses veya sözlü uyarı duymak	Ses bildirimleri
Zamanlanmış işi süreç veya ana makine çıkışları boyunca sürdürmek	Uzun süren işlemler
Yerel, bulut, hibrit, konsey veya arena yürütmesi seçmek	Yürütme modları
Dış araçlar ve veri bağlamak	MCP bütünleştirmeleri
Ajanın Chrome içinde WebMCP ile okuyup işlemesini sağlamak	WebMCP tarayıcı köprüsü
AX Code’u bir uygulamaya gömmek	`@defai-digital/ax-code-sdk`
Başka bir dil için istemci üretmek	HTTP ve OpenAPI uyumluluğu
Masaüstü veya yerel bir ana bilgisayar oluşturmak	Yerel SDK taşıması

Başlarken

Standard ve Business — açık kaynak Standard, ücretsiz ticari kullanım, planlanan tescilli Business ve genel erişim durumu.
Neden AX Code — AX Code’un neyi iyileştirdiği, amaçlanan kitle, nasıl ayrıştığı ve neyi iddia etmediği.
Buradan başlayın — ürün zihin modeli ve kullanım durumuna göre en kısa yollar.
Kurulum ve çalışma zamanı kanalları — desteklenen platformlar, paketler, güncellemeler ve katkıda bulunan başlatıcıları.

Çalışma zamanı rehberleri

Wiki kanıt görselleştirmesi — kaydedilmiş Wiki sayfa ve kaynak ilişkilerinin yerel bir çizgesini açın veya çevrimdışı HTML dışa aktarın. AX Code’un kendi wikisinden radyal, kuvvet ve sayfa odağı ekran görüntülerini içerir.
Konuşma özeti — /recap ile son işe yetişin ve boşta şeritlerini yapılandırın.
Ses bildirimleri — bir çalıştırma dikkatinizi istediğinde sistem sesleri ve isteğe bağlı sözlü uyarılar.
Yürütme kanıtı — çizge, karşılaştırma, yeniden oynatma, risk, geri alma, dal, iz ve denetim dışa aktarma.
Doğrulanmış çok modelli değişiklikler — konsey ve arena iş akışı uçtan uca.
Sandbox modu — yalıtım modları, korunan yollar, ağ denetimleri ve öncelik.
Bulut işlemleri modu — planla, onayla, uygula iş akışı, onay belirteçleri ve cloudops ajan duruşu.
Otonom mod — gözetimsiz yürütme, onaylar, başsız kullanım ve korumalar.
Başsız CLI — betikleme, CI ve ajan çağıranları için tek seferlik ax-code run komutu.
TUI dilleri ve kurulum — arayüz ve konuşma dilleri, ilk kurulum.
TUI animasyonları — açılış ve kapanış çiftleri, terminal yetenekleri ve görüntüleme yedekleri.
Döngü modu ve zamanlanmış görevler — yinelenen istemler, kalıcı zamanlamalar ve uzun çalıştırma sınırları.
Uzun süren işlemler — gözetimli hizmet örnekleri, kurtarma anlambilimi ve operasyonel denetimler.
Yürütme modları — ajan, hibrit, konsey ve arena davranışı.
Çok modelli yönlendirme için iyi uygulamalar — birinci sınıf akıl yürütme ile daha düşük maliyetli destek işini, doğruluk açısından hassas görevleri sessizce zayıflatmadan ayırın.
Model kurtarma — tam model seçimi, açık yedek yapılandırması ve tanılar.
Otomatik yönlendirme — uzman yönlendirme ve isteğe bağlı karmaşıklık yönlendirmesi.
Model eforu — düşünme düzeyleri ve sağlayıcıya özgü davranış.
Başarım — kodlama aracı profilleri ve yerel istek zamanlama tanıları.
Bellek kullanımı — bellek profilleri, önbellek tutma ve arka plan çıktı sınırları.
Yerel kanıt önbelleği — isteğe bağlı SQLite ve RocksDB kanıt yeniden kullanımı, nitelendirme ve geri alma.
Yaşam döngüsü kancaları — kanca olayları ve paketli ilke paketleri.
Çalıştırma raporu — çalışma alanı kullanımı, etkinlik, model ve araç dökümleri ve oturum başına raporlar.

Sağlayıcılar

Desteklenen sağlayıcılar ve modeller — sağlayıcı kimlikleri, kimlik bilgileri ve model keşfi.
Ücretsiz katman API hızlı başlangıç — uyumlu ücretsiz yollar, kısıtlar ve güvenli değerlendirme.
Özel ve ağ geçidi sağlayıcıları — OpenAI ve Anthropic ile uyumlu uç noktalar.
MTPLX ve oMLX kurulumu — kaynak kopyası yerel hazır ayarları, keşif, araçlar ve kimlik doğrulama.
Tiel eş özeti (20 Eylül 2026) — güncel Tiel / Cyber-Tiel ile MTPLX yerel API sayıları; 194.88 tamamlama varsayılanı, 249.01 tepe çözme.
AX Code/OpenCode istemci yeniden sınaması — altı istemci ve çalışma zamanı birleşimi, etkin MTP, ilk ve tekrar zamanlaması ve kod denetimleri.
Yerel çıkarım ölçümleri — zamanlama ve karşılaştırılabilirlik sınırlarıyla tarihli AX Code/OpenCode ve çalışma zamanı sınaması.
AX Engine model seçimi — yerel model sıralaması ve bellek rehberi.

Bütünleştirmeler

MCP bütünleştirmeleri — güven, izinler, kaynaklar ve sunucu güvenliği.
ACP — IDE ana bilgisayarları için Agent Client Protocol mutlu yolu.
AX Wiki — kaynağa dayalı depo bilgisi ve CI iş akışı.
VS Code bütünleştirmesi — düzenleyici komutları, ayarlar ve iş akışları. Pazar yeri listesinden kurun.

SDK ve hizmet sınırları

@defai-digital/ax-code-sdk — birinci taraf TypeScript ve JavaScript gömme.
Yerel SDK taşıması — gRPC biçimli masaüstü ve yerel sınır ile yedek davranış.
HTTP ve OpenAPI uyumluluğu — sunucu modu ve diğer diller için üretilmiş istemciler.
OpenAPI anlık görüntüsü — yetkili HTTP yolu ve şema sözleşmesi.

Mimari ve güvenilirlik

Anlamsal katman — çizge ve LSP kaynağı, denetim ve yeniden oynatma sınırları.
Yerel motor mimarisi — AX Code’un neden bir AX Engine yan süreci kullandığı.
Çalışma zamanı kararlılığı — iptal, çökme, akış, zaman aşımı ve TUI güvenilirlik sözleşmeleri.

Başvuru

Yapılandırma JSON şeması — üretilmiş yapılandırma girdi sözleşmesi.
TypeScript yerel desteği — kaynak derleyici, dil hizmeti, tanılar ve uyumluluk.
Beceri ve eklenti kataloğu — paketli beceriler, proje becerileri, eklentiler ve değerlendirmeler.
Yalıtım ilke paketleri — makinece okunur ilke örnekleri.
Sürüm doğrulama — kurallı minisign ortak anahtarı ve doğrulama komutu.
Windows çalışma zamanı bütünlüğü — imzalar, kurulu dosya doğrulama ve antivirüs kanıtı.
Güvenlik ilkesi — tehdit modeli, kimlik bilgisi saklama ve desteklenen sürümler.

Belge sınırları

docs/, yayımlanmış bir çalışma zamanında var olan davranış için genel rehberlik içerir. Planlama malzemesi, sürüm hedefleri, uygulama ilkesi ve geçici çözümleme buraya ait değildir:

İçerik	Konum
Mimari kararlar	`.internal/adr/`
Ürün gereksinimleri ve teknik belirtimler	`.internal/prd/` ve `.internal/spec/`
Yol haritaları, uygulama planları, sürüm hedefleri, incelemeler ve denetimler	`.internal/reports/`
Yayımlanmış davranış ve genel bütünleştirme rehberi	`docs/`

Her genel Markdown sayfası, üste yakın bir yerde durumunu, kapsamını, son inceleme tarihini ve sahibini bildirmelidir. Kopyalanmış yol listeleri ve diğer yüksek sapmalı anlık görüntüler yerine üretilmiş sözleşmelere veya uygulama kaynaklarına bağlantı tercih edin.

Bakım denetim listesi

Bir sürümden veya önemli bir belge değişikliğinden önce:

Komutları, varsayılanları, bayrakları, sağlayıcı kimliklerini ve çalışma zamanı etiketlerini uygulamalarına karşı doğrulayın.
Aynı davranışı birkaç ön kapı sayfasında yinelemek yerine en dar yetkili rehberi güncelleyin.
Kırık yerel bağlantıları, sahipsiz sayfaları ve eksik sayfa üst verisini yakalamak için pnpm run test:scripts çalıştırın.
Onaylı dışa aktarma bildirimini güncelleyin ve node script/export-public-docs.mjs --website /path/to/ax-code.app çalıştırın, sonra web sitesi denetimini, derlemeyi ve Workers duman denetimlerini çalıştırın. Web sitesi derlemeleri işlenmiş anlık görüntüyü kullanır ve kaynak erişimi gerektirmez. Yeni genel sayfalar ve varlıklar bildirimde açıkça onaylanmalıdır.
Önerileri, proje geliştirme notlarını, sürüm hedeflerini ve tarihsel karar kayıtlarını genel gezintide değil .internal/ altında tutun.