Claude Code Web beta

Claude Code Web beta – Web Üzerinde Claude Code Kullanımı

Claude Code artık doğrudan tarayıcı üzerinden claude.ai/code adresinde çalışabiliyor. Bu özellik, Pro, Max ve Team kullanıcıları ile premium koltuk veya Chat + Claude Code koltuklarına sahip Enterprise kullanıcıları için araştırma ön izlemesinde (research preview) sunuluyor.

Cloud ortamında çalışan oturumlar, tarayıcıyı kapatsanız bile devam ediyor ve Claude mobil uygulamasından izlenebiliyor.

GitHub kimlik doğrulama seçenekleri (GitHub authentication options)

Cloud oturumlarının kod kopyalamak ve branch göndermek için GitHub depolarınıza erişmesi gerekir. İki yöntemle erişim sağlanabilir:

Her iki yöntemde de cloud oturumu, bağlanan GitHub hesabının görebildiği tüm depolara erişebilir. GitHub App'in kurulu olduğu depolarla sınırlı değildir. App kurulumu, Auto-fix için PR webhook'larını etkinleştirir; oturum düzeyinde bir erişim kontrolü değildir.

Not: /schedule komutu, her iki erişim yöntemini de kontrol eder; hiçbiri yapılandırılmamışsa /web-setup çalıştırmanızı ister.

Uyarı: Team ve Enterprise yöneticileri, claude.ai/admin-settings/claude-code sayfasındaki "Quick web setup" anahtarıyla /web-setup'ı devre dışı bırakabilir. Zero Data Retention etkin olan kuruluşlar cloud oturum özelliklerini kullanamaz.

Cloud ortamı (The cloud environment)

Her oturum, deponuzun klonlandığı yeni bir Anthropic yönetimli VM'de çalışır.

Cloud oturumlarında neler mevcut (What's available in cloud sessions)

Uyarı: Ortam değişkenleri ve kurulum script'leri, ortamı düzenleyebilen herkes tarafından görülebilir. Gizli bilgileri eklerken bu görünürlüğü göz önünde bulundurun.

Yüklü araçlar (Installed tools)

¹ Bun yüklüdür ancak proxy uyumluluğu sorunları bilinmektedir.

GitHub issue ve pull request'lerle çalışma (Work with GitHub issues and pull requests)

Cloud oturumları, Claude'ın herhangi bir kurulum gerektirmeden issue'ları okumasını, PR'ları listelemesini, diff'leri almasını ve yorum göndermesini sağlayan yerleşik GitHub araçları içerir. Bu araçlar, GitHub proxy'si üzerinden kimlik doğrulaması yapar; token'ınız konteynıra girmez.

gh CLI önceden yüklenmemiştir. İhtiyacınız varsa kurulum script'inize ekleyin ve GH_TOKEN ortam değişkenini ayarlayın.

Yapıtları oturuma bağlama (Link artifacts back to the session)

Her cloud oturumunun claude.ai'de bir transkript URL'si vardır. Oturum, kendi ID'sini CLAUDE_CODE_REMOTE_SESSION_ID ortam değişkeninden okuyabilir. PR gövdelerine, commit mesajlarına veya raporlara izlenebilir bir bağlantı eklemek için:

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

Test çalıştırma, servis başlatma ve paket ekleme (Run tests, start services, and add packages)

Test araçları (pytest, jest, cargo test) önceden yüklü olduğu için kutudan çıkar çalışır. PostgreSQL ve Redis önceden yüklüdür ancak varsayılan olarak çalışmaz. Claude'dan başlatmasını isteyin:

service postgresql start
service redis-server start

Docker mevcuttur. Büyük imajlar için kurulum script'inize docker compose pull ekleyin; önbelleğe alınır.

Kaynak limitleri (Resource limits)

Daha büyük iş yükleri için Remote Control kullanarak Claude Code'u kendi donanımınızda çalıştırın.

Ortamınızı yapılandırma (Configure your environment)

Ortamlar; ağ erişimini, ortam değişkenlerini ve oturum başlamadan önce çalışan kurulum script'ini kontrol eder.

Ortam değişkenleri .env formatında, satır başına bir KEY=value olacak şekilde girilir. Değerleri tırnak içine almayın.

Kurulum script'leri (Setup scripts)

Kurulum script'i, yeni bir cloud oturumu başladığında, Claude Code başlatılmadan önce çalışan bir Bash script'idir. Script'ler root olarak Ubuntu 24.04 üzerinde çalışır.

Örnek (gh CLI kurulumu):

#!/bin/bash
apt update && apt install -y gh

Script sıfır olmayan bir çıkış koduyla biterse oturum başarısız olur. Kritik olmayan komutlara || true ekleyin. Toplam çalışma süresi yaklaşık 5 dakikanın altında olmalıdır.

Ortam önbellekleme (Environment caching)

Kurulum script'i bir ortamda ilk kez çalıştırıldığında, Anthropik dosya sisteminin anlık görüntüsünü alır ve sonraki oturumlar için bu anlık görüntüyü kullanır. Script şu durumlarda yeniden çalışır:

• Ortamın kurulum script'i değiştiğinde
• İzin verilen ağ ana bilgisayarları değiştiğinde
• Önbellek yaklaşık 7 gün sonra süresi dolduğunda

Kurulum script'leri vs. SessionStart hooks

SessionStart hook ile bağımlılık kurulumu örneği:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

Script'te cloud'a özgü çalışma için CLAUDE_CODE_REMOTE değişkenini kontrol edin:

#!/bin/bash
if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi
npm install
pip install -r requirements.txt
exit 0

Ağ erişimi (Network access)

Her ortam bir erişim seviyesi belirtir. Varsayılan Trusted'dır.

Erişim seviyeleri (Access levels)

Belirli domain'lere izin verme (Allow specific domains)

Custom seçeneğinde "Allowed domains" alanına satır başına bir domain girin:

api.example.com
*.internal.example.com
registry.example.com

Varsayılan izin verilen domain'ler (Default allowed domains)

Trusted ağ erişiminde aşağıdaki domain'lere izin verilir (tam liste dokümantasyonda mevcuttur; başlıca kategoriler):

• Anthropic servisleri: api.anthropic.com, claude.ai, code.claude.com
• Versiyon kontrol: github.com, gitlab.com, bitbucket.org
• Konteyner kayıtları: registry-1.docker.io, ghcr.io, gcr.io, mcr.microsoft.com
• Cloud platformları: cloud.google.com, azure.com, *.amazonaws.com
• Paket yöneticileri: registry.npmjs.org, pypi.org, rubygems.org, crates.io, proxy.golang.org, maven.org, packagist.org, nuget.org
• Linux dağıtımları: archive.ubuntu.com
• Geliştirme araçları: dl.k8s.io, releases.hashicorp.com, repo.anaconda.com

Görevleri web ve terminal arasında taşıma (Move tasks between web and terminal)

Terminalden web'e (From terminal to web)

claude --remote "Fix the authentication bug in src/auth/login.ts"

Bu, claude.ai'de yeni bir cloud oturumu oluşturur. VM, GitHub'dan klonlama yaptığı için önce yerel commit'lerinizi push edin.

Cloud görevleri için ipuçları:

• Yerelde planla, uzakta çalıştır: Önce claude --permission-mode plan ile plan modunda çalışın, sonra claude --remote "Execute the migration plan..." ile cloud'da çalıştırın
• Görevleri paralel çalıştır: Her --remote komutu bağımsız bir oturum oluşturur
• GitHub'sız depolar: Depo GitHub'a bağlı değilse, Claude Code yerel deponuzu paketleyip cloud'a yükler. Limit: 100 MB altı, en az bir commit olmalı

Web'den terminale (From web to terminal)

Teleport gereksinimleri:

• Temiz git durumu (işlenmemiş değişiklik yok)
• Doğru depo (fork değil)
• Branch remote'a push edilmiş olmalı
• Aynı claude.ai hesabı

Oturumlarla çalışma (Work with sessions)

Bağlam yönetimi (Manage context)

Değişiklikleri inceleme (Review changes)

Her oturum, eklenen ve kaldırılan satırları gösteren bir diff göstergesi içerir (+42 -18). Seçerek diff görünümünü açın, satır içi yorum bırakın.

Oturum paylaşma (Share sessions)

Oturum arşivleme ve silme (Archive and delete sessions)

Arşivleme, oturumu varsayılan listeden gizler. Silme kalıcıdır ve geri alınamaz.

Auto-fix pull request'ler (Auto-fix pull requests)

Claude, bir PR'ı izleyebilir ve CI hatalarına veya inceleme yorumlarına otomatik yanıt verebilir. Claude GitHub App'inin deponuza kurulu olması gerekir.

Auto-fix'i etkinleştirme:

• Claude Code web'de oluşturulan PR'lar: CI durum çubuğundan "Auto-fix" seçin
• Terminalden: PR branch'inde /autofix-pr çalıştırın
• Mobil uygulamadan: Claude'a "watch this PR and fix any CI failures or review comments" deyin
• Mevcut PR: PR URL'sini oturuma yapıştırın ve auto-fix yapmasını söyleyin

Uyarı: Claude, sizin adınıza PR yorumlarına yanıt verebilir. Bu, issue_comment olaylarını tetikleyen otomasyonları (Atlantis, Terraform Cloud vb.) çalıştırabilir.

Güvenlik ve izolasyon (Security and isolation)

• İzole VM'ler: Her oturum ayrı bir Anthropic yönetimli VM'de çalışır
• Ağ erişim kontrolleri: Varsayılan olarak sınırlıdır, devre dışı bırakılabilir
• Kimlik bilgisi koruması: Hassas kimlik bilgileri (git kimlik bilgileri, imzalama anahtarları) Claude Code ile aynı sandbox'ta bulunmaz
• Güvenli analiz: Kod, PR'lar oluşturulmadan önce izole VM'lerde analiz edilir ve değiştirilir

Sorun giderme (Troubleshooting)

Oturum oluşturma başarısız (Session creation failed)

• status.claude.com adresinde cloud oturum olaylarını kontrol edin
• Bir dakika sonra tekrar deneyin
• Deponuzun erişilebilir olduğunu doğrulayın

Remote Control oturumu süresi doldu veya erişim reddedildi

• /login ile kimlik bilgilerinizi yenileyin
• Aynı hesaba giriş yaptığınızdan emin olun
• Organizasyonunuz uzak oturumları etkinleştirmemiş olabilir

Ortam süresi doldu (Environment expired)

Cloud oturumları, bir süre hareketsiz kaldıktan sonra sona erer. Oturumu claude.ai/code'dan yeniden açın; konuşma geçmişiniz geri yüklenir.

Sınırlamalar (Limitations)

• Hız limitleri: Claude Code on the web, hesabınızdaki tüm Claude kullanımıyla hız limitlerini paylaşır
• Depo kimlik doğrulaması: Oturumları yalnızca aynı hesaba giriş yaptığınızda web'den yerel'e taşıyabilirsiniz
• Platform kısıtlamaları: Depo klonlama ve PR oluşturma GitHub gerektirir. GitHub Enterprise Server, Team ve Enterprise planlarında desteklenir
• Kuruluş IP allowlist: Cloud oturumları, Anthropic yönetimli altyapıdan API'yi çağırır. IP allowlist etkinse her oturum kimlik doğrulama hatasıyla başarısız olur

İlgili kaynaklar (Related resources)

• Ultraplan: Cloud oturumunda plan taslağı oluşturun ve tarayıcıda inceleyin
• Ultrareview: Cloud sandbox'ta derin çoklu-ajan kod incelemesi çalıştırın
• Routines: İşleri zamanlamaya, API çağrısına veya GitHub olaylarına göre otomatikleştirin
• Hooks configuration: Oturum yaşam döngüsü olaylarında script çalıştırın
• Settings reference: Tüm yapılandırma seçenekleri
• Security: İzolasyon garantileri ve veri işleme
• Data usage: Anthropic'in cloud oturumlarından ne sakladığı

Örnek kullanım senaryosu

Senaryo: Bir geliştirici, takımının CI hatalarını düzelten ve PR yorumlarını yanıtlayan otomatik bir iş akışı kurmak istiyor.

1. GitHub bağlantısını kurun: Tarayıcıda claude.ai/code adresine gidin ve Claude GitHub App'ini yetkilendirin. Bu, Auto-fix özelliği için PR webhook'larını etkinleştirir.

2. Cloud ortamı oluşturun: Web arayüzünden "Add environment" seçeneğini kullanarak yeni bir ortam ekleyin. Adını "production-fixes" koyun, Network access seviyesini "Trusted" olarak bırakın.

3. Kurulum script'i ekleyin: Setup script alanına aşağıdakini girin:

   #!/bin/bash
   apt update && apt install -y gh
   pip install -r requirements.txt
   

4. Ortam değişkenlerini ayarlayın:

   NODE_ENV=production
   LOG_LEVEL=debug
   GH_TOKEN=ghp_your_token_here
   

5. Auto-fix'i test edin: Terminalde, hatalı bir PR branch'ine geçin ve /autofix-pr çalıştırın. Claude Code, gh ile açık PR'ı algılar, bir web oturumu başlatır ve Auto-fix'i etkinleştirir.

6. Paralel görevler çalıştırın: Terminalden birden fazla --remote komutuyla farklı branch'lerdeki hataları aynı anda düzelttirin:

   claude --remote "Fix the flaky test in auth.spec.ts"
   claude --remote "Update the API documentation"
   

7. İlerlemeyi izleyin: /tasks komutuyla tüm arka plan oturumlarını görün. Mobil uygulamadan da takip edin.

8. Oturumu terminale çekin: Bir cloud oturumu tamamlandığında, claude --teleport <session-id> ile oturumu terminalinize alın ve kalan işleri yerelde bitirin.

9. PR'ı inceleyin: Web arayüzünden diff görünümünü açın, değişiklikleri inceleyin ve PR'ı oluşturun. Claude, CI hatalarını ve yorumları otomatik izlemeye başlar.