Geliştirici Kaynakları

VS Code ve Cursor'da Claude Code

VS Code veya Cursor'a Claude Code uzantısını yükleyin ve paylaşılan ayarlarını RunAPI'ye bağlayın.

Genel Bakış

Resmi Claude Code uzantısı hem VS Code hem de Cursor’da çalışır. Her iki editör de aynı Claude Code kullanıcı ayarlarını kullandığından bu kılavuz, eşleşen uzantıyı kurar ve RunAPI’yi ~/.claude/settings.json dosyasında bir kez yapılandırır.

Başlamadan önce

VS Code veya Cursor’ın desteklenen bir sürümünü yükleyin. Mevcut VS Code minimum sürümü resmi uzantı kılavuzunda listelenmiştir.
Kimlik Doğrulama Kılavuzu bölümünde standart bir API anahtarı oluşturun. Çalışma alanı ayarlarına veya kaynak denetimine eklemeyin.
Model Kataloğu‘ndan Anthropic Messages’ı destekleyen bir model tanımlayıcısı kopyalayın.

Yükle

Resmi anthropic.claude-code uzantısını yükleyin:

VS Code: VS Code Marketplace listesini açın veya Uzantılar’da Claude Code araması yapın.
Cursor: cursor:extension/anthropic.claude-code adresini açın veya Uzantılar’da Claude Code araması yapın.

Uzantı, sohbet paneli için gereken çalışma zamanını içerir. Bağımsız CLI’yi yalnızca entegre terminalde claude komutunu da çalıştırmak istiyorsanız kurun.

RunAPI'yi yapılandırın

~/.claude/settings.json dosyasını açın ve paylaşılan kullanıcı düzeyi ortam ayarlarını ekleyin:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

VS Code veya Cursor ayarlarında Claude Code login ifadesini arayın ve bu özel uç nokta için Disable Login Prompt seçeneğini etkinleştirin. Kullanıcı ayarları CLI ile paylaşılır; VS Code uzantısı ayarları yalnızca uzantı davranışını denetler.

Gerçek anahtarı .claude/settings.json ve düzenleyici çalışma alanı ayarlarının dışında tutun; bu dosyalar işleme alınabilir.

Bir model seçin

YOUR_RUNAPI_MODEL_ID değerini Model Kataloğu‘ndaki tam bir tanımlayıcıyla değiştirin. Claude Code panelinde /model geçerli seçimi değiştirir; /status ise etkin modeli gösterir.

Doğrula

Uzantıyı veya ayarları değiştirdikten sonra düzenleyici penceresini yeniden yükleyin.
Claude Code Spark panelini açın.
/status komutunu çalıştırın ve kullanıcı ayarlarını ile modeli doğrulayın.
Describe this repository in one sentence. gönderin ve normal bir yanıt aldığınızı doğrulayın.

Sorun giderme

Uzantı yüklenmiyor: Düzenleyici sürümünün resmi gereksinimleri karşıladığını onaylayın.
Spark simgesi görünmüyor: Düzenleyici penceresini yeniden yükleyin, ardından düzenleyiciyi yeniden başlatın.
Oturum açma istemi hâlâ görünüyor: Claude Code uzantısı ayarlarında Oturum Açma İstemini Devre Dışı Bırak seçeneğini etkinleştirin.
Panel kabuk değişkenlerini devralmıyor: ~/.claude/settings.json dosyasını kullanın veya düzenleyiciyi yapılandırılmış terminalden başlatın. GUI uygulamaları genellikle terminal ortamı olmadan başlar.
CLI çalışıyor ancak panel çalışmıyor: Pencereyi yeniden yükleyin ve isteği daha ayrıntılı tanılamalarla yeniden oluşturmak için bağımsız CLI’yi kullanın.
Kimlik doğrulama veya model seçimi başarısız olur: Kimlik Doğrulama Kılavuzu üzerinden anahtarı doğrulayın ve tam tanımlayıcıyı Model Kataloğu sayfasından kopyalayın.

Sonraki adımlar

Protokol davranışı için LLM API Hızlı Başlangıç ve istek alanları için Anthropic Messages API Başvurusu kullanın. Düzenleyicinin içine RunAPI araçları eklemek için MCP Genel Bakışı ile devam edin.