Claude Code Bulut Oturumlarında Otomatik Kurulum Dönemi: Bağımlılıklar ve API Anahtarları Artık Otonom Yönetiliyor

Yazılım geliştirme süreçlerinde otonom yapay zeka ajanlarının kullanımı hızla yaygınlaşırken, mühendislik ekiplerinin karşılaştığı en büyük operasyonel darboğazların başında uzak (remote) çalışma ortamlarının ilk kurulumu geliyor. Bir kod deposunu (repository) bulut tabanlı bir yapay zeka ajanına teslim ettiğinizde; doğru çalışma zamanı (runtime) sürümlerinin seçilmesi, paket yöneticilerinin kurulması, derleme araçlarının hazırlanması ve dış ağ erişim izinlerinin tanımlanması çoğu zaman zahmetli bir ön hazırlık gerektiriyor. Anthropic, terminal ve bulut tabanlı otonom kodlama ajanı Claude Code için duyurduğu yeni mimari güncelleme ile bu kurulum yükünü ortadan kaldırıyor. Artık Claude Code bulut oturumları, projenin ihtiyaç duyduğu sanal makine ortamını, bağımlılık ağacını ve güvenli API bağlantılarını otonom olarak yapılandırabiliyor.

Anthropic mühendislik ekibi tarafından Pro, Max, Ultra, Team ve Enterprise planlarında kullanıma sunulan bu yeni altyapı; bulut üzerinde başlatılan kodlama oturumlarında manuel yapılandırma betikleri (setup scripts) yazma zorunluluğunu ortadan kaldırırken, aynı zamanda CLAUDE.md ve .claude/settings.json üzerinden deterministik özelleştirmelere ve Agent Proxy tabanlı sıfır-güven (zero-trust) API anahtarı izolasyonuna olanak tanıyor.

Otonom Ortam Keşfi ve Dosya Sistemi Anlık Görüntüleme (Snapshot Caching)

Geleneksel CI/CD hatlarında veya bulut geliştirme konteynerlerinde, projenin ayağa kalkabilmesi için geliştiricinin önceden detaylı bir Dockerfile veya devcontainer.json hazırlaması gerekir. Yeni Claude Code bulut otomatik kurulum mekanizması ise bir bulut oturumu başlatıldığında depoyu izole bir mikro-VM içerisine klonlayarak statik ve dinamik analiz sürecini bizzat yürütüyor.

Ajan ilk aşamada depo kök dizinindeki ve alt modüllerdeki paket bildirim dosyalarını (package.json, pnpm-lock.yaml, requirements.txt, pyproject.toml, Cargo.toml, go.mod, Makefile) tarıyor. Projenin derlenmesi, linter kontrollerinin yapılması ve birim testlerinin çalıştırılması için gereken tüm sistem kütüphanelerini kendi başına tespit ederek kurulum komutlarını çalıştırıyor. Ayrıca kod tabanındaki dış servis çağrılarını inceleyerek gerekli ağ erişim kapsamlarını (network access scopes) ve harici API anahtarı gereksinimlerini belirliyor.

Büyük ölçekli monorepo projelerde yüzlerce paketin her oturumda sıfırdan indirilmesini önlemek adına Anthropic, sisteme kalıcı ortam önbellekleme (filesystem snapshot caching) katmanı ekledi. Claude Code bir deponun kurulumunu başarıyla tamamladığında, sanal makinenin dosya sistemi durumunu anlık görüntü (snapshot) olarak kaydediyor. Yaklaşık 7 gün boyunca sıcak tutulan bu önbellek sayesinde; web arayüzü (claude.ai/code), masaüstü uygulaması, mobil uygulama veya terminal üzerinden başlatılan sonraki tüm oturumlar saniyeler içinde hazır ortamla açılıyor:

claude --cloud

# Mevcut bir görevi bulut ortamında otonom çalıştırmak üzere tetikleme
claude --cloud "Auth modülündeki JWT doğrulama testlerini güncelle ve PR aç"

# Yerel ortam ve bağlantı sağlığını kontrol etme
claude doctor

Bulut Oturumları İçin CLAUDE.md Yapılandırması

Claude Code bir bulut sanal makinesinde çalıştığında, geliştiricinin kendi bilgisayarındaki global ~/.claude/CLAUDE.md dosyasına veya yerel MCP sunucularına erişemez. Bu nedenle bulut ajanının projenin mimari kurallarını, özel derleme bayraklarını ve ortam gereksinimlerini ilk saniyeden itibaren doğru anlaması için depo kök dizininde versiyon kontrolüne dahil edilmiş bir CLAUDE.md dosyası bulundurmak kritik önem taşır.

Otonom kurulum mekanizmasına rehberlik eden teknik bir CLAUDE.md örneği şu şekilde yapılandırılabilir:

# Proje Mimari ve Bulut Ortamı Kılavuzu (CLAUDE.md)

## Çalışma Zamanı ve Paket Yöneticisi
- Node.js: v22.x LTS (nvm veya fnm üzerinden aktif edilmeli)
- Paket Yöneticisi: Sadece pnpm kullanılmalıdır (npm veya yarn çalıştırmayın)
- Veritabanı: Yerel testler için PostgreSQL 16 ve pgvector eklentisi gereklidir

## Temel Komutlar
- Kurulum: pnpm install --frozen-lockfile
- Tip Kontrolü: pnpm run typecheck
- Birim Testleri: pnpm test --run
- Veritabanı Göçü (Migration): pnpm run db:migrate

## Ağ Erişimi ve Güvenlik Kuralları
- Dış ağ erişimi gereken servisler: api.stripe.com, api.openai.com, registry.npmjs.org
- API anahtarlarını asla kod içine veya test loglarına yazdırmayın; tüm dış istekler Agent Proxy üzerinden yönlendirilir.

.claude/settings.json ve SessionStart Kancaları ile İleri Düzey Otomasyon

Otonom keşif mekanizması standart projelerin büyük çoğunluğunu tek başına çözse de, özel derleme adımları, yerel veritabanı tohumlama (seeding) veya dinamik ortam değişkenleri gerektiren karmaşık kurumsal projelerde deterministik kancalara (hooks) ihtiyaç duyulur. Claude Code, depo içerisindeki .claude/settings.json dosyasında tanımlanan SessionStart yaşam döngüsü kancasını her bulut oturumu başladığında veya devam ettirildiğinde (--resume) otomatik olarak tetikler.

Aşağıdaki .claude/settings.json yapılandırması, oturum başlangıcında özel bir kurulum betiğini devreye sokar:

{
  "permissions": {
    "allow": [
      "Bash(pnpm test:*)",
      "Bash(pnpm run typecheck)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ]
  },
  "hooks": {
    "SessionStart": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/cloud-setup.sh"
          }
        ]
      }
    ]
  }
}

Claude Code Mods Duyuruldu: TypeScript ile Özelleştirilebilir Ajan Mimarisi

Anthropic, Claude Code için mod eklenti sistemini tanıttı. TypeScript ile yazılan mod'lar; komutları engelleme, arayüzü değiştirme ve prompt yönetimi sağlıyor.

Anthropic, Claude Code Harcamalarının Getirisini (ROI) Ölçecek Yeni Analitik Sistemini Duyurdu

Anthropic, kurumsal şirketlerin Claude Code harcamalarını ve geliştirici verimliliğini somut metriklerle ölçmesini sağlayan yeni ROI analiz araçlarını tanıttı.

$CLAUDE_CODE_REMOTE ve $CLAUDE_ENV_FILE Kullanımı

.claude/settings.json dosyası hem yerel geliştirici makinelerinde hem de bulut sanal makinelerinde okunduğu için, ağır kurulum betiklerinin yalnızca bulut ortamında çalışması gerekir. Anthropic bunun için çalışma zamanında iki özel ortam değişkeni sunar:

1. $CLAUDE_CODE_REMOTE: Oturum bulut (remote sandbox) üzerinde çalışıyorsa otomatik olarak "true" değerini alır. 2. $CLAUDE_ENV_FILE: Kanca betiğinin ürettiği dinamik ortam değişkenlerini oturumun geri kalanındaki tüm Bash çağrılarına kalıcı olarak aktarmak için kullanılan dosya yolunu tutar.

Bu iki değişkeni kullanan örnek bir .claude/hooks/cloud-setup.sh betiği şu şekildedir:

#!/usr/bin/env bash
set -euo pipefail

# Sadece Claude Code bulut (remote) sanal makinesinde çalışıyorsa devam et
if [ "${CLAUDE_CODE_REMOTE:-false}" != "true" ]; then
  exit 0
fi

echo "[Claude Cloud] Uzak sanal makine ortamı algılandı, bağımlılıklar doğrulanıyor..."

# Paketleri kilit dosyasına sadık kalarak yükle
if [ -f "pnpm-lock.yaml" ]; then
  pnpm install --frozen-lockfile --prefer-offline
fi

# Oturum boyunca tüm alt kabuklarda geçerli olacak ortam değişkenlerini kaydet
if [ -n "${CLAUDE_ENV_FILE:-}" ]; then
  {
    echo 'export NODE_ENV="test"'
    echo 'export NEXT_TELEMETRY_DISABLED="1"'
    echo 'export PYTHONPATH="."'
  } >> "$CLAUDE_ENV_FILE"
fi

echo "[Claude Cloud] Ortam hazırlığı tamamlandı."

Agent Proxy ve Ağ Sırları (Network Secrets): Modelin Görmediği API Anahtarları

Bulut tabanlı otonom kodlama ajanlarının kurumsal mimarilerde benimsenmesinin önündeki en kritik güvenlik engeli, üçüncü parti API anahtarlarının ve veritabanı kimlik bilgilerinin (secrets) korunmasıdır. Bir yapay zeka ajanının çalıştığı sanal makineye STRIPE_SECRET_KEY veya AWS_SECRET_ACCESS_KEY gibi kritik anahtarları düz metin (plaintext) ortam değişkeni olarak vermek; dolaylı komut enjeksiyonu (indirect prompt injection), hatalı hata ayıklama çıktıları (console.log(process.env)) veya zararlı bir npm paketi nedeniyle bu anahtarların modelin bağlam penceresine (context window) ve dış dünyaya sızması riskini taşır.

Anthropic, Claude Code bulut oturumlarında bu tehdit yüzeyini sıfırlamak için Ajan Vekil Sunucu (Agent Proxy) ve Ağ Sırları (Network Secrets) mimarisini uyguluyor. Bu güvenlik modelinde yapay zeka modeli veya sanal makine içerisindeki süreçler gerçek API anahtarı değerlerini hiçbir zaman göremiyor.

Mimarinin teknik işleyişi dört katmandan oluşuyor:

* Sanal Makine Dışı Anahtar Kasası (Out-of-VM Vault): Geliştiricinin bulut ortamı ayarlarında tanımladığı API anahtarları şifrelenmiş olarak Anthropic'in kontrol düzleminde (control plane) tutulur ve kodun çalıştığı sanal makine içerisine kesinlikle kopyalanmaz. Sanal makine içinde yalnızca yer tutucu (placeholder) referanslar veya yerel vekil uç noktalar bulunur. * Egress Güvenlik Vekil Sunucusu (Outbound Proxy): Sanal makineden dış dünyaya çıkan tüm HTTP/HTTPS trafiği (Trusted, Custom veya Full ağ erişim katmanlarına göre) sanal makine sınırının dışındaki güvenli Agent Proxy katmanından geçer. * Alan Adı Bazlı Başlık Enjeksiyonu (Domain-Scoped Header Injection): Ajanın çalıştırdığı kod dış bir servise (örneğin api.openai.com veya kurumsal bir iç API'ye) istek gönderdiğinde, paket sanal makineden çıktıktan sonra Agent Proxy hedef alan adını doğrular ve gerçek kimlik bilgisini (Authorization: Bearer ... veya özel API başlığı) ağ paketine sanal makine dışında enjekte eder. * Kapsamlı GitHub Vekil Sunucusu (GitHub Scoped Proxy): Benzer şekilde, geliştiricinin kişisel erişim anahtarı (PAT) veya SSH anahtarı sanal makineye girmez. VM içindeki Git istemcisi, yalnızca ilgili depoya okuma/yazma yetkisi olan geçici ve kısıtlı bir vekil kimlik bilgisi üzerinden GitHub ile haberleşir.

Bu sayede sanal makine içerisindeki kod env veya printenv komutlarını çalıştırsa, belleği (memory dump) okusa ya da tüm ortam değişkenlerini harici bir sunucuya göndermeye çalışsa bile gerçek API anahtarlarına erişemez; ayrıca anahtar yalnızca tanımlı hedef alan adına enjekte edildiği için farklı bir sunucuya yönlendirilerek çalınması (exfiltration) teknik olarak imkansız hale gelir.

Kurumsal Mühendislik Ekipleri İçin Hibrit İş Akışı

Claude Code'un otonom kurulum, 7 günlük dosya sistemi önbelleklemesi, SessionStart kancaları ve Agent Proxy tabanlı anahtar izolasyonunu bir araya getiren yeni bulut mimarisi, yazılım geliştirme ekiplerinde standartlaşmayı yeni bir boyuta taşıyor. Mühendisler yerel terminallerinde anlık mimari kararları alırken, uzun süren yeniden yapılandırma (refactoring) görevlerini, çoklu dal (multi-branch) hata düzeltmelerini ve kapsamlı entegrasyon testlerini sıfır kurulum maliyetiyle izole bulut oturumlarına devrediyor. Hem hız hem de sıfır-güven siber güvenlik ilkelerini aynı potada eriten bu yapı, otonom yazılım mühendisliğinin kurumsal ölçekte standart haline gelmesindeki en önemli kilometre taşlarından birini temsil ediyor.