Skip to main content

Claude Code Basics Lesson 27 of 46

The Context Window: How Much It Can Hold at Once

In short
  • The context window is the table: everything the model has in front of it right now.
  • It's not memory: it's capacity. And it clears the moment the session closes.
  • It gets filled by the instructions, the files it opens, command outputs, and the whole conversation.
  • Full table = worse answers and higher costs, with no warning at all.

The table, not the memory

Picture your collaborator sitting at a table. To work, it needs everything in front of it at once: the notes pinned up in the office, the documents it's opened, the notes from what you've said to each other so far.

That table has a surface, and it's finite. The context window is that surface.

Careful not to confuse it with memory, because they're opposites: memory is what's left afterward, the table is what fits right now. And at the end of the session, the table clears completely.

What fills it up

  • Your permanent instructions — the CLAUDE.md, sitting there from the start. That's why the last lesson insisted on keeping it short.

  • The files it opens. Every file it reads lands on the table and stays there.

  • Command outputs, including the very long ones and the failed ones.

  • The whole conversation, yours and its, from the start of the session.

Now recall the lesson on the model with no memory: since the model rereads everything from scratch every turn, the table isn't just capacity — it's also the bill. The more stuff is on it, the more every single move costs.

Full doesn't mean better

The table on these models is enormous, and the natural reaction is: great, so I'll just dump everything on it. It's the same mistake as the folder that's too big and the instructions file that's too long.

When the table fills up with stuff that's no longer needed — files opened half an hour ago, failed commands, a topic you abandoned — the things that matter carry less weight. The result is that answers get worse, slowly, with no warning.

You don't get an error. You get increasingly imprecise answers, and you blame the model.

Watching it: /context

No need to go by feel: /context shows you how full it is and what's taking up the space. It's the same command you met in the installation chapter, and it's also where you check that your instructions file actually got loaded.

In the desktop app you don't even need the command: the dot in the bottom right, next to the effort setting, opens the summary.

Looping animation: the cursor clicks the dot at the end of the bar, after model and effort, and the summary opens: «Context window» at zero and below it the plan limits, with the 5-hour quota and the weekly one and their respective percentages.
In the same panel there are two different counters that are easy to mix up: on top, this session's table; below, how much of your plan you've used. The first one clears when the session closes, the second one doesn't.

The useful thing isn't the number: it's the breakdown. If you find out half the table is taken up by your instructions, you know what to trim. If it's the conversation that's taken over, you know it's time to clean up.

And now

I've said "clean up" three times across two lessons without ever explaining it. In the next one we look at the two moves that do it — and there are two, different ones, and using the wrong one in the wrong spot is a shame.

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 is the context window?

The table is nearly full. What should you expect?

How do you check how much space you've used up?

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.