What Claude Code Is (and Isn't)

Agentic teammate, not an autocomplete

Beginner 12 minBuilderDecision-maker
What you'll be able to do
  • Distinguish an agentic coding tool from a copilot/autocomplete and explain why the difference matters
  • Describe the three-phase agentic loop (gather context, take action, verify) that powers every Claude Code task
  • Name the surfaces Claude Code runs on and explain why they share one engine and one configuration
  • Identify the five built-in tool categories and the default model/context window
  • Explain how permissions and checkpoints keep an agent that can run commands safe and reversible
At a glance

Claude Code is Anthropic's agentic coding tool: it reads your whole codebase, plans multi-file changes, runs commands and tests, iterates on failures, and commits — all while staying steerable and asking permission before it touches anything. This lesson builds the mental model the rest of the course depends on: agentic teammate, not autocomplete.

  1. 1The mental model: a teammate, not a hint
  2. 2How this differs from Copilot / autocomplete
  3. 3The engine: a three-phase agentic loop
  4. 4Five built-in tool categories
  5. 5One engine, many surfaces
  6. 6The model and the context window
  7. 7Safety: permission to act, power to undo

The mental model: a teammate, not a hint

Before any commands or config, fix one idea in your head, because everything else in this course rests on it: Claude Code is an agent, not an autocomplete.

An autocomplete tool watches your cursor and offers the next line. You are still doing the work — reading the codebase, deciding what to change, opening files, running tests, fixing the failures. The tool just types a little faster than you.

Claude Code works the way a capable teammate does. You hand it a goal in plain language — "add rate limiting to the login endpoint and update the tests" — and it reads the relevant parts of your codebase, forms a plan, edits multiple files, runs the tests, reads the failures, fixes them, and commits the result. It is doing the loop you would otherwise do by hand, not just predicting your next keystroke.

That shift — from suggesting lines to executing tasks — is the whole reason the tool exists, and it's why the skills you'll learn here (steering it, scoping work, reviewing diffs, managing context) look more like delegating to a junior engineer than configuring an editor plugin.

Key insight

One sentence to remember

Autocomplete finishes your line. Claude Code finishes your task — reading, planning, editing across files, running tests, and committing — then hands you a diff to review.

How this differs from Copilot / autocomplete

The clearest way to internalize the model is to put the two side by side. Tools like GitHub Copilot's classic inline suggestions are completion tools: they predict the next token at your cursor, in the file you're already in, while you drive. They're genuinely useful — but the human stays in the loop for every decision.

Claude Code is an agentic tool. It operates across your whole project, takes a sequence of actions on its own, and closes its own loop by running checks. Two properties make that safe rather than reckless:

  • It asks permission. It cannot silently edit files or run shell commands. By default it pauses and asks before edits and commands (you can widen or narrow that — covered later in the course).
  • It stays steerable. You're never locked out mid-run. Press Esc to interrupt instantly, type a correction, and it picks up your new instruction after its current action. You never have to restart from scratch.
Autocomplete / CopilotClaude Code (agentic)
Unit of helpNext line at your cursorA whole multi-step task
ScopeThe current fileThe entire codebase
Who drivesYou, every stepThe agent, with your oversight
Runs commands / testsNoYes (with permission)
Commits, opens PRsNoYes
Closes its own loopNo — you verifyYes — runs checks and iterates

Neither is "better" in the abstract — they solve different problems. But conflating them is the single most common reason newcomers misuse Claude Code, so keep the distinction sharp.

Tip

Steer, don't restart

If Claude heads the wrong way, hit Esc and type the correction. It reads your message after the current action and adjusts — no need to kill the session and re-explain from zero.

The engine: a three-phase agentic loop

What does "agentic" actually do under the hood? Every Claude Code task runs the same loop — three blended phases that repeat until the work is done:

  1. Gather context — read files, search the code, explore the project to understand what's there.
  2. Take action — edit files, run commands, create branches, run a dev server.
  3. Verify results — run tests, check output, evaluate whether the goal is actually met — and if not, loop back.

The loop is adaptive, not a rigid script. A question like "where is auth handled?" may only need phase 1 — gather context, answer, done. A refactor across ten files runs all three phases several times, re-reading after each edit and re-running tests until they pass. Claude decides how much of the loop a given task needs.

This is exactly why a verifier matters so much: the Verify phase is what lets the agent know it's actually finished, rather than stopping when the code merely looks done. Give it a test command or a build and it closes its own loop; withhold one and you become the verification step.

text
      ┌─────────────────┐
      │ Gather context  │  read files, search, explore
      └────────┬────────┘
      ┌─────────────────┐
      │  Take action    │  edit, run commands, branch
      └────────┬────────┘
      ┌─────────────────┐
      │ Verify results  │  run tests, check output ──┐
      └─────────────────┘                            │
               ▲   (not done yet — loop back)         │
               └─────────────────────────────────────┘

Note

Adaptive means it skips phases

Not every task touches all three phases. A pure question needs only context-gathering; a trivial rename may skip extended verification. The loop bends to the task rather than forcing a fixed sequence.

Five built-in tool categories

An agent is only as capable as the actions it can take. Out of the box, Claude Code ships with five categories of built-in tools — the verbs it uses to move through that loop:

CategoryWhat it doesExamples
File operationsRead, edit, create, and rename filesOpen a source file, apply a multi-line edit, scaffold a new module
SearchFind code by pattern and explore structuregrep for a symbol, find files by glob, explore the directory tree
ExecutionRun shell commands, git, tests, dev serversnpm test, git commit, start a local server
WebSearch the web, fetch pages, look up errorsPull current docs, look up an error message
Code intelligenceType errors, jump-to-definition, find referencesSurface a type error, navigate to a symbol's definition (via plugins)

You don't invoke these by hand — Claude selects them as the task demands. The thing to notice is the shape of the capability: it can not only read and write code but run it and search the web, which is precisely what separates an agent from a suggestion box. (Beyond these built-ins, MCP servers let you add external tools — databases, Jira, Figma — but that's a later lesson.)

Key insight

Execution is the dividing line

An autocomplete tool can read and write text. The Execution category — running tests, git, and shell commands — is what lets Claude Code verify its own work and behave like a teammate rather than a typist.

One engine, many surfaces

Here's the part that surprises people: Claude Code is not a terminal program with some spin-off apps. It's one engine that shows up on many surfaces. You'll most often meet it as a terminal command, but the same agent runs everywhere:

SurfaceWhere you use it
Terminal CLIclaude in any project directory — the canonical surface
VS Code extensionInside VS Code
JetBrains pluginIntelliJ, PyCharm, and the rest of the JetBrains IDEs
Desktop appRedesigned macOS/Windows app (released April 14, 2026): visual diff review, multi-session management, scheduled tasks
Webclaude.ai/code — run sessions in the browser
iOS appClaude Code on your phone
SlackDrive Claude Code from Slack
CI/CDHeadless runs in pipelines (e.g. GitHub Actions)

Because it's one engine, your configuration is portable. The CLAUDE.md instructions you write, your settings, and your MCP server connections work identically across every surface. Set up your project once in the terminal, and the web session, the IDE extension, and the CI run all behave the same way. You learn the tool once; you use it everywhere.

This is also why this course teaches concepts (the loop, permissions, context, CLAUDE.md) rather than one app's buttons — the concepts transfer across every surface unchanged.

Tip

Configure once, run anywhere

Your CLAUDE.md, settings, and MCP setup are not terminal-specific. Commit them to the repo and every surface — IDE, web, Desktop, CI — inherits the same behavior automatically.

The model and the context window

The agent is powered by Anthropic's frontier models. Specifics shift as new models ship, so run /model to see what your account offers right now:

  • Default model depends on your account tier: Pro, Team Standard, and Enterprise subscription seats default to Sonnet 4.6; Max, Team Premium, Enterprise pay-as-you-go, and Console (API) default to Opus 4.8. Either way, switch with /model or the --model flag (e.g. claude --model opus) — run /model to see the options for your account.
  • Opus and Sonnet both serve well; reach for Opus on the hardest reasoning, planning, and refactoring tasks and Sonnet for fast everyday coding.
  • Context window: 200K tokens standard, automatically extended to 1M for Opus on Max, Team, and Enterprise plans with no extra setup. Sonnet with 1M context requires usage credits. Switch within a session via /model opus[1m] or /model sonnet[1m]. That's room to hold large portions of a real codebase, the conversation, your CLAUDE.md, and tool results at once — which is what lets the agent reason across many files instead of one snippet.

A practical note for newcomers, because it trips people up: Claude Code is not on the free tier. It requires a paid plan — Pro, Max, Team Premium, Enterprise, or Console (API). A free Claude.ai account cannot run it.

One more currency note worth fixing now. The older tiered "think" / "think hard" escalation is gone — those phrases are now passed through as ordinary prompt text, because models from 4.6 onward use adaptive thinking and decide how much to reason based on the task automatically. The one keyword that still works is ultrathink: include it anywhere in a prompt to request deeper reasoning on that turn without changing your session effort setting.

Watch out

Two things to un-learn

(1) Claude Code needs a paid plan — it is not on the free tier. (2) The tiered think / think hard escalation is gone — reasoning is adaptive in 4.6+ models — but ultrathink is still a valid keyword for a one-off deep-reasoning boost. Don't carry the old escalation habit in from older guides.

Safety: permission to act, power to undo

An agent that can run git, edit files, and execute shell commands sounds alarming — until you see the two guardrails that make it trustworthy. They're worth understanding on day one.

1. It asks permission before acting. Claude Code does not silently change your files or run commands. By default it pauses and asks before file edits and before running commands, showing you exactly what it wants to do. You stay in control of every consequential action. (You can tune this — granting standing permission for safe operations or locking things down for automation — which the permissions lesson covers in depth.)

2. Every edit is reversible via checkpoints. Before Claude edits a file, it snapshots the prior state. If a change goes wrong, press Esc Esc (on an empty prompt) or run /rewind to restore your code — and optionally the conversation — to an earlier checkpoint. Every prompt you send also creates a checkpoint, so you can rewind to any point in the session.

Two honest limits on checkpoints, so you don't over-trust them:

  • They are local to the session and separate from git — think of them as an undo stack for the agent's edits, not a replacement for commits.
  • They cover file changes only. Side effects outside the filesystem — a dropped database row, a sent API request, a git push — are not captured by a checkpoint and can't be rewound.

Together, permission to act and power to undo are what let you delegate real work to an agent without flying blind: nothing happens without your say-so, and almost any local mistake is one keystroke from being unmade.

Watch out

Checkpoints undo edits, not consequences

/rewind (or Esc Esc) restores files, but it cannot un-send an API call, un-push a commit, or restore a deleted database row. For anything with effects beyond your local files, rely on git and real backups — not checkpoints.

Try it: Run your first agentic task and watch the loop

Goal: feel the difference between autocomplete and an agent firsthand. 1) Confirm access. You need a paid plan (Pro, Max, Team Premium, Enterprise, or Console) — the free tier can't run Claude Code. 2) Start a session. In a small repo of yours (ideally one with a test command), run claude in the terminal. 3) Give it a real task, not a snippet. Try something with a verifier, e.g. "Find and fix the failing test in this project. Run the test suite to confirm, and don't edit files outside src/." 4) Watch the three phases. Notice it first gathers context (reading and searching files), then takes action (editing), then verifies (running the tests) — and loops back if they fail. 5) Practice steering. Mid-run, press Esc, type a small course-correction, and watch it adapt without restarting. 6) Practice undo. After it edits a file, press Esc Esc (empty prompt) or run /rewind and restore to an earlier checkpoint. 7) Write three sentences: where did it gather context, where did the verifier let it know it was done, and what did permission/checkpoints feel like in practice? This builds the core instinct the rest of the course assumes — that you're delegating to a steerable teammate, not configuring an editor.

Key takeaways

  1. 1Claude Code is agentic, not autocomplete: it reads the whole codebase, plans multi-file changes, runs commands and tests, iterates on failures, and commits — closing the loop you'd otherwise run by hand.
  2. 2Unlike Copilot-style completion, it requires permission to edit or run commands and stays steerable — press Esc and type a correction mid-run instead of restarting.
  3. 3The engine is a three-phase adaptive loop: gather context → take action → verify results, repeating until the goal is met.
  4. 4It's one engine across many surfaces (terminal, VS Code, JetBrains, the redesigned Desktop app, web at claude.ai/code, iOS, Slack, CI/CD) — and CLAUDE.md, settings, and MCP work identically on all of them.
  5. 5Its default model depends on your account tier (Sonnet 4.6 for Pro/Team Standard/Enterprise seats; Opus 4.8 for Max/Team Premium/pay-as-you-go/Console) with a 200K-token context window (auto-extended to 1M for Opus on Max/Team/Enterprise), and offers five built-in tool categories: file ops, search, execution, web, and code intelligence.
  6. 6Permission gates and checkpoints (Esc Esc / /rewind) make every local edit reversible — but checkpoints cover file changes only, not git pushes, API calls, or database side effects.

Quiz

Lock in what you learned

Check your understanding

0 / 4 answered

1.What most fundamentally distinguishes Claude Code from a tool like GitHub Copilot's inline autocomplete?

2.A teammate says, 'I gave Claude Code a refactor; it edited some files but I'm not sure the change is actually correct.' Which phase of the agentic loop most directly addresses this, and what does the agent need from you?

3.You set up a project's CLAUDE.md and MCP servers while working in the terminal. A colleague then opens the same repo in the VS Code extension and another runs it in CI. What happens to your configuration?

4.Claude Code finishes a task that edited several files AND ran 'git push' to your remote. You realize the change was wrong and press Esc Esc to rewind. What is restored?

Go deeper

Hand-picked sources to keep learning