İçeriğe geç

MiniMax istemcileri

MiniMax iki farklı komut satırı ürünü sunar. OpenCodex, her birini gerçekten sunduğu protokol sınırında bütünleştirir:

  • MiniMax Code (mcode), özel Anthropic Messages sağlayıcıları kullanan bir kodlama ajanıdır.
  • MiniMax CLI (mmx), çok modlu bir platform CLI’ıdır. Yalnızca text kaynağı, OpenCodex’in yönlendirebildiği Anthropic uyumlu API’yi kullanır.

Önce MiniMax’ın yönergelerini kullanarak MiniMax Code’u kurup oturum açın. Ardından OpenCodex’i başlatıp geri alınabilir dosya bütünleştirmesini bağlayın:

Terminal window
ocx start
ocx integration client enable --client mcode
ocx mcode

Yalıtılmış örnek verilerle gösterilen MiniMax Code bütünleştirmesi

Bütünleştirme, ~/.minimax/config.yaml içine bir blok ekler:

custom_provider:
opencodex:
name: OpenCodex
kind: custom
enabled: true
api: anthropic-messages
options:
apiKey: opencodex-loopback
baseURL: http://127.0.0.1:10100
authMode: api-key
models:
anthropic/claude-opus-5:
limit:
context: 1000000

Gerçek oluşturulan model listesi ile bilinen bağlam pencereleri ve akıl yürütme çabası basamakları çalışan OpenCodex kataloğundan gelir. Yetkili bağlam penceresi veya çaba basamağı olmayan model için tahmini bir değer yazılmaz; ilgili alan atlanır. MCode, oturumda o anda seçili çabayı korur; bu nedenle OpenCodex, seçimi değiştirmeden effortOptions değerini dışa aktarır. Blok gerçek bir anahtar yazmaz, defaultModel değerini değiştirmez ve MiniMax girişinizi etkilemez. MCode içinde custom_provider:opencodex/... altından bir model seçin.

ocx mcode, istemciyi başlatmadan önce sağlayıcının o anda çalışan proxy’ye işaret ettiğini doğrular. Bir kez etkinleştirdikten sonra ocx sync, port veya katalog yetenekleri değiştiğinde sahiplenilmiş bloğu yeniler. Otomatik senkronizasyon sahipsiz bir blok oluşturmaz, kaldırdığınız bloğu yeniden oluşturmaz ve OpenCodex son yazdığından beri değişen dosyanın üzerine yazmaz; bilerek yeniden bağlanmak için etkinleştirme komutunu kullanın. Aynı denetlenen bütünleştirme sistemiyle devre dışı bırakın veya geri yükleyin:

Terminal window
ocx integration client disable --client mcode
ocx integration client history --client mcode
ocx integration client restore --op <opId> [--confirm-drift]

MINIMAX_DATA_DIR ve eski MAVIS_DATA_DIR değerleri dikkate alınır. Göreli yol geçersiz kılmaları reddedilir; OpenCodex ve MCode farklı çalışma dizinlerinde başlayabilir.

Resmî CLI’ı ayrıca kurun:

Terminal window
npm install -g mmx-cli
mmx --version

Bir metin komutunu sarmalayıcı ve bir OpenCodex model kimliğiyle yönlendirin:

Terminal window
ocx mmx text chat \
--model anthropic/claude-opus-5 \
--message "Explain this function"
ocx mmx --output json text chat \
--model openai/gpt-5.6-sol \
--message "Return a JSON summary"

MMX, API temel URL’sinin altına /anthropic/v1/messages yolunu sabit kodlar. Sarmalayıcı, alt sürecin ömrü boyunca geçici bir geri döngü köprüsü başlatır. Köprü yalnızca bu Messages yoluna ve /anthropic/v1/messages/count_tokens yoluna gelen POST isteklerini kabul eder; istek gövdeleri ile sorgu verilerini koruyarak bunları OpenCodex’in mevcut /v1/messages ve /v1/messages/count_tokens veri düzlemine eşler. Kanonik OpenCodex istek çevirisi, kullanım muhasebesi ve yapılandırılmış aşağı akış sağlayıcı kimlik doğrulaması geçerliliğini korur; sağlayıcılar yapılandırmalarına göre x-api-key veya bearer aktarımı alır. Akış, Anthropic ileti ve içerik olaylarını korur. Köprü iletmeden önce gelen kabul kimlik bilgisi başlıklarını kaldırır ve genel opencodex-loopback yer tutucusunu sabitler. Rastgele Anthropic kaynakları proxy’lenmez ve köprü geri döngü dışına açılmaz.

Sarmalayıcı ayrıca yalnızca bu yer tutucuyu içeren geçici bir MMX_CONFIG_DIR oluşturur ve mmx kapandıktan sonra siler. ~/.mmx/config.json dosyanız, OAuth belirteçleriniz ve MiniMax API anahtarınız hiçbir zaman yüklenmez veya kopyalanmaz.

Aşağıdaki sınırlar bilinçli olarak uygulanır:

  • OpenCodex üzerinden yalnızca text chat ve text repl yönlendirilir.
  • Arayanın kimlik bilgileri veya hedef seçicileri yalıtılmış köprüyle çakışmasın diye sarmalayıcı --api-key, --base-url ve --region seçeneklerini reddeder.
  • MMX, uzak bir bağ için OpenCodex’in özel x-opencodex-api-key kabul başlığını gönderemediğinden sarmalayıcı yalnızca geri döngüde çalışır.
  • image, video, speech, music, vision, search, quota, auth, config, file ve update için düz mmx çalıştırın; bunlar OpenCodex’in taklit etmediği MiniMax API’lerini çağırır.

mmx, metin modeli olarak varsayılan MiniMax-M3 kullanır. Belirli bir OpenCodex rotası istiyorsanız --model <provider/model> iletin; aksi halde normal OpenCodex model yönlendirme kuralları varsayılan kimliğin kullanılabilir olup olmadığını belirler.