12 KiB
Numex Codex
Editörüne Türkçe düşünen bir kod ajanı.
İste, yazsın, çalıştırsın — iş bitene kadar.
🇹🇷 Türkçe · 🇬🇧 English
Numex Codex, Numex AI'ın kod ajanıdır. Ona Türkçe ne istediğini söylersin; plan çıkarır, kodu yazar, çalıştırır, test eder ve ancak çalıştığını kanıtladığında "bitti" der. Karmaşık işlerde tek başına değil, dört uzmandan oluşan bir Konsey ile çalışır.
📌 Bu depo Numex Codex'in tanıtım, dokümantasyon ve topluluk deposudur. Hata bildirimleri, öneriler ve tartışmalar burada; sürümler codex.numexai.com.tr'den indirilir. Açık kaynak SDK: numex-sdk.
📑 İçindekiler
- Üç kapı, tek ajan
- Hızlı başlangıç
- 🏛️ Konsey — 4 uzman, tek görev
- Dört çalışma modu
- Kanıtsız "bitti" yok: FinishGate
- Codex IDE
- Codex CLI
- Codex Web
- Şeffaf hafıza:
.numex/ - Güvenlik ve kontrol
- Fiyat
- Dokümanlar
🚪 Üç kapı, tek ajan
| Nerede? | Kurulum | Kimin için? | |
|---|---|---|---|
| 🧩 Codex IDE | Windows masaüstü | İndir — v2.9.59, ~162 MB, tamamen Türkçe | Günlük profesyonel geliştirme |
| 🧩 VS Code eklentisi | Mevcut VS Code'un | Eklentiyi kur + CLI'ye giriş yap | Alışkanlığını bozmadan |
| ⌨️ Codex CLI | Terminal | npm i -g @numexai/cli |
Terminal, otomasyon, uzak sunucu, CI |
| 🌐 Codex Web | Tarayıcı | Yok | Kurulumsuz, "sohbet eder gibi" hızlı proje |
Hepsi aynı Numex Çekirdeği'ni kullanır: terminaldeki komut ile editördeki buton birebir aynı davranır. Programatik erişim için: Numex SDK.
⚡ Hızlı başlangıç
$ npm i -g @numexai/cli
$ numex login
✓ Giriş başarılı — hoş geldin 👋
$ numex
◇ Numex Codex — Türkçe kod ajanı hazır
İlk görevini ver:
numex "koyu temalı, localStorage kullanan bir yapılacaklar uygulaması yap"
🏛️ Konsey — 4 uzman, tek görev
Çoğu kod ajanı tek bir modelin her şeyi aynı anda yapmasına dayanır: planlar, yazar, test eder ve "bitti" der — kendi ödevini kendi notlandıran bir öğrenci gibi. Codex'te karmaşık işler bir Konsey'e verilir; her üyenin tek bir işi ve sınırlı bir yetkisi vardır.
| Üye | Görevi | Yazabilir mi? |
|---|---|---|
| 📐 Mimar | Klasör yapısı, veri modeli, dosya dosya fonksiyon planı | ❌ Sadece plan |
| 💻 Kodlayıcı | Plana göre tam ve çalışan kodu yazar — iskelet, TODO yok | ✅ Tek yazıcı |
| 🛡️ Denetçi | Önce "doğru şeyi mi yaptık?", sonra test ve doğrulama | ❌ Sadece test/rapor |
| 🎨 Tasarımcı | Arayüz ve kullanıcı deneyimi cilası | ⚠️ Sadece CSS/HTML |
flowchart LR
U([İstek]) --> A[📐 Mimar]
A --> C[💻 Kodlayıcı]
C --> H[🔁 Self-Healing]
H --> D[🛡️ Denetçi]
H --> T[🎨 Tasarımcı]
D -->|sorun| C
D --> G{🚦 FinishGate}
T --> G
G -->|kanıt ✓| OK([✅ Onay])
G -->|kanıt yok| H
- Tek yazıcı kuralı: Kodu yalnızca Kodlayıcı yazar; çakışma imkânsızdır.
- Konu sapması kontrolü: Mimar'ın planı isteğinden saparsa Kodlayıcı planı değil senin isteğini esas alır.
- Doğru iş için doğru ekip: Basit bir düzeltmede konsey toplanmaz; işin büyüklüğüne göre 0, 2, 3 ya da 4 üye çağrılır ve token bütçesi önceden kontrol edilir.
- Kendin çağır: "konseyi topla", "ajanları çağır", "ekibi topla", "hep birlikte bak".
- Dürüst rapor: Sonunda ne olduğunu düz Türkçe anlatan bir konsey raporu; çözülemeyen sorun varsa açıkça söylenir.
👉 Ayrıntılı anlatım: Konsey nasıl çalışır?
🔀 Dört çalışma modu
| Mod | Ne yapar? | Örnek |
|---|---|---|
| 💬 Sohbet | Soru-cevap; dosya okur, açıklar, önerir | "Bu proje ne yapıyor?" |
| 🗺️ Plan | Kod değiştirmeden mimari plan ve adım listesi | "Ödeme modülü nasıl eklenir?" |
| 🤖 Otonom | Plan → onay → uygula → doğrula döngüsünü kendisi yürütür | "Testleri yeşile çek" |
| 🐞 Hata Avcısı | Log, terminal çıktısı ve koddan kök nedeni bulur | "Uygulama açılıyor ama ses yok" |
Her adım görünür: "🔍 7 adım · 2 dosya okundu · 2 klasör tarandı · 63 eşleşme".
🚦 Kanıtsız "bitti" yok: FinishGate
Kod ajanlarının klasik hatası: "Tamamlandı!" deyip çalışmayan kod teslim etmek. Codex'te görev ancak canlı kanıtla kapanır:
- ✅ Sunucu gerçekten HTTP 200 dönüyor mu?
- ✅ Testler geçiyor mu?
- ✅ Tarayıcıda DOM beklenen öğeleri içeriyor mu? (Omni-Vision: headless tarayıcıyla görsel kontrol)
Kanıt yoksa ajan Self-Healing döngüsüne döner: sözdizimi, yapı, veri bütünlüğü ve parantez dengesi kontrol edilir, hata düzeltilir, tekrar denenir. Ajan takılırsa StuckDetector devreye girip sana ya da web aramasına döner.
🧩 Codex IDE — "Numex Çözüm"
VS Code tabanlı masaüstü editör. Sağ paneldeki asistanın adı Numex Çözüm.
| ✍️ Satır içi düzenleme | Ctrl+K → "bunu async yap" |
| ⏭️ Sonraki düzenleme | Bir değişiklik yaparsın, ilgili sonraki yeri tahmin eder → Tab |
| 🔍 Kod Lens | Her fonksiyonun üstünde ◆ Numex: … hakkında sor |
| 🧠 Anlamsal arama | "Ödeme nerede doğrulanıyor?" — embedding indeksiyle |
| 🖼️ Görselden arayüz | Ekran görüntüsü → çalışan kod |
| 🖥️ Terminal | Doğal dilden komut üret · terminal çıktısını sohbete gönder |
| 🔀 Git | Commit mesajı üret · değişiklikleri AI ile incele · PR aç |
| 🤖 Ajanlar | Arka plan ajanı · bulut ajanı · gömülü tarayıcı · Design Mode · Composer |
| 🌍 Uzak | SSH ve WSL ile uzak sunucuya bağlan |
| ⚙️ Ayarlar | Model & sağlayıcı · sohbet & onay · Mizah Modu · RAG · tema · token kullanımı |
Tüm komutlar ve kısayollar: docs/komutlar.md
⌨️ Codex CLI
numex # terminal sohbeti
numex "görev" # tek seferlik görev
numex plan "ödeme modülü ekle" # sadece plan, kod değişmez
numex mission "testleri yeşile çek" # izole çalışma alanında uzun otonom misyon
numex undo # son turu tek tıkla geri al
numex --offline "…" # yerel Ollama ile internetsiz
/model fast | pro | code # profili kilitle
- ✂️ Cerrahi yama — dosyayı baştan yazmaz, diff parçalarıyla hedefli değişiklik
- 🛰️ Subshell yakalama — arka plandaki npm/vite/node hatalarını ~2 sn'de yakalar, toparlanır
- 🌳 Canlı ağaç ilerlemesi — görev adımları ağaç görünümünde
- 🔎 BM25 + AST kod indeksi · 🔌 MCP istemcisi (dosya sistemi, git)
📱 Uzaktan PC — telefondan bilgisayarına
numex uzak install # arka plan köprüsü; terminal kapansa da çalışır, sistem tepsisinde ikon
Sonra numexai.com.tr/developers/remote sayfasından Google ile giriş yap, yeşil noktalı PC'ni seç, yaz: klasör oluştur, dosya yaz, komut çalıştır.
 |
 |
🌐 Codex Web
"Chat kutusuna ne istediğini yaz. Agent dosyaları otomatik oluşturur, editöre yazar, önizlemeyi günceller. Tek buton yok, tek tıklama yok — sadece yaz ve izle."
- Solda dosya gezgini + Monaco editörü, sağda ajan sohbeti, altta terminal, ayrı önizleme
- Şablonlar: Başlangıç · Todo · Hesap · Dashboard · E-ticaret · Blog · Manav
- Hedef platform (Web / API / Masaüstü) ve proje türü (Muhasebe, POS, Oyun, E-ticaret…) seçimi
- Ajan değişiklik kartı: Kabul Et / Fark / Reddet
- Kaydet · ZIP indir · URL'den aç · 🚀 Yayınla — tek tıkla herkese açık adres
🧠 Şeffaf hafıza: .numex/
Codex ne bildiğini ve ne yaptığını gizlemez. Her projede okunabilir bir .numex/ klasörü tutar:
RAG indeksi, denetim izi (audit-trail.jsonl), geri alma noktaları, öğrenilen hatalar, misyon
durumu ve token kullanımı. Projeye döndüğünde ajan kaldığı yerden devam eder.
🔐 Güvenlik ve kontrol
- Önce anlaşalım, sonra yapalım: Otonom modda bile plan sunar ve onay alır.
- Diff önizleme: Her değişiklik kabul/ret için gösterilir.
- Geri alma:
numex undo,.numex/checkpoints. - Denetim izi: Ajanın çalıştırdığı her komut ve yaptığı her değişiklik kayıtlı.
- Kendi bilgisayarında: Ajan dosyalarını senin makinende işler; veriler Türkiye'de, KVKK uyumlu altyapı.
💳 Fiyat
| Plan | Codex erişimi |
|---|---|
| Ücretsiz | Temel CLI |
| Başlangıç PRO — ₺99/ay | Tam CLI |
| Numex PRO — ₺399/ay | Tam CLI + API, 128K bağlam, öncelikli kuyruk |
| Advanced — ₺599/ay | Tam CLI + tam API, 3 hesap, canlı destek |
Kota bitince Numex Kredisi; abonelik istemeyenlere zaman bileti (8 saat ₺29'dan). Güncel fiyatlar: numexai.com.tr.
📚 Dokümanlar
| 🏛️ Konsey nasıl çalışır? | 4 uzman, bütçe seviyeleri, FinishGate, konsey raporu |
| ⌨️ Komutlar ve kısayollar | CLI komutları, IDE komut paleti |
| 🧠 .numex klasörü | Ajanın şeffaf hafızası |
| 🌐 Numex ekosistemi | Numex Ailesi'nin tamamı |
| 🧰 Numex SDK | Codex'i kendi kodundan çalıştır |
🤝 Topluluk
- 🐞 Hata mı buldun? → Hata bildir
- 💡 Fikrin mi var? → Özellik isteği
- 💬 Codex ile ne yaptın? → Discussions
- 🔒 Güvenlik açığı → destek@numexai.com.tr (lütfen herkese açık issue açma)
Numex Codex · Numex Ailesi'nin geliştirici kapısı
İnsanı önce koyan Türk yapay zekâsı 🇹🇷