MiniMax Code: Gonka üzerinden kendi anahtarınızla MiniMax ajanı

Ajanın üç giriş noktası var ve üçü de BYOK sağlayıcısıyla aynı şekilde çalışıyor:

Resmi yükleyici en güncel sürümü ~/.minimax-code dizinine kurar, gerekirse uygun Node.js sürümünü getirir ve yönetici izni gerektirmez:

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

Node.js zaten kuruluysa (22 serisinde 22.19 ve üzeri, 24 serisinde 24.2 ve üzeri, ayrıca 25 ve 26), npm de iş görür:

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3

Uzun komut tesadüf değil: ajanın yerel SQLite derlemesine ihtiyacı olduğundan isteğe bağlı bağımlılıklar ve kurulum betikleri açık kalmalı. Kurulumdan sonra terminali yeniden açıp doğrulayın: mcode --version.

TUI içinde Shift+Tab (planlama modu), Alt+M (izin modları arasında geçiş — Ask, Auto ve Full access), @ ile dosyaya başvuru ve komut listesi için /help işinize yarar. Yarım kalan işi mcode --continue sürdürür, mcode init . ise projede ajan için kurallar içeren AGENTS.md dosyasını oluşturur.

Kullanıcı verileri — config.yaml, oturumlar, oturum açma durumu — programdan ayrı olarak ~/.minimax dizininde tutulur (adlandırılmış profil için ~/.minimax-<profile>); MINIMAX_DATA_DIR değişkeni farklı bir konum belirler.

JoinGonka anahtarı. gate.joingonka.ai/register adresinden kaydolun: adresinizi doğruladıktan sonra hesabınıza 3M ücretsiz token yüklenecek. jg- önekli anahtar panelde "API anahtarları" bölümünde oluşturulur; ajan için ayrı bir anahtar açmanızda fayda var — trafiği ayrı bir satırda görünür.

mcode çalışıyorsa kapatın ve şunu çalıştırın:

npx @joingonka/setup --tool minimax-code --model minimax

Kurulum anahtarı soracak, mevcut config.yaml dosyasının bir kopyasını saklayacak, içine yalnızca kendi bloğunu ekleyecek ve gateway'e canlı bir istekle bitirecek: anahtar, adres ve model ilk görevde değil, hemen doğrulanır. ~/.minimax/config.yaml içinde custom_provider dalında joingonka sağlayıcısı görünecek — mcode üçüncü taraf endpoint'leri tam da burada tutar:

custom_provider:
  joingonka:
    name: JoinGonka
    kind: custom
    enabled: true
    api: openai-completions
    options:
      apiKey: jg-your-key
      baseURL: https://gate.joingonka.ai/v1
      authMode: api-key
    models:
      MiniMaxAI/MiniMax-M2.7:
        name: MiniMax M2.7 (Gonka)
        limit:
          context: 200000
          output: 8192
      deepseek-ai/DeepSeek-V4-Flash-0731:
        name: DeepSeek V4 Flash (Gonka)
        reasoning: true
        limit:
          context: 380000
          output: 32768
      zai-org/GLM-5.3-Flash:
        name: GLM 5.3 Flash (Gonka)
        reasoning: true
        limit:
          context: 390000
          output: 8192
defaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

Bu blok hakkında bilinmesi gerekenler:

• API formatı açıkça belirtilmiş. api alanı olmadan mcode sağlayıcıyı Anthropic uyumlu sayar; kurulum openai-completions seçer — gateway'in kanonik yolu.
• Her modelin limitleri kendine ait. mcode tanımadığı bir modele 200 000 bağlam penceresi ve 16 384 token yanıt atfeder; ağdaki gerçek değerler farklıdır, bu yüzden üç kaydın hepsinde limit verilmiştir.
• Anahtar dosyada düz metin olarak durur ve dosyanın kendisi 600 iznini alır. mcode da anahtarları böyle saklar: --api-key-env bayrağı değişkeni okur ve yapılandırmaya referansı değil, değeri yazar.
• Varsayılan model. --model minimax bayrağı MiniMax M2.7'yi ayarlar. Bayrak olmadan kurulum kod ajanları için DeepSeek V4 Flash seçer — daha büyük penceresi ve daha yüksek yanıt tavanı vardır — ve --model glm GLM-5.3 Flash verir. Yapılandırmada başka bir sağlayıcının modeli zaten seçiliyse, --model olmadan tekrar çalıştırmak ona dokunmaz.
• Profiller. Adlandırılmış bir profil için kurulumu bir ortam değişkeniyle çalıştırın, örneğin MINIMAX_DATA_DIR=~/.minimax-work.

Kurulum sırasında mcode'u kapatma ricası bir formalite değil: Ajan kendi kayıtlarında config.yaml dosyasını baştan sona yeniden yazar ve arkasından yapılan bir değişikliği silebilir.

Aynı sonucu ajanın standart komutu da verir. Anahtar bir ortam değişkeni üzerinden aktarılır — argümanlarda ve kabuk geçmişinde işi yoktur:

# read the key without echo
read -s JOINGONKA_API_KEY
export JOINGONKA_API_KEY

mcode provider add --name JoinGonka \
  --base-url https://gate.joingonka.ai/v1 \
  --api-format openai-completions \
  --model MiniMaxAI/MiniMax-M2.7 \
  --api-key-env JOINGONKA_API_KEY \
  --context-limit 200000 --output-limit 8192 --use

--use bayrağı önce listelenen modellerin ilkini canlı bir istekle doğrular, ancak ondan sonra sağlayıcıyı kaydeder ve modeli varsayılan model yapar; başarısızlık durumunda hiçbir şey kaydedilmez. Başarılı bir çalıştırma Provider added and selected: JoinGonka satırıyla biter. mcode sağlayıcı anahtarını adın kendisinden türetir — joingonka —, böylece daha sonra çalıştırılan kurulum aynı kaydı günceller, ikincisini oluşturmaz.

--context-limit ve --output-limit bayrakları komutta listelenen tüm modeller için geçerlidir, ancak ağdaki modellerin limitleri farklıdır. Bu yüzden komutla bir model tanımlamak, geri kalanını dosyaya eklemek pratiktir. mcode'u kapatın ve bu parçayı ~/.minimax/config.yaml içindeki mevcut sağlayıcı bloğuyla birleştirin:

custom_provider:
  joingonka:
    models:
      MiniMaxAI/MiniMax-M2.7:
        limit: { context: 200000, output: 8192 }
      deepseek-ai/DeepSeek-V4-Flash-0731:
        limit: { context: 380000, output: 32768 }
      zai-org/GLM-5.3-Flash:
        limit: { context: 390000, output: 8192 }

Üçüncü yol etkileşimlidir: TUI içinde /model komutu + Add 3rd-party provider… maddesiyle model seçimini açar, /provider ise kayıtlı bağlantıları yönetir. Model ekranındaki adres Ctrl+E ile düzenlenir; başarısız bir doğrulama hiçbir şey kaydetmez, taslak düzenleme için kalır.

Hangi API formatını seçmeli. Gateway üçünü de kabul eder, yalnızca temel adres farklıdır:

Bizim çalıştırmamızda üç format da bağlantı doğrulamasını geçti.

Üç komut, bağlantının çalıştığını gösteriyor. İlki sağlayıcıları listeler — aktif olan yıldızla işaretlenir, anahtar maskelenir:

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

İkincisi canlı bir istek gönderir ve başarılı olursa Provider available: custom_provider:joingonka yanıtını verir; --model bayrağı belirli bir modeli test eder:

mcode provider test custom_provider:joingonka

Üçüncüsü en önemlisini test eder — dosyalarla çalışmayı. Dizine bariz bir hata içeren küçük bir dosya koyun ve hatayı bulmasını isteyin:

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

Ajan, okuma aracını kendisi çağırmalı ve özünde yanıt vermelidir. Bizim test çalıştırmamızda ağdaki üç model de bu şekilde çalıştı; tek bir çalıştırma için başka bir model --model custom_provider:joingonka/<model-id> biçimindeki bayrakla belirtilir. --output-format json bayrağıyla yanıtta giriş ve çıkış token sayısını içeren usage alanı görünür — bunu ağ geçidinin paneliyle karşılaştırmak kolaydır: "Kullanım" bölümünde saatlik ve günlük istekler, model ve anahtar bazında dağılım görünür.

Doğrulama başarısız olursa, mcode nedeni doğrudan mesajda belirtir:

Ağdaki tüm modellerin fiyatı aynıdır, bu yüzden seçim davranışla ilgilidir. Aşağıda limitler ve modellerin aynı görevde bizim mcode exec denememizde nasıl davrandığı yer alıyor (21 Eylül 2026'da doğrulanmıştır):

Pratik kural basittir. Kısa görevler ve hızlı düzeltmeler için MiniMax M2.7 tercih edin: ağ kapasitesinin şu anda en büyük kısmı buna ayrılmıştır. Görünür akıl yürütme engel oluyorsa — örneğin exec çıktısını bir betik işliyorsa — ya da büyük bir depoyu okuyup uzun bir düzeltme almanız gerekiyorsa DeepSeek V4 Flash'a geçin. Karmaşık mantıkta GLM-5.3 Flash daha iyi düşünür.

Geçiş yapmak dosyayı düzenlemeyi gerektirmez: TUI'de komut /model, tek bir oturum için mcode -m custom_provider:joingonka/<model-id>, tek bir çalıştırma için aynı değerle mcode exec --model. Kalıcı seçim defaultModel satırında saklanır. Ağın bileşimi zamanla değişir; limitlerle birlikte güncel liste her zaman GET https://gate.joingonka.ai/v1/models tarafından verilir.

Ajan araçları, tokenleri sohbetten farklı tüketir: mcode, her cümlenize bir sistem istemi ve tüm araçların açıklamalarını ekler, ardından modelle çok aşamalı bir diyalog yürütür. Testimizde "dosyayı oku ve hatayı bul" görevi yaklaşık 40 bin tokene mal oldu ve bunun neredeyse tamamı giriştir. Bu yüzden burada token fiyatı belirleyicidir.

JoinGonka Gateway üzerinden tokenlar girişte milyon başına $0.0069, çıkışta milyon başına $0.021'dir; fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı kaynaktan çekilir. Eylül 2026 fiyatlarıyla yaklaşık değerler: tek seferlik bir görev sentin yüzde birleri kadar, 3-7 milyon tokenlık bir günlük aktif çalışma ise birkaç sent tutar.

BYOK neleri kapsar? Kendi sağlayıcınız modele yönelik istekleri karşılar: kod okuma ve düzeltme, komutlar, alt ajanlar, oturumlar. Yerleşik arama, mcode-tools medya araçları ve yönetilen bağlayıcılar ise üreticinin kendi servisleridir; bunlara hesap girişi ve kredi gerekir. Kendi araçlarınız bunlardan bağımsız olarak, projenin .mcp.json dosyasındaki MCP sunucuları üzerinden bağlanır.

İzinler. TUI'de Ask, Auto ve Full access modları Alt+M ile veya /permission komutuyla değiştirilir; mcode exec'te bunun sorumlusu --permission bayrağıdır.

Telemetri. mcode'daki istatistik, metrik ve teşhis kanalları varsayılan olarak kapalıdır ve tek tek açılabilir; MCODE_DISABLE_TELEMETRY ve DO_NOT_TRACK değişkenleri bunların hepsini birden kapatır. Gateway tarafı ise prompt ve cevap içeriklerini saklamaz; istatistiklerde yalnızca tüketim toplamları görünür.

Görselle çalışmanız gerekiyorsa – arayüz ekran görüntüsü, mockup gibi – yanına görme yeteneği olan bir model içeren ikinci bir sağlayıcı ekleyin ve eklerken --support-image bayrağını kullanın: Gonka ağındaki modeller metin tabanlıdır ancak mcode içinde birden fazla sağlayıcı bulunabilir.

Ağın üç model ailesinin tamamı için laboratuvarların kendi ajanları mevcuttur: MiniMax Code'un yanında DeepSeek Harness ve GLM'in yaratıcıları olan Z.ai'den ZCode yer alır. Üçü de aynı anahtarla aynı gateway'e bağlanır.