Skip to main content

Claude Code Basics Lesson 3 of 46

How an Agent Works: The Loop

In short
  • An agent doesn't just answer and stop: it loops until the task is done.
  • The loop is always the same: think → ask for a tool → look at how it went → decide the next move.
  • The model has no hands: it asks, and the program on your computer executes.
  • The loop ends when it stops asking for tools and just talks to you.

Let's watch it on an example

You have a folder full of this year's invoices. You open Claude Code there and ask for one single thing: «check whether there are any duplicate invoices».

From the outside it looks like a question. From the inside, here's what happens:

  • it looks at what's in the folder, because it doesn't know;

  • it opens a few files to understand what an invoice looks like;

  • it runs a command to compare all of them;

  • the command doesn't return what it hoped, so it changes tack and tries again;

  • in the end it writes to you: there are two identical ones, here they are.

The point isn't how skilled it is. The point is that you didn't ask for any of those steps. You gave the goal; it chose the steps itself, one at a time, checking each time how the previous one had gone.

The loop, in four moves

What you just read isn't a lucky break: it's always the same loop, repeated. Four moves:

  • Think. It looks at the goal and what it knows so far, and decides what the next useful move is.

  • Ask for a tool. Read a file, write one, run a command: it says which one it needs.

  • Look at how it went. The result comes back — even when it's an error.

  • Decide the next move. And it starts over from the top.

This loop has a name, and you'll hear it often: the agentic loop. That's really all there is to it, and it's the one thing that makes an agent an agent instead of a chatbot.

Claude Code at work: first the command that lists the folder with its output, then the line «Empty folder — I'll create a single-file app», then the list of tools used, and at the bottom the time elapsed and tokens spent.
The loop in motion: it looked at the folder, saw it was empty, and that discovery decided the next move. At the bottom, the time and the spend you're paying for in that moment.

Who thinks and who executes

There's a detail that sounds technical but you'll need it for the rest of the course: the part that reasons isn't the part that executes.

The model — the "intelligent" part — can't touch anything on your computer. It doesn't open files, doesn't run commands, doesn't see your folder. All it can do is ask: «I need to read this file». It's the program running on your machine that executes the request and reports the result back to it.

It sounds like a technicality, but it's the reason why later on you'll be able to decide what it can and can't do: every request passes through a point where someone can say no. And that someone is you.

How you know it's done

As long as the model asks for tools, the loop keeps going: you watch its moves scroll by one after another. But when it replies without asking for anything, the loop closes.

That's why a session always ends with a written message: that message isn't the answer to your question, it's the signal that, as far as it's concerned, the work is done. If it looks done badly to you, that's where you pick it back up.

What's next

I've told you about the loop now. In the next lesson we actually watch it run: we open Claude Code, ask it for a small dashboard, and I point out every piece we talked about here as it scrolls by.

Did you get it?

Two minutes, no grade. Trying to answer — even getting it wrong — cements the concepts far more than rereading. Not in the mood? Skip it: the lesson still counts as complete.

What sets an agent apart from a chat?

Who actually opens and edits your files?

How do you know the loop is done?

Course Claude Code Basics
  1. Chapter 1 Introduction

    1. 1 The Claude Ecosystem and Where Claude Code Fits
    2. 2 What Claude Code Is: The Collaborator Who Walks Into Your Studio
    3. 3 How an Agent Works: The Loop
  2. Chapter 2 What's Underneath

    1. 4 Claude Code in Action: The Loop, for Real
    2. 5 The Model Has No Memory: It Starts Over Every Time
    3. 6 The Harness: The Engine and the Gear Around It
    4. 7 The Map: Four Buckets
  3. Chapter 3 You Choose the Engine

    1. 8 There's No Single Claude: The Model Lineup
    2. 9 Which Model for Which Job
    3. 10 Effort: How Hard It Should Think
    4. 11 Model or Effort? The Question That Trips Everyone Up
    5. 12 The Bill: Why Saving Money Can Cost You More
  4. Chapter 4 First Time at the Controls

    1. 13 Where to Run It: Four Doors In
    2. 14 What You Need Before You Start
    3. 15 Installing Claude Code
    4. 16 The Folder: Where You Open It Decides What It Works On
    5. 17 Choosing the Engine, in Practice
    6. 18 Your First Task: Small, Yours, and It Works
  5. Chapter 5 What You Let It Touch

    1. 19 Why It Asks for Permission
    2. 20 The Rules: Always Yes, Ask Me, Never
    3. 21 The Modes: How Much Leash You Give It
    4. 22 Plan Mode: Get the Plan Before the Work
    5. 23 Verification in the Loop: Give It a Yardstick
    6. 24 Example: Putting the Bucket Together
  6. Chapter 6 What It Knows About You

    1. 25 CLAUDE.md: The Notes It Reads the Moment It Walks In
    2. 26 How to Write a CLAUDE.md That Actually Works
    3. 27 The Context Window: How Much It Can Hold at Once
    4. 28 Cleaning Up: Compact and Clear
    5. 29 Automatic Memory
    6. 30 Example: From Repeating Yourself to Never Again
  7. Chapter 7 Skills

    1. 31 What a Skill Is: A Procedure Written Once
    2. 32 Creating Your First Skill
    3. 33 The Description Decides Whether It Gets Used
    4. 34 Example: A Skill That Saves You the Week
  8. Chapter 8 How Many You Put to Work

    1. 35 The Subagent: A Helper With Its Own Desk
    2. 36 When a Helper Is Worth It (and What It Costs)
    3. 37 Teams: When Agents Talk to Each Other
    4. 38 Example: Searching Without Cluttering the Desk
  9. Chapter 9 What It's Connected To

    1. 39 MCP: The Standard Plug Into Your Tools
    2. 40 Plugins: Packaging Up and Borrowing
    3. 41 Example: When You Stop Copying and Pasting
  10. Chapter 10 Automating the Setup

    1. 42 Hooks: The Thing That Always Happens
    2. 43 Where It Fires and What It Can Do
    3. 44 When You Actually Need One (and When It's Too Much)
  11. Chapter 11 Wrap-Up

    1. 45 The Project: Your Expense Tracker
    2. 46 Wrap-Up: What You're Taking Home
From a Confusing Brief to a Complete UX/UI A vague brief becomes a navigable app. Product Ad From a Single Photo A photo becomes an animated ad, no code required. Get Claude to Watch Your Videos Claude watches your videos and turns them into text. Higgsfield Inside Claude Code Generate images and video while you code in Claude Code. Turn a Loom Recording Into a Web Page A screen recording becomes a web page, no code. Vertical Shorts With NotebookLM Your sources become a vertical short. Luxury Landing Pages on Lovable A luxury landing page from a single prompt. Excalidraw Running Locally Excalidraw free on your computer, no code. Mistral OCR in Your Workflow Extract text from documents with Mistral OCR. Claude SEO in the Terminal 25 free SEO skills inside Claude Code. Google Search Console inside Claude Code Search Console data inside your terminal. Claude Code Routines Claude working on its own, computer off. Clone a Landing Page in React With v0 Clone a real landing page into React code. Context Economy With Claude Work light and don't burn through Claude's limits. From Prompt to Self-Improving Skill Claude skills that learn from your mistakes. From NotebookLM to Canva: Presentations NotebookLM slides, finally editable in Canva. The Map for Understanding Every AI Tool 12 categories for placing any AI tool. Transparent PNGs With ChatGPT Real transparency, not a fake checkerboard. Animated Infographics With Gemini Infographics that loop, animated with Gemini. Market Research With Deep Research Deep Research as your market analyst. Get Cited by AI Search Engines (AEO) Become a source that ChatGPT and Perplexity cite.