<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Alper Salik on Medium]]></title>
        <description><![CDATA[Stories by Alper Salik on Medium]]></description>
        <link>https://medium.com/@alper-salik?source=rss-2ede948bfcad------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*aDH-kd89FHn6KOuVDMYRXg.jpeg</url>
            <title>Stories by Alper Salik on Medium</title>
            <link>https://medium.com/@alper-salik?source=rss-2ede948bfcad------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 03:52:00 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@alper-salik/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[️ Claude Code Notlarım]]></title>
            <link>https://medium.com/icommunity/%EF%B8%8F-claude-code-notlar%C4%B1m-511922511172?source=rss-2ede948bfcad------2</link>
            <guid isPermaLink="false">https://medium.com/p/511922511172</guid>
            <category><![CDATA[skills]]></category>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[claude-code]]></category>
            <category><![CDATA[ai]]></category>
            <dc:creator><![CDATA[Alper Salik]]></dc:creator>
            <pubDate>Mon, 29 Jun 2026 17:02:49 GMT</pubDate>
            <atom:updated>2026-06-29T17:02:49.533Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gCX0MVH7pReCZUghW4GgDw.png" /></figure><p>Merhaba ben Alper. Bu Medium’daki ilk yazım. Yazıdan ziyade Claude Code’u öğrenmeye çalışırken dokümantasyonlarından ve izlediğim birkaç videodan aldığım notların toplamı. Biraz kendi anlayacağım dilde bir araya getirmiş olabilirim karmaşık gelirse kusura bakmayın. Bu notları bir Notion dokümanı olarak birleştirmiştim ve sonrasında Medium’da neden paylaşmıyorum dedim. Notion’dan Medium dönüştürürken de yine Claude’dan yardım aldım. Medium yazı formatı Notion’a göre daha basit kaldığı için daha iyi bir görsellikle oradan da okuyabilirsin:</p><p><a href="https://even-apparel-388.notion.site/Claude-Code-Notlar-30fd5b726dda807084f7cc888d12a850?pvs=74">https://even-apparel-388.notion.site/Claude-Code-Notlar-30fd5b726dda807084f7cc888d12a850?pvs=74</a></p><h3>Giriş Bilgileri</h3><ul><li>Claude Code, özellikler oluşturmanıza, hataları düzeltmenize ve geliştirme görevlerini otomatikleştirmenize yardımcı olan yapay zeka destekli bir kodlama asistanıdır.</li><li>Claude Code’u terminal CLI üzerinden, VS Code eklentisi üzerinden, masaüstü uygulaması üzerinden veya web üzerinden kullanabiliyorsunuz. Gerekli kurulumları yaptıktan sonra <a href="https://claude.com/pricing">Claude aboneliği</a> veya <a href="https://console.anthropic.com/">Anthropic Console</a> hesabı ile giriş yapmak gerekiyor.</li><li>Homebrew veya WinGet ile kurduysan oto güncelleme yapmıyormuş. Homebrew için <strong>brew upgrade claude-code</strong>, WinGet için <strong>winget upgrade Anthropic.ClaudeCode</strong> periyodik olarak çalıştırarak güncel tutulabilir.</li><li>Terminalde <strong>claude</strong> komutuyla interaktif bir oturum başlattıktan sonra <strong>/login</strong> ile giriş yapılıyor.</li><li>Herhangi bir proje dizininde terminalinizi açın ve Claude Code’u başlatın. Sonrasında bir soru komutu sorarak codebase’i anlamakla başlayabilirsiniz.</li></ul><pre>cd /proje/yolunuz<br>claude<br>bu proje ne yapıyor?</pre><ul><li>Claude’a kendi yetenekleri hakkında da soru sorabilir veya basit bir görev vererek kodlama yapmasını sağlayabilirsiniz. Değişiklik yapmadan önce Claude’un kodunuzu anlamasına izin verin.</li></ul><pre>Claude Code ne yapabilir?<br>Ana dosyaya bir hello world fonksiyonu ekle</pre><ul><li><strong>/help</strong> yazınca mevcut komutları gösteriyor.</li><li><strong>/clear</strong> yazınca konuşma geçmişini temizliyor.</li><li><strong>/resume</strong> yazınca o projedeki tüm session geçmişini gösteriyor.</li><li><strong>/exit</strong> yazınca konuşmayı sonlandırıyor.</li><li><strong>/compact</strong>: Uzun bir kodlama seansı sırasında Claude ile yaptığınız tüm konuşma geçmişi birikerek token limitine yaklaşabilir. /compact komutu: Mevcut konuşma geçmişinin tamamını siler ama tamamen unutmak yerine, konuşmanın önemli noktalarını içeren bir özet oluşturur. Bu özeti bağlamda (context) tutar. Bu sayede hem token kullanımınızı azaltırsınız hem de Claude’un daha önce neler yaptığınızı hatırlamasını sağlarsınız.</li><li>Komutların tam listesine şuradan bakılabilir: <a href="https://code.claude.com/docs/en/cli-reference">https://code.claude.com/docs/en/cli-reference</a></li><li><strong>Shift+Tab</strong> tuşuna basınca <strong>Planning Mode</strong> açılıyor. Claude Code&#39;a birden fazla dosyada, geniş kapsamlı ama tek tek bakıldığında çok karmaşık olmayan değişiklikler yaptıracağınız zaman çok faydalıdır. Planning modunda Claude analiz yapar ve planlar ama siz onaylayana kadar hiçbir değişiklik yapmaz.</li><li>İki kere <strong>esc</strong> tuşuna basınca chat session içindeki geçmişi gösteriyor.</li><li>Claude code eklentisinde <strong>!</strong> işaretini kullanarak normal terminal komutlarını çalıştırabilirsiniz. Zaten eklenti de aslında bir terminal açıyor.</li></ul><blockquote><em>💡 Mesajlaşmayı uzatmadan yani context bağlamından uzaklaştırmadan mesajlaşmayı bitirip yeni mesajlaşmayı başlatmak gerekiyor.</em></blockquote><ul><li>Claude Code’da pluginler 3 farklı scope’ta eklenebiliyor: <strong>project scope</strong>: projeye eklenir, remote’a push edilir, ekipte herkes kullanır; <strong>local scope</strong>: sadece sen bu projede kullanırsın; <strong>user scope</strong>: bilgisayardaki her projede kullanılır.</li></ul><h3>Best Practices</h3><ul><li>Claude Code, agentic bir kodlama ortamıdır. Kodu kendiniz yazıp Claude’dan incelemesini istemek yerine, ne istediğinizi tarif edersiniz ve Claude dosyalarınızı okuyabilir, komutlar çalıştırabilir, değişiklikler yapabilir ve siz izlerken, yönlendirirken veya tamamen uzaklaşırken sorunlar üzerinde otonom olarak çalışabilir. Claude keşfeder, planlar ve uygular.</li></ul><blockquote><em>💡 </em><strong><em>İpucu:</em></strong><em> Claude’un kendini kontrol edebilmesi için testler, ekran görüntüleri veya beklenen çıktılar ekleyin. Bu, yapabileceğiniz en yüksek kaldıraç etkisine sahip şeydir.</em></blockquote><ul><li>Claude’un doğrudan kodlamaya geçmesine izin vermek, yanlış problemi çözen kod üretebilir. Keşfi yürütmeden ayırmak için <strong>Plan Mode</strong> kullanın. Claude’dan ayrıntılı bir uygulama planı oluşturmasını isteyin. Claude ilerlemeden önce planı metin editörünüzde doğrudan düzenlemek için <strong>Ctrl+G</strong> tuşuna basın. Normal Mode&#39;a geri dönün ve Claude&#39;un planına göre doğrulama yaparak kodlamasına izin verin.</li></ul><blockquote><em>💡 </em><strong><em>İpucu:</em></strong><em> Dosyalara referans vermek için </em><em>@ kullanın, ekran görüntüleri/görseller yapıştırın veya verileri doğrudan pipe&#39;layın.</em></blockquote><ul><li>Claude niyeti çıkarabilir, ancak zihninizi okuyamaz. Belirli dosyalara referans verin, kısıtlamaları belirtin ve örnek kalıplara işaret edin.</li></ul><blockquote><em>💡 UI değişiklikleri Claude Chrome uzantısı kullanılarak doğrulanabilir. Tarayıcınızda yeni sekmeler açar, UI’ı test eder ve kod çalışana kadar yineler.</em></blockquote><ul><li>Mevcut proje yapınıza dayalı bir başlangıç <strong>CLAUDE.md</strong> dosyası oluşturmak için <strong>/init</strong> çalıştırın, bu komut, build sistemlerini, test framework&#39;lerini ve kod kalıplarını algılamak için codebase&#39;inizi analiz eder ve iyileştirmeniz için sağlam bir temel sağlar. CLAUDE.md, Claude&#39;un her konuşmanın başında okuduğu özel bir dosyadır, zamanla iyileştirin. CLAUDE.md her oturumda yüklenir, bu nedenle yalnızca genel olarak geçerli şeyleri ekleyin.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/723/1*M0bFcFPALxEpR3ks5Cq2ww.png" /></figure><ul><li><strong>Auto memory</strong>, Claude’un çalışırken öğrenmeleri, kalıpları ve içgörüleri kaydettiği kalıcı bir dizindir. Claude için yazdığınız talimatları içeren CLAUDE.md dosyalarından farklı olarak, auto memory Claude’un oturumlar sırasında keşfettiklerine dayanan kendi kendine yazdığı notları içerir. Auto memory’yi devre dışı bırakmak için <strong>autoMemoryEnabled</strong> kullanabilirsiniz ve <strong>/memory</strong> komutunu kullanarak herhangi bir memory dosyasını düzenleyebilirsiniz.</li><li>Daha büyük projeler için <strong>.claude/rules/</strong> dizinini kullanarak talimatları birden fazla dosyaya organize edebilirsiniz. Bu, ekiplerin büyük bir CLAUDE.md yerine odaklanmış, iyi düzenlenmiş kural dosyaları tutmasına olanak tanır.</li></ul><pre>projeniz/<br>├── .claude/<br>│   ├── CLAUDE.md           # Ana proje talimatları<br>│   └── rules/<br>│       ├── code-style.md   # Kod stili yönergeleri<br>│       ├── testing.md      # Test kuralları<br>│       └── security.md     # Güvenlik gereksinimleri</pre><ul><li>Kurallar, <strong>paths</strong> alanıyla YAML frontmatter kullanılarak belirli dosyalara kapsamlandırılabilir.</li></ul><pre>---<br>paths:<br>  - &quot;src/api/**/*.ts&quot;<br>  - &quot;lib/**/*.ts&quot;<br>  - &quot;src/**/*.{ts,tsx}&quot;<br>---<br># API Geliştirme Kuralları<br>- Tüm API endpoint&#39;leri girdi doğrulama içermelidir<br>- Standart hata yanıt formatını kullanın<br>- OpenAPI dokümantasyon yorumları ekleyin</pre><blockquote><em>💡 </em><strong><em>.claude/rules/ için en iyi uygulamalar:</em></strong></blockquote><blockquote><strong>Kuralları odaklı tutun</strong>: Her dosya tek bir konuyu kapsamalıdır (ör. testing.md, api-design.md)</blockquote><blockquote><strong>Açıklayıcı dosya adları kullanın</strong>: Dosya adı kuralların neyi kapsadığını belirtmelidir.</blockquote><blockquote><strong>Koşullu kuralları idareli kullanın</strong>: <strong>paths</strong> frontmatter&#39;ı yalnızca kurallar gerçekten belirli dosya türlerine uygulandığında ekleyin.</blockquote><blockquote><strong>Alt dizinlerle organize edin</strong>: İlgili kuralları gruplayın (ör. frontend/, backend/)</blockquote><ul><li>GitHub actionlara da claude eklenebiliyor. Pr’ları review edebiliyor ve hatta açılan issue’ya göre kodda değişiklik yapıp pr açabiliyor.</li></ul><blockquote><strong>Bazı işe yarar kaynaklar:</strong></blockquote><blockquote><a href="https://file.notion.com/f/f/37df588a-62ff-4327-8ca8-4a8441c8f859/ba54df43-f410-41cd-bace-57de94d79107/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?table=block&amp;id=30fd5b72-6dda-8019-808d-ddd94e7299bc&amp;spaceId=37df588a-62ff-4327-8ca8-4a8441c8f859&amp;expirationTimestamp=1781942400000&amp;signature=UL5CfPxX5V0j0DeLBdmBJjn3MPzEbEDSM3teHKot_QM&amp;downloadName=The-Complete-Guide-to-Building-Skill-for-Claude.pdf">📎 <em>The Complete Guide to Building Skill for Claude.pdf</em></a></blockquote><blockquote>Skill, mcp, agents, hooks gibi tüm özelliklere hızlı bakış için: <a href="https://code.claude.com/docs/en/features-overview">https://code.claude.com/docs/en/features-overview</a></blockquote><blockquote><a href="https://www.aitmpl.com/skills">https://www.aitmpl.com/skills</a></blockquote><ul><li>Claude Code’u daha genişletilmiş özelliklerle kullanmak için <strong>MCP Servers</strong> bağlayın, <strong>HOOKS</strong> kurun, <strong>SKILLS</strong> oluşturun. Özel <strong>SUBAGENTS</strong> oluşturun ve <strong>AGENT TEAMS</strong> kullanın. Tüm bunları marketplace üzerinden indirebileceğiniz <strong>PLUGINS</strong> ekleyin.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n88HuLHBdkZqXOuXBw-u8Q.png" /></figure><h3>Plugins</h3><ul><li><strong>Plugins</strong>, claude code marketplace üzerinden indirilebilen veya kendinizin oluşturup kullanabildiği daha önceden hazırlanmış çeşitli skill, mcp ve hooklara deniyor. <strong>Marketplace</strong> başkalarının oluşturup paylaştığı eklentilerin bir kataloğudur.</li><li>Marketplace kullanmak iki adımlı bir süreçtir. Hem marketplace ekleyebilirsin hem de o marketplace’teki pluginleri indirebilirsin. Bunu bir uygulama mağazası eklemek gibi düşünebilirsiniz: mağazayı eklemek koleksiyonuna erişmenizi sağlar, ancak hangi uygulamaları indireceğinize yine siz karar verirsiniz. Ayrıca kendin de bir marketplace yaratabilirsin. Resmi marketplace eklenti yüklemek için:</li></ul><pre>/plugin install plugin-name@claude-plugins-official</pre><ul><li>Bazı programlama dilleri için code intelligence plugins’leri de indirebiliyormuşuz.</li><li>MCP sunucuları ve development workflows için komutlar ve agentlar ekleyebiliyoruz.</li></ul><pre>Source control: github, gitlab<br>Project management: atlassian (Jira/Confluence),<br>asana, linear, notion<br>Design: figma<br>Infrastructure: vercel, firebase, supabase<br>Communication: slack<br>Monitoring: sentry<br>commit-commands: Git commit workflows including commit, push, and PR creation<br>pr-review-toolkit: Specialized agents for reviewing pull requests<br>agent-sdk-dev: Tools for building with the Claude Agent SDK<br>plugin-dev: Toolkit for creating your own plugins</pre><ul><li>Farklı kaynaklardan pazaryerleri eklemek için /plugin marketplace add komutunu kullanın. Anthropic&#39;in kendi marketplace&#39;i olan antropics/claude-code&#39;u da kendimiz ekliyoruz:</li></ul><pre>/plugin marketplace add anthropics/claude-code</pre><ul><li>/plugin komutunu çalıştırarak eklenti yöneticisini açarak eklenenleri, marketplace’leri ve eklenebilecekleri görebiliyoruz. İndirirken bize hangi seviyede indirebileceğimizi de soruyor.</li></ul><pre>User scope: install for yourself across<br>all projects<br>Project scope: install for all collaborators<br>on this repository<br>Local scope: install for yourself in this<br>repository only</pre><ul><li>Örneğin <strong>commit-commands</strong> eklentisini indirdik. Bunu kullanmak için <strong>/commit-commands:commit</strong> komutunu kullanıyoruz. Bu komut değişikliklerinizi hazırlar, bir commit mesajı oluşturur ve commit&#39;i oluşturur. Her eklenti farklı çalışır. Eklentinin neler sağladığını öğrenmek için <strong>Keşfet</strong> sekmesindeki açıklamasına veya ana sayfasına bakın. Örneğin <strong>code-review</strong> pluginini indirdik. Bu plugini kullanmak için proje dizininde terminalde <strong>/code-review</strong> de yazabiliriz ya da bu projedeki tüm dosyaları review et diyerek tetikleyebiliriz.</li><li>Eklentileri doğrudan komutlarla da yönetebilirsiniz. <strong>/plugin enable</strong>, <strong>/plugin disable</strong>, <strong>/plugin uninstall</strong> arkasına eklenti adını yazarak yönetebiliriz. Eklentiyi eklerken sonuna <strong>--scope</strong> project, user, local ekleyerek hedef scope&#39;ı belirleyebiliriz.</li><li>Pluginleri kendimiz de oluşturabiliyoruz. Her plugin, bir manifest ile skills, agents veya hooks içeren kendi dizininde bulunur. Örneğin <strong>my-first-plugin</strong> adında bir plugin oluşturmak için <strong>mkdir my-first-plugin</strong> komutunu kullanıyoruz. .claude-plugin/plugin.json konumundaki manifest dosyası eklentinizin kimliğini tanımlar: name, description, and version. Claude Code bu meta verileri eklenti yöneticisinde görüntülemek için kullanır. Plugin klasörünüzün içinde .claude-plugin dizinini oluşturun: <strong>mkdir my-first-plugin/.claude-plugin</strong>. Ardından my-first-plugin/.claude-plugin/plugin.json dosyasını şu içerikle oluşturun:</li></ul><pre>{<br>  &quot;name&quot;: &quot;my-first-plugin&quot;,<br>  &quot;description&quot;: &quot;A greeting plugin to learn the basics&quot;,<br>  &quot;version&quot;: &quot;1.0.0&quot;,<br>  &quot;author&quot;: {<br>    &quot;name&quot;: &quot;Your Name&quot;<br>  }<br>}</pre><ul><li>Skills <strong>skills/</strong> dizininde bulunur. Her beceri, <strong>SKILL.md</strong> dosyası içeren bir klasördür. Klasör adı, plugin ad alanıyla birleştirilerek skill adını oluşturur. <strong>my-first-plugin</strong> adlı eklentideki <strong>hello/</strong> klasörü, <strong>/my-first-plugin:hello</strong> skillini oluşturur. Plugin klasörünüzde skill dizinini oluşturun: mkdir -p my-first-plugin/skills/hello. Ardından my-first-plugin/skills/hello/SKILL.md dosyasını şu içerikle oluşturun:</li></ul><pre>---<br>description: Greet the user with a friendly message<br>disable-model-invocation: true<br>---</pre><pre>Greet the user warmly and ask how you can help them today.</pre><ul><li>Eklentinizi yüklemek için <strong>--plugin-dir</strong> bayrağıyla Claude Code&#39;u çalıştırın: <strong>claude --plugin-dir ./my-first-plugin</strong>. <strong>/my-first-plugin:hello</strong> komutuyla yeni skillinizi deneyebilirsiniz. Claude&#39;un bir selamlama ile yanıt verdiğini göreceksiniz.</li><li>Kullanıcı girişini kabul ederek skilli dinamik hale getirebilirsiniz. <strong>$ARGUMENTS</strong> yer tutucusu, kullanıcının beceri adından sonra girdiği metni yakalar. <strong>/my-first-plugin:hello Alex</strong> ile deneyebilirsiniz.</li></ul><pre>---<br>name: hello<br>description: Greet the user with a<br>personalized message<br>---<br><br># Hello Skill<br>Greet the user named &quot;$ARGUMENTS&quot; warmly<br>and ask how you can help them today.<br>Make the greeting personal and encouraging</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*8CyCMmQT6VSgj3LW9Kpvuw.png" /></figure><pre>my-plugin/<br>├── .claude-plugin/<br>│   └── plugin.json<br>└── skills/<br>    └── code-review/<br>        └── SKILL.md</pre><ul><li>Her <strong>SKILL.md</strong>, <strong>name</strong> ve <strong>description</strong> alanlarını içeren ön bölüm ile ardından talimatlar içermelidir.</li><li>Plugins kaynağı: <a href="https://code.claude.com/docs/en/plugins">https://code.claude.com/docs/en/plugins</a></li></ul><blockquote><em>💡 Plugin yükledikten sonra Skills kullanmak için Claude Code’u yeniden başlatın.</em></blockquote><h3>Skills</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nbsq8NVUqmguvy9H6Dqf9A.png" /></figure><ul><li>Claude Skills ihtiyaç duyduğunda erişebildiği yeniden kullanılabilir talimatlardır. Claude, sahip olduğu skilllere bakarak bağlama en uygun olanı kendisi seçiyor.</li><li>Claude konuşma başında skillin tamamını yüklemez. Sadece metadata kısmını bağlama ekler. Gövde kısmı ise sadece gerekli olduğunda yüklenir. Anthropic buna <strong>progressive disclosure</strong> diyor. Bu yapının üç seviyesi vardır.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NB7G09czi_VyUFTtsQ3MTA.png" /></figure><ul><li>Skill klasörüne alt klasörler de ekleyebiliriz. Örneğin X, Y ve Z için farklı “how-to” rehberleri varsa, bunları mantıklı bir klasör yapısı içinde organize edebiliriz. Claude skill’i çağırdığında önce body’yi okur, ardından body içinde referans verilen klasör ve dosyaları bağlama göre tek tek ya da hiç okumayabilir. Hatta scripts klasörü gibi bir klasör ekleyip altına çalıştıracağı python kodu veya javascript kodunu ekleyip bu scripti çalıştırmasını da sağlayabiliriz.</li></ul><pre>Skill dizinine ek dosyalar ekleyebilirsin:<br>pdf-skill/<br>├── SKILL.md          ← zorunlu<br>├── reference.md      ← ek dokümantasyon<br>├── examples.md       ← örnekler<br>└── scripts/<br>    └── helper.py     ← yardımcı script</pre><ul><li><strong>Metadata</strong> kısmında o skillin <strong>name</strong> ve kısa <strong>description</strong> bilgileri bulunuyor. Body kısmında ise nasıl çalışacağına dair instructionslar bulunuyor. Örneğin bir <strong>skill.md</strong> dosyan var ve ayrıca research_methodology.md adında ayrı bir skill tanımladın. skill.md dosyanda &quot;Eğer bir kavram bilinmiyorsa ya da araştırma gerektiriyorsa, detaylı rehber için research_methodology.md dosyasını yükle.&quot; gibi bir talimat eklediğinde Claude research_methodology.md dosyasını açabiliyor. Ayrıca bir scripts klasörü tanımladın ve youtube&#39;dan transcript çeken bir python kodu dosyası ekledin diyelim. Bu araç skill body içinde değil, research_methodology.md içinde referanslanıyor. Yani Claude&#39;a bu aracı nasıl kullanacağı orada anlatılıyor.</li></ul><pre>---<br>name: skill-adi<br>description: Bu skill ne yapar ve ne zaman kullanılır<br>---<br><br># Skill Adı<br><br>## Talimatlar<br>Claude&#39;un takip edeceği adımlar...<br>```<br><br>`description` alanı Claude&#39;un skill&#39;i ne zaman kullanacağını <br>keşfetmesi için kritik öneme sahiptir. Hem skill&#39;in ne yaptığını <br>hem de ne zaman kullanılması gerektiğini içermelidir. <br>---<br>## Destekleyici Dosyalar<br><br>Skill dizinine ek dosyalar ekleyebilirsin:<br>```<br>pdf-skill/<br>├── SKILL.md          ← zorunlu<br>├── reference.md      ← ek dokümantasyon<br>├── examples.md       ← örnekler<br>└── scripts/<br>    └── helper.py     ← yardımcı script<br></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2-OmgoDWyjEYdjSNodzquw.png" /></figure><pre>my-monorepo/<br>├── .claude/skills/          ← genel proje skill&#39;leri<br>│   └── genel-skill/<br>├── packages/<br>│   ├── frontend/<br>│   │   ├── .claude/skills/  ← sadece frontend&#39;e özel skill&#39;ler<br>│   │   │   └── react-skill/<br>│   │   └── src/<br>│   └── backend/<br>│       ├── .claude/skills/  ← sadece backend&#39;e özel skill&#39;ler<br>│       │   └── api-skill/<br>│       └── src/</pre><ul><li>Skill’i çağırırken yanına ek bilgi verebilirsin. Bu bilgiye <strong>argüman</strong> denir ve skill içinde $ARGUMENTS değişkeniyle kullanılır. Örnek şu şekilde çalışır: <strong>/fix-issue 123</strong> yazdığında, $ARGUMENTS yerine 123 gelir. Claude şunu görür: <em>&quot;123 numaralı GitHub issue&#39;sunu çöz...&quot;</em></li><li>Birden fazla argüman için sıra numarası $ARGUMENTS[N] kullanırsın.</li></ul><pre>---<br>name: fix-issue<br>description: Fix a GitHub issue<br>disable-model-invocation: true<br>---<br><br>Fix GitHub issue $ARGUMENTS following our coding standards.<br><br>1. Read the issue description<br>2. Understand the requirements<br>3. Implement the fix<br>4. Write tests<br>5. Create a commit<br>---<br>Migrate the $ARGUMENTS[0] component from $ARGUMENTS[1] to $ARGUMENTS[2].<br>Preserve all existing behavior and tests.<br></pre><ul><li>Skillere açıklama kısmında tetikleyici kelimeler eklemelisiniz. Örneğin: “Kullanıcı sprint, linear tasks, project planning gibi ifadeler kullandığında çağır.” Claude Code semantik olarak da benzer ifadeleri yakalayabilir. Ama açık tetikleyici kelime kullanırsanız çağrılma ihtimali neredeyse %100 olur.</li></ul><blockquote><em>💡 To enable </em><a href="https://code.claude.com/docs/en/common-workflows#use-extended-thinking-thinking-mode"><em>extended thinking</em></a><em> in a skill, include the word “ultrathink” anywhere in your skill content.</em></blockquote><h3>Subagents</h3><ul><li><strong>Subagent</strong>’lar, belirli görev türlerini ele alan uzmanlaşmış AI asistanlardır. Her subagent kendi <strong>context window</strong>’unda özel bir system prompt, belirli tool erişimi ve bağımsız izinlerle çalışır. Claude, bir subagent’ın açıklamasıyla eşleşen bir görevle karşılaştığında, o subagent’a devreder; subagent bağımsız olarak çalışır ve sonuçları geri döndürür.</li><li>Subagent’lar şunlarda yardımcı olur:</li></ul><pre>- **Context&#39;i koruma** — keşif ve uygulama işlemlerini ana konuşmanızın dışında tutarak<br>- **Kısıtlamaları zorlama** — bir subagent&#39;ın hangi tool&#39;ları kullanabileceğini sınırlayarak<br>- **Yapılandırmaları yeniden kullanma** — user-level subagent&#39;larla projeler arasında<br>- **Davranışı özelleştirme** — belirli alanlar için odaklanmış system prompt&#39;larla<br>- **Maliyetleri kontrol etme** — görevleri Haiku gibi daha hızlı, daha ucuz model&#39;lere yönlendirerek</pre><ul><li>Claude, görevleri ne zaman devredeceğine karar vermek için her subagent’ın <strong>description</strong> alanını kullanır. Bir subagent oluştururken, Claude’un onu ne zaman kullanacağını bilmesi için net bir açıklama yazın.</li><li>Claude Code, <strong>Explore</strong>, <strong>Plan</strong> ve <strong>general-purpose</strong> gibi birçok yerleşik subagent içerir.</li></ul><pre>Explore: Codebase&#39;leri aramak ve analiz etmek için optimize edilmiş<br>hızlı, salt okunur bir agent.<br>Plan: Plan mode sırasında bir plan sunmadan önce context toplamak için<br>kullanılan bir araştırma agent&#39;ı.<br>General-purpose: Hem keşif hem de eylem gerektiren karmaşık,<br>çok adımlı görevler için yetenekli bir agent.</pre><ul><li>Yeni bir Subagent oluşturmak ve agentları yönetmek için Claude Code chat oturumunda <strong>/agents</strong> komutunu kullanıyoruz. Bu komut, daha önce oluşturduğun ajanların listesini gösterir. Biz henüz hiç oluşturmadığımız için, <strong>Create new agent</strong> seçeneğini seçiyoruz. <strong>Personel</strong> seçeneğini seçin. Bu, subagent&#39;ı <strong>~/.claude/agents/</strong> dizinine kaydeder, böylece tüm projelerinizde kullanılabilir. <strong>Generate with Claude</strong> seçeneğini seçip ajan ne yapmalı ve ne zaman kullanılmalı gibi bilgiler girildikten sonra <strong>Tool</strong>, agentın çalışacağı bir <strong>Model</strong> ve bir renk seçin. Bu, arayüzde hangi subagent&#39;ın çalıştığını belirlemenize yardımcı olur.</li></ul><pre>---<br>name: code-reviewer<br>description: Kodu kalite ve en iyi uygulamalar açısından inceler<br>tools: Read, Glob, Grep<br>model: sonnet<br>---<br><br>Bir kod inceleyicisiniz. Çağrıldığında, kodu analiz edin ve kalite,<br>güvenlik ve en iyi uygulamalar hakkında spesifik, eyleme geçirilebilir<br>geri bildirim sağlayın.<br></pre><blockquote><em>💡 Claude, isteğinizdeki görev açıklamasına, subagent yapılandırmalarındaki </em><em>description alanına ve mevcut context&#39;e göre görevleri otomatik olarak devreder. Belirli bir subagent&#39;ı açıkça da isteyebilirsiniz: </em><em>Code-reviewer subagent&#39;ını son değişikliklerimi incelemesi için kullan</em></blockquote><ul><li><strong>Frontmatter</strong>, subagent&#39;ın metadata&#39;sını ve yapılandırmasını tanımlar. Gövde, subagent&#39;ın davranışını yönlendiren system prompt olur. Subagent&#39;lar yalnızca bu system prompt&#39;u (artı çalışma dizini gibi temel ortam ayrıntılarını) alır, tam Claude Code system prompt&#39;unu değil. Subagent&#39;lar ana oturumdan skill miras almaz; bunları açıkça belirtmeniz gerekir.</li><li>Agent tanımlarken frontmatterda farklı parametreleri de tanımlayabiliyoruz. Bu agenta <strong>permissionMode</strong> ile gerekli izinleri belirtebiliyor, <strong>tools</strong> ile kullanabileceği toolları belirtebiliyoruz, <strong>disallowedTools</strong> ile miras almaması gereken reddedilecekleri çıkarıyoruz. <strong>skills</strong> ile başlangıçta subagent&#39;ın context&#39;ine yüklenecek skilleri belirtebiliyoruz, <strong>mcpServers</strong> ile sunulan mcp&#39;leri tanımlayabiliyoruz, <strong>hooks</strong> ile lifecycle hooklarını belirtebiliyoruz, <strong>background</strong> true vererek arka planda çalışmasını sağlayabiliyor ve <strong>isolation</strong> ile geçici bir worktree içinde çalıştırabiliyoruz.</li></ul><pre>---<br>name: safe-researcher<br>description: Kısıtlı yeteneklere<br>sahip araştırma agent&#39;ı<br>tools: Read, Grep, Glob, Bash<br>disallowedTools: Write, Edit<br>permissionMode: plan, acceptEdits, dontAsk, bypassPermissions<br>memory: user, project, local<br>skills:<br>  - api-conventions<br>  - error-handling-patterns<br>hooks:<br>  PreToolUse:<br>    - matcher: &quot;Bash&quot;<br>      hooks:<br>        - type: command<br>          command: &quot;./scripts/validate-command.sh $TOOL_INPUT&quot;<br>  PostToolUse:<br>    - matcher: &quot;Edit|Write&quot;<br>      hooks:<br>        - type: command<br>          command: &quot;./scripts/run-linter.sh&quot;<br>---</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/593/1*w-jq4p_Sd3ovYCEd0QF5Kw.png" /></figure><ul><li>Subagent’lar foreground (blocking) veya background (concurrent) şeklinde çalışabilir: <strong>Foreground subagents</strong> tamamlanana kadar ana konuşmayı engeller. İzin istemleri ve açıklama soruları (AskUserQuestion gibi) size iletilir. <strong>Background subagents</strong> siz çalışmaya devam ederken eşzamanlı olarak çalışır. Başlatmadan önce Claude Code, subagent&#39;ın ihtiyaç duyacağı tool izinlerini ister ve gerekli onayları önceden almasını sağlar.</li><li>Claude, göreve göre subagent’ları ön planda mı yoksa arka planda mı çalıştıracağına karar verir. Ayrıca şunları yapabilirsiniz:</li></ul><p><em>Çalışan bir görevi arka plana almak için </em><strong><em>Ctrl+B</em></strong><em> tuşlarına basın ve Claude’a “bunu arka planda çalıştır” diye belirtin.</em></p><ul><li>Subagent’ların en etkili kullanımlarından biri, büyük miktarda çıktı üreten işlemleri izole etmektir. Test çalıştırma, belge getirme veya log dosyalarını işleme önemli miktarda context tüketebilir. Bunları bir subagent’a devredererek, ayrıntılı çıktı subagent’ın context’inde kalır ve ana konuşmanıza yalnızca ilgili özet döner.</li><li>Bağımsız araştırmalar için aynı anda çalışmak üzere birden fazla subagent oluşturabilirsiniz:</li></ul><p><em>Authentication, database ve API modüllerini ayrı subagent’lar kullanarak paralel olarak araştır</em></p><ul><li>Çok adımlı iş akışları için Claude’dan subagent’ları sırayla kullanmasını isteyin. Her subagent görevini tamamlar ve sonuçları Claude’a döndürür; Claude daha sonra ilgili context’i bir sonraki subagent’a aktarır.</li></ul><p><em>Code-reviewer subagent’ını kullanarak performans sorunlarını bul, ardından optimizer subagent’ını kullanarak bunları düzelt</em></p><ul><li>Sürekli paralellik gerektiren veya context window’unuzu aşan görevler için <strong>agent teams</strong> her çalışana kendi bağımsız context’ini verir.</li><li>Subagents kaynağı: <a href="https://code.claude.com/docs/en/sub-agents">https://code.claude.com/docs/en/sub-agents</a></li></ul><h3>Agent Teams</h3><ul><li>Agent teams, birlikte çalışan birden fazla Claude Code instance&#39;ını koordine etmenizi sağlar. Bir oturum team lead olarak görev yapar, işi koordine eder, görev atar ve sonuçları sentezler. Teammate&#39;ler bağımsız olarak çalışır, her biri kendi context window&#39;unda, ve birbirleriyle doğrudan iletişim kurar. Subagent&#39;lardan farklı olarak, liderden geçmeden bireysel teammate&#39;lerle doğrudan da etkileşim kurabilirsiniz.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*d8eMKm8k_NaJaeguaSzx6g.png" /></figure><ul><li>Agent teams, paralel keşfin gerçek değer kattığı görevler için en etkilidir.</li></ul><blockquote><strong><em>Araştırma ve inceleme</em></strong><em>: birden fazla teammate bir problemin farklı yönlerini eş zamanlı olarak araştırabilir, ardından bulgularını paylaşabilir ve birbirlerinin bulgularına itiraz edebilir</em></blockquote><blockquote><strong><em>Yeni modüller veya özellikler</em></strong><em>: teammate’ler birbirlerinin ayağına basmadan her biri ayrı bir parçayı sahiplenebilir</em></blockquote><blockquote><strong><em>Yarışan hipotezlerle hata ayıklama</em></strong><em>: teammate’ler farklı teorileri paralel olarak test eder ve cevaba daha hızlı ulaşır</em></blockquote><blockquote><strong><em>Katmanlar arası koordinasyon</em></strong><em>: frontend, backend ve test’leri kapsayan değişiklikler — her biri farklı bir teammate tarafından sahiplenilir</em></blockquote><ul><li>Sıralı görevler, aynı dosya düzenlemeleri veya çok sayıda bağımlılığı olan işler için tek bir oturum veya subagent’lar daha etkilidir. Çalışanlarınızın birbirleriyle iletişim kurmasının gerekip gerekmediğine göre seçim yapın.</li></ul><blockquote><em>💡 </em><strong><em>Uyarı:</em></strong><em> Agent teams deneyseldir ve varsayılan olarak devre dışıdır. </em><em>settings.json dosyanıza veya ortam değişkenlerinize </em><em>CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ekleyerek etkinleştirin.</em></blockquote><pre>{<br>  &quot;env&quot;: {<br>    &quot;CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS&quot;: &quot;1&quot;<br>  }<br>}</pre><ul><li>Agent teams’i etkinleştirdikten sonra, Claude’a bir agent team oluşturmasını söyleyin ve doğal dilde görevi ve istediğiniz takım yapısını tanımlayın. Claude takımı oluşturur, teammate’leri başlatır ve prompt’unuza göre işi koordine eder. Bu örnek iyi çalışır çünkü üç rol birbirinden bağımsızdır ve birbirini beklemeden problemi keşfedebilir:</li></ul><pre>Geliştiricilerin codebase&#39;lerindeki TODO yorumlarını takip etmesine<br>yardımcı olan bir CLI aracı tasarlıyorum. Bunu farklı açılardan<br>keşfetmek için bir agent team oluştur: bir teammate UX üzerine,<br>bir tanesi teknik mimari üzerine, bir tanesi de şeytanın avukatını<br>oynasın.</pre><ul><li>Claude, <strong>shared task list</strong> ile bir takım oluşturur, her perspektif için teammate’ler başlatır, onların problemi keşfetmesini sağlar, bulguları sentezler ve bittiğinde takımı temizlemeye çalışır.</li><li>Agent teams iki görüntüleme modunu destekler:</li><li><strong><em>In-process</em></strong><em>: tüm teammate’ler ana terminalinizde çalışır. Teammate’ler arasında geçiş yapmak için Shift+Down kullanın ve doğrudan mesaj göndermek için yazın.</em></li><li><strong><em>Split panes</em></strong><em>: her teammate kendi panelini alır. Herkesin çıktısını aynı anda görebilir ve doğrudan etkileşim için bir panele tıklayabilirsiniz. tmux veya iTerm2 gerektirir. </em><em>tmux belirli işletim sistemlerinde bilinen sınırlamalara sahiptir ve geleneksel olarak macOS&#39;ta en iyi şekilde çalışır. Varsayılan </em><em>&quot;auto&quot;&#39;dur; zaten bir tmux oturumu içinde çalışıyorsanız split panes kullanır, aksi halde in-process kullanır. </em><em>&quot;tmux&quot; ayarı split-pane modunu etkinleştirir ve terminalinize göre tmux mu yoksa iTerm2 mi kullanılacağını otomatik algılar.</em></li><li>Split-pane modu <a href="https://github.com/tmux/tmux/wiki">tmux</a> veya <a href="https://github.com/mkusaka/it2">it2 CLI</a> ile iTerm2 gerektirir. Elle kurulum için:</li><li><strong><em>tmux</em></strong><em>: sisteminizin paket yöneticisi aracılığıyla kurun. Platforma özel talimatlar için </em><a href="https://github.com/tmux/tmux/wiki/Installing"><em>tmux wiki</em></a><em>’ye bakın.</em></li><li><strong><em>iTerm2</em></strong><em>: </em><a href="https://github.com/mkusaka/it2"><em>it2 CLI</em></a><em>’yi kurun, ardından </em><strong><em>iTerm2 → Settings → General → Magic → Enable Python API</em></strong><em> bölümünde Python API’yi etkinleştirin.</em></li></ul><blockquote><em>💡 Ajanları animated pixel karakterler olarak gösteren bir paket: </em><a href="https://github.com/pablodelucca/pixel-agents"><em>https://github.com/pablodelucca/pixel-agents</em></a></blockquote><ul><li>Karmaşık/riskli görevlerde teammate’lerin uygulamadan önce <strong>plan yapmasını zorunlu kılabilirsiniz</strong>. Teammate, lider yaklaşımı onaylayana kadar <strong>salt okunur plan mode’da</strong> çalışır. Planı bitirince lidere <strong>onay isteği</strong> gönderir; lider planı inceler ve <strong>onaylar</strong> ya da <strong>geri bildirimle reddeder</strong>. Reddedilirse teammate <strong>plan mode’da kalır</strong>, geri bildirime göre <strong>revize edip yeniden gönderir</strong>; onaylanırsa <strong>plan mode’dan çıkar</strong> ve <strong>uygulamaya başlar</strong>.</li></ul><pre>Authentication modülünü yeniden düzenlemek için bir architect<br>teammate başlat.<br>Herhangi bir değişiklik yapmadan önce plan onayı iste.</pre><ul><li>Teammate planlamayı bitirince lidere <strong>onay isteği</strong> gönderir. Lider planı <strong>otonom</strong> değerlendirir: <strong>onaylar</strong> veya <strong>geri bildirimle reddeder</strong>. Reddedilirse teammate <strong>plan mode’da kalır</strong>, geri bildirime göre <strong>revize edip yeniden gönderir</strong>; onaylanırsa <strong>plan mode’dan çıkar</strong> ve <strong>uygulamaya başlar</strong>. Liderin kararını yönlendirmek için prompt’ta <strong>kriter</strong> yazın (örn. “yalnızca test kapsamı içeren planları onayla”, “veritabanı şemasını değiştiren planları reddet”). Her teammate <strong>bağımsız bir oturumdur</strong>; doğrudan mesajla <strong>ek talimat</strong>, <strong>takip sorusu</strong> veya <strong>yönlendirme</strong> verebilirsiniz. Görevleri lider <strong>atayabilir</strong> ya da teammate’ler <strong>talep edebilir</strong>. Lider <strong>shutdown</strong> isteği gönderebilir; teammate <strong>onaylayabilir</strong> veya <strong>açıklamayla reddeder</strong>. İş bitince liderden takımı <strong>temizlemesini</strong> isteyebilirsiniz. Bir teammate, diğer görevlerin bağımlı olduğu bir görevi tamamladığında, <strong>engellenen görevler</strong> otomatik açılır. Teammate’ler liderin <strong>permission</strong> ayarlarını miras alarak çalışmaya başlar.</li><li>Bir agent team mimarisi şunlardan oluşur:</li></ul><pre>Team lead: Takımı oluşturan, teammate&#39;leri başlatan ve işi koordine eden ana Claude Code oturumu <br>Teammate: Her biri atanan görevler üzerinde çalışan ayrı Claude Code instance&#39;ları <br>Task list: Teammate&#39;lerin talep ettiği ve tamamladığı paylaşılan iş öğeleri listesi <br>Mailbox: Agent&#39;lar arasında iletişim için mesajlaşma sistemi</pre><ul><li>En iyi kullanım senaryoları paralel çalıştırma, farklı hipotezleri birbiriyle karşılaştırıp en iyisini seçtirme. Örneğin bir kodu incelerken güvenlik, performans ve test kapsamını kontrol eden farklı agentları paralelde çalıştırabilirsin veya araştırma yaparken bir konuyu farklı açılardan tartışıp birbirlerinin teorilerini çürütecek şekilde ayarlayabilirsin.</li></ul><h3>MCP Servers</h3><pre># Yapılandırılmış tüm server&#39;ları listele<br>claude mcp list<br># Belirli bir server için ayrıntıları al<br>claude mcp get github<br># Bir server&#39;ı kaldır<br>claude mcp remove github<br># (Claude Code içinde) Server durumunu kontrol et<br>/mcp</pre><ul><li>Claude Code, AI-araç entegrasyonları için açık kaynaklı bir standart olan <a href="https://modelcontextprotocol.io/introduction"><strong>Model Context Protocol (MCP)</strong></a> aracılığıyla yüzlerce harici araç ve veri kaynağına bağlanabilir. MCP server’lar Claude Code’a araçlarınıza, veritabanlarınıza ve API’lerinize erişim sağlar.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IW50IzkN_GVZE_1kiPZXOg.png" /></figure><ul><li>HTTP server’lar, remote MCP server’lara bağlanmak için önerilen seçenektir. Bu, bulut tabanlı servisler için en yaygın desteklenen transport’tur:</li></ul><pre># Temel sözdizimi<br>claude mcp add --transport http &lt;ad&gt; &lt;url&gt;<br># Gerçek örnek: Notion&#39;a bağlanma<br>claude mcp add --transport http notion https://mcp.notion.com/mcp<br># Bearer token ile örnek<br>claude mcp add --transport http secure-api https://api.example.com/mcp \<br>  --header &quot;Authorization: Bearer your-token&quot;</pre><ul><li>Local Stdio server kullanarak da ekleyebilirsiniz. Stdio server’lar makinenizde yerel süreçler olarak çalışır. Doğrudan sistem erişimi veya özel script’ler gerektiren araçlar için idealdir:</li></ul><pre># Temel sözdizimi<br>claude mcp add [seçenekler] &lt;ad&gt; -- &lt;komut&gt; [argümanlar...]<br><br># Gerçek örnek: Airtable server ekleme<br>claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \<br>  -- npx -y airtable-mcp-server</pre><blockquote><em>💡 Tüm seçenekler (</em><em>--transport, </em><em>--env, </em><em>--scope, </em><em>--header) server adından </em><strong><em>önce</em></strong><em> gelmelidir. </em><em>-- (çift tire) daha sonra server adını MCP server&#39;a geçirilen komut ve argümanlardan ayırır.</em></blockquote><blockquote><em>Yapılandırmanın nerede saklandığını belirtmek için </em><em>--scope flag&#39;ini kullanın:</em></blockquote><blockquote>local (varsayılan): Mevcut projede yalnızca size görünür (eski sürümlerde project olarak adlandırılıyordu)</blockquote><blockquote>project: .mcp.json dosyası aracılığıyla projedeki herkesle paylaşılır</blockquote><blockquote>user: Tüm projelerde size görünür (eski sürümlerde global olarak adlandırılıyordu)</blockquote><blockquote><em>Ortam değişkenlerini </em><em>--env flag&#39;leriyle ayarlayın (örneğin </em><em>--env KEY=value)</em></blockquote><blockquote><em>MCP server başlatma timeout’unu MCP_TIMEOUT ortam değişkeniyle yapılandırın (örneğin </em><em>MCP_TIMEOUT=10000 claude 10 saniyelik timeout ayarlar)</em></blockquote><blockquote><em>MCP tool çıktısı 10.000 token’ı aştığında Claude Code bir uyarı gösterir. Bu limiti artırmak için </em><em>MAX_MCP_OUTPUT_TOKENS ortam değişkenini ayarlayın (örneğin </em><em>MAX_MCP_OUTPUT_TOKENS=50000)</em></blockquote><blockquote><em>OAuth 2.0 authentication gerektiren remote server’larla kimlik doğrulaması için </em><em>/mcp kullanın</em></blockquote><ul><li>Birçok uygulamanın mcp server’ı bulunmakta. Örneğin Figma mcp’sini ekledikten sonra figma linkini prompta ekleyip “bu tasarımı yap” dediğinizde o mcp’yi kullanır. Bazı popüler MCP Server’lar:</li></ul><pre>claude mcp add slack --transport http https://mcp.slack.com/mcp<br>claude mcp add --transport http supabase https://mcp.supabase.com/mcp<br>claude mcp add --transport http context7 https://mcp.context7.com/mcp<br>claude mcp add --transport http github https://api.githubcopilot.com/mcp/<br>claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp</pre><ul><li>Daha fazlası için: <a href="https://code.claude.com/docs/en/mcp">https://code.claude.com/docs/en/mcp</a></li></ul><h3>Hooks</h3><ul><li><strong>Hook</strong>’lar, Claude Code’un yaşam döngüsündeki belirli noktalarda çalışan kullanıcı tanımlı shell komutlarıdır. LLM’leri kullanmadan belirli eylemlerin her zaman gerçekleşmesini garanti ederler.</li><li>Hook oluşturmanın en hızlı yolu Claude Code’daki <strong>/hooks</strong> komutudur. Mevcut tüm hook event&#39;lerinin bir listesini ve tüm hook&#39;ları devre dışı bırakma seçeneğini göreceksiniz. Claude&#39;un dikkatinize ihtiyaç duyduğunda tetiklenen bir hook oluşturmak için <strong>Notification</strong> seçin. Menü, hook&#39;un ne zaman tetikleneceğini filtreleyen matcher&#39;ların bir listesini gösterir. Tüm bildirim türlerinde tetiklenmesi için <strong>*</strong> olarak ayarlayın veya <strong>permission_prompt</strong>, <strong>idle_prompt</strong> gibi belirli bir değere değiştirerek daraltabilirsiniz. <strong>Add new hook</strong> seçin. Menü, event tetiklendiğinde çalıştırılacak bir shell komutu ister. macOS — yerel bir macOS bildirimini AppleScript aracılığıyla tetiklemek için <strong>osascript</strong> kullanır:</li></ul><pre>osascript -e &#39;display notification &quot;Claude Code dikkatinize ihtiyaç duyuyor&quot; with title &quot;Claude Code&quot;&#39;</pre><ul><li>Menü, hook yapılandırmasını nereye kaydedeceğinizi sorar. Tüm projelerinize uygulamak üzere <strong>~/.claude/settings.json</strong> içine saklamak için <strong>User settings</strong> seçin. Mevcut projeye kapsamlandırmak için <strong>Project settings</strong> de seçebilirsiniz.</li><li>Hook’lar, Claude Code’un yaşam döngüsündeki kilit noktalarda kod çalıştırmanızı sağlar: düzenlemelerden sonra dosyaları biçimlendirme, komutları çalışmadan önce engelleme, Claude girdiye ihtiyaç duyduğunda bildirim gönderme, oturum başlangıcında context enjekte etme ve daha fazlası. En yaygın kalıplar:</li></ul><pre>// Claude&#39;un düzenlediği her dosyada Prettier&#39;ı otomatik olarak çalıştırın<br>{<br>  &quot;hooks&quot;: {<br>    &quot;PostToolUse&quot;: [<br>      {<br>        &quot;matcher&quot;: &quot;Edit|Write&quot;,<br>        &quot;hooks&quot;: [<br>          {<br>            &quot;type&quot;: &quot;command&quot;,<br>            &quot;command&quot;: &quot;jq -r &#39;.tool_input.file_path&#39; | xargs npx prettier --write&quot;<br>          }<br>        ]<br>      }<br>    ]<br>  }<br>}</pre><pre>// Claude çalışmayı bitirip input girdisine ihtiyaç duyduğunda<br>// bir masaüstü bildirimi alın<br>{<br>  &quot;hooks&quot;: {<br>    &quot;Notification&quot;: [<br>      {<br>        &quot;matcher&quot;: &quot;&quot;,<br>        &quot;hooks&quot;: [<br>          {<br>            &quot;type&quot;: &quot;command&quot;,<br>            &quot;command&quot;: &quot;osascript -e &#39;display notification \&quot;Claude Code dikkatinize ihtiyaç duyuyor\&quot; with title \&quot;Claude Code\&quot;&#39;&quot;<br>          }<br>        ]<br>      }<br>    ]<br>  }<br>}</pre><blockquote><em>💡 </em><strong><em>Not:</em></strong><em> Bu sayfadaki Bash örnekleri JSON ayrıştırma için </em><em>jq kullanır. </em><em>brew install jq (macOS), </em><em>apt-get install jq (Debian/Ubuntu) ile kurun veya </em><a href="https://jqlang.github.io/jq/download/"><em>jq indirmeleri</em></a><em> sayfasına bakın.</em></blockquote><ul><li>Deterministik kurallar yerine muhakeme gerektiren kararlar için <strong>type: &quot;prompt&quot;</strong> hook&#39;larını kullanın. Bir shell komutu çalıştırmak yerine, Claude Code kararı almak için prompt&#39;unuzu ve hook&#39;un girdi verilerini bir Claude model&#39;ine (varsayılan olarak Haiku) gönderir.</li></ul><pre>{<br>  &quot;hooks&quot;: {<br>    &quot;Stop&quot;: [<br>      {<br>        &quot;hooks&quot;: [<br>          {<br>            &quot;type&quot;: &quot;prompt&quot;,<br>            &quot;prompt&quot;: &quot;Tüm görevlerin tamamlanıp tamamlanmadığını kontrol et. Tamamlanmadıysa {\&quot;ok\&quot;: false, \&quot;reason\&quot;: \&quot;yapılması gereken şeyler\&quot;} ile yanıt ver.&quot;<br>          }<br>        ]<br>      }<br>    ]<br>  }<br>}</pre><ul><li>Doğrulama dosyaları incelemeyi veya komut çalıştırmayı gerektirdiğinde <strong>type: &quot;agent&quot;</strong> hook&#39;larını kullanın.</li></ul><pre>// Bu örnek, Claude&#39;un durmasına izin vermeden önce testlerin<br>// geçtiğini doğrular<br>{<br>  &quot;hooks&quot;: {<br>    &quot;Stop&quot;: [<br>      {<br>        &quot;hooks&quot;: [<br>          {<br>            &quot;type&quot;: &quot;agent&quot;,<br>            &quot;prompt&quot;: &quot;Tüm unit testlerin geçtiğini doğrula. Test paketini çalıştır ve sonuçları kontrol et. $ARGUMENTS&quot;,<br>            &quot;timeout&quot;: 120<br>          }<br>        ]<br>      }<br>    ]<br>  }<br>}</pre><ul><li>Daha fazlası için: <a href="https://code.claude.com/docs/en/hooks-guide">https://code.claude.com/docs/en/hooks-guide</a></li></ul><h3>Skills, MCP vs Agents</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_fE3VyEIKlWolCpKPSoTIw.png" /></figure><ul><li><strong>Skills</strong>, LLM’lere araçlar ve talimatlar sunmamızı sağlar. <strong>MCP</strong> de LLM’lere kaynaklar, prompt’lar ve araçlar sağlama imkânı sunar. Skills yalnızca Claude ile çalışır. MCP ise evrensel, açık bir standarttır. MCP sayesinde herhangi bir LLM, herhangi bir uygulamayla iletişim kurabilir.</li><li>Skills’te Claude yalnızca bir sonraki adım için gereken bağlamı alır. MCP’de ise başlangıçta sunucu tüm araçları ve tüm araç metadata’larını context window’a yükler.</li><li><strong>Subagents</strong>, belirli iş akışları için özelleştirilmiş ajanlardır ve her birinin kendi context window’u bulunur. Sub-agent, Claude Code hesabımıza önceden yüklenmiş tüm skills’lere erişebilir. Ayrıca ona belirli MCP sunucularını özel olarak atayabiliriz. Böylece hesabımızdaki tüm MCP’leri yüklemek zorunda kalmaz ve gereksiz bağlam şişmesi önlenir.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uhwoCFLZmm79EzAuGL_FVA.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=511922511172" width="1" height="1" alt=""><hr><p><a href="https://medium.com/icommunity/%EF%B8%8F-claude-code-notlar%C4%B1m-511922511172">🗒️ Claude Code Notlarım</a> was originally published in <a href="https://medium.com/icommunity">iCommunity</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>