Kimi K2.5 + Claude Code: Claude Code içinde Kimi K2.5 kullanımı (Eksiksiz Kurulum)

Amaç: claude (Claude Code CLI) akışını (repo tarama, dosya düzenleme, komut çalıştırma) aynen sürdürmek, ancak Kimi K2.5'i kullanabilmek için arka ucu Moonshot'un Anthropic Messages API ile uyumlu uç noktasına yönlendirmek.

10 saniyede mantığı

Claude Code, Anthropic'in Messages API'siyle konuşur. Özel bir Anthropic uyumlu uç nokta kullanacak şekilde yapılandırılabilir (env değişkenleri veya ~/.claude/settings.json ile).
Moonshot (Kimi), şu adreste Anthropic'in Messages API'siyle birebir aynı olan bir uç nokta sunar:

https://api.moonshot.cn/anthropic/v1/messages (Çin)
(Global için aynı kalıp: https://api.moonshot.ai/anthropic/v1/messages)

İşte bu yüzden Claude Code, kodda hiçbir değişiklik yapmadan Kimi modellerini çalıştırabilir.

Neye ihtiyacınız var

Claude Code CLI kurulu olmalı (claude komutunu çalıştırabiliyorsunuz).
Bir Moonshot / Kimi API anahtarı (Moonshot Open Platform'dan).
Temel alan adınızı seçin:
- Global: https://api.moonshot.ai
- Çin: https://api.moonshot.cn

Claude Code, /anthropic altındaki Anthropic uyumlu yolu kullanacaktır.

Seçenek A: ortam değişkenleriyle yapılandırma

claude'u başlatmadan önce bunu kabuğunuza (macOS / Linux) yapıştırın:

# 1) Claude Code → Moonshot Anthropic uyumlu taban
# Moonshot Messages API uyumlu yolu /anthropic/v1/messages şeklindedir
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"

# 2) Kimlik doğrulama
export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"

# 3) Model
export ANTHROPIC_MODEL="kimi-k2.5"
export ANTHROPIC_SMALL_FAST_MODEL="kimi-k2.5"

# 4) İsteğe bağlı: daha az gereksiz istek + uzun çalışmalarda daha az sorun
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export API_TIMEOUT_MS=600000

# Claude Code'u başlat
claude

Çin alan adını kullanıyorsanız taban URL'yi şununla değiştirin:

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"

Seçenek B: `~/.claude/settings.json` içinde kalıcı hale getirme

Claude Code, ~/.claude/settings.json konumunda bir env nesnesi içeren kullanıcı düzeyinde bir yapılandırma dosyasını destekler. Değişkenleri her seferinde dışa aktarmak istemiyorsanız bunu kullanın.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000"
  }
}

Terminalinizi yeniden başlatın ve çalıştırın:

claude

Hızlı doğrulama

Claude Code'un içinde şunu sorun:

"Hangi model id'sini çalıştırıyorsun?"
"Hangi taban URL'ye bağlısın (moonshot.ai mı yoksa moonshot.cn mi)?"

Yanıt verir ve düzenlemeler/komutlar boyunca çalışmaya devam ederse yönlendirmeniz doğrudur.

Sorun giderme

1) Claude Code hâlâ Anthropic'e giriş yapmanızı istiyor

Büyük ihtimalle Claude Code env değişkenlerinizi almadı.

Önce Seçenek A ile test edin (mevcut kabukta dışa aktarın).
Ardından ~/.claude/settings.json üzerinden kalıcı hale getirin.
Terminali yeniden başlatın.

2) 401 / geçersiz token

Anahtarın bir Moonshot Open Platform API anahtarı olduğundan emin olun.
ANTHROPIC_AUTH_TOKEN kullanın.
Taban URL /anthropic ile bitmelidir (/v1 değil ve yalnızca CLI'ye özgü herhangi bir URL de değil).

3) Zaman aşımları / uzun araç çalışmaları yarıda kalıyor

API_TIMEOUT_MS değerini artırın (örneğin, 600000 → 900000).
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 ayarını koruyun.
Devasa dizinlerden (node_modules/ veya derleme çıktıları gibi) kaçının. Gereksiz yolların taranmasını önlemek için Claude Code'un deny/izin kurallarını kullanın.

Anthropic uyumlu yol neden önemli

Moonshot her ikisini de sunar:

.../v1/chat/completions (OpenAI uyumlu)
.../anthropic/v1/messages (Anthropic uyumlu, Claude Code ile eşleşir)

Claude Code, Messages API'siyle yerel olarak konuştuğu için /anthropic/v1/messages yolu en temiz entegrasyondur.

Kimi K2.5 + Claude Code: Claude Code içinde Kimi K2.5 kullanımı (Eksiksiz Kurulum)

İçindekiler