TR ▾

Claude Code için OpenAI Alternatifi: Kodlama Aracı Kurulumu

Claude Code, Anthropic'in kendi API'si ile iletişim kurar, bu nedenle OpenAI tarzı bir uç noktaya basitçe yönlendirilemez. Bunun yerine şunlar çalışır: özel bir OpenAI base URL'si kabul eden kodlama agentleri ve bunların bu API'ye nasıl bağlanacağı.

Güncellendi

Bir kodlama aracının özel bir uç nokta kullandığını gösteren, bir API sunucu küpüne parlayan bir kablo ile bağlantılı terminal penceresi

Temel noktalar

  • Claude Code, Anthropic'in API formatı etrafında tasarlanmıştır; bu hizmet ise OpenAI sohbet tamamlamaları formatını kullanır.
  • Aider, Continue, Cline ve Cursor tarzı araçlar, özel bir OpenAI uyumlu base URL ve bir model adı kabul eder.
  • Base URL https://api.minimaxapikey.com/v1, model ID uncensored ve bir Bearer anahtarı kullanın.
  • Önce curl ile test edin, ardından eşzamanlı istek sayısını 8 istek veya altında tutun; çünkü agentler aynı anda çok sayıda çağrı yapar.

Kısa cevap

Eğer bir claude code için openai alternatifi aradıysanız, ilk olarak neyi değiştirmek istediğinize karar vermelisiniz. Claude Code, Anthropic'in terminal kodlama aracıdır. Anthropic'in kendi API'si ile iletişim kurmak üzere tasarlanmıştır; bu API, OpenAI formatından farklı bir istek formatı kullanır. Bu hizmet OpenAI sohbet tamamlamaları formatını uyguladığından, iki sistem yalnızca bir URL değiştirerek birbirine bağlanmaz.

İşe yarayan şey, herhangi bir OpenAI uyumlu uç nokta kabul eden geniş kodlama agentleri ve editör eklentileri ailesidir. Onlara bir base URL, bir anahtar ve bir model adı verirsiniz ve bu araçlar sıradan POST /v1/chat/completions istekleri gönderir. Aider, Continue ve Cline bu gruba girer; birkaç editör OpenAI modelleri için bir base URL geçersiz kılma seçeneği sunar. Bu API için bu üç değer base URL https://api.minimaxapikey.com/v1, model ID uncensored ve anahtarınızın Bearer token olarak kullanılmasıdır.

Beklentilerinizi gerçekçi tutun. Uç noktanın arkasındaki model, bağımsız bir sağlayıcı tarafından yürütülen ve yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmış bir açık ağırlıklı modeldir. Bu bir Claude değildir ve herhangi bir model satıcısının resmi bir API'si değildir. Bu modelin depounuz için uygun olup olmadığını, kendi görevlerinizde kendiniz keşfedeceksiniz; bu makale bu testi nasıl düşük maliyetle çalıştıracağınızı gösterir.

Claude Code'da URL'yi neden basitçe değiştiremezsiniz

Bir API formatı bir adresten daha fazlasıdır. Anthropic'in API'sinin kendi mesaj yapısı, sistem istemlerini ifade etme biçimi, kendi araç kullanımı blokları ve kendi akış olayları vardır. OpenAI tarzı bir sunucu messages (rolleri içeren), tools (fonksiyon tanımlarının dizisi) ve choices[0].delta taşıyan sunucu tarafından gönderilen olaylar bekler. Bir format için oluşturulmuş bir istemci, diğer format için bir sunucuya karşı çalışmaz veya yanlış davranır; URL erişilebilir olsa bile.

Bazı insanlar bu iki format arasında bir çeviri katmanı, istekleri ve yanıtları yeniden yazan küçük bir proxy yerleştirir. Bu çalışabilir ancak bu, çalıştırmanız ve hata ayıklamanız gereken ayrı bir yazılımdır. Araç çağrıları ve akış etrafındaki davranışlar genellikle bu katmanların bozulduğu yerdir. Claude Code'un üçüncü taraf uç noktalar için resmi bir ayar sunup sunmadığı, Anthropic'in güncel dokümantasyonunda kontrol edilmesi gereken bir konudur; çünkü bu seçenekler değişir.

Daha basit yol, zaten OpenAI formatını destekleyen bir agent seçmektir. Temel döngü açısından hiçbir şey kaybetmezsiniz: agent dosyalarınızı okur, bir istem oluşturur, modelden bir düzenleme ister ve uygular. Değiştirdiğiniz kısım modeldir ve bu kısmın yalnızca uyumlu bir uç noktaya ihtiyacı vardır.

Herhangi bir araca dokunmadan önce uç noktayı curl ile test edin

Her entegrasyon sorunu, ham API'nin çalıştığını zaten biliyorsanız teşhis etmesi daha kolaydır. API anahtarı sayfası üzerinde bir anahtar oluşturun, dışa aktarın ve bir istek çalıştırın. Bu başarılı olursa, sonraki herhangi bir hata anahtarın veya ağın değil, araç ayarlarının bir parçasıdır.

export UNCENSORED_KEY="paste-your-key-here"

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that parses an ISO date string."}
    ]
  }'

Ayrıca GET /v1/models ile modelleri de listeleyebilirsiniz. Araçların çoğu, bir sağlayıcı kaydettiğinizde anahtarın geçerliliğini onaylamak için bu uç noktayı çağırır; bu nedenle herhangi bir şeyi yapılandırmadan önce bu uç noktanın yanıt verdiğini görmek önemlidir. dokümantasyon sayfası tam istek referansını içerir.

Her aracın base URL'yi nereye girdiği

Ayarların adları farklı olsa da, fikir her yerde aynıdır. Tablo yaygın kodlama araçlarını ve doldurmanız gereken alanı listeler. Menüler sürümler arasında değişebilir, bu nedenle bunu bir harita olarak ele alın ve mevcut düzen için her aracın kendi dokümantasyonunu kontrol edin.

AraçUç nokta için giriş yeriKullanılacak model adı
AiderOpenAI base URL'si ve anahtarı için ortam değişkenleri veya komut satırı bayraklarıopenai/uncensored
DevamSağlayıcı openai ve bir apiBase içeren yapılandırma dosyasında bir model girişiuncensored
ClineSağlayıcı listesi, OpenAI uyumlu seçeneği seçinuncensored
İmleçModeller ayarları, base URL geçersiz kılma içeren OpenAI API anahtarı bölümüÖzel model olarak uncensored
Kendi betiğinizHerhangi bir OpenAI SDK'sının base_url bağımsız değişkeniuncensored

Bu hizmet tam olarak bir model sunduğu için yapılandırılacak bir model seçici yoktur. Bir aracın bir model adı istediği her yerde uncensored yazın. Araç bilinmeyen adları reddediyorsa ve bilinen modellerin bir listesini ısrarla istiyorsa, "özel model" veya "model ekle" seçeneğini arayın.

Aider örneği

Aider terminalinizde çalışır, bir git deposundaki dosyaları düzenler ve sonucu taahhüt eder; bu da onu ruh olarak Claude Code'a en yakın yapan şeydir. Arka planda LiteLLM kullandığı için model adı bir sağlayıcı öneki taşır. OpenAI uyumlu bir sunucu için bu önek openai/ şeklindedir.

pip install aider-chat

export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"

cd your-repo
aider --model openai/uncensored

Başladığında, tek bir dosyada küçük bir değişiklik isteyin ve farkı izleyin. Çok dosyalı bir görevi ona vermeden önce, saniyeler içinde doğrulayabileceğiniz bir şeyle başlayın; örneğin bir docstring eklemek veya bir fonksiyonu yeniden adlandırmak. Aider, her adımda depo haritasını ve sohbete eklediğiniz dosyaları gönderir, bu nedenle istem hızla büyür. 100.000 tokenlık pencere (istem ve tamamlama dahil) cömerttir, ancak büyük bir depoda yalnızca önemli dosyaları eklemeniz gerekir.

Aider, model için bağlam boyutunu veya fiyatı bilmediğine dair uyarı verirse, bu beklenen bir durumdur: özel bir model adı için bir girişi yoktur. Bu uyarı çalışmasını engellemez.

Continue örneği

Continue, VS Code ve JetBrains içinde sohbet, düzenleme ve otomatik tamamlama özellikleri ekleyen bir editör uzantısıdır. Yapılandırması modelleri listeler; her birinin bir sağlayıcısı ve isteğe bağlı geçersiz kılmaları vardır. Bu API için bir model girişi aşağıdaki gibi görünür. Tam dosya adı ve şema, kurulu olan Continue sürümüne bağlıdır, bu nedenle mevcut dokümantasyonla karşılaştırın.

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.minimaxapikey.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Sohbet ve düzenleme istekleri bu tür bir uç nokta ile iyi çalışır. Sekme otomatik tamamlama farklı bir iş yüküdür: neredeyse her yazma duraklamasında tetiklenir ve çok düşük gecikme süresi ister; bu, küçük bir yerel model tarafından daha iyi karşılanır. Satır içi tamamlamalar için barındırılan bir sohbet modeli kullanmak, dakikada 300 limitinize karşı istekleri tüketir ve karşılığında çok az şey alırsınız.

Kendi minimal agentinizi oluşturun

Mevcut hiçbir araç uymuyorsa, araç çağırma desteği küçük bir agent yazmayı kolaylaştırır. API tools ve tool_choice kabul eder, tool_calls akışını geri gönderir ve sonuçları role: "tool" ile mesajlar olarak alır. Aşağıdaki döngü, bir dosya okuyan bir fonksiyona model verir, ardından model düz metinle yanıt verene kadar devam eder.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Return the text of a file in the current project.",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "Summarise what main.py does."}]

while True:
    resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = resp.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"], encoding="utf-8") as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

Bir yazma fonksiyonu ve çalışmadan önce bir onay istemi ekleyin, yaklaşık elli satırda bir kodlama agentinin çekirdeğine sahip olursunuz. Okuma veya yazma yapmadan önce her zaman yolları doğrulayın: model beğendiği herhangi bir yolu isteyebilir.

Planlamanız gereken limitler ve maliyetler

Agentler, sohbet eden bir insandan farklı davranır. İstekleri toplu olarak gönderirler, genellikle birden fazla isteği eşzamanlı olarak. Tam anahtar 8 eşzamanlı istek ve dakikada 300 istek izni verir. Deneme anahtarı 2 eşzamanlı ve dakikada 60 izni verir; bu bir agent için sıkı olabilir. Bir limiti aştığınızda API HTTP 429 yanıtı verir ve hata kodu rate_limited veya concurrency olur. Geçici aşırı yük altında 429 ile Retry-After: 5 de döndürür. Çoğu iyi istemci 429'da yeniden dener, ancak sizin istemciniz yapmıyorsa eşzamanlılık ayarını düşürün. Akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar; bu nedenle uzun akışlı düzenlemeler 8 limitine sayılır.

Maliyet konusunda, faturalandırma ön ödemeli krediden pay-as-you-go esasına göredir: 1M input token başına $0.15 ve 1M output token başına $0.50. Diyelim ki bir oturum, her biri 30.000 input token taşıyan 40 istek gönderiyor ve her biri 1.000 output token alıyor. Bu 1.200.000 input token, yani $0.18 artı 40.000 output token, yani $0.02 eder; toplam $0.20. Başarısız veya reddedilen istekler için ücret alınmaz ve kredi süresi dolmaz. Yükleme miktarları ve bonuslar için fiyatlandırma sayfasına bakın.

Yeni hesaplar, anahtar sayfasında tek tıkla $0.50 deneme kredisi talep edebilir; kart gerekmez, 7 gün geçerlidir. Bu, curl testini ve birkaç küçük Aider düzenlemesi çalıştırmak için yeterlidir. İstemler eğitim için kullanılmaz.

Sorular ve cevaplar

Claude Code'u doğrudan bu API'ye yönlendirebilir miyim?

Doğrudan değil. Claude Code, Anthropic'in API formatı için tasarlanmıştır; bu hizmet ise OpenAI tarzı sohbet tamamlamaları sağlar. Claude Code'un hangi özellikleri desteklediğini görmek için Anthropic'in güncel dokümantasyonuna bakın ve bu uç noktayı kullanmak için OpenAI uyumlu bir aracı kullanın.

Özel bir OpenAI base URL'si ile hangi kodlama araçları çalışır?

Aider, Continue ve Cline size bir OpenAI uyumlu Base URL, bir anahtar ve bir model adı girmenizi sağlar. Cursor, OpenAI tarzı modeller için de bir Base URL geçersiz kılma seçeneği sunar; ancak mevcut ayarları ve plan limitlerini kontrol etmeniz gerekir.

API, aracılar için fonksiyon çağırma (tool calling) desteği sağlıyor mu?

Evet. Araçları ve tool_choice'u gönderebilir, akış (streaming) ile tool_calls alabilir ve role tool ile sonuçları döndürebilirsiniz. Belirli bir editör eklentisinin bu alanları kullanıp kullanmadığı eklentinin kendisine bağlıdır.

Bir kodlama oturumu ne kadar tutar?

Fiyatlandırma 1M girdi token'ı başına $0.15 ve 1M çıktı token'ı başına $0.50'dir. Agentler bağlam penceresini sık sık yeniden gönderir, bu nedenle girdi token'ları faturada genellikle baskındır.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al