Harici modelleri Codex'e bağlamak karmaşık bir süreçtir. Bu kılavuzda, macOS ve Windows üzerinde eksiksiz Codex API yapılandırmasını adım adım göstermek için pratik bir örnek olarak Kimi API kullanılmaktadır.
Codex nedir?
Codex, depo ve terminal işleri için OpenAI'nin kodlama agent'ıdır. Şunları yapabilir:
Kod yazma: Fonksiyonlar, testler, betikler ve odaklanmış özellikler oluşturur.
Yabancı kod tabanlarını anlama: Dosyalarda arama yapar, çağrıları izler ve bileşenleri açıklar.
Kod inceleme: Olası hataları, riskli varsayımları, eksik testleri ve güvenlik sorunlarını belirler.
Hata ayıklama ve sorun giderme: Hataları yeniden üretir, değişiklikler önerir ve kontroller çalıştırır.
Rutin işleri otomatikleştirme: Onayınızla dosyaları günceller ve belgelenmiş iş akışlarını yürütür.
Codex'i yükleyin ve oturum açın
Bölüm 1: Codex CLI'yi yükleyin
macOS'ta Terminal'i veya Windows'ta PowerShell'i açın.
İşletim sisteminize uygun komutu çalıştırın:
macOS:
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Kurulumun tamamlanmasını bekleyin, ardından Terminal veya PowerShell'i kapatıp yeniden açın.
Şunu çalıştırın:
codexChatGPT ile Oturum Aç seçeneğini belirleyin, tarayıcıda oturum açma işlemini tamamlayın ve Terminal veya PowerShell'e geri dönün.
Bölüm 2: Codex masaüstü uygulamasını yükleyin
Resmi Codex masaüstü uygulaması sayfasını ziyaret edin.
macOS veya Windows için ChatGPT masaüstü uygulamasını indirin.
Uygulamayı yükleyip açın, ardından ChatGPT hesabınızla oturum açın.
Bir görev oluşturun veya bir proje açın ve çalışma modu olarak Codex'i seçin.
Say hello in one sentence.yazın ve mesajı gönderin.
Yerleşik AI modelleri mi, harici LLM API'leri mi?
Codex'i yükledikten sonra yerleşik AI modellerini kullanabilir veya uyumlu bir harici LLM API'sine bağlanabilirsiniz. En uygun seçenek, ne kadar kurulum, esneklik ve hesap yönetimi istediğinize bağlıdır.
Codex'in yerleşik modellerini kullanma
Yerleşik modeller en basit deneyimi sunar. Başka bir hizmet çalıştırmadan veya ayrı bir API anahtarı yapılandırmadan mevcut bir modeli seçip kodlamaya başlayabilirsiniz.
Avantajlar:
Ek yapılandırma adımı gerektirmeyen hızlı kurulum.
Codex araçları ve özellikleriyle doğrudan entegrasyon
Yönetilmesi gereken daha az servis ve kimlik bilgisi
Sınırlamalar:
Yalnızca hesabınıza tanımlı modeller arasından seçim yapabilirsiniz
Başka bir sağlayıcıya ait bir modeli kullanmak istediğinizde daha az esneklik
GPT aboneliği gerektirir ve kullanım maliyeti nispeten yüksektir.
Harici bir LLM API kullanın
Harici bir API, size daha fazla model seçeneği sunar ve başka bir sağlayıcıdaki mevcut hesabınızı kullanmanıza olanak tanır. Ancak bazı modeller, Codex tarafından kullanılabilmeleri için ek yapılandırma veya yerel bir uyumluluk aracı gerektirir.
Avantajlar:
Diğer sağlayıcılara ait modellere erişim
Farklı kodlama görevleri için daha fazla esneklik
Harici API hesabı ve kullanımı üzerinde ayrı kontrol
GPT aboneliği gerekmez. Maliyete duyarlı senaryolar için idealdir.
Sınırlamalar:
API anahtarı ve ek yapılandırma gerektirir
Çalışır durumda tutulması gereken yerel bir router gerekebilir
Faturalandırma, uyumluluk, gizlilik ve sorun giderme harici sağlayıcıya bağlıdır
En hızlı kurulumu istiyorsanız yerleşik bir modelle başlayın. Zaten harici bir API hesabınız varsa veya daha fazla model seçeneği istiyorsanız aşağıdaki adımlarla devam edin. Bu bölümde, harici bir modeli Codex'e bağlamanın pratik bir örneği olarak Kimi API kullanılmaktadır.
Harici Bir LLM API'sini Codex'e Bağlama: Kimi Örneği
macOS kurulumu
1. Adım: Terminal A'yı açın ve Node.js ile npm'i doğrulayın
Nerede: Command+Space tuşlarına basın, Terminal yazın ve Enter tuşuna basın. Bu ilk pencereyi Terminal A olarak kabul edin.
Çalıştırın:
node --version
npm --versionBeklenen sonuç: Her komut bir sürüm numarası yazdırır. Node.js için v22.x.x ve npm için 10.x.x gibi çıktılar sadece birer örnektir, minimum gereksinim değildir.
Bir komut bulunamıyorsa: Bir tarayıcı açın, https://nodejs.org/en/download adresine gidin, LTS macOS .pkg dosyasını indirin, Finder'da İndirilenler klasörünü açın, pakete çift tıklayın ve yükleyicideki varsayılan ayarları kabul edin. Command+Q ile Terminal'i kapatın, Terminal A'yı yeniden açın ve her iki sürüm komutunu tekrar çalıştırın. Her iki komut da bir sürüm döndürmeden devam etmeyin.
2. Adım: Bir Kimi API anahtarı oluşturun
Kimi API platformunu açın. Konsoldan bir API anahtarı oluşturun ve ardından bunu bir şifre yöneticisinde veya gizli bilgi yöneticisinde saklayın. Konsolunuz tam anahtarı sadece bir kez gösteriyorsa, sayfadan çıkmadan önce kopyalayın.
3. Adım: Terminal A'da MOONSHOT_API_KEY değerini ayarlayın
Nerede: Terminal A'ya geri dönün.
Çalıştırın:
export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"Sadece YOUR_KIMI_API_KEY kısmını gerçek Kimi anahtarınızla değiştirin. Tırnak işaretlerini ve MOONSHOT_API_KEY değişken adını olduğu gibi bırakın.
Beklenen sonuç: export komutu herhangi bir çıktı yazdırmaz. Değeri görüntülemeden var olup olmadığını doğrulayın:
test -n "$MOONSHOT_API_KEY" && echo "Kimi key is set"Terminal Kimi key is set yazdırmalıdır.
4. Adım: Kimi'yi doğrudan Terminal A'dan test edin
Nerede: MOONSHOT_API_KEY değerinin ayarlı olduğu Terminal A'yı kullanmaya devam edin.
Çalıştırın:
curl --silent --show-error https://api.moonshot.ai/v1/chat/completions \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k2.7-code","messages":[{"role":"user","content":"Say hello in one sentence."}],"stream":false}'Beklenen sonuç: choices[0].message.content altında oluşturulan metni içeren bir JSON yanıtı görüntülenir.
Adım 5: Terminal B'yi açın ve yönlendiriciyi Terminal A'da başlatın
Nerede: Terminal A etkinken ikinci bir pencere açmak için Command+N tuşlarına basın. Yeni pencereyi Terminal B olarak adlandırın. Yönlendirici komutunu çalıştırmadan önce Terminal A'ya dönün.
Terminal A'da çalıştırın:
npx @codeproxy/cli --base-url https://api.moonshot.ai/v1 --model kimi-k2.7-code --apikey "$MOONSHOT_API_KEY"Temel URL'yi veya modeli değiştirmeyin. $MOONSHOT_API_KEY bir değişken referansı olarak kalmalı, anahtarın ikinci kez yapıştırılmış bir kopyası olmamalıdır.
Olası ilk çalıştırma istemi: npx, Need to install ... Ok to proceed? (y) mesajını gösterebilir. Önce paket adını ve bağlantılı üçüncü taraf kaynağını inceleyin. Bu paketi kabul ediyorsanız y yazıp Enter tuşuna basın. Burada test edildiği iddia edilen kesin bir paket sürümü yoktur.
Beklenen sonuç: İşlem çalışmaya devam eder ve 127.0.0.1:8787 üzerinde dinlediğini bildirir. Terminal A'yı açık bırakın.
Başarısız olursa: npm paketi indiremiyorsa internet erişimini doğrulayın ve node --version ile npm --version komutlarını yeniden çalıştırın. 8787 portu zaten kullanımdaysa, o portu kullanan diğer yerel işlemi durdurun ya da o işlemin terminaline dönüp Ctrl+C tuşlarına basın, ardından yönlendirici komutunu yeniden çalıştırın.
Adım 6: Terminal B'den localhost'u test edin
Nerede: Terminal B'ye tıklayın.
Çalıştırın:
curl --no-buffer --show-error http://127.0.0.1:8787/v1/responses \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k2.7-code","input":"Say hello in one sentence.","stream":true}'Beklenen sonuç: Terminal B, Responses benzeri akış olaylarını veya tek cümlelik bir selamlama içeren çıktıyı yazdırır. Tam olay sırası yönlendirici sürümüne göre değişebilir.
Connection refused görürseniz: Terminal A'ya bakın. Yönlendirici durduysa Adım 5 komutunu yeniden çalıştırın ve açık tutun. Terminal A üst akıştan gelen bir 401 gösteriyorsa, orada MOONSHOT_API_KEY'i sıfırlayın ve yönlendiriciyi yeniden başlatın.
Adım 7: macOS Codex yapılandırmasını oluşturun ve düzenleyin
Nerede: Terminal B'yi kullanmaya devam edin.
Çalıştırın:
mkdir -p "$HOME/.codex"
if [ -f "$HOME/.codex/config.toml" ]; then cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.backup-$(date +%Y%m%d-%H%M%S)"; fi
touch "$HOME/.codex/config.toml"
open -e "$HOME/.codex/config.toml"Bu komutlar, gerekirse kullanıcı düzeyinde yapılandırma dosyasını oluşturur, mevcut bir dosyayı yedekler ve ~/.codex/config.toml dosyasını TextEdit'te açar.
Dosya boşsa
Aşağıdaki eksiksiz yapılandırmayı yapıştırın:
model = "kimi-k2.7-code"
model_provider = "kimi-proxy"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Dosya zaten ayarlar içeriyorsa
Eksiksiz yapılandırmayı mevcut dosyanın üzerine yapıştırmayın. İlgisiz ayarları koruyun ve gerekli satırları tek tek güncelleyin.
model =ile başlayan satırı bulun ve satırın tamamını şununla değiştirin:
model = "kimi-k2.7-code"model_provider =ile başlayan satırı bulun ve satırın tamamını şununla değiştirin:
model_provider = "kimi-proxy"model_context_window =ile başlayan satırı bulun ve satırın tamamını şununla değiştirin:
model_context_window = 256000model_supports_reasoning_summaries =ile başlayan satırı bulun ve satırın tamamını şununla değiştirin:
model_supports_reasoning_summaries = falseBu dört ayardan herhangi biri zaten yoksa, eksik satırı dosyanın başına yakın bir yere ekleyin.
Şununla başlayan tüm satırı bulun ve silin:
model_catalog_json =Ayrıca şununla başlayan tüm satırı bulun ve silin:
service_tier =Aşağıdaki bölümü ekleyin:
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000[model_providers.openai] gibi diğer sağlayıcı bölümlerini kaldırmayın.
notify, onay, sandbox, proje ve arayüz tercihleri dahil olmak üzere ilgisiz mevcut ayarları koruyun. Başka bir kullanıcının notify satırını kopyalamayın çünkü bu satır bilgisayara özgü mutlak bir yol içerebilir.
Dosyayı kaydetmek için Command+S tuşlarına basın, ardından TextEdit'i kapatın.
Adım 8: Codex'i yeniden başlatın ve eksiksiz macOS testini çalıştırın
Nerede: Yönlendiriciyi Terminal A'da çalışır durumda tutun. Terminal B'de, Ctrl+C ile mevcut Codex oturumunu kapatın, ardından tek kullanımlık bir klasör hazırlayın.
Terminal B'de çalıştırın:
mkdir -p "$HOME/codex-kimi-test"
cd "$HOME/codex-kimi-test"
codexTest: hello. yazıp Enter tuşuna basın. Tek cümlelik bir yanıt, temel bir istek yolunun çalıştığını doğrular.
Windows kurulumu
İki bağımsız PowerShell penceresi kullanın. PowerShell A, geçerli oturum Kimi anahtarını saklar ve yönlendiriciyi çalıştırır. PowerShell B, localhost'u test eder, yapılandırmayı düzenler ve Codex'i başlatır. Kalıcı Kullanıcı değişkeni gelecekteki pencereleri destekler; geçerli oturum ataması ise anahtarı PowerShell A'da hemen kullanılabilir hale getirir.
Adım 1: PowerShell A'yı açın ve Node.js ile npm'i doğrulayın
Nerede: Windows tuşuna basın, PowerShell yazın ve Windows PowerShell'i açın. Bu pencereyi PowerShell A olarak adlandıracağız.
Çalıştırın:
node --version
npm --versionBeklenen sonuç: Her iki komut da sürüm numarası yazdırır. v22.x.x ve 10.x.x gibi değerler sadece örnektir, minimum gereksinim değildir.
Bir komut tanınmıyorsa: Bir tarayıcı açıp https://nodejs.org/en/download adresine gidin. LTS Windows .msi dosyasını indirin, Dosya Gezgini'nde İndirilenler'i açın, yükleyiciye çift tıklayın, varsayılan seçenekleri kabul edin ve yükleyicinin Node.js'i PATH'e ekleme seçeneğini işaretli tuttuğundan emin olun. Tüm PowerShell pencerelerini kapatın, PowerShell A'yı yeniden açın ve her iki komutu yeniden çalıştırın.
Adım 2: Bir Kimi API anahtarı oluşturun
Kimi API platformunu açın. Konsoldan bir API anahtarı oluşturun, ardından bunu bir parola yöneticisinde veya gizli bilgi yöneticisinde saklayın. Konsolunuz tam anahtarı yalnızca bir kez gösteriyorsa, sayfadan ayrılmadan önce kopyalayın.
Adım 3: PowerShell A'da kalıcı ve mevcut oturum değişkenlerini ayarlayın
Nerede: PowerShell A'ya dönün.
Çalıştırın:
[Environment]::SetEnvironmentVariable("MOONSHOT_API_KEY", "YOUR_KIMI_API_KEY", "User")
$env:MOONSHOT_API_KEY = "YOUR_KIMI_API_KEY"Her iki satırda da yalnızca YOUR_KIMI_API_KEY kısmını aynı Kimi anahtarıyla değiştirin. MOONSHOT_API_KEY, User, tırnak işaretlerini ve noktalama işaretlerini değiştirmeden bırakın. İlk satır değeri gelecekteki işlemler için saklar. İkinci satır değeri PowerShell A'da hemen kullanılabilir hale getirir.
Beklenen sonuç: Her iki komut da çıktı döndürmez. Anahtarı yazdırmadan varlığını doğrulayın:
$null -ne $env:MOONSHOT_API_KEYPowerShell True yazdırmalıdır.
False yazdırıyorsa: Mevcut oturum atamasını düz tırnak işaretleriyle yeniden çalıştırın. Kullanıcı yazma işlemi bir politika tarafından engellenmişse, bu kılavuz için mevcut oturum değeriyle devam edin ve kullanıcı ortam değişkenlerinin nasıl saklanması gerektiğini yöneticinize sorun. Günlüklerde veya paylaşılan metinlerde açığa çıkan tüm anahtarları iptal edin.
Adım 4: Kimi'yi doğrudan PowerShell A'dan test edin
API referansları POST URL gösterebilir, ancak POST https://... ifadesini tek başına PowerShell'e yazmayın. Burada gösterildiği gibi Invoke-RestMethod -Method Post kullanın.
Nerede: $env:MOONSHOT_API_KEY değişkeninin ayarlı olduğu PowerShell A'da kalın.
Çalıştırın:
$headers = @{ Authorization = "Bearer $env:MOONSHOT_API_KEY" }
$body = @{ model = "kimi-k2.7-code"; messages = @(@{ role = "user"; content = "Say hello in one sentence." }); stream = $false } | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Method Post -Uri "https://api.moonshot.ai/v1/chat/completions" -Headers $headers -ContentType "application/json" -Body $body
$response.choices[0].message.contentUç noktayı, modeli veya değişken adını değiştirmeyin. PowerShell anahtarı $env:MOONSHOT_API_KEY üzerinden okur.
Beklenen sonuç: Son satır, choices[0].message.content içinden tek cümlelik bir selamlama yazdırır.
401 alırsanız: Anahtarın küresel .ai konsolundan geldiğini doğrulayın, gerekirse iptal edip yeniden oluşturun, Adım 3'teki her iki atamayı yeniden çalıştırın ve yeniden deneyin. Model reddedilirse, kimliğin tam olarak kimi-k2.7-code olduğunu doğrulayın ve Kimi konsolunda model erişimini kontrol edin.
Adım 5: PowerShell B'yi açın ve yönlendiriciyi PowerShell A'da başlatın
Nerede: Windows tuşuna tekrar basın, PowerShell yazın ve ikinci bir Windows PowerShell penceresi açın. Bunu PowerShell B olarak adlandırın. Yönlendirici komutu için PowerShell A'ya geri dönün.
PowerShell A'da çalıştırın:
npx @codeproxy/cli --base-url https://api.moonshot.ai/v1 --model kimi-k2.7-code --apikey $env:MOONSHOT_API_KEY$env:MOONSHOT_API_KEY değişkenini değiştirmeden bırakın; anahtarı doğrudan komuta yapıştırmayın.
Olası ilk çalıştırma istemi: npx, Need to install ... Ok to proceed? (y) uyarısını gösterebilir. Paketi ve üçüncü taraf kaynağı inceleyin. Kabul ediyorsanız y yazıp Enter tuşuna basın. Test edilmiş kesin bir paket sürümü belirtilmemiştir.
Beklenen sonuç: İşlem açık kalır ve 127.0.0.1:8787 üzerinde dinlediğini bildirir. PowerShell A'yı açık tutun.
Başarısız olursa: PowerShell A'da node --version ve npm --version komutlarını çalıştırın. Herhangi biri başarısız olursa, Adım 1'i tekrarlayın. 8787 portu kullanımdaysa, diğer yönlendiriciyi kendi penceresinde Ctrl+C ile durdurun, ardından komutu yeniden çalıştırın.
Adım 6: PowerShell B'den localhost'u test edin
Nerede: PowerShell B'ye tıklayın. PowerShell A'daki yönlendiriciyi durdurmayın.
Çalıştırın:
$localBody = @{ model = "kimi-k2.7-code"; input = "Say hello in one sentence."; stream = $false } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:8787/v1/responses" -ContentType "application/json" -Body $localBodyLocalhost URL'sini değiştirmeyin. Bu, PowerShell A'daki yönlendiriciye işaret eder.
Beklenen sonuç: PowerShell, Responses benzeri bir nesne veya selamlamayı içeren bir çıktı döndürür. Tam alanlar yönlendirici sürümüne göre değişebilir.
Bağlantı reddedilirse: PowerShell A'ya bakın ve yönlendirici kapanmışsa Adım 5'teki komutu yeniden başlatın. PowerShell A bir üst akış kimlik doğrulama hatası gösteriyorsa, Ctrl+C tuşlarına basın, $env:MOONSHOT_API_KEY değişkenini yeniden ayarlayın ve yönlendiriciyi yeniden başlatın. Varsayılan @codeproxy/cli hızlı başlangıcı için yerel bir yetkilendirme başlığı eklemeyin.
Adım 7: Windows Codex yapılandırmasını oluşturun ve düzenleyin
Nerede: PowerShell B'yi kullanmaya devam edin. Sağlayıcı yapılandırması bir proje klasörünün içinde değil, $HOME\.codex\config.toml konumunda bulunmalıdır.
Çalıştırın:
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
$configPath = "$HOME\.codex\config.toml"
if (Test-Path $configPath) { Copy-Item $configPath "$configPath.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')" }
if (-not (Test-Path $configPath)) { New-Item -ItemType File -Path $configPath | Out-Null }
notepad "$HOME\.codex\config.toml"Bu komutlar kullanıcı dizinini oluşturur, mevcut bir yapılandırmayı yedekler, dosya yoksa oluşturur ve Notepad'de açar.
Notepad'de: Dosya zaten çakışan yinelenmiş model veya sağlayıcı anahtarları içeriyorsa bunları kaldırarak bu tam varsayılan yapılandırmayı yapıştırın:
model_provider = "kimi-proxy"
model = "kimi-k2.7-code"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000kimi-proxy, localhost URL'sini veya responses değerini değiştirmeyin. Ctrl+S tuşlarına basın ve Not Defteri'ni kapatın.
Dosya adını doğrulayın: Şunu çalıştırın:
Get-Item "$HOME\.codex\config.toml" | Select-Object FullName, Name, LengthBeklenen sonuç: Name, config.toml.txt değil tam olarak config.toml olmalı ve Length sıfırdan büyük olmalıdır.
Not Defteri .txt eklediyse: Not Defteri'nde Dosya → Farklı Kaydet'i seçin, Kayıt türü'nü Tüm Dosyalar olarak ayarlayın, config.toml yazın ve $HOME\.codex içine kaydedin. Get-Item komutunu yeniden çalıştırın. Codex sağlayıcıyı yok sayıyorsa kullanıcı düzeyindeki yolu düzenlediğinizi doğrulayın ve yinelenen TOML anahtarlarını kaldırın.
Adım 8: Codex'i yeniden başlatın ve tam Windows testini çalıştırın
Nerede: PowerShell A ve yönlendiricisini çalışır durumda bırakın. Açık olan tüm Codex uygulamalarını veya oturumlarını tamamen kapatın. PowerShell B'yi kapatın, Windows tuşuna basıp PowerShell yazarak yeniden açın → Windows PowerShell'i açın ve tek kullanımlık bir klasör oluşturun.
Yeniden açılan PowerShell B'de çalıştırın:
New-Item -ItemType Directory -Force -Path "$HOME\codex-kimi-test" | Out-Null
Set-Location "$HOME\codex-kimi-test"
codexTest: hello. yazın ve Enter tuşuna basın. Tek cümlelik bir yanıt, temel istek yolunu doğrular.
Kimi'yi Codex masaüstü uygulamasında kullanma
Devam etmeden önce, yerel yönlendirici ve config.toml için macOS veya Windows kurulumunun 1–7. adımlarını tamamlayın. Önce CLI testini tamamlamanız gerekmez ancak masaüstü uygulamasında Kimi'yi kullanırken yönlendiricinin çalışır durumda kalması gerekir.
Adım 1: Yerel yönlendiriciyi çalışır durumda tutun
@codeproxy/cli'nin şu adreste çalıştığı Terminal A veya PowerShell A'yı açık tutun:
http://127.0.0.1:8787Adım 2: Sağlayıcı yapılandırmasını doğrulayın
Kullanıcı düzeyindeki Codex yapılandırma dosyasını açın.
macOS'ta şunu çalıştırın:
open -e "$HOME/.codex/config.toml"Windows'ta şunu çalıştırın:
notepad "$HOME\.codex\config.toml"Dosyanın şu üst düzey ayarları içerdiğini doğrulayın:
model = "kimi-k2.7-code"
model_provider = "kimi-proxy"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Adım 3: Masaüstü uygulamasını tamamen yeniden başlatın
macOS'ta masaüstü uygulamasını tamamen kapatmak için Command+Q tuşlarına basın. Yalnızca pencereyi kapatmak yeterli değildir.
Windows'ta tüm masaüstü uygulaması pencerelerini kapatın ve uygulamanın sistem tepsisinde artık çalışmadığını doğrulayın.
Masaüstü uygulamasını yeniden açın ve bir proje klasörü açın.
Adım 4: Custom modelini seçili tutun
Masaüstü model seçicisi Kimi K2.7 Code yerine Custom gösterebilir. Bu beklenen bir durumdur.
config.toml içinde tanımlanan özel sağlayıcılar masaüstü model listesinde her zaman adıyla görüntülenmez. Kimi sağlayıcısını kullanmak istediğinizde GPT-5.6 Sol gibi bir OpenAI modelini seçmeyin. Custom seçili kalsın.
Ayrıca şu uyarıyı da görebilirsiniz:
Model metadata for `kimi-k2.7-code` not found.
Defaulting to fallback metadata.Bu bir uyarıdır, bağlantı hatası değildir. Aşağıdaki ayarlar, normal kullanım için gereken önemli model bilgilerini zaten sağlamaktadır:
model_context_window = 256000
model_supports_reasoning_summaries = falseAdım 5: Masaüstü istek yolunu doğrulayın
Masaüstü uygulamasında şu istemi gönderin:
Masaüstü uygulaması yanıt verirken Terminal A veya PowerShell A'yı izleyin. Terminal A penceresi yeni bir istek alıyor ve masaüstü uygulaması bir yanıt döndürüyorsa, masaüstü uygulaması yerel Kimi yolunu kullanıyor demektir.
Yaygın entegrasyon hatalarını giderme
zsh: command not found: POST
POST URL bir komut değil, API belgeleme gösterimidir. macOS'ta eksiksiz curl örneğini kopyalayın. Windows'ta eksiksiz Invoke-RestMethod -Method Post örneğini kopyalayın.
8787 portunda bağlantı reddedildi
Terminal A veya PowerShell A'ya geri dönün. Çalışan bir yönlendirici işlemi yoksa mevcut oturumun Kimi değişkenini ayarlayın ve belgelenen npx @codeproxy/cli ... komutunu yeniden çalıştırın. O pencereyi açık tutun, ardından localhost testini B penceresinde tekrarlayın.
401 yanıtı
Hangi adımda hata oluştuğunu belirlemek için yönlendirici penceresini okuyun. Üst akıştaki bir Kimi 401 hatası genellikle MOONSHOT_API_KEY'in geçersiz, iptal edilmiş veya yanlış bölgesel hesaba ait olduğu anlamına gelir. Anahtarı global .ai konsolunda iptal edin, yeni bir tane oluşturun, mevcut oturum değişkenini sıfırlayın ve yönlendiriciyi yeniden başlatın. Varsayılan yönlendirici yolunda gelen bearer denetimi yoktur. Başka bir bağdaştırıcıyla yerel bir 401 hatası, isteğe bağlı CODEX_KIMI_PROXY_KEY'inin eksik veya geçersiz olduğu anlamına gelebilir.
Desteklenmeyen parametre veya araç hataları
Yönlendirici, Kimi'nin kabul etmediği bir alanı iletiyor olabilir. Örnekleme alanları ayarlanmamış kalmalıdır; eğer gönderiliyorlarsa kabul edilen sabit değerleri kullanmalıdırlar. tool_choice'ın auto veya none olduğunu ve bağdaştırıcının reasoning_content'i koruduğunu doğrulayın. Çok adımlı test hâlâ başarısız oluyorsa o yönlendirici sürümünü kullanmayı bırakın ve açık Kimi desteği olan bir sürüm seçin veya güncelleyin.
Codex sağlayıcıyı yok sayıyor
Kullanıcı dosyasını doğrudan açın: macOS'ta open -e "$HOME/.codex/config.toml", Windows'ta ise notepad "$HOME\.codex\config.toml" komutunu çalıştırın. Tek bir üst düzey model_provider = "kimi-proxy" satırı, bir sağlayıcı tablosu, localhost temel URL'si ve wire_api = "responses" olduğunu doğrulayın. Kaydedin, Codex'ten tamamen çıkın ve yeniden başlatın. Sağlayıcı seçimini yalnızca proje düzeyindeki .codex/config.toml dosyasına koymayın.
npx router'ı başlatamıyor
Router penceresi A'da node --version ve npm --version komutlarını çalıştırın. Bu komutlardan biri başarısız olursa nodejs.org/download adresinden Node.js LTS paketini kurun, terminali kapatıp yeniden açın ve tekrar deneyin. npx paketi indirmek için izin isterse, y girmeden önce paketi ve kaynağını inceleyin.
Kimi API kullanmanın avantajları
Kimi'nin Cursor API iş akışlarında kullanılması, kodlama, hata ayıklama ve geliştirme görevlerini iyileştirebilir. Gelişmiş yetenekleri, doğru yanıtlar üretmeye, karmaşık talimatları işlemeye ve daha hızlı problem çözmeye yardımcı olur. Üretkenliği ve verimliliği artırmak için Kimi'yi Cursor iş akışlarında kullanmanın temel avantajları şunlardır.
Uzun bağlamlı kod anlama
Kimi, büyük miktarda kodu ve bilgiyi aynı anda işleyebilir. Farklı dosyalar ve proje bölümleri arasındaki ilişkileri daha etkili şekilde tanır. Bunun sonucunda, büyük veya karmaşık kod tabanlarıyla çalışmak çok daha kolay hale gelir.
Daha iyi dokümantasyon ve depo analizi
Proje belgeleri, teknik notlar ve depolar Kimi ile hızlıca incelenebilir. Önemli detaylar, her dosyayı tek tek elle taramaya gerek kalmadan daha kolay bulunur. Geliştiriciler, projenin tümü hakkında daha kısa sürede daha net bir anlayış kazanabilir.
Uygun maliyetli AI geliştirme
Kimi, birçok geliştirme görevini yönetmek için pratik ve bütçe dostu bir seçenek sunar. Tamamen yüksek maliyetli modellere bağlı kalmadan güçlü AI desteğinden yararlanılabilir. Ekipler, giderleri daha iyi kontrol altında tutarken genel üretkenliği artırabilir.
Daha hızlı bilgi erişimi
Büyük kod tabanları, veri kümeleri ve proje dosyaları arasında kullanışlı bilgiler hızlıca bulunabilir. Yanıt veya referans aramak için kaynakları tarama süresi azalır. Kodlama, test etme ve projeyi geliştirme işlerine daha fazla dikkat ayrılabilir.
Gelişmiş iş akışı otomasyonu
Tekrarlayan geliştirme görevlerinin yönetimi ve tamamlanması Kimi ile daha kolay hale gelir. Kod üretimi, içerik incelemesi ve rutin proje faaliyetlerinde yardımcı olabilir. Günlük iş akışları zamanla daha düzenli, verimli ve üretken kalır.
Codex geliştirme iş akışını nasıl iyileştirir
Yapılandırılmış bir Codex CLI API iş akışı, depo incelemesini, düzenlemeyi, komutları ve incelemeyi tek bir bağlamda birleştirir. Codex; dosyaları oluşturabilir, tanıdık olmayan modülleri açıklayabilir, hataları yeniden üretebilir, testler önerebilir ve onaylanmış kontrolleri çalıştırabilir. Harici sağlayıcı desteği model seçimi ekler ancak inceleme sorumluluğunu ortadan kaldırmaz.
Her görevi dar kapsamlı bir hedefle başlatın. Codex'ten düzenleme yapmadan önce inceleme yapmasını isteyin, önerdiği değişiklikleri gözden geçirin, yalnızca anladığınız komutları onaylayın, deponun testlerini çalıştırın ve son diff'i inceleyin. Üretilen kodu, inceleme ve doğrulamadan geçene kadar güvenilmeyen bir katkı olarak değerlendirin.
Sonuç
Güvenilir Codex API kullanımı, her katmanı sırayla test etmekten gelir: Codex'i kimlik doğrulayın, Kimi'yi doğrudan çağırın, localhost'u başlatıp test edin, kullanıcı düzeyindeki sağlayıcı yapılandırmasını kaydedin, salt okunur bir prompt çalıştırın ve dosya ile araç içeren bir görevi tamamlayın. Gerçek Kimi anahtarını router ile birlikte tutun, gizli bilgileri paylaşılan dosyaların dışında tutun ve işiniz bittiğinde router'ı durdurun.