Skip to main content

Claude Code Basics Lesson 35 of 46

The Subagent: A Helper With Its Own Desk

In short
  • A sub-agent is a helper that works in another room, with its own desk.
  • It comes back and tells you only the result: the mess stays with it.
  • It's there to keep your table clean — and so to get you better answers for longer.
  • Some already exist ready-made, and you can create your own.

The problem: some jobs make a mess

There are tasks that, to get done, require looking at a huge amount of stuff and then throwing it away. "Find which document I wrote that thing in": to answer, it has to open twenty files, and nineteen had nothing to do with it.

You already know the catch from the last chapter: those nineteen files stay on the table. You spent half the space to get to a one-line answer, and from then on the rest of the session works worse.

The solution: send it off to do it elsewhere

A sub-agent is a helper you send into another room. It has its own desk, it opens the twenty files itself, makes its own mess, and then comes back and tells you one line: "it's in the March 14th document."

All the clutter stayed over there. Only the answer arrived on your table.

It's not a different model and it's not smarter: it's the same tool, with a separate context. It has its own instructions, the tools you choose to give it, and its own permissions.

The limit, which is also the strength

The empty desk cuts both ways: it doesn't carry your clutter along, but it also doesn't know what you were talking about.

So a delegated task needs to be explained in full. If you send "check if it adds up," it has no idea what's supposed to add up. It's the same job you do when you hand work to a colleague who wasn't in the meeting.

The ones you already have without knowing it

Some helpers already exist, and Claude uses them on its own when needed. The two you'll run into most often:

  • Explore — goes to search and understand how something is built, without changing it. It's the case of the messy search from before.

  • Plan — prepares a plan, like in the chapter on permissions, but in a separate room.

If you've seen those names pop up while it worked and didn't know what they were, now you do: helpers sent off to another room.

Creating your own

Once you notice you're always sending the same kind of helper with the same instructions, it's worth defining it once and for all: a helper with a name, a task, a character, and the tools you choose.

The practical way is the same as always: ask Claude — "create me a helper that does this and this, and can only read" — and let it write the file. Then you reread it, same as with skills.

And now

Put that way, it sounds like it's always worth delegating. It isn't, and the reason is the bill: a helper starting from zero has to rebuild everything, and that costs. In the next lesson, when it's worth it and when it isn't.

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 comes back into your conversation when a sub-agent is done?

Does the sub-agent see your conversation?

What is the built-in helper called Explore for?

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.