AWS Agent Toolkit, Claude Code'a özenle hazırlanmış AWS becerileri ve canlı API erişimi sunuyor

Toolkit'in gerçekte ne kurduğu

dev.to'da yayınlanan, bir serinin ilk bölümü olan uygulamalı inceleme, Claude Code içinde AWS'nin Agent Toolkit'ini adım adım ele alıyor ve net bir çerçeveye ulaşıyor: toolkit, bir kodlama agent'ına normalde sahip olmadığı iki şey veriyor — özenle doğrulanmış AWS bilgisi ve AWS servislerini gerçekten çağırma yolu. Kurulum tek komutluktır, ancak makineye inen şey birbirinden bağımsız iki parçadır.

Gönderiye göre ilk parça Agent Skills: servis seçimi, test edilmiş prosedürler ve sorun giderme konusunda özenle hazırlanmış rehberlik, diskte dosyalar olarak tutuluyor. Her beceri bir SKILL.md ve genellikle bir references klasörü içeren bir dizin, ve tüm set AWS'nin agent-toolkit-for-aws deposunda Apache-2.0 lisansıyla açık kaynak olduğundan herhangi bir kuruldan önce okunabiliyor. İkinci parça ise AWS MCP Server — AWS tarafından yönetilen, yerel bir proxy üzerinden erişilen — agent'ın AWS API'lerini çağırmasına ve güncel dokümantasyonu aramasına imkân tanıyor. Parçalar birbirini gerektirmiyor.

İki tasarım detayı öne çıkıyor. Beceri açıklamaları bir becerinin neleri kapsadığı kadar neleri kapsamadığını da belirtiyor — aws-storage becerisi SQL sorgu motorlarını, ETL, streaming ve yönetilen veritabanlarını dışlıyor — bu da ilgisiz becerilerin context'e çekilmesini önlüyor. Beceri gövdeleri ayrıca davranışsal kurallar taşıyor: rakamları ezbere söylemek yerine güncel olanı doğrula, her maliyet iddiası için fiyatlandırma sayfasını kaynak göster ve doğrulanamayan her rakamı tahmin etmek yerine adıyla an. Kurallar bir kontrol etme yükümlülüğü yaratıyor; server'ın dokümantasyon araçları da agent'a bu yükümlülüğü karşılama yolunu veriyor.

Kurulum ve içindeki tuzaklar

Kurulum komutu aws configure agent-toolkit --region us-east-1 ve region bayrağı resmi örneklerin ima ettiğinden daha önemli. Toolkit yalnızca us-east-1'den sunuluyor. Yazarın varsayılan bölgesi us-west-2'ydi ve bayrak olmadan sihirbaz agent tespiti ve seçim ekranından geçti, ardından becerileri çekerken hata verdi.

Ön koşullar AWS CLI 2.35.0 veya üzeri (kendi kendini güncelleme yok; yükseltme için paketin yeniden kurulması gerekiyor), Claude Code için Node v22+ ve uv. Sonuncusu sessiz tuzak: dev.to yazarı, kurulum çıktısının uv'dan hiç bahsetmediğini, ancak MCP proxy'sinin uvx üzerinden çalıştığını ve uv olmadan server'ın bağlanmadığını bildiriyor.

Sihirbaz kurulu agent'ları tespit ediyor — çalıştırmada Claude Code, Codex, Cursor ve Kiro görüldü — ve IaC, çekirdek servisler, veritabanları, networking, storage, güvenlik, observability, mesajlaşma, SDK'lar ve maliyet yönetimini kapsayan 23 varsayılan beceriyi, symlink yerine agent başına tam kopyalar olarak kuruyor. Varsayılanların ötesinde daha ince ayrıştırılmış beceriler de var: aws agent-toolkit search-skills ile arama, erişim desenleri, partition key ve GSI seçimi, tek tabloya karşı çok tablolu tasarım ve maliyet tahminini kapsayan bir amazon-dynamodb becerisi ortaya çıkardı — alan düzeyindeki aws-database becerisinin sunduğundan daha fazla derinlik.

Doğrulama çalışması ve kırıldığı yer

Agent yeniden başlatıldıktan sonra Claude Code'da /mcp, sekiz araçla birlikte bağlı durumdaki aws-mcp'yi bildirdi. Sessiz bir hata modu: bir projede ilk çalıştırmada Claude Code MCP server'ın etkinleştirilip etkinleştirilmeyeceğini soruyor ve Escape'e basmak bunu reddediyor — server bu durumda başka bir soru sorulmadan devre dışı kalıyor.

Okuma yolu testi, servise göre gruplandırılmış Temmuz 2026 faturalandırma detaylarını istedi; sıralama ve toplama script içinde yapıldı. Agent aws___run_script aracına uzandı ve çalıştırmadan önce script'in tamamını görüntüledi, aritmetik gerçekten modelin cevabında değil script içinde çalıştı. Script yine de başarısız oldu: call_boto3'ün api_calls ve return_value alanlarını içeren bir wrapper döndürdüğünü varsaydı, ancak bu alanların hiçbiri yok; dolayısıyla kendi assertion'ı asla geçemiyordu.

Neden önemli

Agent odaklı bulut çalışması bu toolkit'in her iki yarısına da ihtiyaç duyuyor: güncelliğini koruyan bilgi ve gerçek olan erişim. İkisini eşleştirmek, agent'ları rakamları hatırlamak yerine doğrulamaya iten kurallarla birlikte, agent'lar bulut servislerinden bahsederken en yaygın hata modunu hedefliyor — kendinden emin, bayat rakamlar. Becerilerin açık kaynak yapılması da seçkisinin incelenebilir olmasını sağlıyor; bu da gerçek bir hesap üzerinde çalışan bir agent'a ne kadar güveneceklerine karar veren ekipler için önemli.

Kaba kenarlar da aynı derecede öğretici. Belgelenmemiş bir bağımlılık, örneklerin göz ardı ettiği tek bölge kısıtı ve kendi araçları hakkındaki yanlış bir varsayımla başarısız olan ilk doğrulama scripti, üretilen AWS script'lerinin çalıştırılmadan önce yine de onları okuyan bir insana ihtiyaç duyduğunun hatırlatıcısı.