Windows’ta Claude Code: VS Code Eklenti Düzeltmesi ve Bash Ortam Değişkenleri

Windows Sorun Giderme Rehberi

Windows’ta Claude Code:
VS Code Eklenti Düzeltmesi ve Bash Ortam Kurulumu

Claude Code VS Code eklentisindeki bozuk Git Bash algılama kontrolünü nasıl düzelteceğinizi
ve şifresiz, API anahtarı tabanlı kimlik doğrulama için kabuk ortamınızı nasıl yapılandıracağınızı öğrenin.

İçindekiler
  1. Sorunun Anlaşılması
  2. extension.js Yaması (Çözüm)
  3. Bash ve CMD Ortam Değişkenleri
  4. Git Bash — Kalıcı Kurulum (~/.bashrc)
  5. Windows CMD — Kalıcı Kurulum
  6. Doğrulama

1 Sorunun Anlaşılması

Git Bash’i kurduysanız, CLAUDE_CODE_GIT_BASH_PATH‘i hem kullanıcı hem de sistem ortam değişkeni olarak tanımladıysanız,
VS Code’un settings.json dosyasına eklediyseniz, hatta ~/.claude/settings.json oluşturduysa nız —
ve Claude Code hâlâ VS Code eklenti panelinde yüklenmiyorsa — yanlış bir şey yapmıyorsunuz.
Bu, eklentinin kendisinde onaylanmış bir hata (bug)’dır.

⚠️

Git Bash algılama kontrolü, eklenti herhangi bir ortam değişkeni, VS Code ayarı veya
.claude/settings.json dosyasını okumadan önce çalışır.
Eklenti bu dosyaları okuyacak kadar ilerleyemediği için tüm yapılandırma yaklaşımları başarısız olur.

CMD ve Git Bash çalışırken eklenti neden çalışmıyor?

VS Code eklentisi (v2.1.76) ve global olarak kurduğunuz Claude CLI (v2.1.58)
tamamen birbirinden bağımsız iki ayrı şeydir. Eklenti, kendi dahili CLI ikili dosyasını şu konumda barındırır:

yol

C:\Users\<KullanıcıAdınız>\.vscode\extensions\anthropic.claude-code-2.1.76-win32-x64\extension.js

Hata, extension.js içindeki bir fonksiyonda fırlatılır. Bu fonksiyon, VS Code’un izole
sürecinde Node.js spawnSync aracılığıyla — shell: true seçeneği olmadan —
where.exe git komutunu çalıştırır. Bu izole süreç sistem PATH’ini doğru şekilde devralamamaktadır.
Git kurulu ve mükemmel çalışıyor olsa bile bu dar kontrol başarısız olur ve herhangi bir yapılandırma
yüklenmeden hata fırlatılır.

bozuk kontrol (extension.js içinde)

try {
  A3("where.exe", ["git"], { stdio: "pipe", encoding: "utf8" })
} catch {
  throw Error("Claude Code on Windows requires git-bash ...")
}
return

2 extension.js Yaması (Çözüm)

Çözüm, bozuk try bloğunun hemen öncesine bir return; ifadesi eklemektir.
Bu sayede fonksiyon, kontrol çalışmadan önce çıkar. Alttaki Claude CLI zaten kendi
Git/bash algılamasını doğru şekilde gerçekleştirmektedir — bu kontrol gereksiz bir yineleme.

Eklenti dizinini Dosya Gezgini’nde açın

C:\Users\<KullanıcıAdınız>\.vscode\extensions\anthropic.claude-code-2.1.76-win32-x64\ konumuna gidin ve extension.js dosyasını Notepad++ ya da VS Code ile açın.

Bozuk kontrolü arayın

Ctrl+F tuşuna basın ve şunu arayın: requires git-bash

try bloğunun önüne return; ekleyin

Hata dizisinin hemen öncesindeki try{ ifadesini bulun ve aşağıda gösterildiği gibi önüne return; yazın.

Kaydedin ve VS Code’u tamamen yeniden başlatın

VS Code’u tamamen kapatın — sistem tepsisini de kontrol edin — ardından yeniden açın. Eklenti paneli artık normal şekilde yüklenmelidir.

Öncesi → Sonrası

extension.js — tam olarak bu metni bulun

// ÖNCESİ (orijinal)
try{A3("where.exe",["git"],{stdio:"pipe",encoding:"utf8"})}catch{throw Error("Claude Code on Windows requires git-bash...")}return}

// SONRASI (yamalı) — en başa return; ekleyin
return;try{A3("where.exe",["git"],{stdio:"pipe",encoding:"utf8"})}catch{throw Error("Claude Code on Windows requires git-bash...")}return}

✅

Bu neden güvenli: return;, doğrulama fonksiyonunu hata fırlatmadan önce sonlandırır.
Zaten doğru çalışan asıl Claude CLI süreci, kendi Git ve bash algılamasını bağımsız olarak yönetir.
Eklenti sarmalayıcısındaki bu gereksiz kontrolü atlamak, işlevselliği hiçbir şekilde etkilemez.

🔒

Otomatik güncellemeyi engelleyin: Eklentiler paneline (Ctrl+Shift+X) gidin,
Claude Code‘u bulun, dişli simgesine ⚙️ tıklayın ve “Otomatik Güncellemeyi Devre Dışı Bırak”
seçeneğini seçin. Aksi takdirde bir sonraki eklenti güncellemesi yamanızın üzerine yazacaktır.

3 Bash ve CMD Ortam Değişkenleri

Claude Code’u terminalden her seferinde giriş yapmak zorunda kalmadan kullanmak için
Anthropic API anahtarınızla kimlik doğrulaması yapabilirsiniz. Aşağıda Windows’ta
Claude Code ile ilgili tüm ortam değişkenleri listelenmiştir.

Değişken Açıklama Zorunlu mu?
ANTHROPIC_API_KEY Anthropic API anahtarınız — API anahtarı ile kimlik doğrulamayı etkinleştirir, tarayıcı girişini atlar Zorunlu
CLAUDE_CODE_GIT_BASH_PATH bash.exe‘nin mutlak yolu — Windows’ta eklenti için gereklidir Zorunlu
ANTHROPIC_BASE_URL Özel API uç noktası — yalnızca proxy, AWS Bedrock veya Vertex AI kullanıyorsanız gerekir İsteğe Bağlı
CLAUDE_CODE_MAX_OUTPUT_TOKENS Yanıt başına varsayılan maksimum çıktı token sınırını geçersiz kılar İsteğe Bağlı
DISABLE_AUTOUPDATER Claude CLI’nin kendiliğinden güncellenmesini önlemek için 1 olarak ayarlayın İsteğe Bağlı
CLAUDE_CODE_DISABLE_TELEMETRY Kullanım telemetrisini devre dışı bırakmak için 1 olarak ayarlayın İsteğe Bağlı
🔑

API anahtarınızı console.anthropic.com → API Keys bölümünden alabilirsiniz.
Hesabınızda aktif kredi bulunduğundan emin olun — sıfır kredili geçerli bir anahtar yine de
kimlik doğrulamasında başarısız olacaktır.

4 Git Bash — Kalıcı Kurulum

Bu export tanımlarını ~/.bashrc (veya ~/.bash_profile) dosyanıza ekleyin;
böylece Git Bash her açıldığında otomatik olarak ayarlanırlar.

.bashrc dosyanızı açın

git bash

# .bashrc dosyanızı nano ile açın (yoksa oluşturur)
nano ~/.bashrc

Aşağıdaki export tanımlarını ekleyin

~/.bashrc

# ─── Claude Code Yapılandırması ─────────────────────────────

# Zorunlu: Anthropic API anahtarınız (tarayıcı giriş istemi olmadan)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Zorunlu (Windows): Git Bash çalıştırılabilir dosyasının yolu
export CLAUDE_CODE_GIT_BASH_PATH="/c/Program Files/Git/bin/bash.exe"

# İsteğe bağlı: Özel API base URL (proxy, Bedrock, Vertex vb.)
# export ANTHROPIC_BASE_URL="https://proxy.example.com"

# İsteğe bağlı: CLI otomatik güncellemesini devre dışı bırak
# export DISABLE_AUTOUPDATER=1

# İsteğe bağlı: Telemetriyi devre dışı bırak
# export CLAUDE_CODE_DISABLE_TELEMETRY=1

# ────────────────────────────────────────────────────────────

💡

Git Bash’te Windows yolları, C:\Program Files\... yerine /c/Program Files/...
biçiminde ileri eğik çizgi ve sürücü harfleriyle yazılır. Düzenlemeden sonra terminali yeniden
açmadan değişiklikleri uygulamak için source ~/.bashrc komutunu çalıştırın.

Hemen uygulayın

git bash

# Terminali yeniden açmadan yeniden yükle
source ~/.bashrc

# Değişkenlerin ayarlandığını doğrula
echo $ANTHROPIC_API_KEY
echo $CLAUDE_CODE_GIT_BASH_PATH

5 Windows CMD — Kalıcı Kurulum

CMD’nin .bashrc gibi bir karşılığı yoktur; ancak kalıcı sistem düzeyindeki ortam
değişkenlerini iki yolla tanımlayabilirsiniz: grafiksel arayüz (GUI) ya da yönetici yetkisiyle
açılan CMD’de tek satır komut ile.

Seçenek A — GUI (Denetim Masası)

Sistem Özellikleri’ni açın

Win+R tuşlarına basın, sysdm.cpl yazıp Enter’a basın → Gelişmiş sekmesi → Ortam Değişkenleri

Sistem Değişkenleri altına ekleyin (Kullanıcı değil)

Alt paneldeki “Sistem değişkenleri” bölümünde her değişken için Yeni‘ye tıklayın.

VS Code ve tüm açık terminalleri tamamen yeniden başlatın

Gerekirse VS Code’u Görev Yöneticisi’nden kapatın — arka planda çalışmaya devam ederek eski ortam değerlerini önbelleğe alabilir.

Seçenek B — Yönetici CMD (tek satır komutlar)

CMD’yi Yönetici olarak açın ve aşağıdaki komutları çalıştırın:

cmd (yönetici olarak çalıştır)

:: Zorunlu: Anthropic API anahtarı
setx ANTHROPIC_API_KEY "sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" /M

:: Zorunlu: VS Code eklentisi için Git Bash yolu
setx CLAUDE_CODE_GIT_BASH_PATH "C:\Program Files\Git\bin\bash.exe" /M

:: İsteğe bağlı: Otomatik güncelleyiciyi devre dışı bırak
setx DISABLE_AUTOUPDATER "1" /M

:: İsteğe bağlı: Telemetriyi devre dışı bırak
setx CLAUDE_CODE_DISABLE_TELEMETRY "1" /M

🔐

Güvenlik notu: /M bayrağı değişkenleri tüm kullanıcılara görünür olan
makine (sistem) düzeyinde tanımlar. Paylaşımlı bir bilgisayar kullanıyorsanız, kullanıcı
düzeyinde tanımlamak için /M‘yi kaldırın. API anahtarınızı asla sürüm kontrolüne
eklemeyin veya herkese açık şekilde paylaşmayın.

6 Doğrulama

Yamayı uygulayıp ortam değişkenlerini ayarladıktan sonra aşağıdaki kontrolleri çalıştırın:

git bash

# 1. Claude CLI'nin çalıştığını ve sürümü gösterdiğini doğrulayın
claude --version

# 2. API anahtarının ayarlandığını doğrulayın (anahtar ön ekini yazdırmalı)
echo $ANTHROPIC_API_KEY

# 3. Kimlik doğrulamayı test edin — tarayıcı giriş istemi olmadan bağlanmalı
claude -p "Merhaba de"

# 4. VS Code'da: Komut Paleti'ni açın (Ctrl+Shift+P)
#    ve "Claude Code: Open Chat" komutunu çalıştırın — hatasız yüklenmeli

🎉

VS Code paneli yükleniyorsa ve claude -p "Merhaba de" giriş istemi olmadan yanıt
döndürüyorsa her şey doğru çalışıyor demektir. Eklenti kendi paketlenmiş ikili dosyasını kullanır
ancak API anahtarını ortamdan devralır; bu sayede kimlik doğrulama sorunsuz gerçekleşir.

Claude Code · Windows Sorun Giderme Rehberi · Mart 2026
Resmi Belgeler ↗