Kimi Code CLI: Moonshot Kodlama Ajanı Kurulum ve Çalıştırma Rehberi

Moonshot AI, Kimi K2.7 Kod modeli ile birlikte Kimi Kodu'nu piyasaya sürdü: deponuzu okuyan, dosyaları yazıp düzenleyen, kabuk komutları çalıştıran ve paralel çalışma için alt aracıları başlatan, terminal yerel bir kodlama ajanı. Eğer Claude Code veya Codex kullanıyorsanız, bu yapı size tanıdık gelecektir. Fark, altındaki motor ve fiyattır. Kimi Kodu açık ağırlıklı bir model üzerinde çalışır ve belirteç başına ücretlendirme yerine sabit bir abonelikle faturalandırılır.

Bu rehber sizi sıfırdan bir makineden ilk ajan görevinize ulaştıracak, ardından gerçekten kullanacağınız komutları ve yapılandırmayı anlatacaktır.

Kimi Kodu Nedir?

Kimi Kodu, Moonshot'ın K2.7 Kod modelinin güçlü yönlerini kullanmak üzere inşa edilmiş kendi ajan çerçevesidir: dönüşler arasında korunan düşünme, aralıklı akıl yürütme ve çok adımlı araç çağrıları. Kutudan çıktığı gibi şunları yapabilir:

• Birden fazla dosyada kod yazma, hata ayıklama ve yeniden düzenleme
• Büyük kod tabanlarını keşfetme ve açıklama
• Kabuk komutlarını çalıştırma ve dosyaları işleme
• Belgeler ve güncel bilgiler için web'de arama yapma
• Görevleri paralel olarak çalıştırmak için alt aracıları başlatma

Terminalinizde, bir uzantı aracılığıyla VS Code'da ve ACP protokolü aracılığıyla JetBrains veya Zed'de çalışır. Arkasındaki model açık ağırlıklıdır, bu nedenle aynı zeka gerektiğinde kendi kendine barındırılabilir; model ayrıntıları için Kimi K2.7 Kod açıklayıcımıza bakın.

Kimi Kodu'nu Yükle

Yükleyici önce uv (bir Python paket yöneticisi) çeker, ardından CLI'yi onun aracılığıyla kurar. Tek bir satır her şeyi yapar.

macOS ve Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows (PowerShell):

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Tamamlandığında, herhangi bir proje dizininden ajanı başlatın:

kimi

İlk çalıştırma sizi mevcut klasörünüzde etkileşimli bir oturuma sokar. Kimi Kodu bu dizini proje kökü olarak kabul eder, bu nedenle başlatmadan önce üzerinde çalışmak istediğiniz depoya cd ile gidin.

Giriş Yap

Oturum içinden tek bir komutla kimlik doğrulaması yapın:

/login

Bu, Kimi hesabınızla bir OAuth akışı başlatır ve CLI'yi Kimi Kod platformuna bağlar. Örneğin, üçüncü taraf bir aracı çalıştırmak için bir API anahtarı kullanmak isterseniz, Kimi Kod konsolunda bir tane oluşturun. Her hesap en fazla 5 anahtara izin verir.

Kota hakkında kısa bir not: Kimi Kodu abonelik planları üzerinden çalışır ve limitler aylık değil 7 günlük bir döngüde yenilenir. Oran limitleri, planınıza bağlı olarak 5 saatte yaklaşık 300 ila 1200 istek ve aynı anda 30 isteğe kadar çıkar. Durumunuzu görmek için oturum ortasında /usage komutunu kontrol edin.

İlk Göreviniz

Ajan giriş yaptıktan sonra, istediğiniz şeyi basit bir dille açıklayın. İyi bir ilk çalıştırma, projeyi öğrenmesini sağlamaktır:

/init

/init, kod tabanını analiz eder ve yapıyı, kuralları ve temel giriş noktalarını içeren bir AGENTS.md dosyası yazar. Ajan, gelecekteki çalıştırmalarda bu dosyayı okur, böylece her oturuma her seferinde deponuzu yeniden keşfetmek yerine bağlam ile başlar. Eğer kodlama ajanları için DESIGN.md kullandıysanız, bu aynı fikrin otomatik olarak uygulanmasıdır.

Bundan sonra, ona gerçek işi verin:

POST /users uç noktasına giriş doğrulama ekle ve boş e-posta durumu için bir test yaz.

Kimi Kodu değişikliği planlar, dosyaları düzenler, testi çalıştırır ve rapor verir. Varsayılan olarak yıkıcı eylemlerden önce sorar. Eğer bir görevde ona güveniyorsanız ve sormayı bırakmasını istiyorsanız, otomatik onayı açıp kapatın:

/yolo

Bunu dikkatli kullanın. Yeni başlayan projeler için harika, ancak önemsediğiniz bir depoda risklidir.

Bilmeye Değer Eğik Çizgi Komutları

Bir oturumu eğik çizgi komutlarıyla yönetirsiniz. Bunlar her gün başvuracağınız komutlardır.

/compact hafife alınan bir komuttur. Uzun ajan çalıştırmaları bağlam penceresini araç çıktısıyla doldurur; sıkıştırma geçmişi özetleyerek baştan başlamadan veya pencereyi aşmadan devam etmenizi sağlar.

Mevcut Düzenleyicinize veya Ajanınıza Bağlayın

K2.7 Kod modelini kullanmak için mevcut kurulumunuzu terk etmek zorunda değilsiniz.

VS Code. Pazardan "Kimi Code" uzantısını yükleyin ve aynı hesapla giriş yapın.

JetBrains ve Zed. CLI'nin ACP protokolü aracılığıyla bağlanın, böylece ajan zaten kullandığınız düzenleyici içinde çalışır.

Claude Code, Cline ve RooCode. Model, OpenAI ile uyumlu bir API aracılığıyla sunulur. Aracın temel URL'sini https://api.moonshot.ai/v1 olarak işaretleyin, modeli kimi-k2.7-code olarak ayarlayın ve bir API anahtarı bırakın. Akış, Claude Code ve Cursor içinde Kimi çalıştırmak için belgelediğimizle aynıdır; yalnızca model kimliği değişir.

MCP ve Alt Ajanlarla Özelleştirin

İki özellik, Kimi Kodu'nu yalnızca çalıştırmak yerine yapılandırmaya değer kılar.

Model Bağlam Protokolü (MCP). Kimi Kodu bir MCP istemcisidir, bu nedenle harici araç sunucularını bağlayabilirsiniz: bir veritabanı okuyucusu, bir tarayıcı, dahili bir API, sorun izleyiciniz. Ajan daha sonra bu araçları bir görevin parçası olarak çağırır. Eğer bir MCP sunucusu inşa ediyor veya test ediyorsanız, MCP sunucu test kılavuzumuz, bir ajana teslim etmeden önce araç sözleşmesini nasıl doğrulayacağınızı kapsar.

Alt Ajanlar. Temiz bir şekilde bölünebilen işler için, Kimi Kodu paralel olarak çalışan ve ana oturuma geri rapor veren alt ajanlar başlatabilir. "Kullanımdan kaldırılmış çağrıyı her hizmette tara" veya "bu altı modül için aynı anda taslak testler hazırla" gibi düşünebilirsiniz. Özel ajanları, Claude Code alt ajanlarına benzer şekilde yapılandırmada tanımlarsınız.

İnşa Etmeden Önce Arkasındaki API'yi Test Edin

Eğer kimi-for-coding'i kendi aracınıza API aracılığıyla bağlıyorsanız, tam olarak ne döndürdüğünü bilmek için önce ham uç noktayı test edin. Apidog size bunun için görsel bir çalışma alanı sunar.

1. https://api.moonshot.ai/v1/chat/completions adresine bir POST isteği oluşturun.
2. Kimi platform konsolundan bir anahtar kullanarak Authorization: Bearer <anahtarınız> başlığı ekleyin.
3. "model": "kimi-k2.7-code" ve messages ile OpenAI tarzı bir gövde gönderin.
4. Biçimlendirilmiş yanıtı ve belirteç kullanımını okuyun, ardından çağrıyı yeniden kullanılabilir bir test olarak kaydedin.

Buradan durum kodları hakkında iddialarda bulunabilir, ajanın bağımlı olduğu araç çağrı yapısını doğrulayabilir ve Moonshot modeli her güncellediğinde kontrolleri yeniden çalıştırabilirsiniz. Kurmak için Apidog'u indirin.

Kimi Kodu'na Geçmeye Değer mi?

Dürüst cevap, neyi optimize ettiğinize bağlıdır. K2.7 Kod modeli, çoğu kodlama kıyaslamasında GPT-5.5 ve Claude Opus'un birkaç puan gerisindedir, bu nedenle mümkün olan en yüksek tek atış kalitesini istiyorsanız, kapalı sınır hala kazanır. Ancak Kimi Kodu, yetenekli bir ajanı açık ağırlıklı bir model ve sabit fiyatlandırma ile eşleştirir, bu da tüm gün uzun ajan oturumları çalıştıran herkes için denklemi değiştirir. Ajan ortamının nerede olduğuna dair yan yana bir karşılaştırma için, Claude Code ile OpenAI Codex karşılaştırmamıza bakın.

Düşük riskli hareket: kurun, bir yan projede /init komutunu çalıştırın ve ona gerçek bir görev verin. Bir öğleden sonra içinde mevcut ajanınızın yanında bir yer kazanıp kazanmayacağını anlayacaksınız.

Sıkça Sorulan Sorular

Kimi Kodu'nu nasıl kurarım? Tek satırlık yükleyiciyi çalıştırın (macOS/Linux'ta curl ... | bash, Windows'ta irm ... | iex), ardından kimi ile başlatın.

Nasıl giriş yaparım? OAuth için oturum içinde /login komutunu çalıştırın veya üçüncü taraf araçlar için Kimi Kod konsolunda bir API anahtarı oluşturun.

Hangi modeli kullanır? Kimi K2.7 Kod. Kimi Kod aboneliğinde model kimliği kimi-for-coding; belirteç başına ödeme yapılan Moonshot API'sinde ise kimi-k2.7-code'dur.

VS Code'da çalışıyor mu? Evet, "Kimi Code" uzantısı aracılığıyla. JetBrains ve Zed, ACP protokolü üzerinden bağlanır.

Claude Code veya Cline ile kullanabilir miyim? Evet. API, OpenAI ile uyumludur, bu nedenle aracın temel URL'sini Kimi uç noktasına işaretleyin ve model kimliğini ayarlayın.

Maliyeti ne kadar? Belirteç başına faturalandırma değil, her 7 günde bir yenilenen kotaya sahip abonelik planları üzerinden çalışır. Kalan kotanızı görmek için /usage komutunu kontrol edin.

MCP'yi destekliyor mu? Evet. Kimi Kodu bir MCP istemcisidir ve özel alt ajanları destekler.

Özet

Kimi Kodu, Moonshot'ın açık ağırlıklı K2.7 Kod modeli üzerine inşa edilmiş, terminal ve IDE kodlama ajanıdır. Tek bir komutla kurun, /login ile giriş yapın, deponuzu öğretmek için /init komutunu çalıştırın ve ona görevler vermeye başlayın. MCP konuşur, alt ajanlar başlatır ve VS Code, JetBrains, Zed ve Claude Code gibi OpenAI uyumlu araçlara bağlanır. Kağıt üzerinde en yüksek puan alan ajan olmasa da, açık bir modelde sabit oranlı fiyatlandırma, yoğun günlük kullanım için onu ciddi bir seçenek haline getirir. API'yi önce Apidog'da test edin, ardından ajanı gerçek bir göreve koyun ve kendi kodunuz üzerinde değerlendirin.