İçeriğe atla

Text-to-CAD: Claude Code ve Codex'e konuşarak 3B parça tasarlatmak

Parçayı düz cümleyle tarif edersin; Text-to-CAD ile kodlama ajanın (Claude Code, Codex, Cursor, Gemini, Grok Build) onu Python betiği olarak yazar, bilgisayarındaki motor betiği STEP, STL, 3MF ya da GLB dosyasına çevirir ve modeli ekranda gösterir. Aynı paket üretilebilirlik kontrolü, ölçülü teknik çizim PDF'i ve 3B yazıcı için G-code da çıkarır. Açık kaynak eklenti, ücretsiz (MIT); ajanın planı ayrı. Varsayılan olarak rastgele bir kurulum kimliğiyle etiketlenmiş kullanım istatistiği ve çökme raporu gönderir (dosya, yol, içerik ve istem yok); kapatılabilir.

Ne yapar
Tarif ettiğin parçayı 3B CAD dosyasına çevirir
Tür
Plugin (12 skill + yerel MCP sunucusu)
Yapımcı
Topluluk (earthtojake, MIT)
Çıktı
STEP, STL, 3MF, GLB, PDF çizim, G-code
Nerede
Claude Code, Codex, Cursor, Gemini, Claude Desktop
Dikkat
Telemetri varsayılan açık; Windows 11 Smart App Control engeller
Ücret
Eklenti ücretsiz; ajan planı ayrı

Text-to-CAD ne işe yarar?

Bir braket, kutu, bağlantı parçası ya da sac kesim şablonu çizmek için CAD programı öğrenmek ya da bir tasarımcıya iş vermek gerekir. Text-to-CAD bu adımı kodlama ajanına devreder: ölçüleri ve işlevi tarif edersin, ajan parçayı tasarlar ve imalata gidecek dosyayı üretir. Her değişiklik isteğinde model yeniden oluşur, ekrandaki görüntü güncellenir.

Parça bir "çizim" değil, ölçüleri değiştirilebilen bir betiktir (parametrik model): "delikleri 6 mm yap" dediğinde ajan betikte o sayıyı değiştirir, model baştan oluşur. Ajan bir görselden de başlayabilir.

Kime yarar: ürün geliştiren KOBİ'ler, 3B baskı ve imalat atölyeleri, prototip yapan mühendisler. CAD bilmeyen biri parça tarif edebilir, ama ölçüleri ve dayanımı dosyayı imalata göndermeden önce kendisi ya da bir uzman kontrol etmelidir.

Text-to-CAD nasıl çalışır?

Parçayı tarif edersinÖlçü, malzeme kalınlığı, delikler; istersen görsel
Ajan betiği yazarbuild123d ile Python (Open CASCADE çekirdeği)
Motor modeli oluştururcadgen: STEP, STL, 3MF, GLB
Görüntüleyicide görürsünAjan uygulamasında ya da tarayıcıda
Hepsi kendi bilgisayarında çalışır; model dosyaları proje klasöründe kalır.

build123d, CAD modelini Python koduyla tanımlayan açık kaynak bir kütüphane; cadgen bu eklentinin motoru. Motor her modelin işini bellekte tutar, bir düzenleme yalnız değişen kısmı yeniden oluşturur. Claude Desktop ve uygulama görünümünü destekleyen Claude Code ortamları modeli sohbette kart olarak gösterir (Claude Desktop'ta döndürülebilir); terminaldeki Claude Code tarayıcı bağlantısı verir. Gemini ve Grok Build araç sonuçlarını metin gösterdiği için görüntüleyici bağlantısı verir. Codex uygulamasında kenar çubuğunda bir CAD bölümü ve her konuşmanın yanında CAD sekmesi açılır.

Paketin içinde ne var?

Plugin 12 skill ve bir yerel MCP sunucusu (cad, cadgen motoru ve görüntüleyici) taşır; hook ve alt ajan yok.

SkillNe zaman devreye girer
CADParça ya da montaj oluşturma, düzenleme, dışa aktarma, dosya açıp inceleme
step.partsVida, rulman, motor, konnektör gibi hazır parçanın STEP dosyasını bulma
Engineering DrawingÖlçülü teknik çizim PDF'i
DXF2B profil, şablon, conta, kesim yerleşimi
DFMSac metal, CNC ve enjeksiyon için üretilebilirlik incelemesi
DfAM Check3B baskıda et kalınlığı, çıkıntı, destek hacmi, baskı yönü
G-codeOrcaSlicer ile dilimleme
Bambu LabsDosyayı Bambu Connect ya da Bambu Studio'da açma
SendCutSendSendCutSend siparişi öncesi DXF ve STEP ön kontrolü
URDF, SRDF, SDFRobot tanım dosyaları ve simülasyon dünyaları

SendCutSend ve Bambu Lab yurt dışı hizmetler; bu skill'ler sipariş vermez ya da yazıcıyı çalıştırmaz, dosyayı hazırlar ve kontrol eder. Servislerin Türkiye'ye gönderimi kendi koşullarına bağlı.

Text-to-CAD nasıl kurulur?

Önce uv kurulu olmalı (uv --version ile bak; yoksa uv'nin kendi kurulum sayfasından kur). Kurduktan sonra uygulamayı yeniden başlat: ilk açılış motoru indirir, internet bağlantısı ister. Aynı uygulamaya hem plugin'i hem ayrı skill'leri kurma; her skill iki kez görünür.

README'nin önerdiği yol: ajanına şu mesajı gönder, kurulumu kendisi yapsın.

Ajana gönder› Install text-to-cad from https://github.com/earthtojake/text-to-cad

Text-to-CAD nasıl kullanılır? Örnek istekler

Kurduktan sonra ajanla normal konuşursun; CAD işi istediğinde ilgili skill kendiliğinden devreye girer. Ölçüleri milimetreyle, malzeme kalınlığını ve deliklerin yerini açık yaz.

1. Parça tasarlat"Raf için 3 mm sacdan bir L köşebent tasarla: kollar 40 ve 60 mm, genişlik 30 mm, her kolda 5 mm çaplı iki delik. Modeli göster, sonra STEP ve STL olarak dışa aktar."Ne alırsın: proje klasöründe parçanın Python betiği; model görüntüleyicide açılır (Claude Code'da sohbet içinde kart, terminalde tarayıcı bağlantısı); dışa aktarma istediğinde STEP ve STL dosyaları klasöre yazılır.
2. Düzelt ve yeniden oluştur"Delikleri 6 mm yap ve kenarlara 2 mm pah ekle."Ajan betikteki değeri değiştirir; motor yalnız değişen kısmı yeniden oluşturur, görüntü güncellenir.
3. İmalata hazırla"Bu parçanın sac metal olarak bükülüp bükülemeyeceğini kontrol et, sonra ölçülü teknik çizimini PDF olarak çıkar."Ne alırsın: büküm, büküm boşluğu ve açınım için ölçüme dayalı bulgu raporu (her bulgunun dayandığı kural yazılı); ardından görünüşler, ölçüler, delik notları ve antetli tek bir PDF. Skill kendini bir rehberli inceleme olarak tanımlıyor, imalat sertifikası değil; tedarikçinin şartnamesi önce gelir.
4. 3B yazıcıya hazırla"Bu STL'i yazıcımın OrcaSlicer profiliyle dilimle ve G-code çıkar."OrcaSlicer kurulu olmalı. G-code skill'i yazıcıyla hiç bağlantı kurmaz; Bambu Lab yazıcıda dosya Bambu Connect'te açılır, yazıcıyı ve baskıyı sen seçersin.

Kaynak: cad, dfm, engineering-drawing, gcode ve bambu-labs SKILL.md dosyaları (v0.8.2); 29.10.2026. Örneklerin çıktısı skill tanımlarının anlattığı kadar tarif edildi.

Text-to-CAD hangi dosyaları üretir ve okur?

BiçimNe için
STEPCAD programları ve CNC/sac kesim tedarikçileri arasında standart katı model
STL, 3MF3B baskı için ağ (mesh) dosyası
GLBWeb ve görüntüleyicide gösterim
XBFcadgen'in kendi belgesi: parçalar, adlar, renkler, malzemeler, eklemler
DXF2B profil, conta, kesim yerleşimi (DXF skill'i)
G-codeDilimlenmiş, yazıcıya hazır baskı dosyası
URDF, SRDF, SDFRobot yapısı ve simülasyon dosyaları
PDFÖlçülü teknik çizim (ISO pafta)

Var olan XBF, STEP, STL, 3MF ve GLB dosyalarını görüntüleyicide açıp incelettirebilir, bir tedarikçinin STEP dosyasını modelin içine alabilirsin.

Hangi ajanlarda çalışır?

Claude CodeVarPlugin; model sohbette görüntüleyici kartı, terminalde tarayıcı bağlantısı.
CodexVarEklenti dizini ya da elle; uygulamada CAD sekmesi.
CursorVarYerel plugin klasörü; Claude Code plugin'i kuruluysa onu da okur.
Gemini CLIVarExtension olarak; görüntüleyici bağlantısı metinle gelir.
Grok BuildVarClaude plugin manifestini okur; görüntüleyici bağlantısı metinle gelir.
Claude DesktopVarYalnız MCP sunucusu (yapılandırma dosyasıyla); model sohbette kart olarak görünür.
Diğer ajanlarKısmennpx skills ile yalnız skill'ler; sunucu yok, görüntüleyici tarayıcıda.
Kodlama ajanında CADAjana konuşarak 3B parça tasarlatmak, görüntülemek ve dışa aktarmak.Terminal, Kod editörü, Masaüstü · uv kurulu; ajanın kendi planı · ayrıntı
İmalat öncesi kontrol ve çizimÜretilebilirlik kontrolü, teknik çizim PDF'i, G-code, servis ön kontrolü.Terminal, Kod editörü, Masaüstü · Aynı kurulum; G-code için OrcaSlicer, Bambu için Bambu Connect · ayrıntı

Çalışma ortamı: Python 3.11 ve üstü (komutlar uv'nin yönettiği Python 3.13'ü kullanır). Windows 11'de Smart App Control açıksa CAD çekirdeği yüklenmez; aşağıdaki sorunlar tablosuna bak.

Neye erişir, dışarıya ne gönderir?

Okur

Yolunu verdiğin her CAD dosyasını ve klasör listesini okuyabilir (genelde proje klasörü); kapsam proje klasörüyle sınırlı değil. Görüntüleyici bağlantılarını paylaşma: SECURITY.md'ye göre belirteci, gün içindeki bir bağlantıyı ya da oturum çerezini tutan herkes makinendeki CAD dosyalarını yoluyla okuyabilir. İstersen internetten step.parts parça kataloğunu ve SendCutSend sipariş rehberini okur.

Yazar

Proje klasörüne betikleri, STEP/STL/3MF/GLB dosyalarını, PDF çizimi ve G-code'u. Motorun kendi durum klasörü ve uv önbelleği de diskte yer tutar.

Telemetri
  • Varsayılan açık ve rastgele bir kurulum kimliğiyle etiketli: sürüm, işletim sistemi, ajan uygulaması, araç çağrı sayıları, sabit hata sınıfları; sunucu IP adresinden ülkeyi çıkarır
  • Dosya adı, yol, içerik ve istem gönderilmez
  • Kapatmak (README): uvx --no-config --managed-python --python 3.13 --from cadgen==0.8.2 cadgen telemetry off
Ağ

İlk açılışta PyPI'dan indirme; günde en çok bir kez sürüm kontrolü (CADGEN_UPDATE_CHECK=0 kapatır). Hazır parça aradığında arama terimlerin step.parts'a gider. Çevrimdışı da çalışır.

Gizlilik politikasına göre hizmetleri Thompson Labs LLC işletiyor; telemetri PostHog'da bir yıl tutuluyor ve IP adresi telemetriyle saklanmıyor.

Ajanın yazdığı model betikleri senin kullanıcı yetkinle çalışan Python kodudur ve motor ajanın kum havuzunun dışında çalışır; başkasından aldığın model betiğini içeriğine bakmadan çalıştırma.

Kaynak: README (Telemetry) ve SECURITY.md, v0.8.2; 29.10.2026. Bu bir güvenlik denetimi ya da sertifika değildir.

Text-to-CAD ücretsiz mi?

Evet. Eklenti ve motor açık kaynak, MIT lisanslı; resmî site "%100 açık kaynak ve ücretsiz" diyor. Ödediğin şeyler ayrı: kullandığın ajanın (Claude Code, Codex, Cursor, Gemini) aboneliği ya da API ücreti ve imalat servislerine (baskı, kesim, CNC) verdiğin sipariş. Modeli ajan yazdığı için uzun tasarım oturumları ajanın kullanım hakkından harcar.

Yapabilirsin
  • Ticari projede kullanmak
  • Kodu değiştirmek ve dağıtmak (MIT, telif bildirimi korunur)

Sık sorunlar ve çözümleri

Ne oluyorNe yapmalı
Windows 11'de "DLL load failed while importing OCP"Smart App Control imzasız modülü engelliyor. WSL altında çalıştır ya da Smart App Control'ü kapat (kapattıktan sonra geri açmak Windows'u yeniden kurmayı ister). cadgen doctor bu durumu adıyla söyler.
Claude Desktop uvx'i bulamıyorYapılandırmada uvx yerine tam yolunu yaz (which uvx çıktısı).
Her skill iki kez görünüyorAynı uygulamaya hem plugin hem skill'ler kurulu; birini kaldır.
Kurulumdan sonra araçlar yokUygulamayı yeniden başlat; ilk açılış motoru indirir ve internet ister.
Eski (0.7) proje 0.8'de çalışmıyorDepodaki 0.7 → 0.8 geçiş rehberini ajana uygulat.

Güncelleme ve kaldırma

En kolayı ajana "text-to-cad'i güncelle" demek. Kendi kurduğun kopyada yeni sürüm çıkınca görüntüleyicide mavi bir güncelleme düğmesi belirir; eklenti dizininden kurulan kopyaları mağaza günceller.

Kaldır› claude plugin uninstall text-to-cad@earthtojake claude plugin marketplace remove earthtojake

Eski cadgen sürümleri uv önbelleğinde kalır; uv cache prune siler.

Sık sorulan sorular

Text-to-CAD nedir?

Kodlama ajanına eklenen açık kaynak bir CAD eklentisi. Parçayı tarif edersin, ajan Python betiği olarak yazar, yerel motor STEP, STL, 3MF ya da GLB dosyasına çevirir ve modeli ekranda gösterir.

Text-to-CAD Claude Code'a nasıl kurulur?

uv kurulu olmalı. Sonra claude plugin marketplace add earthtojake/text-to-cad#latest ve claude plugin install text-to-cad@earthtojake komutlarını çalıştırıp Claude Code'u yeniden başlatırsın.

Text-to-CAD ücretsiz mi?

Evet, eklenti açık kaynak ve MIT lisanslı. Kullandığın ajanın aboneliği ya da API ücreti ve imalat servisleri ayrı ödenir.

Hangi dosyaları üretir?

STEP, STL, 3MF ve GLB model dosyaları, kendi XBF belgesi, DXF, ölçülü teknik çizim PDF'i ve 3B yazıcı için G-code.

CAD bilmeden kullanabilir miyim?

Parçayı tarif edebilirsin. uv kurulumu ve çoğu ajan için eklenti kurulumu terminal ister; Codex'te eklenti dizini ya da ajana kurdurma yolu var. Çıktının ölçülerini imalattan önce kontrol etmen gerekir. Üretilebilirlik kontrolü bir rehber incelemedir, sertifika değildir.

Zoo'nun Text-to-CAD'i ile aynı şey mi?

Hayır. Bu rehber earthtojake/text-to-cad açık kaynak eklentisini anlatır; aramalarda çıkan Zoo'nun aynı adlı ürünü ayrı bir hizmettir.

Verilerimi gönderiyor mu?

Model dosyaların bilgisayarında kalır. Varsayılan olarak rastgele bir kurulum kimliğiyle etiketli kullanım sayıları ve çökme raporu gider; dosya adı, yol, içerik ve istem gitmez. cadgen telemetry off komutuyla kapatılır.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Türkçe istekle model kalitesi · yayın etiketiyle (#v0.8.2) sabitlemenin README'de anlatılmaması · imalat servislerinin Türkiye'ye gönderimi (servislerin kendi koşulu) · görüntüleyici arayüzünün dili. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.