Codex'ten bir görsel istediğinizde, neden bazen gerçek bir illüstrasyon yerine düz, SVG benzeri bir çizim döndürüyor?
Bir fotoğraf ya da illüstrasyon beklerken elinize basit geometrik şekillerden oluşan bir koleksiyon geçiyor.
"Codex'in görsel üretme kapasitesi bu kadar mı?"
Ben de ilk başta böyle düşünmüştüm. "ikon" ya da "logo" gibi kelimeler kullanmanın Codex'in SVG, HTML veya CSS ile çizim yapmayı seçmesine yol açtığını, gerçek görsel üretimini devre dışı bıraktığını düşündüm.
Bu yüzden Codex'i bizzat çalıştırarak test ettim.
Codex'i Claude Code üzerinden çağırdım ve aşağıdaki Önce/Sonra sonuçlarını karşılaştırdım:
- Önce: Sadece "Basit bir kedi ikonu oluştur." istendi.
- Sonra: Görsel üretim aracı, konu, renk, doku, yasaklar ve kaydetme konumu belirtildi.
Sonuçlar şüphelerimi doğruladı.
Kısa istek, uzantısı PNG olmasına rağmen aslında rasterleştirilmiş bir SVG olan düz bir kedi ikonu döndürdü.
Öte yandan, görsel üretim aracını ve tamamlanma koşullarını açıkça belirten istek, mikrofon tutan bir kedi, mavi dairesel bir çerçeve, sarı bir arka plan ve hatta bokeh efektleri içeren zengin bir görsel üretti.
Kısacası, bu doğrulama şunu ortaya koydu:
Sadece konuyu değil, aynı zamanda bir görsel üretim modelinin kullanılmasını, SVG alternatiflerinden kaçınılmasını ve renk, doku gibi detayları da ileterek Codex'in görsel oluşturma biçimini tamamen değiştirebilirsiniz.
Bu yazıda, resmi OpenAI bilgilerine ve 13 Temmuz 2026 tarihli gerçek ölçüm sonuçlarına dayanarak Codex'te istediğiniz görselleri nasıl oluşturacağınızı derleyeceğim.
Önce Sonuç
İşte kilit noktalar:
- Codex fotoğraf ve illüstrasyon üretebilir, ancak SVG, HTML ve CSS kullanarak da görseller oluşturabilir.
- Uzantı PNG olsa bile, içerik SVG'den dönüştürülmüş bir görsel olabilir.
- Fotoğraf veya illüstrasyon istediğinizde, isteme
$imagegeneklemek görsel üretim becerisini açıkça çağırır. - Kalite farkı, istem uzunluğundan ziyade "amaç, konu, stil, kompozisyon ve kısıtlamalar"dan kaynaklanır.
- Detaylı spesifikasyonların değeri, sadece görseli süslü yapmaktan ziyade, kompozisyonu amaçlanan kullanım için daha kolay tekrarlanabilir kılmaktır.
- Tek seferde mükemmelliği hedeflemeyin; neyin değiştirileceğini ve neyin korunacağını belirterek öğeleri tek tek düzeltin.
Hemen denemek isterseniz, isteğinizin başına aşağıdaki cümleyi ekleyin:
──────── Kopyala-Yapıştır İçin ────────
Görsel üretim modelini kullanarak raster bir görsel oluşturmak için $imagegen kullan. SVG, HTML, CSS veya canvas ile değiştirme.
──────────────────────
Ancak, sadece bu tek cümle işe yaramaz. "Görselin ne için olduğunu" ve "geçer notun ne olduğunu" ileterek Codex'in nihayet görseli sizinle aynı standartlara göre kontrol etmesini sağlayabilirsiniz.
Neden Görsel Yerine SVG Çıktısı Veriyor?
Codex, özel bir görsel üretim hizmeti değildir. Kod yazar, mevcut dosyaları okur, web sitelerini düzeltir ve gerektiğinde SVG, HTML, CSS ve canvas ile çalışır. Bu büyük bir avantajdır.
Örneğin, bir web sitesinde mevcut bir SVG ikon seti varsa ve aynı çizgi kalınlığı, renk ve boyutta bir ikon daha eklemek istiyorsanız, mevcut SVG'yi düzenlemek, bir görsel üretim modeliyle PNG oluşturmaktan daha doğrudur.
Öte yandan, makaleler için başlık görselleri, fotoğraf tarzı görseller, dokulu karakterler ve reklam afişleri için kod yerine görsel üretimi daha uygundur.
Codex'teki mevcut imagegen becerisi de bu ikisi arasında ayrım yapar:
- Fotoğraflar, illüstrasyonlar, dokular, sprite'lar ve maketler gibi bitmap görseller için uygun görevlerde görsel üretimi kullanır.
- Mevcut SVG, vektör veya kod varlıklarını düzenlemenin daha iyi olduğu görevlerde bunu önceliklendirir.
Önemli olan, bu kararın sadece "ikon" veya "logo" kelimesine göre mekanik olarak alınmamasıdır.
Aynı ikon için bile iki tür kullanım vardır:
- Kullanıcı arayüzlerinde kullanılan ölçeklenebilir vektör bileşenleri.
- Sosyal medyada kullanılan, doku ve gölgelendirmeye sahip dekoratif tek görseller.
İstek belirsizse, Codex projedeki mevcut dosyalara veya çevreleyen bağlama dayanarak hangisini istediğinizi tahmin eder. Bu tahmin sizin niyetinizden saptığında, "fotoğraf istediğinizde SVG benzeri bir şey almak" olgusunu yaşarsınız.
Bu nedenle, sorunun özü "ikon kelimesinin yasak olması" değildir. İstenen çıktının formatının Codex'e iletilmemiş olmasıdır.
Resmi Bilgilerden Ne Doğrulanabilir?
Codex görsel üretiminde, benzer üç isim görünür ancak farklı anlamları vardır:
$imagegen: Codex'in görsel üretim becerisini açıkça çağırma adı.image_gen: Codex'e yerleşik görsel üretim aracının adı.gpt-image-2: API veya yedek CLI aracılığıyla doğrudan modeli belirtirken kullanılan model kimliği.- "Image 2.0" veya "GPT Image 2 eşdeğeri": Çalışma zamanındaki resmi model kimliği değil, kaliteli görseli iletmek için kullanılan terimler.
Normal görsel üretim için temel yaklaşım, beceriyi $imagegen ile çağırmak ve yerleşik image_gen aracını kullanmaktır. Bu yolda ayrı bir OPENAI_API_KEY'e ihtiyacınız yoktur.
Model kimliği olarak doğrudan gpt-image-2'yi belirtmek, API'yi veya yedek CLI'yi açıkça kullanmak içindir. Bu yol bir OPENAI_API_KEY gerektirir.
Ayrıca, etkili görsel istemleri şu ilkeleri izler:
- Amacı, konuyu, arka planı, kompozisyonu, stili ve kısıtlamaları spesifik olarak iletin.
- "Güzel" veya "şık" gibi soyut terimler yerine ışık yönü ve yerleşim gibi spesifik detayları yazın.
- Düzeltme yaparken, her seferinde bir öğeyi değiştirin ve korumak istediğiniz koşulları tekrarlayın.
- Görsel içindeki metni tırnak içine alın ve yazı tipini, rengini, boyutunu ve yerleşimini belirtin.
Bundan çıkarılacak ders, $imagegen'in beceriyi çağırmak için resmi olarak sağlanan açık bir yol olduğudur. "Onsuz kesinlikle görsel oluşturamazsınız" anlamına gelmez. Ancak, "Önce" durumumuzda, görsel üretimi yerine SVG oluşturma yolu seçildi. Rolü, otomatik yargılamaya bırakmak yerine görsel üretimi kullanma niyetini netleştirmektir.
Gerçek Önce/Sonra
İşte gerçek ölçümler. Codex'i Claude Code üzerinden çağırdım. Kullanılan Codex CLI sürümü 0.144.1'di ve bir API anahtarı eklenmeden bir ChatGPT hesabına giriş yapılarak çalıştırıldı.
Açık olmak gerekirse, bu sadece bir koşulun değiştirildiği katı bir karşılaştırmalı deney değildir. "Önce"de, ne yapmak istediğimi kısaca belirttim. "Sonra"da ise üretim aracını, depolama formatını, konuyu, rengi, kompozisyonu, yasakları ve kaliteyi belirttim.
Başka bir deyişle bu, bir başarısızlık deneyimledikten sonra isteği belirttiğinizde sonuçların ne kadar değiştiğine dair bir Önce/Sonra bakışıdır.
Önce: Sadece "Basit Bir Kedi" İstemek
Claude Code'a gönderilen ilk istek sadece şuydu:
──────── Kopyala-Yapıştır İçin ────────
Basit bir kedi ikonu oluştur
──────────────────────
Görsel üretim modelini, PNG'yi, SVG'yi, rengi, dokuyu, arka planı veya kaydetme konumunu belirtmedim.
Ve geriye gelen şu oldu:

Dosyayı incelemek şunları ortaya çıkardı:
- Dosya adı:
cat-icon.png - Biçim: PNG, RGBA
- Boyut: 1024x1024 piksel
- Renk derinliği: 16-bit
- Dosya boyutu: yaklaşık 121KB
- Görünüm: Üst üste bindirilmiş basit şekillerden oluşan düz, kahverengi tekir bir kedi yüzü.
Açık sarı dairesel bir arka plan üzerinde büyük bir kedi yüzüne sahip bir kompozisyon. İfade sevimli ve "basit bir kedi ikonu" isteğini takip ediyor.
Başka bir deyişle, Codex talimatları görmezden gelmedi. Aksine, sorun, isteğin beklediğim "bir görsel üretim modeli tarafından dokulu bitmiş illüstrasyonu" iletmek için çok kısa olmasıydı.
Aynı klasörde bir cat-icon.svg de oluşturuldu. Ayrıca, PNG meta verileri, "Cute brown tabby cat face icon" olarak svg:title ve "background," "ears," "face," "eyes," ve "collar" için svg:comment gibi SVG bileşenleri içeriyordu.
Bu, Codex'in "basit ikon"u bir vektör malzemesi talebi olarak yorumladığı, bir SVG oluşturduğu ve onu PNG'ye dönüştürdüğü anlamına gelir.
"Önce" bir başarısızlık değildi; fazla literal (gerçek anlamıyla) alındı. Sadece "basit" dediğim için Codex, düzenlenmesi kolay geometrik şekillerle basitçe yaptı.
Sonra: Üretim Yöntemini ve Nihai Görseli Düzeltme
Ardından, Codex'i Claude Code üzerinden aşağıdaki içerikle çağırdım:
──────── Kopyala-Yapıştır İçin ────────
mkdir -p ./images
codex exec -C "$(pwd)" -s workspace-write --skip-git-repo-check \
"Mikrofon tutan bir kedinin sevimli bir illüstrasyonunu oluşturmak için görsel üretim aracını (image_gen / gpt-image-2) kullan ve PNG olarak ./images/cat-mic.png yoluna kaydet. Düz ve sevimli renklendirme, yumuşak gölgeler ve vurgular, mavi dairesel bir çerçeve, #FDE68A renginde küçük yıldızlar ve bokeh içeren bir arka plan, #2563EB vurgu rengi kullan ve kedi kremden turuncuya olsun. Tek bir illüstrasyon olarak oluştur ve SVG veya HTML/CSS ile değiştirme. Metin veya filigran ekleme. Kalite yüksek."
──────────────────────
Bu, kullanılan gerçek komuttur. Ancak, image_gen ve gpt-image-2 aynı şeyin takma adları değildir. Yerleşik Codex işlevselliğini kullanıyorsanız, şu anda bunu yazmanın önerilen yolu şudur:
──────── Kopyala-Yapıştır İçin ────────
mkdir -p ./images
codex exec -C "$(pwd)" -s workspace-write --skip-git-repo-check \
'Mikrofon tutan bir kedinin sevimli bir illüstrasyonunu PNG olarak oluşturmak için yerleşik image_gen aracını kullanmak üzere $imagegen kullan. Düz ve sevimli renklendirme, yumuşak gölgeler ve vurgular, mavi dairesel bir çerçeve, #FDE68A renginde küçük yıldızlar ve bokeh içeren bir arka plan, #2563EB vurgu rengi kullan ve kedi kremden turuncuya olsun. SVG veya HTML/CSS ile değiştirme. Metin veya filigran ekleme. Tamamlandıktan sonra, oluşturulan görseli ./images/cat-mic.png yoluna kaydet. Yüksek kalitede bitir.'
──────────────────────
Tüm istemin tek tırnak içine alınmasının nedeni, $imagegen içindeki $ işaretinin bir kabuk değişkeni olarak genişletilmesini önlemek ve onu doğrudan Codex'e iletmektir.
"Önce"den farkı sadece metnin daha uzun olması değildir:
- Görsel üretim aracını açıkça belirtir
- PNG olarak kaydeder
- SVG veya HTML/CSS ile değiştirme yok
- Konu mikrofon tutan bir kedi
- Yumuşak gölgeler ve vurgularla düz, sevimli renklendirme
- Mavi dairesel bir çerçeve içerir
- Arka plan rengi #FDE68A olarak ayarlanmıştır
- Yıldızlar ve bokeh içerir
- Vurgu rengi #2563EB olarak ayarlanmıştır
- Kedi rengi krem/turuncu olarak ayarlanmıştır
- Metin veya filigran yok
- Kalite yüksek olarak ayarlanmıştır
- Kaydetme konumu
./images/cat-mic.pngolarak sabitlenmiştir
İşte oluşturulan görsel:

Gerçek dosya şu şekildeydi:
- Dosya adı:
cat-mic.png - Oluşturma yolu: Codex yerleşik görsel üretim aracı
- Biçim: PNG, RGB
- Boyut: 1254x1254 piksel
- Renk derinliği: 8-bit
- Dosya boyutu: yaklaşık 1.74MB
Görsel, kremden turuncuya kedi, mikrofon tutan, mavi dairesel çerçeve, sarı arka plan, mavi yıldızlar ve bokeh'i yansıtıyor. Kürk ve mikrofonda yumuşak gölgeler ve vurgular var ve "Önce" versiyonuna kıyasla bitmiş bir illüstrasyon olarak çok daha fazla bilgi sağlıyor. Metin veya filigran bulunmuyor.
İki Sonucu Karşılaştırarak Öğrendiklerim
Aynı PNG uzantısına rağmen içerik tamamen farklı.
Hem Önce hem de Sonra .png uzantısına sahip. Ancak, Önce SVG'den PNG'ye dönüştürülmüş bir görsel iken, Sonra doğrudan görsel üretim aracı tarafından oluşturulmuş bir raster görseldi. Sadece "PNG olarak teslim edildi" gerçeğine bakarak beklenen üretim yöntemi olup olmadığını değerlendiremezsiniz.
Önceki sonuç, istem için doğruydu.
Önce'de istediğim şey "basit bir kedi ikonu" idi. Ortaya çıkan şey gerçekten de basit bir kedi ikonuydu. Codex'in yeteneği düşük değildi; benim kelimelerim nihai görseli sınırlamamıştı.
Sonra, üretim yolunu belirtti.
Sonra'da işe yarayan şey "daha güzel yap" gibi belirsiz bir istek değildi. Görsel üretim aracının kullanımını, SVG yerine geçmeme, renk, konu, arka plan, doku ve kaydetme konumunu belirtmekti.
Kalite farkı yalnızca image_gen'e atfedilemez.
Sonra'da, üretim aracıyla birlikte konuyu, renk şemasını, gölgelendirmeyi, arka planı ve kaliteyi aynı anda değiştirdim. Bu nedenle, görsel iyileştirme, tek bir image_gen kelimesinin etkisi olarak izole edilemez. Ancak, en azından "SVG'den PNG'ye dönüştürme yolundan" kaçınma ve görsel üretim modeline geçme niyetini netleştirdi.
Sadece ne istediğinizi değil, nasıl yapılmasını istediğinizi de iletin. Bu Önce/Sonra'dan çıkarılan en büyük derstir.
$imagegen Eklemenin Amacı Nedir?
Bu sonuçlara bakıldığında, "Onsuz da PNG çıktıysa, $imagegen gereksiz mi?" diye düşünebilirsiniz.
İsteğin açıkça bir fotoğraf veya illüstrasyon olması durumunda Codex'in otomatik olarak görsel üretimini seçebileceği doğrudur. Ancak, açık olmak için üç neden vardır:
- Yol karışıklıklarını azaltın Çok sayıda mevcut SVG veya UI varlığı olan projelerde Codex, kod düzenlemenin uygun olduğuna karar verebilir. Tek bir görsele ihtiyacınız varsa, görsel üretimini açıkça belirtmek niyet sapmasını azaltır.
- Bir ekip genelinde istekleri standartlaştırın "Görsel", "ikon" ve "afiş" kelimelerinin anlamları kişiden kişiye değişiyorsa, çıktılar da değişecektir.
$imagegenve amacı ortak bir kural haline getirerek, isteği yapan kişi değişse bile aynı yolu seçmek kolaylaşır.
- Başarısızlığın nedenini izole etmek daha kolaydır Görsel üretimini açıkça belirttiyseniz ancak sonuç kötüyse, bakmanız gereken sonraki şeyler kompozisyon, stil ve kısıtlamalardır. Yol bilinmiyorsa, "görsel üretim modeli kötü", "SVG ile yapıldı" veya "istem belirsiz" olup olmadığını bilemezsiniz.
$imagegen'i görsel kalitesini artıran sihirli bir söz olarak değil, yürütme yöntemini sabitleyen bir anahtar olarak düşünün.
Kullanılabilir En Kısa İstem
İlk olarak, lütfen bu formatı kopyalayıp yapıştırın:
──────── Kopyala-Yapıştır İçin ────────
Görsel üretim modelini kullanarak aşağıdaki görseli oluşturmak için $imagegen kullan. SVG, HTML, CSS veya canvas ile değiştirme; tek bir raster görsel olarak oluştur.
Amaç: X profil fotoğrafı
Konu: Mikrofon tutan kedi
Stil: Dost canlısı, derinlik hissi olan 3D illüstrasyon
Kompozisyon: Kare, ortalanmış, daire şeklinde kırpılsa bile konu bozulmamalı
Kısıtlamalar: Metin, logo veya filigran yok
──────────────────────
Her şeyi detaylı yazmanıza gerek yok. OpenAI'in resmi kılavuzu da görsel istemleri için genellikle 1-3 cümlelik net cümlelerin yeterli olduğunu açıklar. Önemli olan uzunluk değil, başarıyı belirleyen koşulları dahil etmektir.
Görsel Kalitesini Sabitlemek İçin 5 Madde
İstem konusunda emin değilseniz, sadece bu beş şeyi yazın:
- Amaç Görselin nerede kullanılacağını yazın. Örnek: X gönderisi, profil fotoğrafı, blog başlığı, açılış sayfası kahraman görseli, ürün tanıtımı. Amacı yazdığınızda, Codex gerekli kompozisyonu ve kenar boşluklarını daha kolay değerlendirebilir.
- Konu Ne çizileceğini ve hangi durumda olduğunu yazın. Örnek: Mikrofon tutan kahverengi tekir kedi, dizüstü bilgisayarda çalışan bir kadın, masaya konmuş kahve.
- Stil İstenen dokuyu belirtin: fotoğraf, illüstrasyon veya 3D. Örnek: Doğal ışıklı gerçekçi fotoğraf, dergi tarzı editoryal illüstrasyon, yumuşak sulu boya, derinlikli 3D.
- Kompozisyon En boy oranını, konunun konumunu ve gerekli kenar boşluklarını yazın. Örnek: Yatay, kişi solda, başlık için sağda geniş kenar boşluğu bırak. Sonraki örneğimizde, "mavi dairesel çerçeve" talimatı, kedi ve mikrofonun daire içinde kalmasını sağlayan bir kompozisyonla sonuçlandı.
- Kısıtlamalar Neyin dahil edilmesini istemediğinizi ve uyulması gereken koşulları yazın. Örnek: Metin yok, logo yok, filigran yok, arka planı karmaşık yapma.
Bu beş madde ile Codex sadece "resim yapmakla" kalmaz, aynı zamanda "amaca uygun olup olmadığını" da kontrol edebilir.
Amaca Göre Kopyala-Yapıştır Örnekleri
Makale Başlık Görseli
──────── Kopyala-Yapıştır İçin ────────
Bir blog yazısı için yatay bir başlık görseli oluşturmak üzere $imagegen kullan. Ahşap bir masa üzerine yerleştirilmiş bir dizüstü bilgisayar ve kahvenin, yumuşak doğal sabah ışığında çekilmiş gerçekçi bir fotoğrafı olsun. Konuyu sola hizala ve başlık için sağda geniş bir kenar boşluğu bırak. Metin, logo veya filigran ekleme. SVG, HTML veya CSS ile değiştirme.
──────────────────────
X Gönderisi Kare Görseli
──────── Kopyala-Yapıştır İçin ────────
Bir X gönderisi için kare bir illüstrasyon oluşturmak üzere $imagegen kullan. Yapay zeka ve bir insanın aynı masada işbirliği yaparak bir plan oluşturma sahnesini dost canlısı bir editoryal illüstrasyonla ifade et. Kişiyi ve yapay zeka cihazını merkeze yerleştir; akıllı telefon zaman tünelinde görüntülendiğinde bile konunun net olduğu bir kompozisyon olsun. Ana renkler olarak mavi ve turuncu kullan ve metin, logo veya filigran ekleme.
──────────────────────
Açılış Sayfası Kahraman Görseli
──────── Kopyala-Yapıştır İçin ────────
Çevrimiçi bir iş aracının açılış sayfası için bir kahraman görseli oluşturmak üzere $imagegen kullan. Aydınlık bir ofiste küçük bir ekibin büyük bir ekrana bakarken konuştuğu doğal bir fotoğraf olsun. Yatay yönlendirme, kişiler sağa hizalanmış, başlık ve düğme için solda kenar boşluğu bırak. Aşırı derecede fütüristik ifadeler, metin, şirket logosu veya filigran ekleme.
──────────────────────
Japonca Metin İçeren Görsel
──────── Kopyala-Yapıştır İçin ────────
Bir X gönderisi için kare bir görsel oluşturmak üzere $imagegen kullan. Sadece "AIで仕事が変わる" (AI işi değiştirir) metnini üst-ortada, büyük, kalın, beyaz Gothic yazı tipiyle yerleştir. Metin tek satırda, ortalanmış olsun. Başka hiçbir metin, logo veya filigran ekleme. Arka plan koyu maviden mora bir degrade olsun, iş için sakin bir tasarıma sahip olsun.
──────────────────────
Görsele metin koyarken şu üç noktaya dikkat edin:
- Görüntülenecek metni tırnak içine alın.
- Yazı tipini, rengini, boyutunu ve konumunu belirtin.
- Başka karakter eklememesini söyleyin. Oluşturduktan sonra, yayınlamadan önce her karakteri kontrol edin.
Düzeltirken "Neyi Değiştireceğinizi" ve "Neyi Koruyacağınızı" Yazın
İlk görsel neredeyse istediğiniz gibi olduğunda, tüm istemi sıfırdan yeniden yazmanıza gerek yoktur. Aslında, aynı anda çok fazla şeyi değiştirmek beğendiğiniz kısımları da değiştirecektir. Düzeltmeleri her seferinde bir öğe yapın.
- Kompozisyonu olduğu gibi koru, ancak arka planı daha parlak yap.
- Kişiyi ve masayı koru, ancak kupayı bir ev bitkisiyle değiştir.
- Rengi ve ışığı koru, ancak sağdaki kenar boşluğunu genişlet.
- Kedinin ifadesini ve kürk rengini koru, ancak mikrofonu biraz küçült.
OpenAI'in resmi kılavuzu da düzenleme yaparken "neyin değiştirileceğini" ve "neyin korunacağını" netleştirmeyi önerir. İşte kullanılabilir bir format:
──────── Kopyala-Yapıştır İçin ────────
Lütfen ekteki görseli düzenle. Sadece arka planı değiştir. Arka planı açık gri yap. Kişiyi, kıyafeti, ifadeyi, kompozisyonu, ışığı ve renk tonunu olduğu gibi koru. Metin veya logo ekleme.
──────────────────────
"Sadece bunu değiştir. Başka hiçbir şeye dokunma." yazarak genel görselin kaymasını azaltabilirsiniz.
Her Seferinde Yazmak Zahmetliyse, Kuralları Sabitleyin
Codex'i Claude Code üzerinden çağırırken, her seferinde aynı notları girmek zahmetlidir. Bu işlemde, önce projenin CLAUDE.md dosyasına görsel üretim kurallarını koymanız önerilir. Claude Code, CLAUDE.md dosyasını okuduğu için, "görsel istendiğinde Codex'ten nasıl istekte bulunulacağını" buraya sabitlersiniz.
Codex'i doğrudan kullandığınız bir projeyse, aynı fikri AGENTS.md dosyasına koyun. AGENTS.md, Codex tarafının okuduğu bir proje kuralıdır.
──────── Kopyala-Yapıştır İçin ────────
Görsel Oluşturma Kuralları
- Fotoğraflar, illüstrasyonlar, afişler, kahraman görselleri veya sosyal medya gönderi görselleri oluştururken
$imagegenkullan. - Raster bir görsel isteniyorsa, SVG, HTML, CSS veya canvas ile değiştirme.
- Oluşturmadan önce amacı, konuyu, stili, kompozisyonu ve kısıtlamaları düzenle.
- Yalnızca mevcut bir SVG ikon setine ekleme yaparken, mevcut formata uyacak şekilde SVG'yi düzenle.
- Tamamlanan görseli proje içine kaydet ve depolama konumunu bildir. ──────────────────────
Bu kuralın amacı, SVG'yi her zaman yasaklamak değildir. Amaca göre seçim yapmaktır: UI bileşenleri için SVG, bitmiş tek bir görsel için görsel üretimi.
Bir Beceri (Skill) Yapmak Gerekli mi?
Sadece görsel oluşturmak için yeni bir Beceri oluşturmanıza gerek yok. Codex'te zaten bir imagegen becerisi var. Özel bir Beceri oluşturmak, aşağıdaki gibi prosedürleri birden çok projede standartlaştırmak istediğinizde değerli hale gelir:
- Her seferinde marka renklerini veya sanat stillerini uygulamak.
- X, makaleler veya açılış sayfaları gibi amaçlara göre kompozisyonları otomatik olarak seçmek.
- Oluşturduktan sonra metin, kenar boşluğu, boyut ve yasakları kontrol etmek.
- Dosya adlarını ve kaydetme konumlarını birleştirmek.
- Başarısız olursa, aynı standartlara göre düzeltmeler uygulamak.
Karar basittir:
- Tek bir projede kullanılan kurallar:
CLAUDE.md - Codex'in doğrudan uyması için proje kuralları:
AGENTS.md - "Oluşturma -> onaylama -> kaydetme" işlemini birden çok projede yeniden kullanmak için bir mekanizma: Özel Beceri
Baştan bir Beceri oluşturmanıza gerek yok. CLAUDE.md ile başlamak ve aynı prosedürü üç veya daha fazla kez tekrarladığınızı fark ettiğinizde bunu bir Beceri haline getirmeyi düşünmek yeterlidir.
SVG'nin Doğru Cevap Olduğu Durumlar
Görsel üretimini nasıl çağıracağınızı açıkladım, ancak SVG'nin kendisi kötü değildir. SVG aşağıdaki kullanımlar için daha uygundur:
- Mevcut bir UI ikon setine yeni bir ikon eklemek.
- Ölçeklendiğinde bile çizgileri keskin tutmak.
- CSS ile renkleri değiştirmek.
- Şekilleri ve çizgi kalınlıklarını sayısal değerlerle doğru bir şekilde yönetmek.
- Farklılıkları kod olarak incelemek.
Tersine, görsel üretimi şunlar için uygundur:
- Fotoğraf tarzı görseller.
- Kürk, kumaş veya metal gibi dokular gerektiren illüstrasyonlar.
- Reklamlar veya makaleler için dikkat çekiciler.
- Karakterler veya hikaye anlatımı içeren tek görseller.
- Atmosfer veya duygu aktaran görseller.
Kriter "SVG veya PNG" değildir. "Belirleyici olarak yönetilecek bir bileşen mi, yoksa ifade gücüne öncelik veren tek bir görsel mi?" Codex'e sormadan önce buna karar vermek, yol uyuşmazlıklarını azaltacaktır.
Bu Doğrulamayla Düzeltilen 3 Yanlış Anlama
Son olarak, gerçekten denediğim için düzeltebildiğim noktalar şunlardır.
Yanlış Anlama 1: PNG ise, görsel üretim modeliyle yapılmıştır.
Bu seferki ilk görsel bir PNG idi, ancak meta veriler SVG başlıkları ve bileşenleri içeriyordu. Görünümü de basit şekillerin bir kombinasyonuydu ve SVG'den PNG'ye dönüştürülmüş bir görsel olduğu yargısına varıldı. Kontrol etmeniz gereken sadece uzantı değil, hangi yoldan oluşturulduğu ve gerçek görünümüdür.
Yanlış Anlama 2: `$imagegen` eklemek görsel kalitesini artıracaktır.
Bu seferki "Sonra", "Önce"ye göre çok daha bilgilendirici bir görünüme sahipti. Ancak, aynı anda mikrofonu, renk şemasını, gölgelendirmeyi, arka planı, kompozisyonu ve kaliteyi de belirttim. Görsel üretim aracını açıkça belirtmek üretim yolunu sabitler, ancak tek başına beğeninize göre bir sonuç garanti etmez. Ayrıca, görünümü belirleyen ve amaca uygun olup olmadığını değerlendirmek için geçer not koşullarını belirleyen koşullara da ihtiyacınız vardır.
Yanlış Anlama 3: İstem ne kadar uzunsa o kadar iyidir.
"Sonra"nın daha iyi olmasının nedeni kelime sayısının artması değildi. Bunun nedeni, sonucu belirleyen koşulları içermesiydi: görsel üretim aracı, SVG yasağı, konu, renk şeması, arka plan, doku ve kaydetme konumu. Uzunluğu değil, yargı için gerekli koşulları yazın.
Özet
Codex basit bir görsel döndürdüğünde, ilk şüpheleneceğiniz şey görsel üretim modelinin performansı olmamalıdır. Niyetinizin iletilip iletilmediğini kontrol edin: kod için bir vektör bileşeni mi yoksa bir fotoğraf veya illüstrasyon olarak bitmiş tek bir görsel mi istiyorsunuz?
Tek bir görsel istiyorsanız, önce şu cümleyi ekleyin:
──────── Kopyala-Yapıştır İçin ────────
Görsel üretim modelini kullanarak raster bir görsel oluşturmak için $imagegen kullan. SVG, HTML, CSS veya canvas ile değiştirme.
──────────────────────
Bunun üzerine amacı, konuyu, stili, kompozisyonu ve kısıtlamaları yazın.
Bu gerçek ölçümde, Claude Code'dan yalnızca "basit bir kedi simgesi" istediğimde, Codex bunu bir vektör malzemesi talebi olarak yorumladı ve SVG'den türetilmiş düz bir PNG oluşturdu. Öte yandan, $imagegen ile görsel oluşturma becerisini çağırarak, yerleşik image_gen aracını kullanarak, SVG ile değiştirmeden ve konuyu, renk şemasını, dokuyu, arka planı ve kaliteyi belirterek, bu belirtimleri yansıtan bitmiş bir illüstrasyon oluşturmak daha kolay hale geliyor.
Görsel kalitesini belirleyen şey, istemin uzunluğu değildir. Ne yapılacağının yanı sıra, ne için olduğunu ve hangi durumun geçer not sayılacağını da paylaşıp paylaşmadığınızdır. Bunu bu kadar detaylı ilettiğinizde, Codex yalnızca bir görsel oluşturucu olmaktan çıkar; amaca göre görseller oluşturan ve kontrol eden bir üretim ortağına dönüşür.
Başlamak için, olağan görsel taleplerinize bir "amaç" ve bir "geçer not koşulu" eklemeyi deneyin. Bu bile sizi, şans eseri isabet bekleyen görsel oluşturmaktan, istenen sonuçları tekrar üreten bir görsel üretimine yaklaştıracaktır.
Referanslar:





