A getting-started guide

Start with
Claude Code

An AI collaborator that lives in your terminal. You tell it what you want in plain English, and it builds it. By the end of this guide you'll have a real website of your own, live online.

~10 min setup~30 min first projectNo coding experience
The steps

Day one → getting good

Click a number to open →
01What you need
01

What you need

  • Your own Claude subscription — the Claude Pro plan (about €17/month) includes Claude Code. Make your own account at claude.ai and pick Pro; you'll log in with it in step 2.
  • A free GitHub account, where your code lives.
  • A free Vercel account. It puts your projects on the internet; sign up with GitHub.
  • A terminal. Mac: the Terminal app. Windows: PowerShell.
  • Optional: Supabase, a free database for when a project needs to remember things. Skip it for now.

You don't need to install anything else yourself. Claude sets up the developer tools for you in step 5.

02Install & launch
02

Install & launch

Mac — open Terminal and run:

Terminal
curl -fsSL https://claude.ai/install.sh | bash

Windows — open PowerShell and run:

PowerShell
irm https://claude.ai/install.ps1 | iex

Then make a folder and start Claude inside it:

Terminal
mkdir my-first-project
cd my-first-project
claude
Logging in

When Claude starts, it opens your browser to log in with your Claude account — use the one with your Pro subscription. No API key needed.

Mental model

Claude works in the folder you started it in, and you talk to it in plain English. One folder per project.

03Bypass permissions
03

Turn on bypass permissions

By default, Claude checks with you before every edit and command. For an expert that's useful. While you're learning it just gets in the way, so turn it off:

Paste into Claude
Turn on bypass permissions permanently — change my settings so I don't have to approve every action.

Claude edits its own settings file. Then restart it: type exit, run claude again, and accept the one-time warning.

Why this is safe enough

You work in one folder per project, so there's nothing here Claude can break that you couldn't rebuild. Git keeps a history you can roll back to, and your CLAUDE.md tells Claude never to delete anything without checking first.

04Your CLAUDE.md
04

Your CLAUDE.md

CLAUDE.md is a file of standing instructions Claude reads at the start of every session. Copy the starter, then tell Claude: "create a CLAUDE.md with this content" and paste.

Starter CLAUDE.md
# My Claude Code Preferences

I'm a beginner learning to build things with AI. Help me learn, not just ship.

## How to communicate
- Explain *why* you chose an approach before doing it.
- Make changes in files; tell me in plain English what you did.
- When something errors, explain what it means before fixing it.
- Use simple, readable solutions over clever ones.

## Safety
- Commit to git after every working change. Git is my undo button.
- Never delete files or run destructive commands without asking.
- If about to do something irreversible, stop and explain first.

## Working style
- For anything bigger than a small fix, give me a 2-3 sentence plan first.
- Verify changes actually work before saying it's done.
- One task at a time. Finish and verify before moving on.

## Memory
- Keep a NOTES.md: plan, decisions, what's done, what's next.
- When I say "gnite": commit + push, update NOTES.md, short summary.
The most important thing

The file grows with you. Every time Claude does something you didn't like, add a rule for it. By the end, the CLAUDE.md is yours.

05GitHub & Vercel
05

Set up GitHub & Vercel

Now let Claude set up your developer tools — this is where those free accounts come in:

Paste into Claude
Set up my computer for web development. Install the GitHub CLI and the Vercel CLI, then help me log in to both. Make sure git knows my name and email. Explain each step — I'm a beginner.
Handy trick

If Claude asks you to run a command yourself, type ! before it (e.g. ! gh auth login). The ! runs it inside the conversation, so Claude sees the output.

06First project
06

Your first project

You're set up. Now build something real:

Paste into Claude
Build me a simple one-page personal site: my name, a short bio, and three project cards. Keep the code simple enough that I can read it. When it works, show me how to see it in my browser, then deploy it to Vercel so I have a public URL.

Thirty minutes from now you'll have a real URL you can send to anyone.

07Survival skills
07

Survival skills

The things experienced users do that beginners don't know exist.

EscStops Claude in the middle of a task. Use it any time, as often as you like.
/clearWipes the conversation. Start a new task with a clean one; long sessions get slower and pricier.
/exit + /loginWhen Claude acts strange, quit, restart, run /login. Fixes a lot.
claude -cClosed the terminal? Run this in your folder to continue your last conversation.
Shift + TabCycles permission modes, including plan mode — approve a plan before it builds.
Paste the errorCopy the whole error in and ask "what does this mean?" before a fix. This is how you learn.
"Did it work?""Done!" is not proof. Open the page, click the button, verify yourself.
Paste a pictureCtrl + V (yes, Ctrl — even on Mac) pastes a screenshot. Claude can see images.
"do it"Short replies are fine: "yes", "do it", "keep going".
/helpShows everything else.
08Level up
08

Level up

Once the basics feel comfortable, a few habits that make you faster.

  • Use multiple windows. Open several terminals, run claude in each, work on different parts at once — it's how experienced people work.
  • The web is your reference library. See a component you love? Screenshot it or paste the link, and ask Claude to recreate it in your style.
  • Make Claude write things down. Keep memory in files, not the chat. Your CLAUDE.md keeps a NOTES.md, so you can /clear freely.
  • Talk like a director. Nearly half of expert prompts are under 30 characters: "ok", "do it", "why?", "wait". The skill is steering with short nudges.
09Unlocks
09

Unlocks & when you're stuck

Claude can use almost any tool or service. Each account you connect gives it a new power.

  • A database — Supabase. Lets your projects remember: sign-ups, favourites, comments. Free account at supabase.com, then: "Add a database to this project using Supabase — walk me through connecting it."
  • Eyes — let Claude see your site. Normally Claude builds blind. Give it the ability to open your page and look, so it checks its own work.
When you're stuck

Paste the full error and ask what it means. Reopen the terminal. Run /exit then /login. And remember — you can always ask Claude itself.

In plain words

What do these words mean?

No jargon — promise
Terminal
The text window where you type instructions to your computer instead of clicking. On Mac it's the "Terminal" app; on Windows it's "PowerShell." It's where you run Claude.
Command
A short line of text you give the computer to do something. Usually you copy it, paste it, and press enter.
Claude subscription
Your own paid Claude plan. The Pro plan (about €17/month) includes Claude Code — that's all you need to run it. You log in with your account; no extra code to paste.
Folder
A place on your computer that holds all the files of one project. Rule of thumb: one folder per project.
GitHub
A free online home for your code. It saves every version, so you can always go back to an earlier one.
Commit
Saving a snapshot of your work to that history, with a short note about what changed.
Deploy
Putting your project online so anyone with the link can open it in their browser.
Vercel
The free service that deploys your site and gives it a web address (a URL) you can share.
CLI
Short for "command-line tool": a program you control by typing instead of clicking. The GitHub and Vercel tools are both CLIs.
Database
A place your app stores things it needs to remember — sign-ups, saved data, comments. Supabase is one.
CLAUDE.md
A plain text file of your standing instructions that Claude reads at the start of every session.
Bypass permissions
Letting Claude make changes without checking with you each time. It keeps things moving while you learn.
Reference

The tools you'll use

Tap a card to open it ↗
The AI
Claude Code

Your AI collaborator in the terminal. Tell it what you want in plain English and it writes the files, runs the commands, and looks things up online. The whole guide runs on it.

Open the docs ↗
Your account
Claude subscription

Where you sign up and manage your plan. The Pro plan (about €17/month) includes Claude Code — make your own account and log in with it. No API key needed.

Get Claude Pro ↗
Code hosting
GitHub

A free home for your code online. It keeps every version, so you can always go back to one that worked.

Open GitHub ↗
Hosting
Vercel

Turns your project into a real website with a public URL you can share. Free, and it connects straight to your GitHub.

Open Vercel ↗
Database
Supabase

A free database, for when your app needs to remember things like logins or comments. You can add it later.

Open Supabase ↗
Built-in
Terminal

Already on your computer, nothing to install. Mac: the Terminal app. Windows: PowerShell. This is where you run Claude.

Already on your Mac / PC
Starter skills

Skills you can download

Drop these into Claude to see what's possible
Brand deck

A short intake — your fonts, colours, an old deck, image inspiration — then a slide deck in your own style.

Download ↓
ZZP finance

Plain-language grip on your money: what to set aside for tax, and a simple monthly bookkeeping overview.

Download ↓
Working with AI

Field notes

Insights, not prompts
Play first, then purpose

The short version of what we've learned helping people use AI well. These are mindset tips, not prompts — read them once, then go build something.

A few truths

Where AI actually stands

InevitableAI is (probably) here to stay — it's being baked into Office, Google Docs, Canva, Miro. It'll be hard to escape.
Still acceleratingIt might "plateau" soon. I wouldn't bet on it.
Fear blocks skillMost people are afraid of it — and not very good at it. The fear prevents the play that builds the skill.
Raises the ceilingEveryone can build now. It's mostly an attitude.
New goalsAuthenticity, curiosity, intrinsic motivation. Experiment as much as you can.
How to work with it

The day-to-day habits

It's up to youAI augments you; it isn't autonomous. Bad results? Assume there's a better prompt.
Be specificVague questions get generic answers.
Play with itEffective use comes from intuition — and intuition comes from play.
Vibe, don't engineer"Prompt engineering" is too left-brained. Vibe with it.
Crap begets crapA lame reply poisons the ones after it. Edit your input until quality returns.
Quality breeds qualityPrime it with rich context before you ask the real question.
Start freshNew chat per task — quality degrades over a long thread. (This is what /clear is for.)
Brain onGive it your own ideas; it thinks better. And it can't finish the job — the last 10% is half the work.
Ask its planAsk what it's about to do before it does it, so you can steer.
In your work

Keeping your judgment in the loop

Think criticallyAssume anything it says could be false — it's a perspective, not the truth. Verify.
Be authenticTell it your real purpose. Use it to figure out what you actually want.
Have integrityKnow what you want to say. Don't cite what you haven't read.
Own the outcomeLike a camera — you didn't paint the pixels, but you framed it, and you own it.
Parts, not wholesAI makes parts, not finished things. Copy the good selections, not the whole.
Edit extensivelyLearn what "sounds like AI" means — and cut it.
Start earlyIt doesn't make you faster; it makes it easier to start.
Don't be lazySupplement your thinking, don't replace it. Raise your own standards.
Myths

Eight things people get wrong

Each one is worth questioning
The truth is usually more interesting than the fear

These are the common misconceptions. You don't have to agree — just don't take them on faith.

AI is not magic Using AI well needs a technical background First you must understand how it works You shouldn't treat AI like a person AI saves time but reduces quality AI is bad for the planet AI is bad for designers AI is bad for learning
Reality

What's annoying — and the 90/10 paradox

The 90/10 paradox

It can do 90% of the work — but the last 10% of a project is usually 90% of the work. Don't leave it all to the end.

Thinks it can't do something Talks too much Loses the plot Context rot Confident mistakes Sycophancy Slop Fluff Generic Makes you feel like you're getting work done
In their words

What people notice after trying it

"It was good to get started. You have to use your brain to finish it."

"It's great to put words to what you already thought."

"Use it as inspiration, not just an answer."

Where these come from

Field notes by J. Derek Lomas, from teaching people to work with AI. The full version, with prompts ↗  ·  dereklomas.me ↗

Ask for help

Confused by a word? Ask here

Not your real terminal — a sandbox to ask questions and click the jargon