@koreanhole/opencodex 2.95.2 → 2.95.4

package/readme/README.tr.md

@@ -0,0 +1,512 @@
+<p align="center">
+  <img src="../assets/banner.png" alt="opencodex — Codex, Claude Code, Claude Desktop, Grok Build ve diğerleri için tek bir yerel ağ geçidi" width="100%">
+</p>
+
+<h3 align="center">AI kodlama araçlarınız ve modelleriniz için tek bir yerel ağ geçidi.</h3>
+<p align="center"><b>Seçtiğiniz modelleri Codex, Claude Code, Claude Desktop ve Grok Build ile kullanın;<br>OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code ve diğerlerini yönetilen yapılandırmalarla bağlayın.</b><br>
+<a href="https://opencodex.me/tr/reference/client-support/">Desteklenen tüm araçları görün →</a></p>
+
+<p align="center">
+  <a href="https://x.com/claudeebum"><img src="https://img.shields.io/badge/%40claudeebum-000000?logo=x&logoColor=white" alt="X üzerinde @claudeebum hesabını takip et"></a>
+  <a href="https://www.npmjs.com/package/@koreanhole/opencodex"><img src="https://img.shields.io/npm/v/@koreanhole/opencodex?color=cb3837&label=npm&logo=npm" alt="npm sürümü"></a>
+  <a href="https://github.com/koreanhole/opencodex-cli/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@koreanhole/opencodex?color=blue" alt="lisans"></a>
+  <img src="https://img.shields.io/node/v/@koreanhole/opencodex?logo=node.js&label=node" alt="node sürümü">
+</p>
+
+```bash
+npm install -g @koreanhole/opencodex
+ocx start
+```
+
+<p align="center">
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/macOS-.dmg-24292f?logo=apple&logoColor=white" alt="macOS için indir (.dmg)"></a>
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/Windows-.msi-24292f?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0zIDNoOC41djguNUgzem05LjUgMEgyMXY4LjVoLTguNXpNMyAxMi41aDguNVYyMUgzem05LjUgMEgyMVYyMWgtOC41eiIvPjwvc3ZnPg==" alt="Windows için indir (.msi)"></a>
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/Linux-.AppImage-24292f?logo=linux&logoColor=white" alt="Linux için indir (.AppImage)"></a>
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/Linux-.deb-24292f?logo=debian&logoColor=white" alt="Linux için indir (.deb)"></a>
+</p>
+
+<table>
+<tr>
+<td width="50%" valign="middle">
+
+### Claude Code, istediğiniz modelle
+
+Seçici Claude Code'un kendi seçicisi. Arkasındaki beyin değil.
+
+</td>
+<td width="50%">
+  <img src="../assets/claude-code-models.gif" alt="opencodex üzerinden yönlendirilen bir modeli çalıştıran Claude Code — durum çubuğunda etkin model olarak gpt-5.6-luna-medium görünüyor" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Codex, istediğiniz modelle
+
+Bir sağlayıcı seçin ve başlayın — aynı iş akışı, farklı beyin.
+
+</td>
+<td width="50%">
+  <img src="../assets/demo.gif" alt="opencodex demosu — Codex uygulamasında OpenAI dışı bir yönlendirilmiş modelle görev çalıştırma" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Claude Desktop, istediğiniz modelle
+
+Opus yanıtlıyor, sonra görevi bir GPT-5.6 Sol alt ajanına devrediyor.
+
+</td>
+<td width="50%">
+  <img src="../assets/claude-desktop-subagent.gif" alt="Claude Opus 4.8 olarak yanıtlayan, ardından opencodex üzerinden bir GPT-5.6 Sol alt ajanı başlatan Claude Desktop" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Grok Build, istediğiniz modelle
+
+Sol oturumu yürütüyor ve bir Kimi K3 alt ajanını çağırıyor.
+
+</td>
+<td width="50%">
+  <img src="../assets/grok-build-subagent.gif" alt="opencodex üzerinden GPT-5.6 Sol çalıştıran ve bir Kimi K3 alt ajanı çağıran Grok Build" width="100%">
+</td>
+</tr>
+</table>
+
+<p align="center">
+  <a href="../README.md">English</a> · <a href="README.fr.md">Français</a> · <a href="README.ko.md">한국어</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-TW.md">繁體中文</a> · <a href="README.ru.md">Русский</a> · <a href="README.ja.md">日本語</a> · <b>Türkçe</b> · 📖 <a href="https://opencodex.me/tr/"><b>Tüm dokümantasyon →</b></a>
+</p>
+
+opencodex, kodlama araçlarınızla model sağlayıcılarınız arasında çalışan hafif bir yerel ağ geçididir. Responses, Chat Completions ve Anthropic Messages API isteklerini kabul edip sağlayıcınızın protokolüne çevirir; istemci, model ve sağlayıcı desteklediğinde akış, araç çağrıları, akıl yürütme ve görselleri aktarır. Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama ve diğer sağlayıcıları Codex, Claude Code, Claude Desktop, Grok Build ve [istemci desteği sayfasındaki](https://opencodex.me/tr/reference/client-support/) araçlarla kullanın. Codex kimlik doğrulaması için bir **ChatGPT hesap havuzunu** da yönetebilir: hesap ekleyip kotalarını panelde yenileyin; yeni oturumlar kullanımı en düşük sağlıklı hesaba otomatik yönlendirilirken mevcut diziler başladıkları hesaba bağlı kalır.
+
+## Hızlı başlangıç
+
+### Kişisel kurulum (CLI)
+
+```bash
+npm install -g @koreanhole/opencodex   # Node 18+; Bun çalışma zamanı otomatik olarak paketlenir
+ocx start                         # proxy + kontrol paneli, localhost:10100
+```
+
+Arka planda çalıştırmak için `ocx service` kullanın.
+
+**http://localhost:10100** adresini açın ve her şeyi web kontrol panelinden yapılandırın: sağlayıcı
+ekleyin (40'tan fazla hazır sağlayıcı ya da herhangi bir OpenAI uyumlu uç nokta), model seçin, hesap
+yönetin. `ocx gui` paneli istediğiniz zaman yeniden açar.
+
+### Aracınızı bağlayın
+
+Zaten kullandığınız aracı bağlayın:
+
+| Araç | Bağlantı yöntemi |
+|---|---|
+| Codex | Panelin **Connect** sayfasındaki Codex anahtarını açın, ardından `codex` komutunu her zamanki gibi çalıştırın. Yerel dinleyicide bu, Codex’in yerleşik sağlayıcısını proxy’ye yönlendirir. Terminalden, panelde sağlayıcı eklemeden önce `ocx init` çalıştırın ve Codex istemini kabul edin. |
+| Claude Code | `claude` CLI kuruluysa `ocx claude` çalıştırın. Gerekirse proxy’yi başlatır ve Claude Code’u onun üzerinden açar. |
+| Claude Desktop | `ocx claude desktop` çalıştırın. Yeni kurulumda tüm uygulama için ağ geçidi profilini ayarlar; mevcut first-party yapılandırması korunur ve `ocx claude desktop apply --gateway` açıkça geçiş yapar. [Claude Code kılavuzuna](https://opencodex.me/tr/guides/claude-code/) bakın. Geçişten sonra Claude Desktop’tan tamamen çıkıp yeniden açın. |
+| Grok Build | Yerel bir dinleyicide Grok entegrasyonu etkinse ve `~/.grok` mevcutsa, `ocx start` modelleri kaydeder; Grok Build içinde bir `ocx-*` modeli seçin. Uzak kurulumlar için [Grok Build kılavuzuna](https://opencodex.me/tr/guides/grok-build/) bakın. Sağlayıcı ekledikten sonra listeyi yenilemek için proxy’yi yeniden başlatın (veya Codex otomatik başlatma etkinse `ocx ensure` çalıştırın). |
+| Yönetilen entegrasyonu olan araçlar | Panelin **Connect** sayfasını veya `ocx integration client enable --client <id>` komutunu kullanın. |
+| Diğer tüm araçlar | Özel OpenAI uyumlu temel URL’yi `http://localhost:10100/v1` veya Anthropic temel URL’sini `http://localhost:10100` olarak ayarlayın. |
+
+[İstemci desteği sayfası](https://opencodex.me/tr/reference/client-support/), her aracın bağlantı yolunu ve kullandığı protokolü listeler.
+
+<details>
+<summary><b>Masaüstü uygulaması (beta)</b></summary>
+
+Masaüstü uygulaması; aynı proxy ve kontrol panelini yerel bir pencerede, menü çubuğu simgesi ve
+paketlenmiş `ocx` ile sunar. Zaten çalışan bir proxy'ye bağlanır ya da kendi paketlenmiş proxy'sini
+başlatır; kontrol paneli proxy bağlantı noktasında kalır (başka bir tane yapılandırmadıysanız
+**http://localhost:10100**). Platformunuza uygun dosyayı
+[en güncel sürümden](https://github.com/lidge-jun/opencodex/releases/latest) seçin:
+
+| Platform | Dosya | Notlar |
+|---|---|---|
+| macOS 13+ (Apple Silicon ve Intel) | `OpenCodex-<version>-macos.dmg` | Evrensel derleme, Developer ID ile imzalı ve noter onaylı |
+| Windows (x64) | `OpenCodex-<version>-windows-x64.msi` | SignPath Foundation ile kod imzalama kullanıma alınıyor ([kod imzalama politikası](https://opencodex.me/tr/reference/code-signing/)); bir sürüm imzalanana kadar SmartScreen bir kez sorar, **Diğer bilgiler → Yine de çalıştır** seçin |
+| Linux (x86_64) | `OpenCodex-<version>-linux-x86_64.AppImage` veya `-linux-amd64.deb` | Menü çubuğu simgesi AppIndicator destekli bir masaüstü gerektirir |
+
+Her dosyanın yanında sürüm sayfasında bir `.sha256` bulunur. macOS 14 ve üzerinde uygulama ayrıca
+proxy durumunu, bugünkü kullanımı ve sağlayıcı kotalarını gösteren bir WidgetKit uzantısıyla gelir;
+görüntülediği anlık görüntü modeli [`app/`](../app) dizinindedir (`MenuBarCore`). Uygulamayı kendiniz
+derlemek için depo kökünde `bun install && bun run build:gui`, ardından `desktop/` içinde macOS'ta
+`bun install && bun run prepare-sidecar && bun run prepare-widget && bun run build:local`,
+Windows ve Linux'ta ise `bun install && bun run prepare-sidecar && bun run build:local` çalıştırın (widget adımı yalnızca macOS'ta çalışır).
+[Masaüstü uygulaması kılavuzu](https://opencodex.me/tr/guides/desktop-app/) ve
+[macOS menü çubuğu uygulaması kılavuzu](https://opencodex.me/tr/guides/macos-menu-bar/) ilk açılışı
+anlatır; [`AGENTS_INSTALL.md`](../AGENTS_INSTALL.md#where-things-are-installed) diske yazılan her
+şeyi listeler.
+
+</details>
+
+### ChatGPT hesap havuzu
+
+opencodex, Codex kimlik doğrulaması için bir **ChatGPT hesap havuzu** da yönetebilir. Birden fazla
+ChatGPT / Codex hesabı ekleyin, 5 saatlik / haftalık / 30 günlük kotalarını panelden tazeleyin. Kota
+yönlendirmesinde yeni oturumlar en az kullanılan sağlıklı hesabı kullanabilir; round-robin ve
+fill-first kendi politikalarını izler. Mevcut Codex dizileri normalde onları başlatan hesaba bağlı
+kalır, böylece uzun SSH, tmux ya da mobil oturumlar konuşmanın ortasında hesap değiştirmez — ancak
+kota yeniden değerlendirmesi, failover, hesabın devre dışı bırakılması, bağlılığın süresinin dolması
+ya da 401/403 ve 429 toparlanması bu bağı yeniden kurabilir. Yalnızca diğerleri tükendiğinde
+kullanılmasını istediğiniz bir hesap varsa — genellikle Codex Desktop girişiniz — hesaplara bir seçim
+sırası verin.
+
+### Sponsorlar
+
+Her yukarı akış protokol değişiminde opencodex'in bakımını sürdürebilmesi sponsorlar sayesinde.
+İlgileniyor musunuz? [SPONSORS.md](../SPONSORS.md) dosyasına bakın.
+
+<!-- sponsors:main — one banner, model developers only; empty until a Main sponsor signs -->
+
+<!-- sponsors:standard — one row per sponsor, in order of signing -->
+<table>
+<tbody>
+<tr>
+<td width="180"><a href="https://www.orcarouter.ai/?utm_source=opencodex&utm_medium=readme"><img src="../assets/sponsors/orcarouter.png" alt="OrcaRouter" width="150"></a></td>
+<td>Bu projeye sponsor olduğu için <a href="https://www.orcarouter.ai/?utm_source=opencodex&utm_medium=readme">OrcaRouter</a>'a teşekkürler! OrcaRouter, üretimdeki yapay zekâ için tek bir OpenAI uyumlu yapay zekâ ağ geçidi: her istemi puanlayıp çıtanızı geçen modele gönderen uyarlanabilir yönlendirme, otomatik failover, kod olarak yazılan yönlendirme kuralları, istem önbelleğiyle birlikte sıfır marjlı sağlayıcı fiyatlandırması ve 200'den fazla modeldeki her çağrıda koruma kuralları, bir ajan güvenlik duvarı ve istek günlükleri. Add provider seçicisinden <code>OrcaRouter</code> seçin ya da <code>ocx provider add orcarouter</code> çalıştırın; uyarlanabilir yönlendirici <code>orcarouter/auto</code>.</td>
+</tr>
+<tr>
+<td width="180"><a href="https://tokenlab.sh/r/OPENCODEX"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/sponsors/tokenlab-dark.png"><img src="../assets/sponsors/tokenlab-light.png" alt="TokenLab" width="150"></picture></a></td>
+<td>Bu projeye sponsor olduğu için <a href="https://tokenlab.sh/r/OPENCODEX">TokenLab</a>'a teşekkürler! TokenLab, kodlama ajanlarına önde gelen modeller için tek bir API anahtarı sunar; OpenAI Responses ve Chat Completions, Anthropic Messages ve Gemini'nin yerel API biçimleri, akış ve araç çağırma ile desteklenir. Kolay entegrasyon için bir MCP sunucusu ve ajan Skills'i de sağlar. Teslimat modunuzu seçin, kullandıkça ödeyin. Add provider seçicisinden <code>TokenLab</code> seçin ya da <code>ocx provider add tokenlab</code> çalıştırın.<br><sub>TokenLab 为编程智能体提供统一的多模型 API，一枚 API Key 即可接入主流模型，支持 OpenAI Responses、Chat Completions、Anthropic Messages 和 Gemini 原生 API 格式，以及流式输出和工具调用。同时提供 MCP 服务器和 Agent Skills，方便接入现有工作流；交付模式可选，按量付费。</sub></td>
+</tr>
+</tbody>
+</table>
+
+---
+
+<details>
+<summary>Docker Compose</summary>
+
+Depo, digest ile sabitlenmiş, root olmayan bir Compose derlemesi içerir. Derleme, seçilen Git anlık
+görüntüsünden standart uyumluluk manifestosunu üretip doğrular. Yerel klon için Git ve Docker Compose,
+uzak Git bağlamı için Docker Compose gerekir. İki yöntemde de ana makinede Bun veya bir hazırlık adımı
+gerekmez. Veri düzlemi belirtecini stdin üzerinden bir kez ilklendirip hub'ı başlatın:
+
+```bash
+git clone https://github.com/lidge-jun/opencodex.git
+cd opencodex
+docker compose build
+openssl rand -hex 32 | docker compose run --rm -T hub bun run docker/bootstrap-token.ts
+docker compose up -d
+curl --fail --silent http://127.0.0.1:10100/healthz
+curl --fail --silent http://127.0.0.1:10100/readyz
+```
+
+Varsayılan ana makine bağlaması `127.0.0.1:10100`. Uzaktan erişime açmak için
+`OPENCODEX_BIND_ADDRESS=<LAN-or-Tailscale-IP> docker compose up -d` gerekir; `0.0.0.0` tüm ana
+makine arayüzlerini açar. Erişimi bir güvenlik duvarı ve kimlik doğrulamalı bir TLS/tailnet ön yüzüyle
+kısıtlayın. Üretilen JSON izlenmez. Derleme bağlamına yalnızca `git ls-files` envanterinin okuduğu
+`.git/index` ve `.git/HEAD` alınır; tam nesne deposu yerine yaklaşık 1 MB tutar. Bunlar salt okunur bir
+bağlama üzerinden yalnızca derlemeye özel manifesto aşamasında görünür, dolayısıyla hiçbir `COPY` `.git`
+içermez. Ana makinede önceden üretilmiş bir manifesto yalnızca doğrulandıktan sonra kabul edilir; aksi
+halde derleme manifestoyu kendisi üretir. Derleme; eski manifestoları, eksik ya da uyuşmayan
+dosyaları, fazladan kaynak dosyalarını ve sembolik bağlantıları reddeder. Kayıtlı her SHA-256 değerini
+derleme bağlamıyla ve kopyalanan çalışma zamanı dosyalarıyla karşılaştırır: `package.json`,
+`bun.lock` ve özellikle dahil edilen `scripts/model-metadata.source.json`.
+
+Uzak Git bağlamında BuildKit'in Git meta verilerini koruması gerekir. Bu Compose derleme parçası uzak
+anlık görüntüyü seçer ve gereken yerleşik argümanı iletir:
+
+```yaml
+services:
+  hub:
+    pull_policy: build
+    build:
+      context: https://github.com/lidge-jun/opencodex.git#main
+      dockerfile: Dockerfile
+      target: runtime
+      args:
+        BUILDKIT_CONTEXT_KEEP_GIT_DIR: "1"
+```
+
+Belirteç ve değişken durum `ocx-state` adlı volume içinde kalır; imaja, Compose dosyasına, ortama ya da
+kabuk argümanlarına hiçbir kimlik bilgisi konmaz. Sağlayıcı kurulumu, kimlik doğrulamalı kabul kontrolleri,
+uzaktan yönetim ve geri alma için
+[Remote Hub dağıtım kılavuzuna](https://opencodex.me/tr/guides/remote-hub/) bakın.
+
+</details>
+
+<details>
+<summary>Kaynaktan kurulum (en güncel dev)</summary>
+
+**macOS / Linux:**
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+git clone -b dev https://github.com/lidge-jun/opencodex.git
+cd opencodex && ~/.bun/bin/bun install
+~/.bun/bin/bun run build:gui
+~/.bun/bin/bun run src/cli/index.ts start
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm bun.sh/install.ps1 | iex
+git clone -b dev https://github.com/lidge-jun/opencodex.git
+cd opencodex; bun install
+bun run build:gui
+bun run src/cli/index.ts start
+```
+
+Kaynaktan kurulum en güncel `dev` dalını çalıştırır. Bellek sahipliği yamaları, çalışma zamanı GC
+iyileştirmeleri ve henüz yayımlanmamış düzeltmeler npm paketine ulaşmadan önce burada bulunur.
+
+</details>
+
+<details>
+<summary>Ajanlar için</summary>
+
+```bash
+npm install -g @koreanhole/opencodex
+ocx start     # ya da `ocx service`
+ocx init      # etkileşimli kurulum: ~/.opencodex/config.json yazar ve Codex'i bağlar
+```
+
+`ocx init` proxy'yi hiçbir zaman başlatmaz; önce onu başlatın (ya da sonra — sıra fark etmez, ancak
+`ocx provider add` ve `ocx combo set` gibi başsız komutlar **çalışan** proxy ile konuşur ve ona
+ulaşamadıklarında sıfırdan farklı bir kodla çıkar). `ocx status` / `ocx doctor` / `ocx health`
+çalışma durumunu bildirir.
+
+> **opencodex'i kuran ya da çalıştıran ajanlar:**
+> [`AGENTS_INSTALL.md`](../AGENTS_INSTALL.md) dosyasını okuyun. Etkileşimli bir `ocx start` bu depoya
+> yıldız verip vermeyeceğinizi bir kez sorabilir — bu kullanıcının kararıdır, hiçbir zaman bir ajanın
+> değil. CLI, ajan tarafından yürütülen çalışmalarda bu soruyu bastırır ve API bunları
+> `403 agent_consent_required` ile reddeder.
+
+</details>
+
+## Desteklenen platformlar
+
+| İşletim sistemi | Durum | Servis yöneticisi | Masaüstü uygulaması (beta) |
+|---|---|---|---|
+| macOS (arm64 / x64) | Tam destekleniyor | launchd | Evrensel `.dmg` |
+| Linux (x64 / arm64) | Tam destekleniyor | systemd (kullanıcı birimi) | x86_64 `.AppImage` / `.deb` |
+| Windows (x64) | Tam destekleniyor | Görev Zamanlayıcı (gizli) / isteğe bağlı yerel servis (`--native`, WinSW) | x64 `.msi` |
+
+CLI kurulumu [Node](https://nodejs.org) 18 veya üzerini gerektirir; masaüstü uygulamasının ne Node'a ne de Bun'a ihtiyacı vardır. Bun çalışma zamanı `npm install` sırasında paketlenir —
+ayrıca Bun kurmanıza gerek yok, Windows'ta WSL de gerekmez. npm, paketlenmiş çalışma zamanının kurulum
+betiklerini engellediyse [kurulum belgelerine](https://opencodex.me/tr/getting-started/installation/) bakın.
+
+## Öne çıkanlar
+
+- **Codex, Claude Code, Claude Desktop ve Grok Build ile istediğiniz LLM** — kutudan çıktığı gibi 40'tan
+  fazla sağlayıcı, her biri kendi yerel arayüzünü korur.
+- **Yerel CLI oturumunu yeniden kullanın** — `cline-cli/default` ve `gemini-cli/default` kurulu ve oturum açmış CLI'ye devreder; araç onayı ve yürütmesi Codex'te kalır.
+- **ChatGPT hesaplarını havuzlayın** — dizi bağlılığı, kota farkındalıklı otomatik geçiş, bekleme süresi ve
+  fail-closed kimlik doğrulama davranışı.
+
+  > **Sağlayıcı politikası notu:** Hesap havuzu yalnızca yönlendirme ve işletimsel dayanıklılık içindir;
+  > sağlayıcının hız sınırlarından, yaptırımlarından, askıya almalarından ya da diğer hesap işlemlerinden
+  > korunmayı garanti etmez. OpenCodex, sağlayıcı sınırlarını aşmak için ek hesap kullanılmasını ya da hesap
+  > kimlik bilgilerinin kişiler arasında paylaşılmasını onaylamaz. Her sağlayıcının güncel koşullarına
+  > uymak sizin sorumluluğunuzdadır. Bkz.
+  > [Codex Auth hesap havuzu rehberi](https://opencodex.me/tr/guides/web-dashboard/)
+  > ve [OpenAI'nin güncel Kullanım Koşulları](https://openai.com/policies/terms-of-use/).
+- **Kombolar** — sağlayıcılar arasında failover ya da ağırlıklı round-robin yapan tek bir sanal model
+  kimliği. [Kombo rehberine](https://opencodex.me/tr/guides/combos/) bakın.
+- **Her modelde alt ajanlar** — yönlendirilmiş modelleri Codex'in alt ajan seçicisinde gösterin, v1/v2
+  yüzey denetimi ve yedek zincirleriyle birlikte.
+  [Alt ajan rehberine](https://opencodex.me/tr/guides/sub-agent-surface/) bakın.
+<!-- sponsors:main-first-mention -->
+- **Bir kez giriş yapın, API anahtarını atlayın** — xAI, Anthropic ve Kimi için OAuth; ya da
+  `codex login` oturumunu iletin, bir anahtar yapıştırın veya `${ENV_VAR}` referansları kullanın.
+- **Web araması ve görü yardımcıları** — OpenAI dışı modeller, ChatGPT girişiniz üzerinden çalışan bir
+  yardımcı süreç sayesinde gerçek web araması ve görsel anlama kazanır.
+- **Ne olup bittiğini görün** — kontrol paneli sağlayıcıları, OAuth durumunu, model seçimini ve önbellek
+  belirteç sayılarını içeren canlı bir istek günlüğünü gösterir.
+- **Temiz çıkış, sıfır artık** — `ocx stop` Codex'i özgün yapılandırmasına geri döndürür.
+- **Sınırlı bellek sahipliği** — uzun ömürlü her önbelleğin, halka arabelleğinin ve protokol çevirisi
+  deposunun sonlu bir üst sınırı, bayt bütçesi ya da etkin bir uzlaştırması vardır. Yapılandırma yeniden
+  yüklendiğinde sınırsız hiçbir `Map` ya da `Set` hayatta kalmaz.
+
+<details>
+<summary>Bellek sahipliği ayrıntıları</summary>
+
+OpenCodex, süreçte tutulan durumu aşağıdaki kategorilerde izler. Her birinin belgelenmiş bir sınırı vardır:
+
+- **14 tutulan depo** (istek günlüğü, hata ayıklama halkaları, görsel önbelleği, model önbelleği, görü
+  açıklamaları, imleç blob'ları, responses devamlılığı vb.) bayt olarak hesaplanır ve uygulamanın sahip
+  olduğu bellek bütçesiyle (varsayılan 256 MiB) tahliye edilir; yalnızca native control replay deposu
+  sabitlenmiştir ve hiç tahliye edilmez.
+- **4 gözlenen arabellek** (çevirici biriktiricileri, görsel/OAuth/Grok kuyrukları) tahliye edilmeden,
+  yalnızca uçuştaki bayt baskısı için izlenir.
+- **31 state-store kaydı**, süre dolumu taramalarını (60 sn aralık) ve yapılandırma kuşağı uzlaştırmasını
+  yürüterek eski sağlayıcı/hesap anahtarlarını kaldırır.
+- **Yol ve parmak izi notları** (çalışma alanı meta verileri, sağlamlaştırılmış kimlikler, kurulum
+  tuzları, mod ipucu yetenekleri) ekleme sıralı LRU sınırları kullanır (8–128 girdi).
+- **Model önbelleği kuşak mezar taşları** uzlaştırmadan sonra silinir; genel bir kuşak artışı, uçuştaki
+  eski keşiflerin kaldırılmış sağlayıcıları yeniden doldurmasını engeller.
+- **Lab olay kimliği yinelenme ayıklaması** diskten alınan bir defter kilidi altında çalışır; süreç
+  düzeyinde RAM dizini yoktur.
+
+Canlı tutulan baytları, tahliye sayaçlarını ve gözcü örneklerini incelemek için yönetici belirteciyle
+`GET /api/system/memory` çağrısını yapın.
+
+</details>
+
+## Model yönlendirme
+
+`provider/model` söz dizimiyle yapılandırılmış herhangi bir sağlayıcıyı ve modeli hedefleyin:
+
+```bash
+codex -m "anthropic/claude-opus-5" "Bu yığın izini açıkla"
+codex -m "google/gemini-3-pro" "auth.ts için birim testleri yaz"
+codex -m "ollama/llama3" "Bu fonksiyonu yeniden düzenle"
+```
+
+Varsayılan sağlayıcıyı kullanmak ya da model adı desenine göre otomatik eşleştirmek için `provider/`
+önekini atlayın. İçinde `/` bulunan sağlayıcı model kimlikleri, iç eğik çizgileri `-` ile
+değiştirilmiş biçimde sunulur; eğik çizgili tam biçim de çalışmaya devam eder. Ayrıntılar:
+[model yönlendirme belgeleri](https://opencodex.me/tr/guides/model-routing/).
+
+### JEV Auto yönlendirme (isteğe bağlı)
+
+TypeSafe JEV, açıkça etkinleştirilen bir Combo için ilk modeli ve akıl yürütme düzeyini seçebilir;
+normal model seçici ve tüm doğrudan rotalar değişmez. Kimlik bilgisini `ocx login jev` ile,
+**Providers → TypeSafe JEV → Add API key** üzerinden veya `TYPESAFE_API_KEY`/`JEV_API_KEY` ile ekleyin.
+Ardından **Models → Combos → Create JEV Auto** bölümünü açın, izin verilen hedef modelleri seçin ve
+JEV'in her hedef için seçebileceği düzeyleri işaretleyin. Düzey ayarına dokunulmayan bir hedef, modelin
+şu anda duyurduğu tüm düzeylere izin verir.
+
+JEV yalnızca `jev-auto` için ve mantıksal model çağrısı başına yalnızca bir kez kullanılır. Eksik kimlik
+bilgisi, ağ hatası veya geçersiz karar durumunda şu anda uygun olan ilk hedefe fail-open yapılır;
+çağıranın iptali isteği yine iptal eder. Otomatik testler sahte bir TypeSafe uç noktası kullanır ve
+gerçek bir JEV hesabını doğrulamaz.
+
+Bir JEV Combo bunun yerine Ollama'nın anahtarsız `tev1` modeli gibi kendi barındırdığınız bir karar
+modeline de sorabilir: `baseUrl` değeri tam `/v1/systemone` uç noktası olan bir `jev-decision`
+sağlayıcısı ekleyin ve Combo'nun `decisionProvider` alanına yazın. TypeSafe kimlik bilgileri oraya asla
+gönderilmez. Ayrıntılar: [kendi barındırılan karar modeli](https://opencodex.me/tr/guides/combos/).
+
+## Sağlayıcılar ve adaptörler
+
+<!-- sponsors:main-first-mention -->
+OpenAI (ChatGPT girişi ya da API anahtarı), Anthropic, Google Gemini, xAI, Kimi, Azure OpenAI, Ollama
+(yerel + Cloud), Cursor (deneysel) ve her OpenAI uyumlu uç nokta — ayrıca DeepSeek, Groq, OpenRouter, OpenGateway,
+Together, Fireworks, Cerebras, Mistral, Hugging Face, NVIDIA NIM, MiniMax, Qwen Cloud, Qoder Global ve CN
+(resmî PAT + CLI), SiliconFlow ve daha fazlası. Tam liste: `ocx init` ya da
+[sağlayıcı belgeleri](https://opencodex.me/tr/guides/providers/).
+
+## CLI
+
+```bash
+ocx init                       # etkileşimli kurulum (config yazar, Codex'i bağlar, shim önerir)
+ocx start [--port 10100] [--socks5 [host:port] | --socks5-off]  # SOCKS5 varsayılanı socks5://127.0.0.1:10808
+ocx stop                       # durdur + yerel Codex'i geri yükle
+ocx service [install|repair|restart|start|stop|status|uninstall|remove]  # arka plan servisi
+ocx codex-shim install         # `codex` her başladığında proxy'yi isteğe bağlı başlat
+ocx health [--json]            # proxy'nin şu an ayakta olup olmadığını kontrol et
+ocx ready [--json] [--wait [--timeout <seconds>]]  # eşitleme sonrası hazırlığı kontrol et
+ocx status                     # proxy çalışıyor mu?
+ocx gui                        # web kontrol panelini aç
+ocx provider <...>             # sağlayıcıları yönet (list/add/edit/test/remove)
+ocx account <...>              # ChatGPT hesaplarını ve API anahtarı havuzlarını yönet
+ocx combo <...>                # failover / round-robin kombolarını yönet
+ocx v2 <...>                   # çoklu ajan v1/v2 yüzey denetimleri
+ocx update [--tag preview]     # opencodex'i güncelle
+```
+
+Tercih edilen bağlantı noktası meşgulse başlatma başka bir bağlantı noktasına geçmek yerine durur ve bağlantı
+noktasını hangi işlemin tuttuğunu bildirir; böylece ilkinin yanında ikinci bir proxy çalışır durumda kalamaz.
+Bağlantı noktasını boşaltın veya `--port` ile farklı bir tane belirtin. Tam başvuru:
+[CLI belgeleri](https://opencodex.me/tr/reference/cli/).
+
+### Sağlık ve hazırlık
+
+`GET /healthz` proxy'nin o anki canlılığını bildirir. Kimlik doğrulaması gerektirmeyen `GET /readyz`
+uç noktası, eşitleme sonrası hazırlığı arındırılmış `{service, version, uptime, pid, port, status}` JSON
+kimliğiyle bildirir. `status` değeri `ready` olduğunda `200` döner; `pending` ve nihai
+`failed` durumları `Retry-After: 1` ile `503` döner.
+
+`ocx ready [--json] [--wait [--timeout <seconds>]]` varsayılan olarak tek bir yoklama yapar. `--wait`
+varsayılan olarak 45 saniyeye kadar yoklar, ancak nihai `failed` durumunu gördüğü anda çıkar;
+`--timeout <seconds>` 1–300 saniyelik bir sınır koyar, `--wait` gerektirir ve yalnızca pozitif tam
+sayı kabul eder. CLI `--json` çıktısı `{ready, status, pid, port}` biçimindedir; `status` değeri
+`ready`, `pending`, `failed` ya da `unreachable` olur.
+
+| Çıkış | Sonuç |
+| --- | --- |
+| `0` | Hazır |
+| `1` | Hazır değil: pending, failed, zaman aşımı ya da ulaşılamıyor |
+| `64` | Geçersiz argüman |
+
+`/readyz` içermeyen eski bir proxy `unreachable` olarak fail-closed davranır ve 1 koduyla çıkar;
+`ocx health` ise uyumlu kalır.
+
+### Otomatik başlatma: servis mi shim mi
+
+Çökme sonrası yeniden başlayan, sürekli açık bir proxy için **servisi** (`ocx service`) kullanın. Arka
+plan artalan süreci olmadan hafif, isteğe bağlı başlatma için **shim**'i
+(`ocx codex-shim install`) kullanın. Kaldırmak için `ocx service uninstall` /
+`ocx codex-shim uninstall`.
+
+### Kaldırma
+
+```bash
+ocx uninstall                  # durdur, servis/shim kaldır, yerel Codex'i geri yükle, durumu temizle
+npm uninstall -g @koreanhole/opencodex
+```
+
+## Uzaktan erişim
+
+opencodex varsayılan olarak `127.0.0.1` adresine bağlanır ve ek bir kimlik doğrulaması gerektirmez.
+Geri döngünün dışına bağlanmak (`"hostname": "0.0.0.0"`) bir bearer belirteci **gerektirir**: proxy
+`OPENCODEX_API_AUTH_TOKEN` olmadan başlamayı reddeder ve her istemci isteği bu belirteci
+`x-opencodex-api-key` olarak taşımalıdır. Ayrıntılar:
+[yapılandırma başvurusu](https://opencodex.me/tr/reference/configuration/).
+
+## Belgeler
+
+Herkese açık belgeler — kurulum, sağlayıcılar, yönlendirme, kombolar, alt ajanlar, yardımcı süreçler,
+entegrasyonlar ve CLI/yapılandırma/yönetim API'si başvuruları — [`docs-site/`](../docs-site) içinden
+derlenir ve **[opencodex.me](https://opencodex.me/tr/)** adresinde yayımlanır.
+
+Bakımcılar için doğruluk kaynağı notları [`structure/`](../structure) altında, katkıda bulunan kurulumu
+[`CONTRIBUTING.md`](../CONTRIBUTING.md) içinde, güvenlik bildirimi ise
+[`SECURITY.md`](../SECURITY.md) içindedir. Açıklanmamış güvenlik açıklarını herkese açık bir issue
+yerine [GitHub özel güvenlik açığı bildirimi](https://github.com/lidge-jun/opencodex/security/advisories/new)
+üzerinden gizlice bildirin.
+Teknik kanal yalnızca bu formdur; ayrı bir güvenlik e-posta adresi yoktur. Sonraki yazışmalar özel
+bildirimin içinde kalır; herkese açık bir issue yalnızca koordinasyon taşıyabilir, güvenlik açığının
+ayrıntılarını asla. Bildirimin alındığını onaylamak onu incelemekle aynı şey değildir ve ilk yanıt
+için bir süre taahhüt edilmez.
+
+## Geliştirme
+
+Kaynak geliştirmesi `PATH` üzerinde `bun` CLI gerektirir. Yayımlanmış npm paketi kurulu `ocx` komutları
+için kendi Bun çalışma zamanını içerir; paket betikleri de Bun'u bu paketlenmiş bağımlılıktan bulabilir.
+
+```bash
+git clone https://github.com/lidge-jun/opencodex.git
+cd opencodex
+bun install
+bun run typecheck
+bun run test
+```
+
+**[Katkıda bulunma](../CONTRIBUTING.md)** belgesine bakın.
+
+Bir bakımcının devralması ya da yeniden uygulamasıyla gelen ve commit'inde özgün yazarı anılmayan katkılar
+**[CREDITS.md](../CREDITS.md)** içinde kayıt altına alınır.
+
+## Kod imzalama politikası (Code signing policy)
+
+Windows ikili dosyaları Authenticode imzalamaya geçiyor ([#7207](https://github.com/lidge-jun/opencodex/issues/7207)). Geçiş durumu, imzanın nasıl doğrulanacağı ve politikanın tamamı [Windows kod imzalama kılavuzunda](https://opencodex.me/tr/reference/code-signing/) anlatılıyor.
+
+Free code signing provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/).
+
+- Committers and reviewers: [lidge-jun](https://github.com/lidge-jun)
+- Approvers: [lidge-jun](https://github.com/lidge-jun)
+- Privacy: This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
+
+## Sorumluluk reddi
+
+opencodex bağımsız, toplulukça sürdürülen bir projedir ve **OpenAI, Anthropic ya da başka herhangi bir sağlayıcıyla bağlantılı değildir, onlar tarafından onaylanmamıştır**.
+
+Bazı sağlayıcılar — özellikle Anthropic (Claude) — API trafiğini üçüncü taraf bir proxy üzerinden geçiren hesapları askıya alabilir ya da kısıtlayabilir. **Kullanım riski size aittir (UAYOR).** Bir sağlayıcıyı bağlamadan önce, proxy tabanlı erişime izin verildiğini doğrulamak için hizmet koşullarını inceleyin. opencodex bakımcıları, yukarı akış sağlayıcılarının aldığı hesap kararlarından sorumlu değildir.
+
+## Lisans
+
+MIT