Kurulum
Gereksinimler
| en az | neden | |
|---|---|---|
| Node.js | 22 | çalışma ortamı |
| npm | 10 | Node 22 ile gelir |
| Bir ajan CLI'ı | aşağıdakilerden biri | Kortext'in sürdüğü motor |
Git gerekmez.
Bir ajan CLI'ı
Kortext anahtar tutmaz: zaten kullandığınız CLI'ın arkasındaki aboneliği
harcar. Hangisiyse onu kurun — Kortext hepsini PATH'inizden bulur, paneldeki
motor seçici ne bulduğunu gösterir.
Dördü Kortext'te gerçek bir projeyi baştan sona koşturdu:
npm install -g @anthropic-ai/claude-code # claude
npm install -g @openai/codex # codex
npm install -g @google/gemini-cli # gemini
# antigravity: Antigravity uygulamasını kurun, sonra `agy install` çalıştırın
Sekizi daha kendi belgelerinden hazırlandı ve kurulduğu gün sunulur: Cursor
(agent), GitHub Copilot (copilot), OpenCode, Amp, Droid, Goose, Qwen Code
ve Cline. Bayrakları burada bir koşudan değil, belgelerden geliyor — biri
yanlış davranırsa bir issue açın.
Kurulu bir CLI mutlaka giriş yapmış bir CLI değildir. Kortext'i gerçek bir projeye yöneltmeden önce sizinkini bir kez kendi başına çalıştırın — en sık görülen başarısız adım, hiç kimlik doğrulaması yapmamış bir ajan CLI'ıdır.
Kortext'i kurun
npm install -g kortext
npm artık paketlerin kurulum betiklerini varsayılan olarak çalıştırmıyor.
Kortext'in SQLite bağlaması yaygın platformlar için hazır derlenmiş ikili
dosyalarla geldiğinden bu genellikle yeterlidir. kortext başlar ama veri
tabanını açamazsa betiğe izin vererek bir kez kurun:
npm install -g --allow-scripts=better-sqlite3 kortext
Node 22, platforma göre
macOS
brew install node@22
Node sürümleri arasında mı geziyorsunuz? brew install fnm && fnm install 22 && fnm default 22.
Windows — deneysel
Kortext macOS ve Linux'ta geliştiriliyor ve test ediliyor. Windows yolları —
ajan CLI'ınızı where ile bulmak ve npm'in kurduğu .cmd shim'ini
çalıştırmak — belgelenmiş davranışa göre yazıldı ama Windows'ta koşturulmadı.
Bir şey çalışmazsa bir issue açın;
bu bir eksik, sizin kurulumunuzun suçu değil.
Node 22'yi nodejs.org'dan kurun (v22.x etiketli LTS). Tools for Native Modules ekranında "Automatically install the necessary tools" kutusunu işaretleyin — Kortext'in SQLite bağlaması bunlara ihtiyaç duyar.
Global kurulumda EACCES ya da izin hatası mı? Yönetici kabuğu yerine npm'in
global önekini size ait bir klasöre yöneltin:
npm config set prefix "$env:APPDATA\npm"
ve %APPDATA%\npm'i PATH'inize ekleyin.
Linux
sudo apt install -y curl build-essential python3 # SQLite bağlaması için gcc/make
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install 22 && nvm alias default 22
Asla sudo npm install -g yapmayın. EACCES görürseniz
npm config set prefix ~/.npm-global çalıştırın ve ~/.npm-global/bin'i
PATH'inize koyun.
Menü çubuğu uygulaması — macOS, isteğe bağlı
Mac'te Kortext menü çubuğunda da yaşayabilir: sizi ne bekliyor, bir belge
düştüğünde bildirim, sunucu için ⏻. Ayrı bir indirmedir ve önce kortext'in
kurulu olmasını ister — bkz. Menü çubuğu uygulaması.
Çalıştığını doğrulayın
node --version # v22 ya da daha yeni
kortext --version
which claude || which codex || which agy || which gemini
Hiç ajan CLI'ı kurulu değilse panel bunu başlığında söyler.
Sıradaki: İlk projeniz.