2026-09-23 23:40:08 +00:00
< div align = "center" >
< img src = "gorseller/codex-banner.png" alt = "Numex Codex — Editörüne Türkçe düşünen bir kod ajanı " width = "100%" >
# Numex Codex
### Editörüne Türkçe düşünen bir kod ajanı .
**İste, yazsı n, çalı ştı rsı n — iş bitene kadar.**
[](https://codex.numexai.com.tr)
[](https://codex.numexai.com.tr)
[](https://codex.numexai.com.tr)
2026-09-24 00:54:13 +00:00
[](https://github.com/numexai/numex-sdk)
2026-09-23 23:40:08 +00:00
🇹🇷 Türkçe · [🇬🇧 English ](README.en.md )
< / div >
---
Numex Codex, [Numex AI ](https://numexai.com.tr )'ı 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](https://codex.numexai.com.tr)'den
2026-09-24 00:54:13 +00:00
> indirilir. Açı k kaynak SDK: [numex-sdk](https://github.com/numexai/numex-sdk).
2026-09-23 23:40:08 +00:00
## 📑 İçindekiler
- [Üç kapı , tek ajan ](#-üç-kapı -tek-ajan )
- [Hı zlı başlangı ç ](#-hı zlı -başlangı ç )
- [🏛️ Konsey — 4 uzman, tek görev ](#️ -konsey--4-uzman-tek-görev )
- [Dört çalı şma modu ](#-dört-çalı şma-modu )
- [Kanı tsı z "bitti" yok: FinishGate ](#-kanı tsı z-bitti-yok-finishgate )
- [Codex IDE ](#-codex-ide--numex-çözüm )
- [Codex CLI ](#️ -codex-cli )
- [Codex Web ](#-codex-web )
- [Şeffaf hafı za: `.numex/` ](#-şeffaf-hafı za-numex )
- [Güvenlik ve kontrol ](#-güvenlik-ve-kontrol )
- [Fiyat ](#-fiyat )
- [Dokümanlar ](#-dokümanlar )
---
## 🚪 Üç kapı , tek ajan
| | Nerede? | Kurulum | Kimin için? |
|---|---|---|---|
| 🧩 **Codex IDE** | Windows masaüstü | [İndir ](https://codex.numexai.com.tr ) — 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ı
2026-09-24 00:54:13 +00:00
davranı r. Programatik erişim için: [Numex SDK ](https://github.com/numexai/numex-sdk ).
2026-09-23 23:40:08 +00:00
## ⚡ Hı zlı başlangı ç
```console
$ 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:
```bash
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 |
```mermaid
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?](docs/konsey.md)**

---
## 🔀 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 ](docs/komutlar.md )**
## ⌨️ Codex CLI
```bash
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
```bash
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.
👉 [docs/numex-klasoru.md ](docs/numex-klasoru.md )
## 🔐 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 ](https://numexai.com.tr ).
## 📚 Dokümanlar
| | |
|---|---|
| 🏛️ [Konsey nası l çalı şı r? ](docs/konsey.md ) | 4 uzman, bütçe seviyeleri, FinishGate, konsey raporu |
| ⌨️ [Komutlar ve kı sayollar ](docs/komutlar.md ) | CLI komutları , IDE komut paleti |
| 🧠 [.numex klasörü ](docs/numex-klasoru.md ) | Ajanı n şeffaf hafı zası |
2026-09-24 00:54:13 +00:00
| 🌐 [Numex ekosistemi ](https://github.com/numexai/numex_nedir ) | Numex Ailesi'nin tamamı |
| 🧰 [Numex SDK ](https://github.com/numexai/numex-sdk ) | Codex'i kendi kodundan çalı ştı r |
2026-09-23 23:40:08 +00:00
## 🤝 Topluluk
- 🐞 Hata mı buldun? → [Hata bildir ](../../issues/new/choose )
- 💡 Fikrin mi var? → [Özellik isteği ](../../issues/new/choose )
- 💬 Codex ile ne yaptı n? → [Discussions ](../../discussions )
- 🔒 Güvenlik açı ğı → **destek@numexai.com.tr** (lütfen herkese açı k issue açma)
< div align = "center" >
---
**Numex Codex** · [Numex Ailesi ](https://www.numexai.com.tr/aile )'nin geliştirici kapı sı < br >
*İnsanı önce koyan Türk yapay zekâsı * 🇹🇷
< / div >