Claude Code kod ve metin yazar, görsellere bakabilir ama görsel çizemez. Ondan görsel almak için bir görsel modeli bağlarsınız. Çoğu kişinin tercihi, Google'ın Gemini görsel modeli Nano Banana'dır: Claude Code ona, prompt'unuzu kendi anahtarınızla Gemini API'ye gönderen bir MCP sunucusu ya da skill üzerinden ulaşır. Bu rehberde iki kurulumu, her görselin maliyetini, bugün bu araçların birçoğunu bozan bir model sorununu ve hiç anahtar gerektirmeyen bir yolu ele alıyoruz.
Kısa cevap: API anahtarı kurmadan hazır görseller istiyorsanız tercihiniz Orkas'taki ImageStudio olsun. Yerleşik bir görsel modeli olan bir görsel ajanıdır ve yeni hesaplar 500 ücretsiz kredi alır. Özellikle Nano Banana istiyorsanız Gemini anahtarınızı Orkas'a ekleyin; ImageStudio bu durumda Nano Banana 2.1'i kullanır. Nano Banana'yı doğrudan Claude Code içinden çağırmak için bir Nano Banana MCP sunucusu ekleyin, ancak modeli kendiniz ayarlayın: 8 Kasım 2026 itibarıyla popüler sunucular varsayılan olarak Google'ın kapattığı model ID'lerini kullanıyor.
Claude Code görsel oluşturabilir mi?
Kendi başına hayır. Anthropic'in yardım merkezine göre Claude, görsel oluşturma araçlarının yaptığı gibi fotoğraf veya illüstrasyon üretmez. SVG, HTML ve grafik kodu yazabilir; bu da simgeler, diyagramlar, basit banner'lar ve grafikler için yeterlidir. Fotoğraflar, illüstrasyonlar, ürün çekimleri ve resimsel stiller için bir görsel modeli gerekir. OpenAI'ın Codex'inde gpt-image-2 ile yerleşik görsel oluşturma var; Claude Code'da buna benzer bir şey yok.
Claude Code'un yapabildiği şey görsel dosyalarını okumaktır. Bir görsel modeli projenize bir resim kaydettikten sonra Claude onu açabilir, istediğinizle karşılaştırabilir ve prompt'u yeniden yazabilir. İkisinin birlikte kullanılmasının nedeni bu döngüdür: Claude planlar ve kontrol eder, görsel modeli çizer.
Anthropic'in eklenti pazaryerinde resmî bir Nano Banana eklentisi yok. Kullanıcılar onu üç yoldan biriyle bağlıyor ve hepsi, Google AI Studio'da oluşturduğunuz bir anahtarla Google'ın Gemini API'sini çağırıyor:
- MCP sunucusu, Claude Code'a bir görev görsel gerektirdiğinde çağırabileceği yeni bir araç kazandırır.
- Skill, talimatlar ve bazen bir betik içeren bir klasördür. Claude Code onu, isteğiniz görsellerle ilgili olduğunda ya da onu adıyla çağırdığınızda yükler.
- Google'ın Gemini CLI için nanobanana uzantısı, Gemini CLI'ye görsel komutları ekler. Bir Claude Code skill'i bu uzantıyı sizin yerinize çalıştırabilir.
Kurulumsuz: Orkas'ta ImageStudio
Orkas'a yerleşik görsel ajanı ImageStudio ile başlamanızı öneriyoruz. Ona brief'inizi, fotoğraflarınızı, logonuzu ve tam metni verin, istediğiniz sonucu tarif edin. Sosyal medya görselleri, ürün görselleri, kapaklar, posterler, infografikler, grafikler ve illüstrasyonlar hazırlar. Başlıklar, fiyatlar ve etiketler gerçek yazı olarak dizilir; böylece metin tam yazdığınız gibi çıkar. Bir fotoğrafı düzenlemek için neyin değişeceğini söyleyin, örneğin arka planı ya da ışığı; yalnızca o kısmı değiştirir. Bir görsel yeni pikseller gerektirdiğinde, yerleşik Seedream 5.5 modelini kullanır (13–23 kredi / çıktı görseli + 5 / girdi görseli). Yeniden boyutlandırma, kırpma ve metin yerleştirme gibi yerleşim işleri görsel modeli çağırmaz.
Nano Banana'yı tercih ediyorsanız Gemini anahtarınızı Orkas'a ekleyin: Ayarlar bölümünü açın, Modeller sekmesini seçin, ardından Görsel ve Görsel hizmeti ekle adımlarına geçin, Google · Nano Banana 2.1 seçeneğini seçin ve anahtarı yapıştırın. Yeni anahtar listenin en üstüne eklenir; bu yüzden ImageStudio, güncel model olan Nano Banana 2.1 ile görsel üretir. Bu görselleri Google faturalandırır, Orkas bunlar için kredi düşmez. Google'a giden bir istek başarısız olursa ImageStudio, kredi harcayan yerleşik modele geçebilir.
- Orkas'ı kurun ve giriş yapın. Yeni hesaplar yerleşik modeller için 500 ücretsiz kredi alır; yani API anahtarı olmadan başlayabilirsiniz.
- ImageStudio'yu seçin ve fotoğraflarınızı ve logonuzu ekleyin.
- Sonucu tarif edin: boyut veya platform, tam metin, neyin değişmeden kalması gerektiği ve istediğiniz dosya türü.
- Görseli inceleyin ve daha büyük bir başlık ya da farklı bir arka plan gibi odaklı değişiklikler isteyin. Varsayılan olarak her istekte tek bir yeni görsel üretir; bir tane daha üretmesi için sizin istemeniz gerekir.
Bilgisayarınıza kaydedilen PNG, JPG, WEBP, AVIF veya TIFF dosyaları alırsınız. ImageStudio katmanlı PSD veya vektör dosyası üretmez.
Denemeniz için bir istek
Ürün fotoğrafınızı ve logonuzu ekleyin, köşeli parantezlerin içini kendinize göre değiştirin ve bunu ImageStudio'ya gönderin:
[Instagram] için [bahar kampanyamız] konulu, [1080×1350] boyutunda bir gönderi hazırla.
Ana görsel olarak [ürün fotoğrafımı] kullan ve ürünü olduğu gibi koru.
Onu doğal ışıkta, [yumuşak bej bir stüdyo] arka planının önüne koy.
Bu başlığı aynen yaz: "[Bahar kampanyası — %20 indirim]".
[Logomu] sağ alt köşeye yerleştir.
PNG olarak teslim et.Görsel hazır olduğunda belirli değişiklikler isteyin, örneğin: "Başlığı büyüt ve logoyu sağ üst köşeye taşı." ImageStudio o kısmı değiştirir, gerisini korur.
Nano Banana modelleri ve maliyetleri
Nano Banana, Google'ın Gemini'deki görsel oluşturma özelliği için kullandığı addır. Aşağıda Gemini API'deki modeller ve ücretli katmanda Google'ın görsel başına liste fiyatları yer alıyor:
| Model | Model ID | Görsel başına fiyat | Notlar |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | 1K için $0.0336, 2K için $0.0504, 4K için $0.113 | En yeni model; 6 Ekim 2026'dan beri genel kullanımda. Buradan başlayın. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, yalnızca 1K | En hızlı ve en ucuzu. Birden fazla referans görsel veya adım adım düzenleme için tasarlanmadı. |
| Nano Banana Pro | gemini-3-pro-image | 1K veya 2K için $0.134, 4K için $0.24 | Karmaşık sahneler için; çizmeden önce akıl yürütür. |
| Nano Banana 2 | gemini-3.1-flash-image | 1K için $0.067, 2K için $0.101, 4K için $0.151 | Kullanımdan kaldırılıyor; Google yeni projeler için 2.1'i öneriyor. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | Orijinal model. Google onu 15 Mart 2027'de kapatıyor. |
İnsanların en çok takıldığı üç nokta:
- Görseller için ücretsiz katman yok. API anahtarıyla görsel oluşturmak için bir faturalandırma hesabı bağlar ve en az $5 ön ödeme yaparsınız. Google'ın $300'lık Cloud ücretsiz deneme kredisi Gemini API'yi kapsamaz.
- Önizleme (preview) model ID'leri artık çalışmıyor. Google, 15 Ocak 2026'da gemini-2.5-flash-image-preview modelini, 25 Haziran 2026'da ise gemini-3.1-flash-image-preview ve gemini-3-pro-image-preview modellerini kapattı. Hâlâ bunlardan birini çağıran bir araç hata verir.
- Her görselde görünmez bir SynthID filigranı bulunur. Bu, yukarıdaki tüm modeller için geçerlidir.
Fiyatlar ve ID'ler, 8 Kasım 2026 itibarıyla Google'ın fiyatlandırma sayfasından ve görsel oluşturma rehberinden alınmıştır.
Nano Banana için MCP sunucuları ve skill'ler: karşılaştırma
Claude Code için en sık karşınıza çıkacak projeler bunlar. Hepsi ücretsiz ve açık kaynak; görseller için ödemeyi Google'a yaparsınız. Kurmadan önce modeli kontrol edin:
| Proje | Ne olduğu | Varsayılan model | Neyi değiştirmeli |
|---|---|---|---|
| nanobanana-mcp-server | MCP sunucusu, uv ile çalışır | Kapatılmış bir Nano Banana 2 önizleme ID'si | NANOBANANA_MODEL değerini flash yapın; bu, orijinal Nano Banana'yı kullanır |
| nanobanana uzantısı | Google'ın Gemini CLI uzantısı | Kapatılmış bir Nano Banana 2 önizleme ID'si | NANOBANANA_MODEL değerini gemini-nano-banana-2.1 yapın |
| cc-nano-banana | Yukarıdaki uzantıyı çalıştıran Claude Code skill'i | Uzantının varsayılanı | Uzantıdakiyle aynı ayar |
| Nano-Banana-MCP | MCP sunucusu, npx ile çalışır | Koda gömülü bir Nano Banana önizleme ID'si | Bunun için bir ayar yok; proje güncellenene kadar bunu atlayın |
Her projenin kodunu 8 Kasım 2026'da kontrol ettik. Bir projeyi kurmadan önce README'yi okuyun: proje bilgisayarınızda kod çalıştırır ve prompt'larınızı ve görsellerinizi Google'a gönderir.
Nano Banana, MCP sunucusuyla Claude Code'a nasıl eklenir?
- Bir Gemini API anahtarı oluşturun: bunu Google AI Studio üzerinden yapın, ardından faturalandırmayı bağlayın ve ön ödemeli kredi ekleyin.
- uv'yi kurun; sunucuyu sizin için indirip çalıştırır.
- Sunucuyu terminalinizde ekleyin:
claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest.--transport stdiokısmını adın hemen önünde tutun; aksi hâlde Claude Code adı başka bir değişken olarak okur. - Bağlandığını kontrol edin: Claude Code'u başlatın ve
/mcpyazın. - Görseli görevin bir parçası olarak isteyin, örneğin: "Bu açılış sayfası için 16:9 bir hero görseli hazırla, public/images klasörüne kaydet, sonra aç ve neyi düzeltmem gerektiğini söyle."
Sunucu, IMAGE_OUTPUT_DIR ayarlamadığınız sürece görselleri ana dizininizdeki nanobanana-images klasörüne kaydeder. Varsayılan olarak yukarıdaki komut sunucuyu yalnızca sizin için ve yalnızca mevcut projede ekler. Tüm projelerde kullanmak için --scope user ekleyin. Sunucuyu proje kapsamıyla eklemeyin: bu, anahtarı commit edebileceğiniz bir .mcp.json dosyasına yazar.
Bu sunucuda flash ayarı orijinal Nano Banana'yı kullanır; bu, sunucunun listesinde Google'ın hâlâ sunduğu tek modeldir ve Google onu 15 Mart 2027'de kapatıyor. Nano Banana 2.1 desteği ise henüz yayımlanmamış bir pull request'te bekliyor. 2.1'i bugün kullanmak için aşağıdaki uzantı yolunu ya da Gemini anahtarınızla ImageStudio'yu kullanın.
Bunun yerine skill kullanın
Skill, kullandığınız boyutlar ve sevdiğiniz prompt yapısı gibi görsel kurallarınızı tek bir yerde tutar. En bilineni olan cc-nano-banana, Google'ın Gemini CLI uzantısı üzerinden çalışır:
- Gemini CLI'yi ve uzantıyı kurun:
npm install -g @google/gemini-cli, ardındangemini extensions install https://github.com/gemini-cli-extensions/nanobanana. - Shell profilinize iki değişken ekleyin: Gemini anahtarınızı içeren
NANOBANANA_API_KEYveNANOBANANA_MODEL=gemini-nano-banana-2.1. - Skill'i ekleyin:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - Claude Code'dan bir görsel isteyin ya da skill'i
/nano-bananaile adıyla çağırın.
Önce skill'in SKILL.md dosyasını okuyun. Bu dosya Claude'a Gemini CLI'yi --yolo bayrağıyla çalıştırmasını söyler; bu bayrak Gemini CLI'nin her eylemini sormadan onaylar. Bazı kullanıcılar ayrıca uzantının anahtarı shell'den almadığını bildiriyor. Kendi skill'inizi yazarsanız model ID'sini içine yazın, anahtarı ise skill dosyasında değil, bir ortam değişkeninde tutun.
Claude Code'u Orkas'tan çalıştırın
Orkas ile mevcut kurulumunuz arasında seçim yapmak zorunda değilsiniz.
- MCP sunucularınız ve skill'leriniz çalışmaya devam eder. Kenar çubuğunda Ajanları bağla seçeneğine tıklayın ve Claude Code'u seçin. Orkas, bilgisayarınızda kurulu kopyayı sizin oturumunuzla çalıştırır. Kendi araçlarını MCP sunucularınızın yerine koymaz, yanlarına ekler; böylece kurduğunuz Nano Banana sunucusu ve skill'ler yüklenmeye devam eder.
- Her ajan kendi işini yapsın. Sayfayı ya da uygulamayı Claude Code'a yaptırın, gereken görselleri ImageStudio'dan isteyin. ImageStudio dosyaları bilgisayarınıza kaydeder; böylece Claude Code onları projenize ekleyebilir.
Hangi yolu seçmelisiniz?
| Hedefiniz | Başlangıç noktası | Elde ettiğiniz |
|---|---|---|
| Kurulum yapmadan, metni birebir doğru sosyal medya gönderileri, ürün görselleri veya posterler | Orkas'ta ImageStudio | PNG, JPG, WEBP, AVIF veya TIFF dosyaları; yerleşik model, başlangıç için 500 ücretsiz kredi |
| Betik veya yapılandırma dosyası olmadan Nano Banana 2.1 | Gemini anahtarınızla ImageStudio | Nano Banana görselleri; Google faturalandırır, Orkas kredisi harcanmaz |
| Claude Code'dan çıkmadan, kod yazarken görseller | Modeli ayarlanmış bir Nano Banana MCP sunucusu | Bilgisayarınıza kaydedilen görseller; Google her görseli faturalandırır |
| Kendi kurallarınızla tekrarlanabilir bir görsel iş akışı | Bir Nano Banana skill'i | Kendiniz kurduğunuz, okuduğunuz ve güncellediğiniz bir skill |
| Simgeler, diyagramlar ve grafikler | Tek başına Claude Code | SVG veya grafik kodu; görsel modeline gerek yok |
Sorular
Claude Code tek başına görsel oluşturabilir mi?
Hayır. Anthropic'e göre Claude, görsel oluşturma araçlarının yaptığı gibi fotoğraf veya illüstrasyon üretmez. Claude Code SVG, HTML ve grafik kodu yazabilir, görsel dosyalarını açıp kontrol edebilir; bu yüzden Nano Banana gibi bir görsel modeliyle iyi çalışır.
Nano Banana'yı Claude Code'da ücretsiz kullanabilir miyim?
Hayır. Gemini API'nin görsel modelleri için ücretsiz katmanı yok: faturalandırmayı bağlar ve en az $5 ön ödeme yaparsınız; Google'ın $300'lık Cloud ücretsiz denemesi de bunu kapsamaz. Nano Banana 2.1'in fiyatı 1K görsel başına $0.0336'dır. Orkas'taki ImageStudio'nun yerleşik bir modeli var ve yeni hesaplar 500 ücretsiz kredi alır.
Hangi Nano Banana modelini kullanmalıyım?
En yeni model olan Nano Banana 2.1 (gemini-nano-banana-2.1) ile başlayın. En ucuz 1K görseller için Nano Banana 2 Lite'ı, karmaşık sahneler için Nano Banana Pro'yu kullanın. Sonu -preview ile biten model ID'lerinden uzak durun; Google bunları kapattı.
Nano Banana MCP sunucum neden 404 hatası veriyor?
Büyük ihtimalle Google'ın kapattığı bir modeli çağırıyor. Google, 15 Ocak 2026'da gemini-2.5-flash-image-preview modelini, 25 Haziran 2026'da ise gemini-3.1-flash-image-preview ve gemini-3-pro-image-preview modellerini kapattı. Sunucuda bunun için bir ayar varsa onu güncel bir modele ayarlayın ya da modeli seçmenize izin veren bir araca geçin.
Orkas'ta görsel oluşturmak için Gemini API anahtarına ihtiyacım var mı?
Hayır. ImageStudio yerleşik Seedream 5.5 modelini kullanır ve yeni hesaplar 500 ücretsiz kredi alır. Kendi Gemini anahtarınızı eklerseniz ImageStudio bunun yerine Nano Banana 2.1'i kullanır ve bu görselleri Google faturalandırır.
Görsel üzerinde Photoshop'ta çalışmaya devam etmek için Claude Photoshop ile Nasıl Kullanılır? yazısına göz atın. Daha fazla fikir için ImageStudio ile neler yapabileceğinize bakın. Kendi fotoğraflarınızla denemek için Orkas'ı indirin ve ImageStudio ile başlayın.