Hızlı Başlangıç
Bu kılavuz, yeni kurulumdan kullandığınız kodlama aracındaki ilk isteğe kadar size yol gösterir. 1. ve 2. adımlar tüm araçlar için aynıdır; 3. adımda her araç için kısa bir bölüm vardır. İstemci desteği sayfası araçları ve bağlantı yöntemlerini listeler.
1. Kurulum sihirbazını çalıştırın
Bölüm başlığı “1. Kurulum sihirbazını çalıştırın”ocx initocx init adım adım size rehberlik eder:
- Bir sağlayıcı seçin — yerleşik kayıt defterindeki 107 önayardan birini
veya bir temel URL ile adaptör yazmak için
customseçeneğini belirleyin. - API anahtarı — bir anahtar yapıştırın veya
${ANTHROPIC_API_KEY}gibi bir ortam değişkenine başvurun. - Varsayılan model — anahtar, yerel ve özel sağlayıcılar için önayarı kabul edin veya bir model kimliği girin.
- Proxy portu — varsayılan olarak
10100. - Codex’e enjekte edilsin mi? — normal bir geri döngü kurulumunda
opencodex,
$CODEX_HOME/config.toml(varsayılan~/.codex/config.toml) dosyasına bir kökopenai_base_urlekler, böylece Codex’in yerleşikopenaisağlayıcısı proxy’yi hedefler. Uzak/LAN bağlantıları bunun yerine bir API kimlik doğrulama başlığına sahip özel bir sağlayıcı girdisi kullanır. - Otomatik başlatma dolgusu (shim) kurulsun mu? — etkinleştirildiğinde,
codexbaşlatıldığında önceocx ensureçalışır.
Sonuç $OPENCODEX_HOME/config.json (varsayılan ~/.opencodex/config.json)
dosyasına kaydedilir.
2. Proxy’yi başlatın
Bölüm başlığı “2. Proxy’yi başlatın”ocx start # varsayılan port 10100ocx start --port 8080Başlatıldığında opencodex:
- PID’sini
~/.opencodex/ocx.piddosyasına yazar (ve iki kez başlamayı reddeder), - Sağlayıcının desteklediği durumlarda canlı modelleri keşfeder ve yerel ile yönlendirilen girdileri Codex’in model kataloğuna senkronize eder,
http://localhost:<port>/v1üzerinde dinler.
İstenen port meşgulse ocx start durur ve portu neyin tuttuğunu bildirir: orada bir
opencodex yanıt veriyorsa önce ocx stop çalıştırın veya ocx start --port <port> ile
boş bir portta başlatın. Kendiliğinden başka bir porta geçmez; önceki davranış, iki
proxy’nin yan yana çalışmasına ve Codex’in daha yeni olana yönlendirilmesine neden oluyordu.
Kontrol edin:
ocx statusocx gui # kontrol panelini canlı port üzerinde açın3. Aracınızı bağlayın
Bölüm başlığı “3. Aracınızı bağlayın”Kullandığınız araca ait bölümü seçin. Birden fazla araç bağlayabilirsiniz; bunlar aynı sağlayıcıları ve modelleri paylaşır.
- adımda Codex istemini kabul ettiyseniz Codex artık opencodex ile şeffaf biçimde iletişim kurar. İstemi reddettiyseniz veya mevcut yapılandırma nedeniyle kurulum sona erdiyse Codex’i çalıştırmadan önce panelin Connect sayfasındaki Codex anahtarını açın; Codex Entegrasyonu değişiklikleri ve nasıl geri alınacağını açıklar.
codex "Okunabilirlik için bu fonksiyonu yeniden düzenle"Yönlendirilen belirli bir modeli hedeflemek için Codex’in model seçicisinin
gösterdiği saglayici/model biçimini kullanın:
codex -m "anthropic/claude-opus-5" "Bu yığın izini (stack trace) açıkla"codex -m "ollama-cloud/glm-5.2" "Bir SQL geçişi yaz"Claude Code
Bölüm başlığı “Claude Code”claude CLI kuruluysa:
ocx claudeocx claude, çalışmıyorsa proxy’yi başlatır ve Claude Code’u ortamı opencodex’e yönlendirilmiş olarak açar. Ek argümanlar aynen iletilir. Katman varsayılanları, diğer başlatıcılar ve devre dışı bırakma için Claude Code sayfasına bakın.
Claude Desktop
Bölüm başlığı “Claude Desktop”ocx claude desktopYeni kurulumda tüm uygulama için ağ geçidi profilini ayarlar. Zaten first-party modunu kullanan bir kurulum bu modu korur; açıkça geçiş yapmak için ocx claude desktop apply --gateway çalıştırın. Desktop’ı claude.ai üzerinde tutup yalnızca Code sekmesini yönlendiren first-party modu, Claude Code sayfasındaki Claude Desktop modları bölümünde açıklanır.
Mod değiştirdikten sonra Claude Desktop’tan tamamen çıkıp yeniden açın.
Grok Build
Bölüm başlığı “Grok Build”Yerel dinleyicide ~/.grok varsa ocx start görünür modelleri ~/.grok/config.toml dosyasına kaydeder. Grok Build içinde bir ocx-* modeli seçin. Uzak kurulumlar ve yönetilen blok Grok Build sayfasında anlatılır.
Sağlayıcı veya model ekledikten sonra Grok Build’in görmesi için ocx ensure çalıştırın veya proxy’yi yeniden başlatın.
Diğer araçlar
Bölüm başlığı “Diğer araçlar”Yönetilen entegrasyonu olan araçlar (OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code ve diğerleri) panelin Connect sayfasından veya şu komutla bağlanır:
ocx integration client enable --client <id>Her aracın yapılandırma dosyası ve değişikliğin ne zaman geçerli olacağı Entegrasyonlar sayfasında listelenir. Özel uç noktayı kabul eden diğer araçlar OpenAI uyumlu temel URL http://localhost:10100/v1 veya Anthropic temel URL http://localhost:10100 kullanabilir.
Alt ajan modellerini seçin (isteğe bağlı)
Bölüm başlığı “Alt ajan modellerini seçin (isteğe bağlı)”Yeni bir yapılandırma, Codex’in alt ajan seçicisinde beş yerel model sunar:
gpt-5.5, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna ve gpt-6-astra. En
fazla beş yerel veya yönlendirilmiş modeli değiştirmek veya yeniden sıralamak
için ocx gui’yi açın. Kontrol paneli ayrıca tercih edilen bir alt ajan
modelini ve akıl yürütme çabasını ayarlayabilir. v1/base/v2 seçmek ve rehberlik,
yerel varsayılanlar ve geri dönüşün ne zaman geçerli olduğunu anlamak için Alt
Ajan Arayüzü sayfasına bakın.
Anahtar yapıştırmak yerine giriş yapma
Bölüm başlığı “Anahtar yapıştırmak yerine giriş yapma”Bazı sağlayıcılar gerçek hesap girişini (OAuth, otomatik yenilenen) destekler:
ocx login xai # veya: anthropic, kimi, kiro, google-antigravity, cursorocx logout xaiOpenAI’nin kendisi hiçbir anahtara ihtiyaç duymaz — varsayılan sağlayıcı
mevcut codex login kimlik bilgilerinizi doğrudan iletir (bkz.
Sağlayıcılar).
Durdurma ve geri yükleme
Bölüm başlığı “Durdurma ve geri yükleme”ocx stop # proxy'yi durdurun ve yerel Codex'i geri yükleyinocx restore # durdurmadan yerel Codex'i geri yükleyin (takma ad: ocx eject)ocx restore back # Codex'i hala çalışan proxy üzerinden tekrar yönlendirinSonraki Adımlar
Bölüm başlığı “Sonraki Adımlar”- Nasıl Çalışır — her isteğe ne olur?
- Sağlayıcılar — kimlik doğrulamanın her yolu.
- Yapılandırma — tam
config.jsonreferansı.