The second stop in the “Claude Code Journey” series. Last time we looked at what vibe coding is; now we turn to the thing that makes it possible — the coding agent.
In the last post I talked about vibe coding: describing intent and leaving the code to AI. But what exactly is on that “AI” side? The answer: a coding agent.
Most of us first met AI-assisted coding through autocomplete tools. You start typing and the tool suggests the rest of the line. Useful, but passive: it only looks at where your cursor is and makes a guess based on the immediate context. It doesn’t do anything for you — it just predicts the next keystroke.
A coding agent is a completely different category. You give it not a line but a goal: “write tests for the auth module, run them, and fix the failures.” The agent then plans and carries out its own steps to reach that goal.
By its official definition, Claude Code is “an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools.” The verbs in that sentence matter, because they’re exactly what separates an agent from autocomplete:
That loop — plan, act, observe the result, retry if needed — is the heart of agentic behavior. (I’ll devote a separate post to this “agentic loop” later in the series.)
Say you give a command like this:
claude "write tests for the auth module, run them, and fix any failures"
An agent won’t just generate code once and stop. Typically it will: read the auth module’s files, understand what they do, write the tests, run the test command, read any errors, fix the code or the tests, and keep cycling until the tests pass. In other words, it runs the “write–run–debug” loop you’d otherwise do by hand.
Because it changes the kind of problems you can solve. Autocomplete is good at “how do I finish this line?” An agent can take on multi-step, side-effecting work like “find and fix this bug,” “update the dependencies,” or “clean up these lint errors across the project.” In the words of the official docs, it can take over “the tedious tasks you keep putting off.”
But — as I said in the first post — this power doesn’t remove the responsibility to review. Because the agent can run commands and change files, understanding and approving what it does is still your job. A powerful assistant, not a boss.
Autocomplete predicts the next keystroke; a coding agent reads, writes, runs and fixes itself to reach a goal. Claude Code is exactly that kind of tool. In the next post we’ll look at its concrete face — the Claude CLI in the terminal.
Next post: Getting Started with the Claude CLI
]]>“Claude Code Yolculuğu” serisinin ikinci durağı. Önceki yazıda vibe coding‘in ne olduğuna bakmıştık; şimdi onu mümkün kılan asıl şeye, kodlama ajanına geliyoruz.
Geçen yazıda vibe coding’den, yani niyeti tarif edip kodu yapay zekâya bırakmaktan bahsettim. Peki o “yapay zekâ” tarafında tam olarak ne var? Cevap: bir coding agent (kodlama ajanı).
Çoğumuz yapay zekâ destekli kodlamayı önce otomatik tamamlama araçlarıyla tanıdık. Yazmaya başlıyorsun, araç satırın geri kalanını öneriyor. Faydalı, ama pasif: sadece imlecin olduğu yere, o anki bağlama bakarak bir tahmin yapıyor. Senin yerine bir şey yapmıyor, sadece bir sonraki tuşu tahmin ediyor.
Kodlama ajanı bambaşka bir kategori. Ona bir satır değil, bir hedef veriyorsun: “auth modülü için testleri yaz, çalıştır ve hataları düzelt”. Sonra ajan bu hedefe ulaşmak için kendi adımlarını planlıyor ve uyguluyor.
Resmi tanımıyla Claude Code “kod tabanını okuyan, dosyaları düzenleyen, komutları çalıştıran ve geliştirme araçlarınla entegre olan ajansal bir kodlama aracı”. Bu cümledeki fiiller önemli, çünkü bir ajanı tamamlayıcıdan ayıran şey tam olarak bunlar:
İşte bu döngü — planla, uygula, sonucu gözlemle, gerekiyorsa tekrar dene — ajansal davranışın kalbi. (Serinin ileri yazılarında bu “agentic loop” konusuna ayrı bir başlık ayıracağım.)
Diyelim ki şöyle bir komut veriyorsun:
claude "auth modülü için testleri yaz, çalıştır ve hataları düzelt"
Bir ajan burada tek seferde kod üretip durmaz. Tipik olarak: önce auth modülünün dosyalarını okur, ne yaptığını anlar, testleri yazar, test komutunu çalıştırır, çıkan hataları okur, kodu veya testi düzeltir ve testler geçene kadar bu döngüyü sürdürür. Yani senin elle yapacağın “yaz–çalıştır–hata ayıkla” turunu kendisi çeviriyor.
Çünkü çözebileceği problemlerin türünü değiştiriyor. Tamamlayıcı, “bu satırı nasıl bitiririm?” sorusuna iyidir. Ajan ise “bu bug’ı bul ve düzelt”, “bağımlılıkları güncelle”, “şu lint hatalarını proje genelinde temizle” gibi çok adımlı ve yan etkili işlerin altından kalkabilir. Resmi dokümanın deyişiyle, “sürekli ertelediğin sıkıcı işleri” devralabilir.
Ama —ilk yazıda da söylediğim gibi— bu güç, gözden geçirme sorumluluğunu ortadan kaldırmıyor. Ajan komut çalıştırıp dosya değiştirebildiği için, ne yaptığını anlamak ve onaylamak hâlâ senin işin. Güçlü bir asistan, patron değil.
Otomatik tamamlama bir sonraki tuşu tahmin eder; kodlama ajanı bir hedefe ulaşmak için okur, yazar, çalıştırır ve kendini düzeltir. Claude Code da tam olarak böyle bir araç. Bir sonraki yazıda bu aracın somut yüzüne — terminaldeki Claude CLI’a — bakacağız.
Sıradaki yazı: Claude CLI’a Giriş
]]>The first stop in my “Claude Code Journey” series, following the roadmap.sh/claude-code curriculum.
A few years ago, writing code meant typing every single line yourself. Today a different approach is becoming common: you describe what you want in natural language, the AI writes the code, and you run it and steer the result. This is called vibe coding.
The phrase took off in early 2025 to describe the “go by feel” nature of AI-assisted development. The idea is simple: instead of holding every detail of the code in your head, you describe the overall intent (“make a login screen like this, validate the email”) and evaluate and correct what the model produces. The focus shifts from how something is written to what it does.
In the classic flow the loop is: think → write → run → debug. In vibe coding the loop becomes: describe → evaluate → steer. You’re now responsible for the result and the direction, not for each individual line. This is a real speed boost, especially when:
Let’s be honest — yes. The appeal of vibe coding also brings the risk of accepting generated code without understanding it. Code that runs isn’t always correct, secure or maintainable. If you keep piling up output without reading it, your own project eventually turns into a stranger.
The balance that works: let the AI produce the draft, but keep understanding and approval with you. Just like I don’t auto-publish this blog series without reviewing it — speeding up production is one thing, handing off responsibility is another.
Claude Code is a tool that lets you do vibe coding from the terminal. Instead of asking for individual functions, you give it a goal (“make these tests pass”, “find and fix this bug”) and it works toward that goal by reading and writing files and running commands. In the next posts of the series we’ll get into exactly how that works — starting from the CLI and moving on to commands, hooks and subagents.
Vibe coding is the shift from writing code to managing it. Used well, it’s an enormous accelerator; trusted blindly, it’s a technical-debt machine. The secret is to take the speed without giving up control.
Next post: What Is a Coding Agent?
]]>Bu yazı, roadmap.sh/claude-code müfredatını takip ettiğim “Claude Code Yolculuğu” serisinin ilk durağı.
Birkaç yıl önce kod yazmak demek, her satırı bizzat klavyeden geçirmek demekti. Bugün giderek yaygınlaşan başka bir yaklaşım var: ne istediğini doğal dille anlatıyorsun, yapay zekâ kodu yazıyor, sen sonucu çalıştırıp yönlendiriyorsun. Buna vibe coding deniyor.
Tabir, 2025 başında yapay zekâ destekli geliştirmenin “hisse göre ilerleyen” doğasını anlatmak için popülerleşti. Fikir basit: kodun her detayını kafanda kurmak yerine, genel niyeti (“şuna benzer bir giriş ekranı yap, e-postayı doğrula”) tarif ediyorsun ve modelin ürettiğini değerlendirip düzeltiyorsun. Odak, nasıl yazıldığından ne yapıldığına kayıyor.
Klasik akışta döngü şöyle: düşün → yaz → çalıştır → hata ayıkla. Vibe coding’de döngü şuna dönüşüyor: tarif et → değerlendir → yönlendir. Sen artık tek tek satırların değil, sonucun ve yönün sorumlususun. Bu, özellikle:
ciddi bir hız kazandırıyor.
Burada dürüst olmak lazım — var. Vibe coding’in cazibesi, üretilen kodu anlamadan kabul etme riskini de beraberinde getiriyor. Çalışan kod her zaman doğru, güvenli veya bakımı kolay kod demek değil. Üretilen şeyi okumadan biriktirdiğinde, bir süre sonra kendi projende yabancıya dönüşürsün.
İşe yarayan denge şu: yapay zekâ taslağı üretsin, ama anlama ve onay sende kalsın. Tıpkı bu blog serisini otomatik üretip incelemeden yayınlamamam gibi — üretimi hızlandırmak başka, sorumluluğu devretmek başka.
Claude Code, vibe coding’i terminalden yapmanı sağlayan bir araç. Tek tek fonksiyon istemek yerine, ona bir hedef veriyorsun (“bu testleri geçir”, “şu bug’ı bul ve düzelt”) ve dosyaları okuyup yazarak, komut çalıştırarak hedefe gidiyor. Serinin sonraki yazılarında tam olarak bunun nasıl çalıştığına — CLI’dan başlayıp komutlara, hooks’a ve subagent’lara kadar — gireceğiz.
Vibe coding, kodu yazmaktan çok kodu yönetmeye geçiş. Doğru kullanıldığında muazzam bir hızlandırıcı; körü körüne güvenildiğinde ise teknik borç makinesi. Sır, hızı almak ama kontrolü bırakmamakta.
Sıradaki yazı: Coding Agent (Kodlama Ajanı) Nedir?
]]>