What Claude Code is, in plain language
Claude Code is Claude with your files open. It runs in a terminal, it works inside whatever folder you start it in, and instead of telling you what to do it goes and does it, then checks whether what it did worked.
The name is the problem. It says code, so everyone who is not a programmer assumes it is not for them, and that is wrong in a way that costs people a lot. Most work that is not coding is also files and commands. A folder of transcripts. A spreadsheet of leads. Two hundred images that need renaming. A script that calls an API and writes the result somewhere. All of that is exactly what it is good at.
Everything on this site was built with it by someone doing marketing. The barrier is being willing to open a terminal, not knowing how to program.
Installing it, on any machine
- What you need
- A paid Claude plan from $20 a month, or an API account
- Operating system
- Macos 13+, windows 10 1809+, ubuntu 20.04+, debian 10+, alpine 3.19+
- Hardware
- 4 GB of ram, x64 or arm64
- Time
- About five minutes, most of it waiting
- Also available as
- A desktop app, in vs code and jetbrains, on the web, in slack, and in ci
From Anthropic's setup docs, read 2026-08-27.
1Get a plan
Claude Code is not free. You need a paid Claude plan (Pro at $20 a month, Max, Team or Enterprise) or a Claude console account with credit on it.
This trips up almost everyone once, because the install itself works perfectly and then the login refuses you. Nothing is broken. The full cost picture is on The pricing page.
2Install it with one line
Open a terminal and paste the line for your machine.
# macOS, Linux, WSL curl -fsSL https://claude.ai/install.sh | bash # Windows PowerShell irm https://claude.ai/install.ps1 | iex # Windows CMD curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Not sure which windows shell you are in? Your prompt shows
PS C:\in PowerShell andC:\in cmd.Homebrew (
brew install --cask claude-code) and winget (winget install Anthropic.ClaudeCode) both work too, with one catch worth knowing: the native install updates itself in the background, and the homebrew and winget ones do not. If you install that way you have to run the upgrade yourself.3Close the terminal, open a new one
This is not optional and it is the reason half the "command not found" comments exist. The terminal reads your PATH when it starts, so the window that ran the installer does not know about the new command yet.
In the new window,
claude --versionshould print a number followed by(Claude Code).4Start it in a folder that matters
Claude Code works inside the folder you launch it from. So go somewhere real first, then type
claude.If you are not a developer and have no code to point it at, make an empty folder for the thing you actually want. I started mine as a folder with a text file describing my content process, and everything since has grown out of that.
5Ask before you tell
The first prompt should be a question, not a job. "what is in this folder and what does it do?"
Two reasons. You find out how it explains things, which tells you how much context it needs from you. And if it is wrong, nothing has happened yet.
6Write down how you work, once
Make a file called
CLAUDE.mdin the folder. Put in it what this project is, how you want things done, and anything you have found yourself saying twice.Claude Code reads it at the start of every session. This is the single highest-leverage thing on this page: it is the difference between a clever assistant you re-brief daily, and something that already knows how you work.
Your first twenty minutes
A sequence that works, in the order that gets you to something real fastest.
- Ask it what is in the folder. You are testing how it explains, not what it knows.
- Ask it to make one small change you could check by eye in ten seconds. Rename something. Fix a typo across five files.
- Ask it to do something you would have to look up. Convert a folder of images. Pull the numbers out of a CSV into a summary. This is where it stops being a demo.
- Write your
CLAUDE.md. Five minutes, and every session after this one is better for it. - Give it something real and walk away. Come back and read what it did.
The one habit worth forming on day one
Read what it changed before you accept it. Not forever, just until you have a feel for where it is reliable and where it guesses. That calibration is the whole skill, and you cannot get it by reading about it.
The commands that actually matter
There are a lot. These are the ones I use every day, and the rest you can meet when you need them.
| command | What it does | When I reach for it |
|---|---|---|
| /clear | Throws away the conversation so far | Every time I switch to an unrelated task. Keeps answers sharp and the bill small. |
| /usage | Shows what this session and this month have used | Once a week, and any time something feels slow |
| /model | Switches which model is answering | Down to a cheaper one for routine editing, up for anything that needs judgement |
| Plan mode | Makes it write the plan before touching anything | Anything that will change more than a couple of files |
| /doctor | Prints a health report on the install | First thing when something is broken and I do not know why |
| /help | Lists everything else | More often than I expected to |
What it does
- /clear
- Throws away the conversation so far
- /usage
- Shows what this session and this month have used
- /model
- Switches which model is answering
- Plan mode
- Makes it write the plan before touching anything
- /doctor
- Prints a health report on the install
- /help
- Lists everything else
When I reach for it
- /clear
- Every time I switch to an unrelated task. Keeps answers sharp and the bill small.
- /usage
- Once a week, and any time something feels slow
- /model
- Down to a cheaper one for routine editing, up for anything that needs judgement
- Plan mode
- Anything that will change more than a couple of files
- /doctor
- First thing when something is broken and I do not know why
- /help
- More often than I expected to
The four ideas that make it click
People who get value out of Claude Code and people who bounce off it are usually separated by these four, not by technical skill.
1. Context is the product. The quality of what you get back is decided almost entirely by what it can see. Naming the three files that matter beats letting it search the whole folder, and it is cheaper. Carrying an old conversation into a new problem makes the answers worse, not better, which is what /clear is for.
2. CLAUDE.md is where you stop repeating yourself. A file in the folder that it reads every session. What this project is, how you want it done, the rules that are not obvious. Anything you have explained twice belongs there instead.
3. Plan first on anything that matters. Ask for the plan before the work. You get to correct a paragraph instead of a day of edits, and it is the cheapest review you will ever do.
4. It is a delegation habit, not a typing habit. The failure mode is treating it like autocomplete and staying in the loop for every keystroke. The win is handing over a whole job, going and doing something else, and reviewing the result. That feels wrong for about a week and then it does not.
Past those four there are skills (reusable instructions it loads on demand), sub agents (separate workers for separate parts of a job), MCP servers (connections to outside services) and hooks (things that run automatically at certain points). None of them matter until the four above are habits.
What I build with it
Every guide below is a real system I run, written out in full so you can rebuild it without watching anything. They are the answer to "fine, but what do I actually do with it".
- Claude Code for marketing: The overview: SMM, ads and outreach in one workspace
- Content creation in 10 minutes: Ten pieces of content, images included, in one run
- Viral Instagram reels: Study what already worked, then write from it
- Claude Code as a video editor: Cutting the reel, not writing it
- Viral TikTok videos: The TikTok version of the same pipeline
- An X/Twitter content machine: Posts plus generated infographics
- Social media growth: The system that decides what to post next
- B2b outreach, 35% reply rate: Research, write, review, send
- LinkedIn outreach with cowork: The browser-driving version
- A second brain in Obsidian: Notes that answer back
- Video ads: Concept to cut
- A high-converting landing page: The kit I built boldane.com with
And if the job is a document rather than a repository, Claude Cowork is the other half of the same plan.
The mistakes everyone makes first
- installing the VS Code extension and expecting the
claudecommand. The extension keeps a private copy for its own panel. Install Claude Code itself. - Not opening a fresh terminal after installing. The old window does not know about the new command.
- Expecting the free plan to work. It installs and then will not sign you in, which reads as a bug and is not one.
- Letting one session run all day. The conversation becomes input on every turn, so it gets slower, more expensive and less accurate at the same time.
- Skipping permission prompts to go faster. The prompts are the only thing standing between a misunderstanding and a deleted folder. Read them until you have a feel for it.
- Never writing a
CLAUDE.md. The most common one, and the most expensive.
The errors people actually hit, taken from the comments under my videos, are answered in the troubleshooting section above. What it costs, including Anthropic's own figures for what real usage runs to, is on The pricing page. And if you are still deciding between this and an editor, the Comparison is next door.
Install commands and system requirements checked against Anthropic's own quickstart on 2026-08-27.