Grok Build

opencodex, yerel portunda OpenAI uyumlu bir POST /v1/chat/completions (ve /v1/responses) sunar ve Grok Build, OpenAI uyumlu sunuculara karşı özel modelleri destekler. Bu entegrasyonla başlayarak opencodex, görünür kataloğunun tamamını otomatik olarak Grok Build’e kaydeder — manuel yapılandırma düzenlemesi gerekmez.

Otomatik Kayıt (Auto-registration)

~/.grok dizini mevcut olduğunda ocx start (ve ocx ensure / ocx restart), ~/.grok/config.toml dosyasına yönetilen bir blok yazar:

# >>> opencodex managed block — do not edit (removed by `ocx stop`) >>>
[model.ocx-gpt-5-6-sol]
model = "gpt-5.6-sol"
base_url = "http://127.0.0.1:10100/v1"
api_backend = "chat_completions"
api_key = "opencodex-loopback"
name = "OCX gpt-5.6-sol"
# ... görünür model başına bir [model.ocx-*] tablosu ...
# <<< opencodex managed block <<<

Eklemelidir (Additive): çitin dışındaki kendi yapılandırmanıza asla dokunulmaz. Önceden var olan bir dosyaya ilk enjeksiyondan önce ~/.grok/config.toml.bak-opencodex konumuna tek seferlik bir yedek yazılır.
Eşkuvvetlidir (Idempotent): her ocx start (ve otomatik başlatma etkinleştirildiğinde ocx ensure), çitle çevrili bloğu geçerli katalogla değiştirir.
Kaldırıldığında temizlenir: ocx stop, ocx eject, ocx uninstall ve zarif servis dışı arka plan programı kapatması, çitle çevrili bloğu kaldırır ve dosyanızı bayt bayt geri yükler. Bir servis yöneticisi altında kaldırma ocx stop/ocx uninstall üzerinden gerçekleşir (servis modu süreçleri kasıtlı olarak yeniden başlatmalar boyunca bloğu korur).
Çakışma güvenlidir: kendi [model.*] tablolarınız tarafından zaten tanımlanmış takma adlara saygı duyulur (opencodex kendi girdilerine sonek ekler); hasarlı bir çit (bitiş işareti olmayan başlangıç işareti) herhangi bir otomatik değişikliği reddeder ve manuel onarım ister.

Ardından Grok Build içinde bir model seçin:

grok models          # yerel grok modellerinin yanında ocx-* girdilerini listeler
grok -m ocx-anthropic-claude-opus-4-8 -p "hello"
# veya TUI içinde: /model ocx-anthropic-claude-opus-4-8

Akıl yürütme çabası (Reasoning effort)

Grok Build’in /effort (ve --effort) ayarı yalnızca katalog girdisi merdiveni bildiren modeller için çalışır: model listesi getirme işlemi ham GET /v1/models yanıtını okur ve buradaki girdiler supports_reasoning_effort artı reasoning_efforts menü seçeneklerini taşımalıdır. Yönlendirilen model girdileri için opencodex, yapılandırılmış sağlayıcı katmanlarını (reasoningEfforts / modelReasoningEfforts ve modelDefaultReasoningEfforts varsayılanı) bu yanıta yansıtır. Bu meta veriler proxy tarafından yapılandırılmış yönlendirilen merdiveni açıklar — yerel yukarı akış akıl yürütme desteğini iddia etmez ve adaptörler akıl yürütmeyi taklit edebilir veya seviyeleri sağlayıcıya özgü alanlarla eşleyebilir. Yapılandırılmış bir merdivene sahip yönlendirilen modeller, tıpkı Codex’te olduğu gibi Grok Build’de de çaba denetimini gösterir. Boş bir katman listesine sahip modeller, Codex davranışıyla eşleşecek şekilde çaba denetimi tutmaz. Yerel GPT-5.6 girdileri ayrıdır: sağlayıcı tarafından yapılandırılmış yönlendirilen meta veriler yerine sabitlenmiş yukarı akış akıl yürütme merdivenlerini korur ve ortaya çıkarır.

Kimlik doğrulama notu

Grok Build, geri döngüde (loopback) bile özel modeller için boş olmayan bir API anahtarı gerektirir. Enjekte edilen girdiler bir yer tutucu (opencodex-loopback) taşır — opencodex geri döngü bağlantıları için kabul anahtarlarını yok sayar, bu nedenle gerçek bir sır söz konusu değildir.

Otomatik kayıt yalnızca geri döngü içindir. opencodex geri döngü olmayan bir ana bilgisayarı bağladığında — her arabirimi açığa çıkaran 0.0.0.0 ve :: joker karakterleri dahil — istekler gerçek kabul belirtecinize ihtiyaç duyar ve yönetilen bir blok bunu güvenli bir şekilde taşıyamaz. Değişmezi yazmak sırrınızı ~/.grok/config.toml dosyasına koyar ve bir sonraki ocx start/ensure/restart sırasında orada ayarladığınız her şeyin üzerine yazar. Bu nedenle opencodex bu durumda hiçbir şey yazmaz (ve daha önceki bir geri döngü bağlantısından kalan tüm blokları kaldırır) ve modelleri yönetilen işaretçilerin dışında kendiniz yapılandırırsınız, burada opencodex’in yaptığı hiçbir şey onları ezemez. Tam tablo için Manuel tarif bölümüne bakın ve hem base_url (gerçekte grok çalıştırdığınız yerden erişilebilen bir ana bilgisayar) hem de api_key (OPENCODEX_API_AUTH_TOKEN değeriniz) ayarlayın.

Burada api_key’i env_key ile değiştirmeyin. model_provider ayarlanmadığında, çözümlenemeyen bir env_key isteği durdurmaz — Grok, xAI oturum belirtecinize geri döner ve bunu girdinin adlandırdığı base_url’e gönderir; bu da bir LAN dağıtımı için xAI olmayan düz metin bir HTTP uç noktasıdır.

Enjekte edilen model başına api_key, bu modeller için Grok’un kimlik bilgisi zincirinde ilk sırada yer alır; bu nedenle opencodex’e karşı yapılan dönüşler ek bir Grok girişi gerektirmez. Yerel grok modelleri ve doğrudan xAI ile iletişim kuran herhangi bir donanım özelliği için normal grok login / XAI_API_KEY kurulumunuzu koruyun.

Otomatik kayıt olmadan manuel tarif

~/.grok/config.toml dosyasını kendiniz yönetiyorsanız — veya opencodex geri döngü olmayan bir bağlantıdaysa — # >>> opencodex managed block işaretçilerinin dışına doğrudan alanlarla model başına tablolar ekleyin:

[model.ocx-opus]
model = "anthropic/claude-opus-4-8"
base_url = "http://127.0.0.1:10100/v1"
api_backend = "chat_completions"
api_key = "opencodex-loopback"

Ağ üzerinden erişilebilen bir proxy için base_url’i grok’un gerçekten çevirebileceği adrese yönlendirin ve kabul belirtecinizi kullanın:

[model.ocx-opus]
model = "anthropic/claude-opus-4-8"
base_url = "http://192.168.1.10:10100/v1"   # 127.0.0.1 değil, erişilebilir ana bilgisayar
api_backend = "chat_completions"
api_key = "OPENCODEX_API_AUTH_TOKEN_DEGERINIZ"

Uç nokta için [model_providers.<id>] kalıtımına güvenmeyin: Grok Build 0.2.101 itibarıyla devralınan base_url çıkarım yönlendirmesine uygulanmaz (istekler varsayılan xAI proxy’sine düşer ve 401 ile başarısız olur). Doğrudan model başına alanlar doğru şekilde yönlendirilir.

Nokta içeren herhangi bir takma adı tırnak içine alın: yalın [model.grok-4.5], grok-4.5 kimliği değil, üç segmentli bir anahtar yoludur. Oluşturulan takma adlar bu nedenle noktalardan tamamen kaçınır.

Bilinen sınırlamalar

Responses arka ucu ve canlı tutmalar (keep-alives): opencodex, yukarı akış sessizliği sırasında /v1/responses akışlarında bir response.heartbeat canlı tutma yayar. Grok Build’in Responses kod çözücüsü bilinmeyen olay türlerini reddeder, bu nedenle manuel olarak yapılandırılmış bir api_backend = "responses" modeli yavaş yukarı akışlarda tur ortasında başarısız olabilir. Otomatik olarak kaydedilen girdiler, ham kalp atışı çerçevelerini asla göstermeyen api_backend = "chat_completions" değerini sabitler.
Servis kurulu ocx restart: çalışan proxy yeniden başlatma yetkilendirmesine ve tahliye koordinasyonuna sahiptir, kurulu servis yöneticisi ise eski süreç çıktıktan sonra yenisini başlatır. Servis denetimi kurulu kalır. Geri döngü otomatik kaydında, yönetilen blok devir teslim boyunca yerinde kalır; geri döngü olmayan dağıtımlar bunun yerine manuel olarak yönetilen Grok yapılandırmasını kullanır. Komut yalnızca aynı port üzerinde farklı, kimliği doğrulanmış bir süreç sağlıklı olduğunda başarılı olur.
Yapılandırma okuma zamanlaması: en öngörülebilir sonuçlar için önce opencodex’i başlatın, ardından grok’u başlatın. Grok Build ~/.grok/config.toml dosyasını izler ve [model] tablosu gerçekten değiştiğinde (içeriğe göre karşılaştırılan yaklaşık bir saniyelik bir gecikme) yeniden yükler, böylece yenilenen bir blok yeniden başlatma olmadan açık bir oturuma ulaşır. Grok’un neyi ayrıştırdığını doğrulamak için grok inspect komutunu çalıştırın: yüklediği yapılandırma kaynaklarını listeler ve reddettiği herhangi bir alan hakkında uyarır. Çözümlenen model listesini yazdırmaz. Tek bir TOML hatasının tüm kullanıcı yapılandırma katmanını geçersiz kıldığını unutmayın; bu nedenle opencodex dosyayı atomik olarak yazar — Grok asla yarı yazılmış bir yapılandırma görmez.
Katalog güncellemeleri: çitle çevrili blok, enjeksiyon anındaki kataloğu yansıtır. Sağlayıcılar veya modeller ekledikten sonra yenilemek için ocx ensure çalıştırın (veya proxy’yi yeniden başlatın).