Kimi Code CLI: Gonka üzerinden kendi anahtarınızla Moonshot AI ajanı

Adım 1: Kimi Code'u kurun. Belgelerdeki resmi yöntemler:

# macOS and Linux: prebuilt binary, no Node.js needed
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows (PowerShell); Git for Windows is required before the first run
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# npm (Node.js 22.19 or newer)
npm install -g @moonshot-ai/kimi-code

Betik, ikili dosyayı ~/.kimi-code/bin/kimi konumuna yerleştirir ve bu dizini kabuk ayar dosyası üzerinden PATH'e ekler. Derlemeleri yalnızca glibc içindir: Alpine ve musl kullanan diğer sistemlerde durur ve npm'i önerir. Terminali yeniden açıp doğrulayın: kimi --version.

Adım 2: anahtar alın. gate.joingonka.ai/register adresinden kaydolun, adresinizi doğrulayın ve "API anahtarları" bölümünde jg- önekli bir anahtar oluşturun.

Adım 3: yükleyiciyi çalıştırın.

npx @joingonka/setup --tool kimi-code

Yükleyici anahtarı sorar (komut satırı argümanı olarak aktarılmaz) ve ~/.kimi-code/config.toml dosyasına yalnızca kendi tablolarını ekler:

• türü openai olan — yani Chat Completions protokolü — ağ geçidi adresi ve api_key alanındaki anahtarla [providers.joingonka] sağlayıcısı; dosya 600 izinlerine sahip olur;
• ağdaki her model için [models."joingonka/…"] tablosu — gerçek bağlam penceresi ve yanıt üst sınırı ile açık yeteneklerle: araç çağrısı hepsinde, akıl yürütme DeepSeek V4 Flash ve GLM-5.3 Flash'ta, MiniMax M2.7'de yalnızca araçlar;
• default_model — varsayılan model henüz seçilmemişse veya ağdan çıkmış bir ağ geçidi modelini gösteriyorsa DeepSeek V4 Flash; --model bayrağı olmadan başka bir sağlayıcının seçimine dokunmaz, bunun yerine tek seferlik çalıştırma için komut önerir;
• önceki dosyanın bir kopyasını saklar, diğer sağlayıcılara ve ağ geçidi tablolarınızdaki alanlarınıza dokunmaz ve sonunda ağ geçidine canlı bir istek göndererek anahtarın, adresin ve modelin kabul edilip edilmediğini bildirir.

Bizim çalıştırmamızdaki çıktı şöyle görünüyordu (kısaltılmış):

Configured provider "joingonka" in ~/.kimi-code/config.toml
Base URL: https://gate.joingonka.ai/v1 (provider type "openai" — Chat Completions)
Models: joingonka/MiniMaxAI/MiniMax-M2.7, joingonka/deepseek-ai/DeepSeek-V4-Flash-0731, joingonka/zai-org/GLM-5.3-Flash
Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
…
✓ Verified: the gateway accepted the key, base URL and model.

Başka bir varsayılan modeli --model bayrağı belirler (glm, minimax veya tam kimlik); soru sormayan mod anahtarı ortam değişkeninden alır:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool kimi-code --model glm --non-interactive

KIMI_CODE_HOME değişkeniyle taşınan veri dizinini yükleyici kendisi hesaba katar. ~/.kimi ise eski Python istemcisi kimi-cli'ın dizinidir: Kimi Code 2.x onu okumaz ve ilk çalıştırmada oradan ayarları taşımayı önerir (aynısını kimi migrate yapar).

Kurulum aracının yaptığı her şey elle de yazılabilir. Kimi Code ayarlarını TOML içinde saklar; nokta veya eğik çizgi içeren tablo anahtarları tırnak içine alınır. Gonka ağı için eksiksiz bölüm:

default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[providers.joingonka]
type = "openai"
base_url = "https://gate.joingonka.ai/v1"
api_key = "jg-your-key"

[models."joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"]
provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"
max_context_size = 380000
max_output_size = 32768
capabilities = ["thinking", "tool_use"]
display_name = "DeepSeek V4 Flash (Gonka)"

[models."joingonka/zai-org/GLM-5.3-Flash"]
provider = "joingonka"
model = "zai-org/GLM-5.3-Flash"
max_context_size = 390000
max_output_size = 8192
capabilities = ["thinking", "tool_use"]
display_name = "GLM 5.3 Flash (Gonka)"

# MiniMax M2.7, unlike DeepSeek and GLM, is declared without thinking
[models."joingonka/MiniMaxAI/MiniMax-M2.7"]
provider = "joingonka"
model = "MiniMaxAI/MiniMax-M2.7"
max_context_size = 200000
max_output_size = 8192
capabilities = ["tool_use"]
display_name = "MiniMax M2.7 (Gonka)"

Anahtar nerede tutulur. Kimi Code anahtarları kabuk ortamından almaz: export OPENAI_API_KEY=… burada işe yaramaz. İki yöntem var ve ikisi aynı anda kullanılamaz:

Aynı tabloda her iki alanı da Kimi Code başlatmada reddeder: has both apiKey and apiKeyEnv set in config.toml - they are mutually exclusive. Şunu unutmayın: kimi doctor böyle bir çakışmayı yakalamaz — yalnızca dosyanın biçimini kontrol eder.

Hangi sağlayıcı tipini seçmeli. Kimi Code birkaç protokolü destekler, ağ geçidi de öyle:

Kimi Code'da bir sağlayıcı tek bir protokol konuşur, dolayısıyla ikinci protokol başka bir ad altında ikinci bir sağlayıcıdır. Sağlayıcıları ajan içinde /provider komutuyla etkileşimli olarak ekleyip kaldırabilirsiniz.

Kimi Code'da bir model bir takma addır, [models."…"] tablosunun adıdır. Kurulum programı bunları joingonka/<model-id> şemasına göre adlandırır — tıpkı Kimi Code'un kendi modellerini adlandırdığı gibi (kimi-code/k3) — ve modelin seçildiği her yerde ihtiyaç duyulan şey tam da bu takma addır. Ön ek içermeyen bir tanımlayıcıyı, örneğin MiniMaxAI/MiniMax-M2.7, Kimi Code bulamaz.

Bizim denememizde /model şöyle görünüyordu:

Select a model  (type to search)
Tab toggle provider · ↑↓ navigate · Enter select · Alt+S session-only · Esc cancel

 All   joingonka

   MiniMax M2.7 (Gonka)       joingonka
 ❯ DeepSeek V4 Flash (Gonka)  joingonka ← current
   GLM 5.3 Flash (Gonka)      joingonka

 Thinking  (←→ to switch)
  [ On ]    Off

Thinking anahtarı. Listenin altındaki akıl yürütme anahtarı, ağın modellerinde kendi başına hiçbir şeyi değiştirmez: Kimi Code akıl yürütme seviyesini yalnızca seviyeleri tanımlanmış modellere gönderir. GLM-5.3 Flash için bunu yapmaya değer — bu modelde akıl yürütme low değeriyle kapatılır (ayrıntılar için model incelemesine bakın). Model tablosuna üç alan ekleyin:

[models."joingonka/zai-org/GLM-5.3-Flash"]
# … fields written by the installer …
support_efforts = ["low", "high"]
default_effort = "high"
off_effort = "low"

Gateway'e ne gittiğini kontrol ettik: Thinking açıkken Kimi Code reasoning_effort: "high" gönderiyor ve model akıl yürütüyor; kapalıyken "low" gönderiyor ve yanıt akıl yürütme bloğu olmadan geliyor. Kurulum programını yeniden çalıştırmak bu alanlara dokunmaz: yalnızca kendi anahtarlarını düzenler.

Alt ajanlar için model. Yerleşik alt ajanlar (coder, explore, plan) varsayılan olarak ana ajanın modeli üzerinde çalışır. [secondary_model] bölümü onlara, ana ajanın ipuçlarına bakarak kendisinin seçtiği bir havuz verir. Havuz için herhangi bir takma ad uygundur — DeepSeek V4 Flash, GLM-5.3 Flash veya MiniMax M2.7:

[secondary_model]
default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[secondary_model.models]
"joingonka/deepseek-ai/DeepSeek-V4-Flash-0731" = "Long context and long output: big reads and edits."
"joingonka/zai-org/GLM-5.3-Flash" = "Reasoning model for tricky logic and debugging."

Havuzun anahtarları [models] içindeki takma adlarla birebir eşleşmelidir: belgelere göre ölü bir referans oturum oluşturmayı engeller. MiniMax M2.7 satırı da aynı şekilde eklenir; ağdan çıkmış modellere yapılan referansları kurulum programı yeniden çalıştırıldığında kendisi temizler.

Hangi modeli seçmeli. Ağdaki tüm modellerin fiyatı aynı, dolayısıyla seçim davranışla ilgili. Kimi Code 2.0.2'de "dosyayı oku ve hatayı bul" görevinde şöyle davrandılar (23 Eylül 2026'da doğrulandı):

Önce Kimi Code'un sağlayıcıyı gördüğünden ve dosyanın hatasız ayrıştırıldığından emin olun:

$ kimi provider list
joingonka  type=openai  models=3  source=inline

Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

$ kimi doctor
OK config.toml  ~/.kimi-code/config.toml

kimi provider list --json çıktısını hiçbir yerde yayımlamayın: anahtar içinde açık metin olarak duruyor.

Ardından tek seferlik bir çalıştırma yapın. Dizine, aslında çıkarma yapan bir toplama fonksiyonu içeren calc.py koyun ve hatayı bulmasını isteyin:

kimi -p "Read calc.py and tell me in one sentence whether it has a bug."

-p modunda yanıt stdout'a, akıl yürütme ve araç akışı ise stderr'e gider; böylece çıktıyı bir betikle rahatça ayrıştırabilirsiniz. GLM-5.3 Flash şöyle yanıt verdi:

• Yes: the `add` function in calc.py:2 returns `a - b` instead of `a + b`, so `add(2, 3)` prints `-1`.

Dikkat: -p modunda Kimi Code hiçbir şey sormaz ve komutları kendisi çalıştırır — bizim çalıştırmamızda model, tahminini doğrulamak için sormadan python3 başlatmayı denedi. Yeni bir dizinde arayüzün ilk başlatılması Trust this folder? sorusuyla başlar — bu soru projenin MCP sunucularıyla ilgilidir — ve karşılama ekranında model görünür: Model: DeepSeek V4 Flash (Gonka). Kontrolün ikinci yarısı gateway panelidir: „Kullanım" bölümünde istek, modellere ve anahtarlara göre dökümüyle görünür.

Bir şeyler ters gittiyse, teşhis genellikle doğrudan mesajdan okunur:

Kimi Code, her cümlenize bir sistem istemi (system prompt) ve iki düzineden fazla yerleşik aracın açıklamalarını ekler; bir görev genellikle birkaç adım sürer. Bizim denememizde her adım yaklaşık 20 bin giriş tokenı içeriyordu ve "dosyayı oku, hata bul" görevi iki adım sürdü; yaklaşık 40 bin token, neredeyse hepsi giriştedir. Bu nedenle token başına fiyat burada belirleyicidir.

JoinGonka Gateway üzerinden tokenlar girişte milyon başına $0.0069 ve çıkışta milyon başına $0.021'dir; fiyat ağdaki tüm modeller için aynıdır ve bu sayfadaki canlı kaynaktan çekilir.

Sağ sütundaki tahminler Eylül 2026 fiyatlarına göredir. Kıyaslama için, Kimi Code'da modeller için nasıl ödeme yapabilirsiniz:

Tam tüketim ve bakiye, paneldeki "Kullanım" ve "Faturalandırma" bölümlerindedir. Konuşma uzunluğunu Kimi Code'un kendisi takip eder: durum satırı bağlamın ne kadarının dolu olduğunu gösterir ve /compact komutu geçmişi manuel olarak sıkıştırır.

İzin modları. Kimi Code arayüzü varsayılan olarak Always Ask modunda çalışır: okuma işlemi hemen yapılır, değişiklikler ve komutlar onayınızdan sonra gerçekleşir. Ask When Needed (/yolo veya --yolo bayrağı) rutin değişiklikleri ve komutları atlar, ancak hassas dosyalar ve tehlikeli komutlar hakkında soru sorar; Never Ask (/auto, --auto) hiçbir şey sormaz. Planlama modu Shift-Tab ile açılır. Tek seferlik kimi -p çalışması her zaman sorusuz ilerler, bu yüzden onu bir konteynerde veya ayrı bir çalışma kopyasında çalıştırın.

Moonshot hesabı olmadan neler çalışır. Kendi sağlayıcınız modelin yaptığı her şeyi yönetir: kod okuma ve düzenleme, komutlar, alt temsilciler, oturumlar, MCP sunucuları. Web araması ise Moonshot servisidir: hesaba giriş yapmadan aracın setinde WebSearch aracı bulunmaz, ancak adrese göre sayfa yükleme (FetchURL) kalır. Ağ modelleri metin tabanlıdır, bu nedenle resim ve video girişi bunlarda çalışmaz.

Telemetri ve güncellemeler. Anonim telemetri varsayılan olarak açıktır: config.toml içindeki telemetry = false satırı veya KIMI_DISABLE_TELEMETRY=1 değişkeni ile kapatılır. Güncellemeler otomatik kurulur (~/.kimi-code/tui.toml içinde [upgrade] auto_install = true); öngörülebilirlik gerekiyorsa, bunu kapatın ve kimi upgrade komutuyla güncelleyin. Gateway, istem ve yanıtların içeriğini saklamaz; istatistiklerde sadece tüketim toplamları kalır.

Birden fazla ortam. Kimi Code'da proje düzeyinde sağlayıcı ayarları yoktur. Çalışma ve kişisel anahtarları KIMI_CODE_HOME değişkeni ile ayırabilirsiniz: bununla ayarlar, oturumlar ve günlükler başka bir dizine taşınır ve aynı değişkenle başlatılan yükleyici de oraya yazar.

Editör içinde. Kimi Code, Zed, JetBrains ve diğer ACP istemcileri içinde kimi acp komutuyla — aynı veri dizini ve aynı sağlayıcılarla — çalışır.

Ağ modellerinin sunulduğu laboratuvarlar da kendi ajanlarını çıkarırlar: MiniMax'in terminal tabanlı MiniMax Code'u, DeepSeek'in DeepSeek Harness'ı, GLM'in yazarları Z.ai'nin ise ZCode'u vardır. Hepsi aynı Gateway'e aynı anahtarla bağlanır.