Entegrasyonlar
Bağlantı sekmesi, opencodex’in sağlayıcı bloğunu istemcinin kendi yapılandırma dosyasına yazar ve tekrar kaldırır. On sekiz istemci bu şekilde çalışır, her biri bir anahtarla:
Windows’ta mutlak yol gerektiren geçersiz kılmalar bir sürücü harfi (C:\Users\me\client) veya UNC paylaşımı (\\server\share\client) içermelidir. Geçerli sürücüye bağlı \Users\me\client ve /client/config biçimleri reddedilir. ~ desteği belgelenmiş seçiciler bunu etkin ev dizinine göre genişletir; Gentle Shell ~ işaretini genişletmez.
| İstemci | Yapılandırma dosyası | Format | Değişiklik ne zaman geçerli olur? | Kimlik bilgisi |
|---|---|---|---|---|
| OpenCode | ~/.config/opencode/opencode.json |
JSON | sonraki doğrudan başlatmada | OPENCODEX_OPENCODE_API_KEY |
| Pi | ~/.pi/agent/models.json |
JSON | yeni oturumlarda | geri döngü (loopback) yer tutucusu |
| OMP | ~/.omp/agent/models.yml |
YAML | OMP yeniden başlatıldıktan sonra | opencodex-loopback yer tutucusu |
| Hermes | ~/.hermes/config.yaml |
YAML | yeni oturumlarda | OPENCODEX_HERMES_API_KEY |
| OpenClaw | ~/.openclaw/openclaw.json |
JSON5 | hemen, çalışan bir ağ geçidinde | OPENCODEX_OPENCLAW_API_KEY |
| Kimi Code | ~/.kimi-code/config.toml |
TOML | yeniden başlatmada veya /reload ile |
geri döngü (loopback) yer tutucusu |
| gjc | ~/.gjc/agent/models.yml |
YAML | yeni oturumlarda veya /model açtığınızda |
non-secret loopback placeholder |
| DeepSeek Harness (DSH) | $DSH_HOME/profiles/desktop/cordis.patch.yml (varsayılan ~/.dsh/profiles/desktop/cordis.patch.yml); DSH Desktop bu profili oluşturana kadar $DSH_HOME/settings.yaml |
YAML | çalışırken yeniden yükleme | gizli olmayan geri döngü bearer yer tutucusu |
| MiniMax Code | ~/.minimax/config.yaml |
YAML | yeni oturumlarda veya model seçici açıldıktan sonra | geri döngü (loopback) yer tutucusu |
| Prime Agent | ~/.prime/agent/models.json |
JSON | yeni oturumlarda | geri döngü yer tutucusu |
| ZCode | ~/.zcode/v2/provider_config.json (schemaVersion 1); eski biçim için yedek yol: ~/.zcode/v2/config.json |
JSON | yeniden başlatmada | geri döngü yer tutucusu |
| Aside | ~/.aside/u/<account>/models.json |
JSON | Aside tamamen kapatılıp yeniden açıldıktan sonra | geri döngü yer tutucusu |
| Raycast | ~/.config/raycast/ai/providers.yaml |
YAML | kaydedildiği anda — Raycast dosyayı izler | yok — yalnızca geri döngü |
| omo | ~/.omo/agent/models.json |
JSON | yeni oturumlarda | geri döngü yer tutucusu |
| Cline CLI | ~/.cline/data/settings/providers.json + models.json |
JSON | kapatıp yeniden başlattıktan sonra | yalnızca loopback |
| Kilo | ~/.config/kilo altında ilk bulunan kilo.jsonc, kilo.json, opencode.jsonc, opencode.json veya config.json (XDG_CONFIG_HOME bu dizini taşır; hiçbiri yoksa kilo.jsonc oluşturulur) |
JSONC | yeni oturumlarda | OPENCODEX_KILO_API_KEY |
| Command Code | ~/.commandcode/providers.json (Windows’ta varsayılan ana dizin kullanılırken: HOME ?? USERPROFILE değerini yalnızca boş veya sırf boşluklardan oluşmayan mutlak bir Windows yoluysa kullanır, aksi halde homedir() kullanılır; ayrıca verilen ana dizin korunur; sonuna .commandcode\providers.json eklenir) |
JSON | Command Code’un sonraki başlatılmasında | yok — anahtarsız geri döngü (apiKey: false) |
| Factory Droid | ~/.factory/settings.json (%USERPROFILE%\.factory\settings.json Windows’ta) |
JSON | dosya değişince hemen | anahtarsız geri döngü |
Desteklenen akıl yürütme düzeylerine sahip GJC modelleri, GJC’nin düzey seçimi sunabilmesi için reasoning: true, thinking.levels ve compat.supportsReasoningEffort alanlarını dışa aktarır. Yerel Codex modelleri, katalogda belirtilmese bile standart düzeylerini alır. Bilinen düzeyi olmayan modellerde bu alanlar bulunmaz. none düzey göndermez ve ultra gönderimde max düzeyine dönüşür; bu yüzden seçeneklerde yer almazlar. Model seçeneklerini güncellemek için entegrasyonu yenileyin.
Yönetilen DSH desteğinin en düşük uyumlu sürümü DSH 0.1.0-rc.6’dır. DSH 0.1.7 ve üzeri, sağlayıcı rotalarını
$DSH_HOME/profiles/desktop/cordis.patch.yml dosyasındaki [id=llm-pi-ai].config.providers.opencodex satırından okur.
Desktop profili ve yaması varsa OpenCodex yalnızca bu satırı yazar.
$DSH_HOME/profiles/desktop/package.json varsa ancak cordis.patch.yml yoksa Uygula işlemi reddedilir:
[] içeren bir cordis.patch.yml oluşturun (DSH’nin yeni bir profil için yazdığı boş yama), ardından
entegrasyonu yeniden etkinleştirin. Yalnızca Desktop profili yoksa
$DSH_HOME/settings.yaml içindeki llm-pi-ai.providers.opencodex bölümünü kullanır. Uygula ve Yenile seçilen yönetilen bölümü değiştirir, Devre Dışı
Bırak yalnızca bu bölümü kaldırır, Geri Yükle ise kaydedilmiş bir anlık görüntüyü geri koyar. DSH
sağlayıcı değişikliklerini çalışırken yeniden yükler. Bu işlemler kullanıcının varsayılan modelini
veya yerel deepseek-official sağlayıcısını değiştirmez. Yönetilen DSH entegrasyonu şu anda yalnızca
geri döngü içindir ve asla gerçek bir kimlik bilgisi yazmaz.
MiniMax Code önce MINIMAX_DATA_DIR, ardından MAVIS_DATA_DIR yolunu izler ve
son olarak ~/.minimax dizinine geri döner. Yönetilen blok yalnızca
custom_provider.opencodex alanına sahiptir; defaultModel değerini, seçilen
MiniMax kimlik bilgisi kaynağını veya kullanıcının MiniMax oturumunu değiştirmez.
Bağladıktan sonra MCode içinde bir custom_provider:opencodex/<provider/model> girdisi seçin.
Entegrasyon yenilendiğinde model başına doğrulanmış bağlam pencereleri ve akıl yürütme
çabası seçenekleri de yenilenir; bilinmeyen yetenekler atlanır ve MCode oturumunun
yönettiği geçerli çaba seçimi korunur.
Raycast’in iki ön koşulu vardır. Özel sağlayıcılar (Custom Providers) bir Raycast Pro
özelliğidir: ücretsiz planda dosya yine yazılır, ancak Raycast onu okumayacağı için
ocx integration client status --client raycast ve Bağlantı sayfası bir uyarı
bildirir. Ayrıca Raycast ai klasörünü yalnızca Raycast → Settings → AI →
Reveal Providers Config seçeneğini bir kez açtığınızda oluşturur; opencodex bu
klasörü kurulum sinyali olarak kullanır ve klasör var olana kadar istemciyi kurulu değil
olarak bildirir. Raycast, ~/.config/raycast/ai/providers.yaml dosyasını macOS ve
Windows’ta aynı şekilde okur ve XDG_CONFIG_HOME değerini dikkate almaz; bu nedenle bu
yol taşınamaz.
Yönetilen blok, dosyanın providers dizisindeki tek bir öğedir: id: opencodex,
name: OpenCodex, base_url: http://<host>:<port>/v1 ve abilities alanıyla birlikte
yönlendirilen her model — dışa aktarma kuralı olarak tools ve system_message değeri true olur, vision
kataloğun giriş modalitelerini izler, reasoning_effort modelin bir çaba merdiveni
varsa ayarlanır ve temperature akıl yürütme modelleri için kapatılır. Dosyadaki diğer
sağlayıcılar korunur ve devre dışı bırakma yalnızca OpenCodex öğesini kaldırır. Raycast
değişikliği dosya kaydedilir kaydedilmez, yeniden başlatma gerekmeden alır; modeller
Raycast’in model seçicisinde OpenCodex altında gruplanmış olarak görünür. Raycast şeması
isteğe bağlı api_keys alanını destekler; OpenCodex bu alanı bilerek yazmaz ve geri döngü
dışı veya kimlik doğrulaması gerektiren hedefleri reddeder. Bu entegrasyon OpenCodex’in
zorunlu kabul başlığını sağlayamaz. macOS’taki özel tercih yalnızca bir Pro ipucudur;
Windows bu tercihi hiç okumaz ve durumu bilinmiyor olarak bildirir. Bu bilgi yazmayı engellemez.
Dışa aktarılan meta veriler her modelin araç desteğini doğrulamaz. Diğer sağlayıcıların
değerleri korunur; YAML biçimlendirmesi ve yorumlarının korunması garanti edilmez. Format
manual.raycast.com/ai/custom-providers
adresinde belgelenmiştir.
Raycast CLI dışa aktarmaları ve panel indirmeleri, yapılandırılmış kimlik doğrulamasız
geri döngü dinleyicisi dahil çalışan sunucunun adresini ve kabul politikasını kullanır.
ocx ensure, çalışan sunucudan farklı olabilecek kayıtlı yapılandırma kopyasıyla Raycast’i
yenilemez. Sunucu başlangıcı ve açık senkronizasyon katalog yenilemeye devam eder.
Yollar, varsa her istemcinin kendi ortam geçersiz kılmalarını dikkate alır. OMP
için OMP_PROFILE, açıkça boş olduğunda bile varlığıyla PI_PROFILE’a üstün
gelir. Adlandırılmış bir profil, PI_CONFIG_DIR’i kullanıcının ev dizinine göre
bir dizin adı olarak kullanır ve PI_CODING_AGENT_DIR’i yok sayar;
adlandırılmış bir profil olmadığında PI_CODING_AGENT_DIR kazanır. OMP
sağlayıcı düzeyinde başlıkları destekler, ancak bu ilk entegrasyon kasıtlı
olarak yalnızca geri döngü (loopback) içindir; uzaktan x-opencodex-api-key
bağlantısı ertelenmiştir. Taşınmış HERMES_HOME, KIMI_CODE_HOME ve
XDG_CONFIG_HOME yolları tahmin edilmek yerine benzer şekilde takip edilir.
Tablo her istemcinin varsayılanını listeler.
Yerel OpenAI modelleri için üretilen OMP bloğu, görsel girişini ve akıl yürütme çabası denetimlerini koruyarak model düzeyindeki Responses API’sini seçer. Yönlendirilen modeller, sağlayıcının Chat Completions lehçesini korur, böylece mevcut adaptörleri uyumlu kalır.
OpenClaw’un birkaç yolu vardır ve bunlar farklı işler yapar.
OPENCLAW_CONFIG_PATH dosyayı seçer; OPENCLAW_STATE_DIR, OPENCLAW_PROFILE
ve OPENCLAW_HOME algılamanın da baktığı durum dizinini seçer — bu nedenle bir
profil veya taşınmış bir ev dizini hala kurulu olarak okunurken, bir
yapılandırma yolu geçersiz kılması yalnızca dosyayı taşır. Hala eski .clawdbot
düzenindeyseniz bu da bulunur: modern dizin mevcut olduğunda kazanır ve eski
dizin yalnızca orada tek olduğunda kullanılır.
Bunlar mutlak yollar olmalı veya ~ ile başlamalıdır. Göreli bir yol
çözümlenmek yerine reddedilir, çünkü her sürecin tesadüfen başladığı dizin
anlamına gelirdi — ve bu yol yedekle birlikte saklanır, bu yüzden yarın da bugün
olduğu gibi aynı dosyayı adlandırmalıdır.
opencodex bunları kendi ortamından okur. Ağ geçidiniz bir profil veya taşınmış bir ev dizini ile çalışıyorsa, opencodex’i aynı değişkenler ayarlanmış olarak başlatın; aksi takdirde doğru şekilde farklı bir kurulumu takip eder.
Diğer beş yüzey anahtar değildir
Bölüm başlığı “Diğer beş yüzey anahtar değildir”API Anahtarları (API Keys) opencodex’in kendi kimlik bilgilerini yönetir ve hiçbir şekilde bir istemci değildir. Codex CLI, proxy servisinin kendisi tarafından bağlanır — opencodex’i başlatmak uygular, durdurmak yerel yönlendirmeyi geri yükler — bu nedenle dosya başına değiştirilecek bir şey yoktur. Claude kendi etkinleştirme bayrağını ve Desktop’ın Kaydet/Uygula akışını korur; Grok Build ise seç ve uygula model çitini korur. Bu anlambilimler bu özellikten öncedir ve değişmemiştir. Cursor hiçbir şey yazmaz: sekmesi algılama durumunu, ağ geçidi değerlerini ve görülen son isteği gösterir; geri kalanı Cursor Private Inference içinde gerçekleşir.
Geri Alma (Rollback)
Bölüm başlığı “Geri Alma (Rollback)”Her başarılı yazma işlemi önce dosyanızın bir anlık görüntüsünü alır, böylece sahip olduğunuz durum her zaman kurtarılabilir:
- Geri Al (Undo), dosyanız yazdığımızla hala eşleştiğinde en yeni işlemde görünür.
- Bu noktayı geri yükle… (Restore this point…), daha eski işlemlerde veya dosya bu işlemden sonra değiştiğinde görünür. Böyle bir değişiklik üzerinden geri yükleme yapmak, daha yeni düzenlemelerinizin üzerine yazmadan önce ikinci kez sorar — ve bunları da yedekler, böylece bu geri yüklemenin kendisi de geri alınabilir olur.
- İstemci başına on yedek saklanır. Bunun ötesinde, en eski anlık görüntü dosyaları kaldırılır ve geçmiş satırlarında Yedek süresi doldu (Backup expired) yazar.
Devre dışı bırakma, yalnızca opencodex’in kendisine ait olarak kaydettiği
girdileri kaldırır. Dosyanız biz yazdıktan sonra değiştiyse, ne olacağı kendi
girdilerimizin hâlâ bozulmamış olup olmadığına ve dosyanın biçimine bağlıdır.
Katı JSON yapılandırmalarında (OpenCode, Pi), bloğumuzun yanında yapılan bir
düzenleme — bir MCP sunucusu eklemek, kendinize ait bir sağlayıcı tanımlamak —
Güncelleme gerekli (Update needed) olarak görünür: yenileme, girdilerinizin
etrafında birleştirir ve onları korur; yalnızca biçimlendirme
normalleştirilebilir. İstisna, JSON’un birebir yeniden yazamayacağı şeylerdir —
1e999 gibi sonlu olmayan bir sayı, yeniden yazımın yuvarlayacağı bir sayı (çok
büyük bir tam sayı ya da sıfıra çökecek kadar küçük bir sayı), -0, aynı
nesnede iki kez yazılmış bir anahtar veya 1000 seviyeden derin iç içe geçme —
bu durumda anahtar kilitlenir, böylece
hiçbir şey sessizce değiştirilmez veya düşürülmez. OMP de yanındaki
düzenlemelerden etkilenmez, ama başka bir nedenle: writer’ı yalnızca kendi
providers.opencodex aralığını bayt bayt yamalar, dosyanın geri kalanı hiçbir
zaman yeniden yazılmaz. Yorum taşıyabilen diğer biçimlerde (Hermes, OpenClaw,
Kimi Code, gjc, MiniMax Code, Raycast — bütün belge olarak yazılan YAML, JSON5 ve TOML) veya
kendi girdilerimiz düzenlenmişse, anahtar kilitlenir ve hangi düzenlemelerin
size ait olduğunu tahmin etmek yerine devre dışı bırakmayı reddeder.
Hermes istisnası: yönetilen bloğa yalnızca session_affinity_header: session-id eklenmişse Apply ile benimsenebilir; diğer yönetilen alan değişiklikleri çakışma olarak kalır. Uygulanana kadar arka plandaki model listesi güncellemeleri de bekletilir. Ayar provider içindeki tüm modeller için geçerlidir ve bu özelliği destekleyen bir Hermes sürümü gerektirir; önbellek isabet oranı garanti edilmez. İngilizce yükseltme açıklamasına bakın.
Değişiklikleri önizleyin ve onaylayın
Bölüm başlığı “Değişiklikleri önizleyin ve onaylayın”Uygula, Değiştir, Devre dışı bırak ve Geri yükle işlemleri artık bir önizlemeyle başlar. İletişim kutusu, yönetilen ayarlardan tam olarak hangilerinin değişeceğini, sınırlı değişiklik yollarını ve her değişikliğin bir değer eklediğini, güncellediğini veya kaldırdığını gösterir. Onaylamadan önce bu planı inceleyin.
Bir plan değişiklik olmadığını bildiriyorsa yönetilen istemci belgesi zaten istenen durumdadır. Seçili bir Aside profilinde onaylama, yönetilen belge değişmese bile profilin eşitleme tercihini kaydedebilir.
Dosya siz inceledikten sonra değişirse yazma işlemi eski plan nedeniyle reddedilir. İletişim kutusu eski planı güncel planla değiştirir ve yeniden açıkça onaylamanızı ister; yazma işlemini hiçbir zaman otomatik olarak yeniden denemez. Önizleme henüz model kataloğu yüklenmediğini bildirirse iletişim kutusu açık kalır ve Kataloğu yükle ve yeniden dene seçeneğini sunar: entegrasyon listesini yeniden okur ve planı tekrar ister.
Aside, aynı önizleme ve onay akışını bir defada seçili tek bir profil için kullanır. Tüm profilleri eşitle ayrı bir toplu işlem olarak kalır ve tek bir birleşik önizlemeye bağlı değildir. Bir plan yalnızca bir profilin dosyasını anlatır; bu yüzden çakışmadaki Aside genel bakış kartı Profil seç sunar ve blok o profilin sayfasında değiştirilir.
Dürüstçe ne beklenmeli?
Bölüm başlığı “Dürüstçe ne beklenmeli?”Biçimlendirme genellikle korunmaz. Uygulama işlemi bir yapılandırmayı
ayrıştırır ve geri yazar, bu nedenle JSON, JSON5 ve TOML yeniden
biçimlendirilebilir ve JSON5 veya TOML içindeki yorumlar kaybolur. OMP ve DSH
istisnadır: OMP YAML yazıcısı yalnızca providers.opencodex bölümünü yamalar.
DSH yazıcısı, Desktop profili varsa $DSH_HOME/profiles/desktop/cordis.patch.yml içindeki
[id=llm-pi-ai].config.providers.opencodex satırını, profil yoksa
$DSH_HOME/settings.yaml içindeki llm-pi-ai.providers.opencodex bölümünü yamalar;
ilgisiz sağlayıcı yorumlarını ve biçimlendirmesini bayt bayt korur. Bu tam
kaynak aralığı güvenli bir şekilde tanımlanamazsa işlem bunun yerine reddeder.
Diğer istemciler için önceki dosya baytlarına ihtiyacınız olduğunda Geri
Yükle’yi kullanın: anlık görüntü birebir bir kopyadır.
Bir değer aslına sadık kalınarak yeniden yazılamıyorsa anahtar bunun yerine
reddeder. Gidiş-dönüş, bu formatların pratikte kullandığı değer türlerini
kapsar ve kapsamadığı yerlerde — örneğin elimizdeki ayrıştırıcının doğru şekilde
geri okuyamadığı inf veya nan kullanan bir TOML dosyası — uygulama işlemi
değişen bir değer yazıp buna başarı demek yerine durur ve bunu söyler. Dosyanın
adlandırıldığını ve diskte hiçbir şeyin taşınmadığını görürsünüz. Bu dosyayı
elle düzenlemek hala çalışır; yalnızca otomatik yeniden yazmamız reddeder.
TOML tarih ve saat değerleri de otomatik yeniden yazmayı engeller: birleştirme adımı, diziler ve satır içi tablolar dahil bu türlenmiş değerleri tırnaklı metne dönüştürür. Zaten tırnak içinde yazılmış tarihler desteklenir. Tırnaksız tarih türünü korumak için yapılandırmayı elle düzenleyin.
Pi, Kimi Code, gjc, MiniMax Code ve yönetilen DSH entegrasyonu yalnızca geri döngü (loopback) bağlantısına karşı
çalışır. İlk dördünün yapılandırmasında geri döngü olmayan bir bağlantının gerektirdiği
x-opencodex-api-key başlığı için alan yoktur. DSH genel bir headers haritası sunar, ancak rc.6
bu özel kabul başlığını desteklenen bir entegrasyon sözleşmesi olarak belgelememektedir; bu nedenle
yönetilen writer tahmin yürütmek yerine kapalı biçimde reddeder. Bunun yerine bir SSH tüneli veya
başlığı ekleyen yerel bir iletici aracılığıyla geri döngü erişimi verin.
Oluşturulan OMP entegrasyonu da kasıtlı olarak yalnızca geri döngü içindir.
OMP sağlayıcı düzeyinde başlıkları destekler, ancak bu ilk entegrasyon uzak
x-opencodex-api-key kimlik bilgisi bağlantısını yayınlamaz. Manuel uzak OMP
yapılandırması şimdilik yönetilen entegrasyonun dışındadır.
Kimi Code bir ortam referansı tutamaz, bu nedenle yapılandırması bir anahtar
yerine opencodex-loopback yer tutucusu taşır. Hiçbir istemci yapılandırmasına
asla gerçek bir kimlik bilgisi yazılmaz.
ocx opencode için başlatıcının sağlayıcı bloğu kazanır. Bu başlatıcı,
provider.opencodex’i diskteki aynı girdiden üstün olan
OPENCODE_CONFIG_CONTENT aracılığıyla enjekte eder — opencode yapılandırmanızın
geri kalanı her zamanki gibi geçerli olmaya devam eder. Başlatıcının yazdığı bloklar,
dışa aktarımlarla aynı geçerli kanonik model meta verisinden (bilinen yetenekler ve
akıl yürütme seçenekleri) kurulur; bilinmeyen değerler uydurulmaz, yalnızca çıkış sınırı
bilinmiyorsa şemanın zorunlu 32000 yedeğine (bağlama göre kırpılmış) düşer. Buradaki anahtar,
opencode’u doğrudan başlattığınızda önemlidir.
Terminalden
Bölüm başlığı “Terminalden”Aynı işlemler başsız (headless) olarak da mevcuttur:
ocx integration client statusocx integration client enable --client hermesocx integration client disable --client hermesocx integration client history --client hermesocx integration client restore --op <opId> [--confirm-drift]--overwrite-conflict, Replace eyleminin terminal karsiligidir:
ocx integration client enable --client zcode --overwrite-conflict--confirm-drift gibi asla varsayilmaz: bayrak yazilmadan catisma yine reddedilir.
Yalnizca enable icin gecerlidir; bir catismanin uzerine disable zorlamak hic
yazmadigimiz bir blogu silecegi icin bu birlesim reddedilir.
MiniMax Code için sağlayıcıyı bir kez bağlayın ve denetimli başlatıcı üzerinden çalıştırın:
ocx integration client enable --client mcodeocx mcodeBağlandıktan sonra ocx sync ve POST /api/sync, yönetilen MCode, Pi, Aside,
Raycast, omo, OpenCode ve Kilo kataloglarını yeniler. Proxy başlangıcı da yönetilen Raycast
kataloğunu yeniler. Model görünürlüğü, sağlayıcı veya ön ayar değişiklikleri Pi,
Aside, Raycast, omo, OpenCode ve Kilo kataloglarını günceller. Eksik, dışarıdan düzenlenmiş, güvenli olmayan
veya elle kaldırılmış bloklara dokunmaz; yeniden bağlamak istediğinizde
entegrasyonu açıkça etkinleştirin. Güncellenen dosyayı yüklemek için yeni bir
Pi, OpenCode veya Kilo oturumu başlatın.
Ayrı MiniMax platform CLI’si (mmx) bir dosya anahtarı entegrasyonu değildir.
Metin komutları MiniMax’ın Anthropic uyumlu uç noktasını kullandığı için OpenCodex,
kimlik bilgilerini yalıtan ve yalnızca geri döngüde çalışan bir başlatıcı sağlar:
ocx mmx text chat --model anthropic/claude-opus-5 --message "Hello"ocx mmx text repl --model openai/gpt-5.6-solYalnızca mmx text chat ve mmx text repl proxy üzerinden yönlendirilir. MiniMax’a
özgü diğer komutlar için doğrudan mmx çalıştırın. Başlatıcı yalnızca gizli olmayan
geri döngü yer tutucusunu içeren geçici bir yapılandırma kullanır; ~/.mmx OAuth veya
API anahtarı kimlik bilgilerinizi yüklemez ve --api-key, --base-url ile --region
geçersiz kılmalarını reddeder. Tam iş akışı için
MiniMax istemcileri sayfasına bakın.
--confirm-drift asla varsayılmaz. Geri yüklediğiniz işlemden sonra dosya
değiştiyse, komut reddeder ve size bildirir; çünkü daha yeni düzenlemelerinizin
üzerine yazmak sizin vereceğiniz bir karardır.
İstemci ayrıntıları her projenin kendi yapılandırma formatına göre
doğrulanmıştır; neyin ne zaman denetlendiğine ilişkin
devlog/_fin/260802_client_toggle_api/002_client_toggle_matrix.md içindeki
araştırma notlarına bakın.
ZCode 3.14 ve sonrası
Bölüm başlığı “ZCode 3.14 ve sonrası”Bu yollar varsayılandır. Varsayılan ev dizininde kalan ~/.zcode/v2/setting.json içindeki mutlak dataBaseDir, depoyu <dataBaseDir>/.zcode/v2/provider_config.json konumuna taşır. ZCODE_DATA_DIR doğrudan .zcode kökünü belirtir ve ayardan önceliklidir; ZCODE_PERSONAL_PROVIDER_CONFIG_FILE sağlayıcı dosyası için önceliklidir. Okunamayan, bozuk veya göreli ayarlar yeni uygulamaları ve yenilemeleri engeller. Mevcut sahiplik ve geri alma kayıtları korunur. İngilizce yol ve geri alma kurallarına bakın.
ZCode 3.14 özel sağlayıcılarını ~/.zcode/v2/provider_config.json dosyasına taşıdı; bu
entegrasyonun yazdığı ~/.zcode/v2/config.json dosyasına artık yalnızca, yeni dosya yokken bir kez
çalışan bir içe aktarma üzerinden ulaşıyor. ZCode yeni dosyayı ilk çalıştırmada oluşturduğu için,
bir kez bile başlatılmış her kurulumda bu içe aktarma çoktan tükenmiştir ve config.json dosyasına
yazmak hiçbir şeye ulaşmaz.
opencodex artık mümkün olduğunda provider_config.json dosyasını doğrudan yazıyor. Entegrasyonu
etkinleştirmek bu dosyaya opencodex sağlayıcı kuralını ekler, katalog yenilemesi onu günceller ve
devre dışı bırakmak opencodex’in oraya koyduğu şeyi tam olarak kaldırır. Dosyadaki diğer her kural
olduğu gibi kalır; buna başka bir sağlayıcının, bizde de bulunan bir model kimliği için tuttuğu
kural da dahildir. opencodex’in yazmadığı, opencodex kimliğini taşıyan bir kural devralınacak bir
şey değil, bir çakışmadır: ZCode içinde çözün ya da açık üzerine yazmayı kullanın.
İki durum hâlâ yazmak yerine reddeder. ZCode deposunu taşımadan önce opencodex’in yazdığı bir blok,
entegrasyonu config.json üzerinde tutar: önce orada devre dışı bırakın, sonra yeni depoyu yazmak
için yeniden etkinleştirin. schemaVersion değeri opencodex’in gözlemlediklerinden biri olmayan
bir provider_config.json ise birleştirilmez, bildirilir: o dosya ZCode’un tüm sağlayıcılarını
tutar ve oraya bir şekil dayatmak sessiz bir etkisizliği sessiz bir kayıpla değiştirirdi. Durum
ekranı, entegrasyon o dosyayı yazmadığı her durumda ZCode’un okuduğu dosyayı adlandırır.
Bu ikinci durumda sağlayıcıyı ZCode’un kendi ayarlarından ekleyin: temel URL
http://127.0.0.1:10100/v1 (bağlantı noktasını kendi bağınıza göre ayarlayın), boş olmayan
herhangi bir anahtar ve ocx export --client zcode çıktısındaki model kimlikleri. ZCode’un içe
aktarmasını yeniden tetiklemek için provider_config.json dosyasını silmek desteklenmez: bu,
ZCode’un orada sakladığı tüm sağlayıcıları yok eder.
Cline CLI
Bölüm başlığı “Cline CLI”Cline CLI providers.json ve models.json kullanır. Değişiklik veya eşitleme öncesinde Cline’ı kapatın, sonra yeniden başlatın. Geri al iki özgün dosyayı geri yükler. Varsayılan sağlayıcı değişmez. Eski VS Code uzantısının depolaması taşınmaz.
ocx integration client enable --client clineocx integration client history --client clineocx integration client restore --op <operation-id>CLI / rollback / CLINE_PROVIDER_SETTINGS_PATH.
omo (Codex / LazyCodex) rol akıl yürütme çabası
Bölüm başlığı “omo (Codex / LazyCodex) rol akıl yürütme çabası”LazyCodex algılandığında omo sekmesindeki omo (Codex / LazyCodex) bölümünde $CODEX_HOME/agents/*.toml içindeki her rol için model ve akıl yürütme çabası seçip Kaydet düğmesine basabilirsiniz. Model sabitlemesi olmayan bir rolün satırı yalnızca çabayı kaydedebilir; rol modelini devralmaya devam eder. opencodex, rol dosyasında yalnızca kökteki model ve model_reasoning_effort anahtarlarını günceller ve eksik sabitlemeleri dosyanın başına yakın bir yere ekler. Rolün talimatları, diğer yorumlar ve diğer anahtarlar olduğu gibi kalır. Yalnızca modeli değiştiren kayıt effort göndermez; bu yüzden iki dosyadaki çaba değerleri korunur. Bir düzey seçmek rol dosyasındaki model_reasoning_effort değerini ekler veya değiştirir; LazyCodex bu düzeyi destekliyorsa değer ~/.omo/omo.jsonc içindeki [codex].agents.<role>.reasoning alanına da yazılır (ultra yalnızca rol dosyasında kalır ve eski reasoning kaldırılır). Komut satırında aynı işi ocx agent roles set <role> <model> --effort <level> yapar.
Çabası zaten sabitlenmiş roller dahil her satırda Çabayı devral seçeneği vardır. Sabitlenmiş bir çabayı bununla değiştirip kaydetmek "effort": null gönderir: rol dosyasındaki kök model_reasoning_effort satırı ve satır sonu yorumu ile omo.jsonc içindeki [codex].agents.<role>.reasoning kaldırılır. Model sabitlemesi yerinde kalır. Ardından Codex çabayı, kendi değeri olmayan herhangi bir rolde olduğu gibi belirler (açıkça verilen bir başlatma değeri, [agents] varsayılanı veya üst oturum); modelin sabit bir varsayılanını kullanmaz. Yalnızca var olan tek satırlık bir dize değeri kaldırılabilir; çok satırlı veya dize olmayan bir değer 409 unsupported_model_value ile reddedilir ve iki dosya da değişmez.
PUT /api/codex-agent-roles/{role} isteğinde model atlanırsa rol dosyasındaki model sabitlemesi ve omo.jsonc içindeki model olduğu gibi kalır; böylece sabitlemesi olmayan bir rol, çabası değişirken veya temizlenirken modelini devralmaya devam eder. Kontrol paneli böyle bir satır için yalnızca çaba içeren bu isteği gönderir ve omo.jsonc içinde girdisi olmayan bir rol için, LazyCodex’in desteklediği bir çaba düzeyi kaydedildiğinde yalnızca reasoning içeren bir girdi oluşturulur. Kayıt hiçbir zaman model sabitlemesini kaldırmadığı için null model 400 invalid_model ile reddedilir; ne model ne de effort içeren bir istek, rol dosyası veya omo.jsonc okunmadan önce 400 empty_update ile reddedilir. ocx agent roles set her zaman bir model alır.
~/.omo/omo.jsonc yoksa oluşturulmaz. Yorum içeriyorsa, kaydetmek yorumları sileceği için dosyaya dokunulmaz; bu durumda değeri elle ayarlayın. Atlanan bir yansıtma, rol dosyasının kaydını geri almaz. Rol dosyası kaydedilir ama omo.jsonc yazımı başarısız olursa satırdaki düğme omo.jsonc’yi yeniden dene olur ve Çabayı devral ile yapılan temizleme (null) dahil aynı çaba seçimini yeniden gönderir. Bu yeniden deneme başarılı olana kadar, o rol için çabaya dokunmayan sonraki bir Kaydet veya Otomatik ata Uygula işlemi bekleyen seçimi de birlikte gönderir; açıkça seçilen bir çaba onun yerine geçer.
Otomatik ata, seçilen modelin çaba listesi boş olmayan gereksinimleri değerlendirilmiş her rol için bir çaba önerir; Uygula, Tümünü uygula veya ocx agent roles suggest --apply o rolün model_reasoning_effort değerini ekler ya da değiştirir. Çaba, seçilen modelin kendi düzeylerine yerleştirilir: en düşük, varsayılan, varsayılanın bir üstü veya en yüksek. Liste boşsa çaba önerilmez (proposedEffort: null); Uygula bu durumda effort göndermez ve mevcut sabitlenmiş çabayı olduğu gibi bırakır. null bir öneri hiçbir zaman sabitlenmiş çabayı temizlemez.
Kilo yalnızca ~/.config/kilo altındaki ilk mevcut genel dosyada provider.opencodex yazar (XDG_CONFIG_HOME bu dizini taşır; hiçbir aday yoksa kilo.jsonc oluşturulur). Başka bir aday dosya da provider.opencodex tanımlıyorsa durum çakışma bildirir ve Uygula işlemi reddedilir. Diğer anahtarlar değişmez. Modellerin akıl yürütme seçenekleri, sağlayıcı bloğu içinde bir varyant haritası olarak OpenCode dışa aktarımıyla aynı geçerli kanonik meta veriden yazılır. ocx sync ve POST /api/sync OpenCodex’e ait Kilo bloğunu yeniler; güncellenen dosyayı yeni bir Kilo oturumu yükler. Uygula dosyanın tamamını yeniden yazar; yorumlar ve sondaki virgüller korunmaz. Kilo’da opencodex/<model> seçin.
Başka bir aday çakışsa veya ayrıştırılamasa bile Devre Dışı Bırak, kaydedilen dosyadaki OpenCodex’e ait bloğu kaldırabilir; diğer aday dosya değişmez.
ocx integration client enable --client kiloFactory Droid
Bölüm başlığı “Factory Droid”Factory Droid, ~/.factory/settings.json dosyasını (Windows’ta %USERPROFILE%\.factory\settings.json) kullanır. ocx integration client enable --client droid komutuyla açıkça etkinleştirin, ardından /model içinde özel bir model seçin. Yönetilen satırlar anahtarsızdır ve yalnızca geri döngü bağlantısında çalışır. Devre dışı bırakma yönetilen satırları kaldırır; Undo kaydedilen baytları geri yükler. Eski config.json dosyasında OpenCodex satırları varsa veya settings.local.json, customModels değerini geçersiz kılıyorsa etkinleştirmeden önce çakışmayı giderin. Factory BYOK belgelerine bakın.
Hermes / Command Code: model names
Bölüm başlığı “Hermes / Command Code: model names”Hermes and Command Code support --model-names alias|routed (API: modelNames).
The default is routed, independent of preferModelAliasIds. A connection
stores its mode; later Apply without the option preserves it. Alias mode uses
only provider-qualified aliases that the router proves equivalent; missing,
unsafe or colliding aliases fall back to routed keys. Combos keep their keys.
Removed/renamed aliases migrate on the next successful managed refresh, with
foreign-edit refusal. Named Hermes profiles need explicit Apply.
ocx export --client hermes --model-names alias --json previews a current
already loaded catalog without writing client files or managed state; a cold or
stale catalog returns unavailable. Explicit --out writes an export artifact.
See the English integration guide
for the canonical workflow.