Section 2
One app, one AI assistant, and a microphone. After that, your AI can install almost everything else for you.
You might expect a long list here. It isn't one, and that's deliberate.
You need exactly three things to start:
VS Code is a free app from Microsoft. It's a text editor, but a very good one — and more importantly it's where your AI assistant will live.
On a Mac, do one more thing so you can open projects from the terminal. In VS Code press Cmd+Shift+P, type shell command, and pick "Shell Command: Install 'code' command in PATH".
Now code . in any folder opens it. Small thing, used constantly.
This is the part where people accidentally spend a lot of money, so read this section slowly.
There are two completely different ways to pay for AI coding help:
| Subscription ✅ | API ❌ | |
|---|---|---|
| What you pay | A flat fee each month | Per word, forever, no cap |
| Surprise bills? | No. It's the same every month. | Yes. This is the famous problem. |
| How you sign in | Email and password, like any app | Pasting a long secret key |
| Right for you? | Yes | Not for now |
The API is built for companies running software that serves thousands of people. You're one person learning. Use the subscription.
| Assistant | How you pay | Roughly | Notes |
|---|---|---|---|
| Claude Code | Subscription | $20 / $100 / $200 a month | Very strong at long multi-step work |
| OpenAI Codex | Subscription | $20 or $200 a month | Comes with ChatGPT Plus / Pro |
| GitHub Copilot | Subscription | $10 a month | Cheapest. Best at finishing lines. |
| Kimi | Subscription | Varies | Handles very long documents well |
| Qwen | Pay per use | Very cheap | Alibaba's. Capable, inexpensive. |
| DeepSeek | Pay per use | Very cheap | Strong at code for the price |
| OpenRouter | Prepaid credit | You top up | One key, hundreds of models. Later. |
You don't need more than one. If you already pay for any of these, use that — no reason to pay twice.
To install Claude Code, open Terminal and run:
curl -fsSL https://claude.ai/install.sh | bash
Lines will scroll past for a minute while it downloads. That's normal — let it finish.
Wording varies slightly between versions. What matters is that it finishes without the word error on the last line.
Then start it and log in:
claude
It'll ask how you want to sign in. Choose the option that says Claude account with subscription — not the Console / API option. A browser window opens, you log in normally, and you're done.
For the VS Code extension: open the Extensions panel on the left (the four-squares icon), search Claude Code, check the publisher says Anthropic, and install. It uses the same login.
ANTHROPIC_API_KEY saved in it, Claude Code will ignore your subscription and bill you per word instead — even though you're paying monthly. You'd be paying twice, and the second one has no ceiling.
Check whether you have one. In Terminal:
echo $ANTHROPIC_API_KEY
sk-? That's an API key, and it's overriding your subscription.To remove it for the current terminal window:
unset ANTHROPIC_API_KEY
If it comes back every time you open Terminal, it's saved in a startup file. Ask your AI: "find where ANTHROPIC_API_KEY is being set in my shell config and help me remove it." That's exactly the kind of errand it's good at.
The same idea applies to the others — OPENAI_API_KEY does the same thing to Codex.
OpenRouter is a middleman. One account, one key, and you can reach hundreds of models — Claude, GPT, Gemini, Qwen, DeepSeek and many more — without signing up to each one separately.
It's worth knowing this exists, because one day you'll want to compare models, or use a cheap one for something boring and an expensive one for something hard. Have a look at the model list on their site; it's genuinely impressive.
Here's the bit that confuses everyone, so let's be blunt:
Like a games console: OpenRouter is the electricity, Cline is the console. Neither does anything alone.
vscode.
$0.003. Watch that number. It's the habit that keeps this safe: if a task ever jumps to something that makes you wince, stop it.
| What you see | What it means |
|---|---|
401 / "invalid key" | Key is wrong or has a stray space. Paste it again, carefully. |
402 / "insufficient credits" | No money on the account. Back to step 2. |
429 / "rate limited" | Too many requests too fast. Common on free models. Wait, or pick a paid one. |
| Nothing happens | Provider probably isn't set to OpenRouter. Check step 6. |
It's tempting to think the answer to disappointing results is a stronger model. Usually it isn't. Almost every time an AI heads off in the wrong direction, it's because nobody told it which direction was right — and the stronger the model, the further it gets before anyone notices.
The fix isn't a bigger subscription. It's a couple of small text files in your project saying what you're building, what you've already ruled out, and what it must never touch.
That's Section 3 — and it's the most important thing on this whole site. Better model, no harness, is the expensive way to go wrong. If you properly read one section, make it that one.
Describing what you want out loud is faster than typing it, and you'll naturally give more detail — which happens to make the AI much better at its job. Two ways to set this up.
| What you want | Mac | Windows |
|---|---|---|
| Talk into the file you're editing | Option+Cmd+V | Ctrl+Alt+V |
| Talk to your AI assistant | Cmd+I | Ctrl+I |
It runs entirely on your own computer. Your voice isn't sent anywhere, and it works with the wifi off.
If those shortcuts are awkward, change them:
voice.Option+Space gives you hold-to-talk without breaking normal typing.
For dictation in any app, not just VS Code:
There are also paid apps built specifically for hold-a-key-and-talk that tend to punctuate better. Worth looking at once you know you like working this way, but don't buy anything yet — start with the free one built into VS Code.
Here's where the effort stops. You've now got something that can set up anything else.
Whenever a project needs a tool you don't have, don't go hunting through websites. Ask:
I'm on a Mac and I want to <what you're trying to do>.
Tell me what I need to install, check whether I already
have it first, and give me the commands one at a time.
Explain what each one does before I run it, and tell me
if any of them change things outside this project folder.
Every clause in that prompt is doing something:
There's enormous pressure in programming to use the newest, most complicated tool. Resist it for now.
| What you're making | Use |
|---|---|
| Portfolio, blog, band page, anything you mostly read | Plain HTML |
| Something with a form that just emails you | Plain HTML |
| A page that updates live, logs people in, or saves their stuff | Now you need JavaScript |
| Something with accounts, payments, a database | JavaScript, and ask for help planning it |
Plain HTML has no build step, no dependencies to update, and nothing that can break while you sleep. The page you're reading is plain HTML. It loads instantly on a phone on bad hotel wifi, and it will still work in fifteen years.
Fancy frameworks are built to solve problems that appear at large scale. Borrowing their complexity before you have their problems just gives you the complexity.
When a project really does need JavaScript, use Bun.
Historically you'd install four separate tools that all had to agree with each other — and a lot of beginner pain came from them not agreeing. Bun is all four in one program. Fewer parts, fewer arguments.
curl -fsSL https://bun.com/install | bash
Check it landed:
bun --version
Any version number means it worked. command not found means the install didn't finish — close the Terminal, open a new one, and try again. New programs often only appear in a fresh window.
The four commands that cover most of what you'll do:
| Command | What it does |
|---|---|
bun init | Start a new project here |
bun add <name> | Add someone else's code to your project |
bun install | Get everything a project needs (after downloading someone's project) |
bun run <file> | Run it |
npm
Most of the time you can type bun where it says npm and it just works. If it doesn't, that's fine — npm still works too. Nothing is broken, they're simply two tools doing the same job.
index.html. Type <h1>hi</h1>, save, and open it in your browser. That's a web page. You've made one now.echo $ANTHROPIC_API_KEY. Confirm it prints nothing. Thirty seconds, potentially saves a lot.