Gözetimsiz ajan

Şimdiye kadar ajan sizin bilgisayarınızda, siz başındayken çalıştı. Oysa birçok iş sizi beklemeden de ilerleyebilir. Telefondan bir hata düzeltmesi başlatıp akşam PR'ını incelemek, her PR'a otomatik inceleme yaptırmak bunlara örnek. Bu derste ajanı makinenizden ve ekrandan ayırıyoruz.

Üç yol

Bulut oturumu

Bulut oturumu, sizin makineniz yerine sağlayıcının yönettiği bir sanal makinede çalışan ajan oturumudur. Laptopunuzu kapatsanız da çalışmaya devam eder, ona her cihazdan bakabilirsiniz.¹ Claude Code'da claude.ai/code adresinden, mobil uygulamanın Code sekmesinden ya da terminalden başlatılır:¹

claude --cloud "Ürün listesindeki sayfalama hatasını düzelt, testleri çalıştır"

Sanal makine repoyu GitHub'dan klonlar, yerel klasörünüzü değil. Yerel commit'leriniz varsa önce push edin.¹ Her --cloud komutu ayrı bir oturum açar, yani birkaç işi aynı anda başlatabilirsiniz.¹ İş bitince PR açarsınız ya da claude --teleport ile oturumu branch'iyle birlikte terminalinize çekip devam edersiniz.¹

Claude Code dokümanının önerdiği akış: planı yerelde plan modunda birlikte çıkarın, bir dosyaya yazıp push edin, uygulamayı buluta verin.¹ Spec-driven geliştirme dersindeki SPEC.md tam olarak bu iş için.

PR'ı takip ettirmek: Auto-fix açık olduğunda ajan PR'daki CI hatalarını ve inceleme yorumlarını izler. Düzeltme netse kendisi push eder, yorum belirsizse size sorar.¹

Cursor'da karşılığı Cloud Agents. Web'den, mobilden, Slack'ten ya da bir PR'a @cursor yazarak başlatılır. Ajan ayrı bir branch'te çalışır ve ekran görüntüleriyle birlikte PR açar.²

GitHub'da ajan

Claude Code GitHub Actions ile ajanı reponuzun içine koyarsınız. En kolay kurulum, Claude Code'da /install-github-app komutudur. GitHub App'i kurar, anahtarı repo secret'ı olarak ekler ve workflow dosyası için bir PR hazırlar.³ Sonra herhangi bir issue veya PR yorumunda ajana iş verebilirsiniz:³

@claude CartSummary'deki TypeError'ı düzelt ve bir test ekle

Ajanı her PR'da kendiliğinden çalıştırmak için workflow'a bir prompt verirsiniz. Bu durumda ajan bahsedilmeyi beklemez.³ Her PR'da otomatik inceleme yapan workflow:³

# .github/workflows/code-review.yml
name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

--comment bulguları PR'a satır yorumu olarak yazdırır. Taslak PR'lar atlanır.³ Ajan projenin CLAUDE.md'sini okuyarak inceler. İnceleme ölçütlerinizi oraya yazın.³

Maliyet iki kalemden oluşur: GitHub Actions dakikaları ve token. claude_args içinde --max-turns ile tur sayısını, workflow'a timeout-minutes ekleyerek süreyi sınırlayın.³

Headless

claude -p ajanı sohbet açmadan tek bir komutla çalıştırır. Bir script'in, pre-commit hook'unun ya da CI adımının parçası olur:⁴

claude -p "Değişen dosyalardaki lint hatalarını düzelt" \
  --allowedTools "Edit,Bash(pnpm lint *)"

--output-format json sonucu bir script'in okuyabileceği biçimde verir. --allowedTools gözetimsiz çalışmada yalnızca izin verdiğiniz araçların kullanılmasını sağlar.⁴

Sonucu doğrulamak

Ajan ne kadar uzun gözetimsiz çalışırsa, işi bitti saymadan önceki bağımsız kontrol o kadar önemli olur.⁴ Üç kural:

1. Kontrol edilebilir bir hedef verin. Ajan çalıştırabileceği bir kontrol olmadan "bitti gibi görünüyor" noktasında durur.⁴ Test komutunu prompt'a yazın ya da Hooks ve izin modları dersindeki Stop hook'unu kullanın.

2. Kanıt isteyin. Test çıktısı, çalıştırılan komut, ekran görüntüsü. Kanıtı okumak, doğrulamayı baştan yapmaktan hızlıdır.⁴

3. Riskli işi izole edin. Simon Willison riskli işleri yerel terminal yerine bulutta, asenkron çalışan ajanlara veriyor.⁵ Ajan sizin makinenize ve anahtarlarınıza dokunamaz.

Kendin dene

• Küçük bir işi claude --cloud ile başlatın ve terminali kapatın. Telefondan oturuma baktığınızda ajan ne yapıyor?

• Bir test reposunda /install-github-app çalıştırıp bir issue'ya @claude ile küçük bir istek yazın. Sonuç yorum mu, PR mı?

• Otomatik inceleme workflow'unu açın ve kasıtlı olarak hatalı bir PR gönderin. İnceleme hatayı buluyor mu?

• claude -p ile aynı isteği bir kez --allowedTools vererek, bir kez vermeden çalıştırın. Fark ne?

Detaylı öğrenmek için

• Resmi doküman: Claude Code "Use Claude Code in the cloud"; bulut ortamları, --teleport, auto-fix ve güvenlik.¹

• Resmi doküman: Claude Code "GitHub Actions"; kurulum, örnek workflow'lar ve maliyet kontrolü.³

• Yazı: Simon Willison, "Embracing the parallel coding agent lifestyle"; yerel ve bulut ajanları hangi işlere verdiği.⁵