What Is Claude Code? A Beginner's Guide to Coding Harnesses (2026)

Last tested and updated: June 2026

You’ve pasted a function into ChatGPT and watched the answer look right but fail at runtime. A coding harness closes that gap: it reads your repo, runs your tests, and loops until green. Claude Code is Anthropic’s coding harness.

See L02 — Vibe Coding vs Real Coding for the first hands-on.

The hook

Pick a real task from your last sprint: “Add a ?since= filter to the user list endpoint, and update the tests.”

A chatbot can’t do this. It doesn’t know your routes, ORM, test fixtures, or the broken serializer. A coding harness does. It lives in your repo, runs the tests, fixes what fails. That’s the gap.

A coding harness turns an AI from a question-asker into a project-worker. It reads your codebase, runs commands, proposes diffs, and loops on test output until done. Claude Code is the Anthropic-native version.

The mental model

Claude Code is an engineering shell that wraps a model and lives in your repo. A chat interface is a slot machine. Claude Code is a teammate.

The diagram above is the shape of a real session. The cycle is:

1. You open Claude Code in your repo and describe a task in plain English.
2. Claude Code reads the relevant files, proposes a diff, and runs the test runner.
3. The test runner either goes green — done — or returns an error. On error, the cycle loops.
4. When the suite is green, Claude Code commits and opens a pull request for human review.

The point isn’t that Claude Code is “smarter” than a chat model. It owns the engineering shell: the file system, the shell, the test runner, and the Git workflow. The model is the brain. The harness is the body.

Claude Code doesn’t replace the engineering shell. It is the engineering shell. The model inside it is interchangeable; the loop around it is the product.

Pick your tool

Claude Code is not the only way to use AI in 2026. Pick wrong in week one and you may not ship by month one.

Coding harnesses verify by running. They live in your repo, run your test suite, and iterate. Claude Code, Kilo Code, and Cursor’s agent mode are the three that matter in 2026.

Agent harnesses verify by inferring. They live outside one codebase, persist across sessions, run on schedules, and integrate with chat channels. Hermes is the flagship. See L01 — What Is Hermes Agent?.

Chat interfaces are the third category. They’re a tab you open, a question you type, an answer you copy-paste. Useful for one-shot research, useless for shipping software.

When to pick which

Goal	Pick	Why
Ship a feature in a real repo	Claude Code or Kilo Code	Test-driven loop, diff review, Git workflow.
Hard refactor across hundreds of files	Claude Code	Polished harness, long context, the best at “really big problems.”
Daily incremental work on a budget	Kilo Code + a cheap model	Open-source, BYOK (Bring Your Own Key) — you supply the model API key. $15–$30/mo instead of $200/mo.
7am Discord summary from RSS feeds	Hermes	Long-running, multi-channel, persistent — see L09 — Hermes vs Claude Code vs Mavis.
Visual / IDE-first workflow	Cursor with agent mode	Editor-native, less test-loop, more “show me the file.”
One-off “what does this regex mean?”	Chat interface	Single question, no repo context needed.

Rule of thumb: work in a repo → coding harness. Work outside one → Hermes. One-shot question → chat tab.

For pricing tiers, BYOK tradeoffs, and the Max plan — see L09 — Hermes vs Claude Code vs Mavis.

What Claude Code specifically is

Claude Code is Anthropic’s coding harness. It is a terminal-native program (also packaged as an IDE plugin) that:

• Reads and writes files in the repo you launch it from.
• Runs shell commands — npm test, pytest, go test, make, whatever your project uses.
• Proposes diffs before applying them, so you can review.
• Commits, pushes, and opens pull requests on GitHub.
• Works with any model Anthropic ships (Sonnet for daily, Opus for hard), but you don’t bring your own key.

What Claude Code is not:

• Not a chat app. The interface is a terminal session, not a web tab. There’s a desktop wrapper, but the underlying model is CLI.
• Not a model. Claude Code ships with Anthropic’s models baked in. Pricing is a flat subscription: Pro ($20/mo) for Sonnet, Max ($200/mo) for heavy Opus use.
• Not magic. Claude Code is best at well-bounded, well-tested work. Vague prompts on a sprawling codebase still go sideways — that’s the topic of L02 — Vibe Coding vs Real Coding.

A side-by-side: Claude Code vs Cursor

The two are the most-confused tools in 2026, and they’re not the same thing.

Dimension	Claude Code	Cursor (agent mode)
Where it lives	Terminal (CLI) + IDE plugin	IDE first, chat panel inside
Test loop	Yes — runs your suite, iterates	Partial — better for visual diffs
Best for	Hard refactors, multi-file work, shipping	Visual refactors, single-file edits, exploration
Pricing	$20 / $200 per month	~$20 per month
Open source	No	No
Diff review	First-class	Good
Beginner-friendly	Moderate (terminal)	Easy (IDE)

The honest answer: if your work is “I need to ship a feature in my repo this week,” Claude Code. If your work is “I need to fiddle with a component and see the preview live,” Cursor.

Try it

The exercise

You don’t need to install anything. The exercise is conceptual — but it forces the right mental model.

Open a text file on your computer. Write down the answer to this in your own words, no copy-paste:

“Pick a real task from your last week of coding — a bug, a refactor, a feature. Walk it through the loop: editor → harness → test runner → pull request. Where would Claude Code have helped? Where would you still need to be the engineer?”

A good answer names where Claude Code would have caught a regression. It also names where you stay in the loop: design, ambiguous requirements, diff review.

Check your understanding

See the standalone quiz at /lessons/ai-projects/L01-coding-with-claude-code/quiz.json (6 questions).

What’s next

• L02 — Vibe Coding vs Real Coding
• L09 — Hermes vs Claude Code vs Mavis
• L01 — What Is Hermes Agent?