Claude Max API proxy'si

claude-max-api-proxy, bir Claude Max/Pro aboneliğini OpenAI uyumlu bir API uç noktası olarak sunan bir topluluk npm paketidir (OpenClaw plugin’i değildir); böylece OpenAI uyumlu herhangi bir aracı Anthropic API anahtarı yerine aboneliğinize yönlendirebilirsiniz.

Yalnızca teknik uyumluluk sağlar; resmî olarak onaylanmış bir yöntem değildir. Anthropic geçmişte Claude Code dışındaki bazı abonelik kullanımlarını engellemiştir; buna güvenmeden önce Anthropic’in güncel faturalandırma kurallarını doğrulayın.Anthropic’in Claude Code belgeleri, claude -p özelliğini Agent SDK/programatik kullanım olarak tanımlar. Anthropic’in 15 Haziran 2026 tarihli destek güncellemesi itibarıyla Claude Agent SDK, claude -p ve üçüncü taraf uygulama kullanımı, oturum açılmış aboneliğin kullanım sınırlarından düşülür (daha önce duyurulan ayrı Agent SDK kredi planı duraklatılmıştır). Anthropic’in Agent SDK planı makalesine, Pro/Max ve Team/Enterprise planı makalelerine ve OpenClaw’ın kendi Claude CLI faturalandırma notları için Anthropic sağlayıcısına bakın.

Neden kullanılmalı?

Yaklaşım	Maliyet yöntemi	En uygun kullanım
Anthropic API anahtarı	Claude Console üzerinden token başına ödeme	Üretim uygulamaları, paylaşılan otomasyon, yüksek hacim
Claude abonelik proxy’si	Claude Code / `claude -p` planı ve kredi kuralları	Uyumlu araçlarla kişisel denemeler

Bu proxy, bir Claude Max veya Pro aboneliğinin OpenAI uyumlu araçlarla çalışmasını sağlar. Sınırsız ve sabit ücretli bir yöntem değildir; Claude Code’un kullanım sınırlarını devralır. Üretim kullanımında API anahtarları daha açık bir faturalandırma yöntemi olmaya devam eder.

Nasıl çalışır?

Uygulamanız -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic
     (OpenAI biçimi)                (biçimi dönüştürür)              (oturumunuzu kullanır)

Proxy, her istek için Claude Code CLI’ı bir alt süreç olarak başlatır, OpenAI biçimindeki sohbet isteklerini CLI istemlerine dönüştürür ve yanıtı OpenAI biçiminde akışla iletir (veya döndürür).

Başlarken

Proxy'yi yükleyin

Node.js 20+ ve kimliği doğrulanmış bir Claude Code CLI gerektirir.

npm install -g claude-max-api-proxy

# Claude CLI kimlik doğrulamasının yapıldığını doğrulayın
claude --version
claude auth login   # kimlik doğrulaması henüz yapılmadıysa

Sunucuyu başlatın

claude-max-api
# Sunucu http://localhost:3456 adresinde çalışır

Proxy'yi test edin

curl http://localhost:3456/health
curl http://localhost:3456/v1/models

curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "Merhaba!"}]
  }'

OpenClaw'ı yapılandırın

OpenClaw’ı özel bir OpenAI uyumlu uç nokta olarak proxy’ye yönlendirin:

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

Aşağıdaki model kimlikleri OpenClaw’ın Anthropic model referansları değil, proxy’nin kendi kataloğudur. Her kimlik bir Claude Code CLI model diğer adına (opus, sonnet, haiku) eşlenir; dolayısıyla Anthropic CLI’daki bu diğer adı her güncellediğinde temel model değişir. Belirli bir eşlemeye güvenmeden önce proxy’nin güncel README dosyasını kontrol edin.

Model kimliği	CLI diğer adı	Geçerli eşleme
`claude-opus-4`	`opus`	Claude Opus 4.5
`claude-sonnet-4`	`sonnet`	Claude Sonnet 4
`claude-haiku-4`	`haiku`	Claude Haiku 4

Gelişmiş yapılandırma

Proxy tarzı OpenAI uyumluluğu notları

Bu, OpenClaw’ın genel özel /v1 OpenAI uyumlu yolunu, yani kendi barındırdığınız diğer tüm OpenAI uyumlu arka uçlarla aynı yolu kullanır:

Yalnızca yerel OpenAI’a özgü istek biçimlendirmesi uygulanmaz.
/fast ve service_tier yalnızca doğrudan api.anthropic.com trafiğine uygulanır; proxy yolları service_tier değerine dokunmaz (Anthropic sağlayıcısının hızlı moduna bakın).
Responses store, istem önbelleği ipuçları veya OpenAI akıl yürütme uyumluluğu yük biçimlendirmesi yoktur.
OpenClaw’ın OpenAI/Codex ilişkilendirme üstbilgileri (originator, version, User-Agent) yalnızca yerel api.openai.com OAuth trafiğinde gönderilir; bu proxy gibi özel OPENAI_BASE_URL hedeflerine gönderilmez.

LaunchAgent ile macOS'ta otomatik başlatma

cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.claude-max-api</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
  </dict>
</dict>
</plist>
EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

Notlar

Claude Code’un claude -p faturalandırma, kullanım kredisi ve hız sınırı davranışını devralır.
Yalnızca 127.0.0.1 üzerinde dinler; CLI’ın Anthropic’e yaptığı kendi çağrısı dışında hiçbir üçüncü taraf sunucuya veri göndermez.
Akış yanıtları desteklenir.
Kimlik doğrulama hataları başlangıçta kontrol edilmez ve yalnızca bir sohbet isteği gerçekten çalıştırıldığında ortaya çıkar; CLI’ın kimliği doğrulanmamışsa sunucunun başlamayı reddetmesi yerine ilk isteğin başarısız olması beklenir.

Claude CLI veya API anahtarlarıyla yerel Anthropic entegrasyonu için Anthropic sağlayıcısına bakın. OpenAI/Codex abonelikleri için OpenAI sağlayıcısına bakın.

İlgili içerikler

Anthropic sağlayıcısı

Claude CLI veya API anahtarlarıyla yerel OpenClaw entegrasyonu.

OpenAI sağlayıcısı

OpenAI/Codex abonelikleri için.

Model seçimi

Tüm sağlayıcılara, model referanslarına ve yük devretme davranışına genel bakış.

Yapılandırma

Tam yapılandırma başvurusu.

Overview

Concepts and configuration

Providers

Claude Max API proxy'si

Neden kullanılmalı?

Nasıl çalışır?

Başlarken

Gelişmiş yapılandırma

Notlar

İlgili içerikler

Anthropic sağlayıcısı

OpenAI sağlayıcısı

Model seçimi

Yapılandırma

​Neden kullanılmalı?

​Nasıl çalışır?

​Başlarken

​Gelişmiş yapılandırma

​Notlar

​İlgili içerikler

Anthropic sağlayıcısı

OpenAI sağlayıcısı

Model seçimi

Yapılandırma

Neden kullanılmalı?

Nasıl çalışır?

Başlarken

Gelişmiş yapılandırma

Notlar

İlgili içerikler