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

Kurulum ve Çalışma Zamanı Kanalları

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

Kök README birincil kurulum yolunu tutar. Bu sayfa, desteklenen CLI yükleyici kanalları, ax-code doctor çalışma zamanı etiketleri, yerel başlatıcı davranışı ve genel yükseltme davranışı için doğruluk kaynağıdır.

Genel kullanılabilirlik

Genel sürüm yükleyicileri ve imzalı çalışma zamanı arşivleri download.ax-code.com üzerinden dağıtılır. Kurulum özel GitHub kimlik bilgileri gerektirmez.

AX Code ve SDK yalnızca Node.js 26 veya üzerini destekler. Bağımsız yükleyiciler doğrulanmış bir Node çalışma zamanı paketler. Kaynak kopyaları ve Node tabanlı SDK uygulamaları Node.js 26+ sağlamalıdır; paket kurulumu daha eski Node sürümlerini reddeder.

AX Code Standard, mevcut lisansı altında kişisel ve ticari kullanım için ücretsiz kalır. Geliştirme kaynak erişimi, genel dağıtımdan ayrı yönetilir. Planlanan tescilli Business bileşenlerinin ayrı lisansı vardır; bu, Standard lisansını değiştirmez. Ayrıntılar için Standard ve Business sayfasına ve genel kurulum güncellemeleri için web sitesi rehberine bakın. Genel yükleyiciler ve imzalı varlıkları, web sitesi tek satırlık bir kurulum komutu duyurmadan önce erişilebilir ve doğrulanmış olmalıdır.

Sürüm kullanılabilirliği

Bir vMAJOR.MINOR.PATCH git etiketini itmek Release iş akışını başlatır. Genel sürüm dizini bir sürümü yalnızca o iş akışı varlıkları imzalayıp yayımladıktan sonra listeler. O zamana kadar Latest önceki yayımlanmış etikette kalır. Doğrulama başarılı olduktan sonra bakımcılar yeni etiket için bir Draft görebilir; bu, genel Latest değildir.

Mevcut kurulumlar için Yükseltme ve kurtarma sayfasını izleyin.

Önerilen yol

Bir kopyadan geliştirme yapmıyorsanız desteklenen paketli bir yükleyici kullanın. Sürüm yükleyicisi macOS ve Linux üzerinde birincil CLI yoludur; Windows üzerinde yerel PowerShell yükleyicisini kullanın.

macOS (Apple Silicon)

curl -fsSL https://download.ax-code.com/install | bash

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Ubuntu 24.04+

curl -fsSL https://download.ax-code.com/install | bash

Homebrew, macOS CLI için desteklenen bir alternatif olarak kalır:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Homebrew, resmi olmayan tap kayıtları için açık güven ister. Bu tap genelindeki güven, defai-digital/tap içinde yayımlanan tüm güncel ve gelecekteki formülleri, cask paketlerini ve dış komutları kapsar. Paylaşılan tap hem CLI formülünü hem de Desktop cask paketini içerir ve Homebrew bir kurulumu çözerken her iki tanımı da yükleyebilir. Tap genelindeki güven kabul edilemezse sürüm yükleyicisini kullanın.

Mevcut bir kurulumu eski tap kaydından taşıma

defai-digital/ax-code artık yalnızca geçiş için bir tap kaydıdır. AX Code sürümleri yalnızca defai-digital/tap değerini günceller. Eski tap kaydından kurduysanız, Homebrew kurulu paketin tap sahipliğini taşıyabilsin diye güncellemeden önce paylaşılan tap kaydını ekleyin:

brew tap defai-digital/tap
brew trust --formula defai-digital/tap/ax-code
brew update
brew upgrade defai-digital/tap/ax-code
brew info defai-digital/tap/ax-code

Kurulumun paylaşılan tap kaydını kullandığını doğruladıktan sonra eski tap kaydını kaldırın:

brew untap defai-digital/ax-code

Homebrew hâlâ eski tap kaydını bildiriyorsa, kaydı kaldırmadan önce brew reinstall defai-digital/tap/ax-code çalıştırın. Eski depo, mevcut kurulumların geçişi keşfedebilmesi için erişilebilir kalır.

Sürüme sabitlenmiş bir Unix yükleyicisini doğrulama

İncelenmiş, sürüme sabitlenmiş bir Unix kurulumu için önce yükleyiciyi ve imzasını aynı sürümden indirin. Güvenilen bir minisign zaten varsa:

AX_INSTALL_VERSION="<release>"
AX_INSTALL_BASE="https://download.ax-code.com/releases/download/v${AX_INSTALL_VERSION}"
curl -fsSL "$AX_INSTALL_BASE/install" -o ax-code-install
curl -fsSL "$AX_INSTALL_BASE/install.minisig" -o ax-code-install.minisig
minisign -Vm ax-code-install -x ax-code-install.minisig -P 'RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO'
# Inspect ax-code-install before running it.
bash ax-code-install --version "$AX_INSTALL_VERSION" --no-modify-path

Arşivin imzası, önyükleme betiğini yürütmeden önce kimlik doğrulamaz. Aynı kaynaktan indirilen bir özet bozulmayı saptar ama bağımsız bir yayımcı kimliği denetimi değildir. Tek satırlık yol, HTTPS dağıtım uç noktasına dayanır.

Tek satırlık uzaktan yürütme bir kolaylık yoludur. Windows yükleyicisi, indirdiği CLI ZIP dosyasını başladıktan sonra minisign ile doğrular, ancak irm | iex yürütmeden önce install.ps1 dosyasının kendisini doğrulamaz.

minisign PATH üzerinde değilse PowerShell yükleyicisi, sabitlenmiş minisign 0.12 arşivini download.ax-code.com adresinden indirir, SHA-256 değerini denetler ve çıkarılan yürütülebilir dosyayı önbelleğe almadan önce yeniden denetler. Varsayılan kurulum yolu için minisign’ı elle kurmanız gerekmez. PATH üzerinde zaten bulunan bir minisign ikilisi olduğu gibi kullanılır.

Güvenlik açısından hassas ortamlarda yükleyiciyi indirin, minisign ile doğrulayın, inceleyin ve CI tarafından kullanılan yayın sürümünü sabitleyin:

$AX_CODE_VERSION = "<release>"
$AxCodeMinisignPublicKey = "RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO"
irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
irm https://download.ax-code.com/install.ps1.minisig -OutFile ax-code-install.ps1.minisig
# Optional: use a preinstalled minisign, or let install.ps1 bootstrap one when verifying the archive.
minisign -Vm ax-code-install.ps1 -x ax-code-install.ps1.minisig -P $AxCodeMinisignPublicKey
Get-Content .\ax-code-install.ps1
.\ax-code-install.ps1 -Version $AX_CODE_VERSION -NoModifyPath

Doğrulanamayan bir sürüm indirmesini kasıtlı olarak kabul ettiğinizde yalnızca AX_CODE_SKIP_MINISIGN_VERIFY=1 ayarlayın.

Kurulu çalışma zamanını doğrulayın:

ax-code doctor

Desteklenen kullanıcı kurulumları macOS, Windows ve Linux (glibc) üzerinde Runtime: Node vX.Y.Z (node-bundled) bildirmelidir.

Bu yükleyiciler CLI/TUI çalışma zamanını dağıtır. Desktop sürüm sahipliği AX Coder içindedir ve yeni Desktop sürümleri şu anda dondurulmuştur. Bu rehber bir Desktop kurulum veya yükseltme kanalı sunmaz.

Kanal matrisi

node-bundled ve source çalışma zamanı modlarıdır, paket yöneticisi adları değildir. Uygulama kodunu hangi yürütülebilir dosyanın yüklediğini anlatırlar:

• node-bundled: Node.js, paketli sürüm çalışma zamanını yükler (desteklenen tüm kullanıcı kurulum kanalları).
• source: Node, dosyaları doğrudan bir kopyadan yükler.

compiled ve bun-bundled emekliye ayrılmış Bun dönemi çalışma zamanı modlarıdır ve yalnızca eski tanı için tutulur. Desteklenen kullanıcı kurulum kanalları değildir.

pnpm dev ve pnpm cli, başlatmadan önce çalışma alanı SDK değerini (packages/sdk/js) depo TypeScript derleyicisiyle dist hedefine derler; böylece yeni bir kopya elle SDK derlemesi olmadan çalışır. Adım typescript/bin/tsc değerini node üzerinden doğrudan çağırır, bu yüzden node_modules/.bin bağlantısına bağlı değildir. Paketli yollar (pnpm run setup:cli ve pnpm --dir packages/ax-code run build) hâlâ önce pnpm --dir packages/sdk/js run build gerektirir.

Platform ilkesi

• macOS: belgelenmiş birincil CLI yolu olarak bash sürüm yükleyicisini kullanın. ~/.ax-code altına kurar, gerektiğinde sabitlenmiş Minisign önyükler, sürüm arşivini doğrular ve Homebrew gerektirmez. darwin-arm64 arşivi, yerel çıkarım için kendi içinde bir AX Engine yan sürecini içerir. Katkıda bulunan derlemeleri pnpm run setup:cli kullanır.
• Desteklenen Homebrew yolu, tam nitelikli kurulum komutlarını kullanmadan önce defai-digital/tap kaydını açıkça ekler ve güvenir. Tap genelindeki güven, paylaşılan kayıt içindeki tüm güncel ve gelecekteki formülleri, cask paketlerini ve dış komutları kapsar; bu güven kapsamı kabul edilemezse bash sürüm yükleyicisini kullanın.
• Linux CLI: amd64 ve arm64 (glibc) üzerinde Ubuntu Desktop/Server 24.04 LTS ve daha yenisi için bash yükleyicisini kullanın. Sürüm derlemeleri, glibc taban çizgisinin 24.04+ ile uyumlu kalması için Ubuntu 24.04 çalıştırıcılarında ax-code-linux-x64.tar.gz ve ax-code-linux-arm64.tar.gz üretir. Musl (Alpine) güncel sürüm arşivleri tarafından desteklenmez.
• macOS CLI arşivleri: sürüm derlemeleri yalnızca darwin-arm64 yayımlar (Apple Silicon). Intel macOS, güncel CLI/Desktop paketleri için desteklenen bir kurulum hedefi değildir.
• Windows CLI: yerel PowerShell yükleyicisini kullanın. GitHub sürüm varlığını kullanıcıya yerel bir dizine kurar ve -NoModifyPath verilmedikçe kullanıcı PATH değerini günceller. İndirilen ZIP dosyasını çıkarmadan önce sabitlenmiş ortak anahtarla doğrular ve AX_CODE_SKIP_MINISIGN_VERIFY=1 kasıtlı olarak ayarlanmadıkça hata durumunda kapanır. minisign yoksa yükleyici, sabitlenmiş minisign 0.12 arşivini download.ax-code.com adresinden %LOCALAPPDATA%\ax-code\tools\minisign içine indirir ve çıkarılan yürütülebilir dosyayı önbelleğe almadan önce denetler. PATH üzerinde zaten bulunan bir minisign ikilisi olduğu gibi kullanılır. Kullanıcıya yerel kurulumu ve PATH girdisini kaldırmak için -Uninstall kullanın.
• Windows Desktop: GitHub Releases üzerinden AX-Code-<version>-win-x64.exe veya AX-Code-<version>-win-arm64.exe adlı imzalı Electron yükleyicisini kullanın. Beklenen Authenticode yayımcısı DEFAI Private Limited değeridir. install.ps1 değerini bir Desktop yükleyicisi olarak anlatmayın. Sessiz kurulum: .\AX-Code-<version>-win-x64.exe /S (NSIS).
• Winget: paket bildirimleri pnpm exec tsx tools/winget/generate-manifests.ts --version <ver> ile üretilir ve microsoft/winget-pkgs hedefine gönderilir (bkz. tools/winget/README.md). Yukarı akışta yayımlanana kadar GitHub Releases, Windows kurulumunun doğruluk kaynağı olarak kalır.

Tek satırlık uzaktan yürütme bir kolaylık yoludur, tek yol değildir. Belgelerde incelenebilir (ve Windows üzerinde minisign ile doğrulanmış) bir yükleyici akışını tutun, CI içinde sabitlenmiş sürümler kullanın ve platform yükleyicilerini yalnızca ax-code --version değerini doğrulayan ve ax-code doctor değerinin o platform için beklenen çalışma zamanı modunu bildirdiğini doğrulayan kurulum matrisi kapsamıyla belgeleyin.

Kurumsal ve gözetimsiz kurulumlar

Windows CLI (kullanıcıya yerel, yönetici yok)

# Pin version in CI/images
$env:AX_CODE_VERSION = "7.9.4"
irm https://download.ax-code.com/releases/download/v$env:AX_CODE_VERSION/install.ps1 -OutFile install.ps1
# Optional: verify install.ps1.minisig first (see SECURITY.md)
.\install.ps1 -Version $env:AX_CODE_VERSION -NoModifyPath
# Then add %USERPROFILE%\.ax-code\bin to the machine/user PATH via your MDM.

macOS (kullanıcıya yerel / Homebrew / MDM)

Homebrew olmadan kullanıcıya yerel bir CLI kurulumu için sürüm yükleyicisini kullanın:

curl -fsSL https://download.ax-code.com/install | bash

Yönetilen Mac bilgisayarlar, CLI güncellemelerinin tap kaydını izlemesi için Homebrew formülünü kullanabilir:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

MDM ile paketlenmiş DMG kurulumları için GitHub Releases üzerinden noter onaylı AX-Code-*-mac-arm64.dmg kullanın ve ilke tedarik zinciri denetimleri gerektirdiğinde ayrık .minisig imzasını doğrulayın.

Winget kullanılabilirliği

Doğrulanmış bir topluluk CLI paketi yoksa genel yükleyiciyi kullanın. GitHub üzerinde barındırılan bildirim paketlerinin anonim olarak erişilebilir olduğunu varsaymayın.

Güncelleme

Etkin kuruluma sahip olan kanalı seçin:

Mevcut eski tap kullanıcıları paylaşılan tap geçişini izlemelidir. İkinci bir kurulum PATH üzerinde birincisini gölgeleyebilir; kanal değiştirmeden önce which -a ax-code, ax-code --version ve ax-code doctor kullanın. Bağımsız sürümü kurmak Homebrew kurulumunu kaldırmaz. Kanallar arasında yalnızca bilinçli geçin ve oturum ile yapılandırma verilerinizi saklayın.

Unix kendi kendine yükseltmeleri, yükleyiciyi hedef sürümden alır ve SHA-256 yan dosyasını gerektirir. Eksik bir yükleyici veya özet yükseltmeyi durdurur; değişebilir bir main yedeği yoktur. Yükleyici varlıkları olmayan bir sürümden daha eski bir arşiv kurmak için güncel yayımlanmış bir yükleyiciyi indirip doğrulayın, sonra --version <older-version> ile çalıştırın.

Bağımsız Unix kurulumları ~/.ax-code/bin/ax-code değerini, ~/.ax-code/versions/ altındaki benzersiz bir çalışma zamanı kuşağına giden kararlı bir sembolik bağ olarak kullanır. Yükleyici, bu bağı değiştirmeden önce yeni ağacın tamamını doğrular. Bir sürümü yeniden kurmak yeni bir kuşak oluşturur. Eski kuşakları ve eski çalışma zamanı dosyalarını saklar, böylece hâlihazırda çalışan ajanlar kendi modüllerini yüklemeye devam edebilir. Çalışan ajanları yeniden başlatmaz. Yeni sürümü kullanmak için yeni bir istemci veya çalışma zamanı başlatın; bir çalışma zamanı yeniden başlatmasından önce etkin işi açıkça durdurun. Homebrew dosyaları Homebrew tarafından yönetilmeye devam eder.

Geri alma için --version <previous-version> ile doğrulanmış bir yükleyici kullanın. Saklanan her kuşaktaki version dosyası, kendi sürümünü tanımlar. Eski kuşaklar otomatik olarak budanmaz; onları kullanan tüm süreçleri durdurduktan sonra kullanılmayan kuşakları kaldırabilirsiniz. Kaldırma sırasında gerekirse oturumları ve yapılandırmayı --keep-data --keep-config ile saklayın; ikili kaldırma rehberini izleyin ve kullanılmayan çalışma zamanı kuşaklarını ancak süreçleri durduktan sonra ayrıca kaldırın. Başka yapılandırma veya kişisel dosyalar sakladıysanız .ax-code klasörünün tamamını silmeyin.

Eşzamanlı bir Unix kurulumu .install-lock dizin konumuyla başarısız olur. Aniden sonlandırılan bir yükleyici o boş dizini bırakabilir. Eski bir kilidi kaldırıp yeniden denemeden önce etkin yükleyicileri denetleyin; bir kurulum sürerken onu kaldırmayın.

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Windows üzerinde bu, CLI kurulumunu günceller. CLI kurulumunu ve kullanıcı PATH girdisini kaldırmak için:

irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
.\ax-code-install.ps1 -Uninstall

Katkıda bulunan başlatıcı davranışı

Bu bölüm yetkili bir kaynak kopyası gerektirir. Genel kurulum veya yükseltmeler için gerekli değildir; bkz. Kaynak erişimi.

pnpm run setup:cli kasıtlı olarak varsayılan derlenmiş yoldur. packages/ax-code/dist/... altındaki yerel paketli ikiliyi derler veya yeniden kullanır ve o ikiliye işaret eden genel bir başlatıcı kurar. Bu, yerel paketli çalışma zamanı denetimlerini Homebrew ve curl yükleyici kullanıcılarının çalıştırdığı şeye yakın tutar.

Bu başlatıcı genellikle ~/.local/bin veya PNPM_HOME içine yerleşir; bu konum PATH üzerinde tipik olarak Homebrew kaydından öncedir. Homebrew zaten ax-code sağlıyorsa setup:cli kopyayı ax-code-src olarak kurar ve daha önce yazılmış bir ax-code sarmalayıcısını kaldırır; böylece brew upgrade ax-code, ax-code komutunu güncellemeye devam eder. Yalnızca pnpm run setup:cli -- --override-homebrew kullanın; kopyanın ax-code değerini devralmasını kasıtlı olarak istediğinizde. ax-code doctor bu geçersiz kılmayı hâlâ PATH launchers olarak uyarır.

Paketli çalışma zamanını etkilemesi gereken kaynak değişikliklerinden sonra, genel başlatıcıyı sınamadan önce paketli ikiliyi yenileyin:

pnpm --dir packages/ax-code run build -- --single
pnpm run setup:cli -- --rebuild
ax-code-src --version   # or `ax-code` if Homebrew is not installed

Kopya komutunun bu kopyayı Node üzerinden kaynak dosyalardan yürütmesini kasıtlı olarak istediğinizde yalnızca kaynak başlatıcıyı kullanın:

pnpm run setup:cli -- --source
ax-code-src doctor      # or `ax-code doctor` if Homebrew is not installed

Kaynak başlatıcı Runtime: Node vX.Y.Z (source) bildirmelidir.

Araç zinciri gereksinimleri

Depo, pnpm@10.33.4 kuralını kök packageManager alanı ve only-allow pnpm üzerinden uygular: preinstall kancası pnpm dışı kurulumları engeller ve kök pre<script> kancaları npm run <script> değerini aynı gereksinimle engeller. Node.js, kök package.json motoruyla (>=26) eşleşmelidir; bu motor kaynak modu TUI komutları için --experimental-ffi de sağlar.

Kök pnpm test kullanmayın; kök betik kasıtlı olarak do not run tests from root ile çıkar. packages/ax-code için testleri packages/ax-code/ içinden çalıştırın.

Homebrew kurulumları, otomatik arka plan yükseltmesi olmadan güncelleme bildirimleri alır. Homebrew fıçılarını açıkça yükseltmeden veya eski fıçıları temizlemeden önce etkin ajan çalıştırmalarını bitirin.