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.
- Üç 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
| 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.
$ 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"Ç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ı |
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?
| 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".
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.
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
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)
numex uzak install # arka plan köprüsü; terminal kapansa da çalışır, sistem tepsisinde ikonSonra 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.
 |
 |
"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
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.
- Ö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ı.
| 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.
| 🏛️ 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 |
- 🐞 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ı 🇹🇷