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?
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.
| Skill | Ne zaman devreye girer |
|---|---|
| CAD | Parça ya da montaj oluşturma, düzenleme, dışa aktarma, dosya açıp inceleme |
| step.parts | Vida, rulman, motor, konnektör gibi hazır parçanın STEP dosyasını bulma |
| Engineering Drawing | Ölçülü teknik çizim PDF'i |
| DXF | 2B profil, şablon, conta, kesim yerleşimi |
| DFM | Sac metal, CNC ve enjeksiyon için üretilebilirlik incelemesi |
| DfAM Check | 3B baskıda et kalınlığı, çıkıntı, destek hacmi, baskı yönü |
| G-code | OrcaSlicer ile dilimleme |
| Bambu Labs | Dosyayı Bambu Connect ya da Bambu Studio'da açma |
| SendCutSend | SendCutSend siparişi öncesi DXF ve STEP ön kontrolü |
| URDF, SRDF, SDF | Robot 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.
› Install text-to-cad from https://github.com/earthtojake/text-to-cad› claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojakeREADME komutu latest dalını kurar; yayın etiketiyle sabitlemek README'de anlatılmıyor. Claude Code'un depo#ref biçimiyle #latest yerine #v0.8.2 yazarak sürümü sabitleyebilirsin. Güncellemek için claude plugin marketplace update earthtojake ve claude plugin update text-to-cad@earthtojake, sonra Claude Code'u yeniden başlat.
Codex eklenti dizininde text-to-cad sayfasından "Open in desktop app". Elle kurmak için:
› codex plugin marketplace add earthtojake/text-to-cad --ref latest
codex plugin add text-to-cad@earthtojakeCursor, Claude Code için kurulan plugin'i de yükler; o kuruluysa bu adımı atla.
› git clone --depth 1 --branch latest https://github.com/earthtojake/text-to-cad ~/.cursor/plugins/local/text-to-cadKlonladıktan sonra Cursor'u yeniden başlat. Ekipler depoyu Dashboard › "Plugins & MCPs" › "Team Marketplaces" altından içe aktarabilir.
› gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update--auto-update eklentiyi kendiliğinden günceller; --consent güvenlik sorusunu onaylar.
Settings sonra Developer sonra Edit Config ile yapılandırma dosyasına sunucuyu ekle, uygulamayı yeniden başlat. uvx bulunamazsa tam yolunu yaz.
› {
"mcpServers": {
"cad": {
"command": "uvx",
"args": ["--no-config", "--managed-python", "--python", "3.13", "--from", "cadgen==0.8.2", "cadgen", "mcp"],
"env": {"CADGEN_INSTALL_CHANNEL": "claude-desktop"}
}
}
}› npx skills add earthtojake/text-to-cad#latestPlugin desteği olmayan ajanlar için. Bu yolda CAD sunucusu yok; modeller tarayıcıdaki görüntüleyicide açılır.
Grok Build, Claude Code için kurulan plugin'i de yükler; o kuruluysa bu adımı atla.
› grok plugin install earthtojake/text-to-cad@latest --trust
grok plugin enable text-to-cadGrok araç sonuçlarını metin olarak gösterdiği için model istendiğinde görüntüleyici bağlantısı verir.
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.
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çim | Ne için |
|---|---|
| STEP | CAD programları ve CNC/sac kesim tedarikçileri arasında standart katı model |
| STL, 3MF | 3B baskı için ağ (mesh) dosyası |
| GLB | Web ve görüntüleyicide gösterim |
| XBF | cadgen'in kendi belgesi: parçalar, adlar, renkler, malzemeler, eklemler |
| DXF | 2B profil, conta, kesim yerleşimi (DXF skill'i) |
| G-code | Dilimlenmiş, yazıcıya hazır baskı dosyası |
| URDF, SRDF, SDF | Robot yapısı ve simülasyon dosyaları |
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 CodeVar | Plugin; model sohbette görüntüleyici kartı, terminalde tarayıcı bağlantısı. |
|---|---|
| CodexVar | Eklenti dizini ya da elle; uygulamada CAD sekmesi. |
| CursorVar | Yerel plugin klasörü; Claude Code plugin'i kuruluysa onu da okur. |
| Gemini CLIVar | Extension olarak; görüntüleyici bağlantısı metinle gelir. |
| Grok BuildVar | Claude plugin manifestini okur; görüntüleyici bağlantısı metinle gelir. |
| Claude DesktopVar | Yalnız MCP sunucusu (yapılandırma dosyasıyla); model sohbette kart olarak görünür. |
| Diğer ajanlarKısmen | npx skills ile yalnız skill'ler; sunucu yok, görüntüleyici tarayıcıda. |
Ç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?
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.
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.
- 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
İ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.
- Ticari projede kullanmak
- Kodu değiştirmek ve dağıtmak (MIT, telif bildirimi korunur)
Sık sorunlar ve çözümleri
| Ne oluyor | Ne 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ıyor | Yapılandırmada uvx yerine tam yolunu yaz (which uvx çıktısı). |
| Her skill iki kez görünüyor | Aynı uygulamaya hem plugin hem skill'ler kurulu; birini kaldır. |
| Kurulumdan sonra araçlar yok | Uygulamayı yeniden başlat; ilk açılış motoru indirir ve internet ister. |
| Eski (0.7) proje 0.8'de çalışmıyor | Depodaki 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.
› claude plugin uninstall text-to-cad@earthtojake
claude plugin marketplace remove earthtojake› codex plugin remove text-to-cad@earthtojake
codex plugin marketplace remove earthtojake› gemini extensions uninstall text-to-cadEski 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
- text-to-cad GitHub deposu ve README
- texttocad.dev
- plugin.json (v0.8.2)
- cad SKILL.md
- dfm SKILL.md
- engineering-drawing SKILL.md
- SECURITY.md
- PyPI: cadgen
- Gizlilik politikası
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ı.




