Tarayıcı çalışıyor ama Claude Code bağlanmıyor mu? Terminal proxy ayarları

Claude tarayıcıda açılıyor ama terminaldeki claude zaman aşımına uğruyor veya oturum açmayı tamamlamıyor mu? Önce terminalin proxy kullanıp kullanmadığını kontrol edin. Tarayıcı eklentisi, sistem proxy ayarı ve kabuk ortam değişkenleri ayrı yapılandırmalardır.

Bu rehber bağımsız Claude Code CLI içindir; Claude Desktop ayarlarını kapsamaz. Uygun bir hesap ve resmen desteklenen bir konum gerekir. Bağlantının çalışması bu koşulları değiştirmez.

Bu geçici ayarlar, mevcut terminalden ön planda başlatılan CLI içindir. --bg veya arka plan ajanları için ayrı resmî yapılandırmayı izleyin: sürekli çalışan yönetici süreç sonraki kabuk değişikliklerini güvenilir biçimde devralmaz.

1. Önce proxy istemcisini bağlayın

JMS aboneliği istemcideki düğümleri yapılandırır. Gerçek istek yolu şöyledir:

Claude Code → istemcinin yerel HTTP/mixed portu → seçilen JMS düğümü → Anthropic hizmeti.

Güncel aboneliğinizi, düğümlerin gerçek protokolünü destekleyen bir istemciye aktarın. JMS, 2026 boyunca protokollerini değiştirdi; eski bir yalnızca Shadowsocks istemcisinin çalışacağını varsaymayın. Önce VLESS/Reality sorun giderme veya Clash Verge kurulum rehberine bakın.

Yerel HTTP veya mixed dinleme portunu bulun ve istemciyi açık tutun. Bu, uzak sunucunun portu, abonelik adresi, UUID veya Reality açık anahtarı değildir. Dinleyiciyi yerel bilgisayarla sınırlayın; LAN paylaşımını açmanız gerekmez.

Resmî ağ belgelerine göre Claude Code HTTP/HTTPS proxy destekler, ancak SOCKS’u doğrudan desteklemez. HTTP/mixed dinleyicisini açın ya da uyumlu bir istemci kullanın.

2. Claude’u başlatacak terminali yapılandırın

İlk deneme için ayrı bir terminal açın. https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY, no_proxy veya NO_PROXY önceden ayarlanmış mı, yerel olarak kontrol edin. Değerleri yayımlamayın: proxy adresleri parola içerebilir.

Claude Code, https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY sırasındaki ilk tanımlı değeri seçer. Eski küçük harfli değer, yeni büyük harfli ayara üstün gelebilir. Diğer araçların kuralları farklıdır; ALL_PROXY, Claude’a SOCKS desteği kazandırmaz. Üzerine yazmadan önce eski değerleri özel olarak saklayın ve çakışmaları çözün.

macOS veya Linux: Bash/Zsh

7890 yalnızca örnektir. Çalıştırmadan önce istemcinizdeki gerçek HTTP/mixed portuyla değiştirin:

JMS_PROXY_PORT=7890
export HTTPS_PROXY="http://127.0.0.1:${JMS_PROXY_PORT}"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,::1"
claude

Windows: PowerShell

Burada da 7890 yerine gerçek HTTP/mixed portunuzu yazın. Komut İstemi değil PowerShell kullanın:

$JmsProxyPort = 7890
$env:HTTPS_PROXY = "http://127.0.0.1:$JmsProxyPort"
$env:HTTP_PROXY = $env:HTTPS_PROXY
$env:NO_PROXY = "localhost,127.0.0.1,::1"
claude

http://, yerel proxy’ye bağlantıyı tanımlar; hedefin HTTPS bağlantısını şifresiz HTTP’ye dönüştürmez. NO_PROXY yerel istekleri doğrudan gönderir ve tarayıcıdaki oturum açma geri çağrısının CLI’a ulaşmasına yardımcı olur.

Değişkenler bu terminal ve buradan başlatılan süreçler için geçerlidir. Açık Claude Code oturumu sonradan değişen kabuk değişkenlerini yeniden okumaz. Oturumdan çıkın, değişkenleri ayarlayın ve claude komutunu aynı terminalde yeniden çalıştırın. Test başarılı olmadan kalıcı kabuk profili ayarları eklemeyin.

WSL, kapsayıcı veya SSH ortamında 127.0.0.1 komutun çalıştığı ortamı gösterir; istemcinin bulunduğu bilgisayar olmayabilir. Proxy’yi internete açmadan erişilebilirliği doğrulayın.

3. Kimlik bilgisi göndermeden test edin

Claude Code’dan çıkıp yapılandırılan terminalde testi çalıştırın. Yerel proxy’yi açıkça kullanır ve herkese açık API sunucusuna API anahtarı olmadan erişir.

macOS/Linux:

curl --proxy "$HTTPS_PROXY" --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output /dev/null --silent --show-error --write-out 'HTTP %{http_code}\n' https://api.anthropic.com/

Windows’ta eski PowerShell sürümlerinin curl takma adından kaçınmak için curl.exe kullanın:

curl.exe --proxy $env:HTTPS_PROXY --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output NUL --silent --show-error --write-out "HTTP %{http_code}\n" https://api.anthropic.com/

Bağlantı için 10, tüm istek için 20 saniye sınırı vardır. HTTP 401, 403 veya 404 alınması HTTP yanıtı geldiği anlamına gelebilir; API kökü, oturum açılmış bir model çağrısı değildir. Hatayı inceleyin: 2xx dışı kod tek başına proxy arızasını, herhangi bir yanıt da hesap yetkisini kanıtlamaz.

Bağlantı hatası veya zaman aşımıyla birlikte HTTP 000, normal HTTP yanıtı gelmediğini gösterir. Sertifika hatalarını ayrıca inceleyin. TLS doğrulamasını açık tutun: -k eklemeyin veya sertifika denetimini kapatmayın. Abonelik adresi, giriş kodu, belirteç ya da özel tanılama günlüklerini yayımlamayın.

4. Belirtiye göre sonraki kontrolü seçin

claude --version ile sürümü görün, claude doctor çalıştırın ve resmî kurulum rehberindeki yönteminize uygun biçimde güncelleyin. Sürüm hatası, süresi dolmuş giriş veya platform kesintisi ağ hatası gibi görünebilir.

5. Geçici ayarları kaldırın

Değişkenler testten önce yoksa yalnızca eklenen değerleri silin:

Bash/Zsh:

unset HTTPS_PROXY HTTP_PROXY NO_PROXY JMS_PROXY_PORT

PowerShell:

Remove-Item Env:HTTPS_PROXY, Env:HTTP_PROXY, Env:NO_PROXY -ErrorAction SilentlyContinue
Remove-Variable JmsProxyPort -ErrorAction SilentlyContinue

Bu işlem geçerli değerleri siler; üzerine yazılan eski değerleri geri getirmez. Gerekirse bunları özel olarak geri yükleyin ve Claude Code’u yeniden başlatın. Kalıcı sistem veya profil ayarları ayrıca incelenmelidir.

Bağlantı hizmeti seçmek

JMS uyumlu istemciye düğüm sağlar; istemci ve terminal ayarları CLI’ı bu düğümlere bağlar. Anthropic aboneliği sunmaz, hesap onayı veya askıya alınmama garantisi vermez. Yerel proxy, buluttaki MCP bağlayıcısının çıkış yolunu da değiştirmez.

Planları ve istemci indirme rehberini cihazlarınız ve güncel protokollerle karşılaştırın. Bu kurulum ihtiyacınıza uygunsa Just My Socks’a göz atın.

Satış ortaklığı açıklaması: bu bağlantıdan alışveriş yaparsanız komisyon kazanabiliriz.