The full guide · frame by frame
From a blank computer to a working Claude setup
Every step, in order, with copy-paste commands and frame-by-frame diagrams. Written for people who are not developers. Follow it top to bottom, or jump to a chapter.
08 chapters
You are reading
The simple set-up
Everything you need to get going, on one page. Want the full extensive reference, all 16 chapters with worked examples? Open the full guide → or download the PDF.
Chat, Claude Code, and Cowork.
Claude is not one product. It comes in three surfaces, and the first thing to get right is which one a task belongs to. Chat is for talking, Claude Code is for building inside a project, Cowork is for getting multi-step work done across your files.
Surface A
Chat
Ask questions, draft and rewrite, think things through. The free tier covers basic Chat. This is talking.
Surface B
Claude Code
Runs in your terminal or VS Code, inside a project folder. For building and editing real files. Needs a paid plan.
Surface C
Cowork
The desktop agent. Describe a multi-step job; it plans and executes across your files and connected tools. Needs a paid plan.
Which surface for which job
How it all connects
Once it is set up, the pieces stack into one system. Each layer sits on the one below it.
How a full setup stacks up
What to have ready.
Account
A paid plan
Claude Code and Cowork need Pro (from 20 USD/mo), Max, Team, or Enterprise. The free tier is Chat only.
Machine
Mac or PC
macOS 13+ or Windows 10/11, at least 4 GB RAM, admin rights, and a stable internet connection.
Windows + Cowork
Pro edition
On Windows, Cowork needs the Pro, Enterprise, or Education edition (it relies on Hyper-V). Home does not support it.
Optional
Accounts to connect
Shopify, Google (Gmail, Calendar, Drive), or Notion if you plan to connect them later. Not needed to start.
Six steps, in order.
Most steps run in Terminal (Applications, Utilities, Terminal). Type a command, press Return, wait for it to finish, then do the next one. You do not need to be a programmer.
Install Homebrew
The package manager for macOS. It installs and updates software from one place. Paste this and press Return. It may ask for your Mac password (the cursor will not move as you type; that is normal).
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install Claude Code
The tool that runs in your terminal inside a project folder. The native installer keeps itself up to date. Pick one method, not both.
curl -fsSL https://claude.ai/install.sh | bash
brew install --cask claude-code
Install Node.js optional
Needed for some MCP tools that use npx, and the Shopify CLI later. Skip it if you will not touch those; you can add it any time.
brew install node
Install Git and the GitHub CLI
Git tracks changes in projects; the GitHub CLI (gh) connects you to GitHub, which some plugins use. Install both, then sign in.
brew install git gh
gh auth login
Install the Claude desktop app
Where Chat and Cowork live. Download it from claude.ai/download, open the file to install, then open the app and sign in with your paid account.
Get the app
Claude for Desktop
Where Chat and Cowork live. Sign in with your paid account.
First run and verify
Confirm Claude Code works. Make a folder, open it, run claude, then run the doctor check. If both run without errors, your Mac is set up.
claude doctor
Tip: if Terminal says claude is “not found” right after installing, close the window and open a new one.
Pick your route, then the shared steps.
Open PowerShell from the Start menu (it shows PS C:\ at the start of the line, not just C:\). The install commands are written for PowerShell.
Route 1 · recommended
Native Windows
Claude Code installs and runs directly on Windows. Simplest path, good for most non-developers. Paste the line below into PowerShell and press Enter. It downloads and sets up Claude Code, which can take a few minutes.
irm https://claude.ai/install.ps1 | iex
Route 2 · advanced
WSL2 (Linux)
Only if you already do serious development with Linux tools. Install WSL, open the Ubuntu terminal, then run the install script there (not in PowerShell).
wsl --install
Node.js, if a tool needs it
Install Node.js from nodejs.org when a tool asks for it.
The Claude desktop app
Install it from claude.ai/download and sign in with your paid account.
Verify
Check it works with claude --version, then claude doctor for a deeper check.
CLAUDE.md: give Claude a memory.
The single most useful habit in the whole guide. Out of the box Claude is clever but forgetful. A CLAUDE.md file in your project folder is read at the start of every session: who you are, what you are working on, and the rules you care about.
# CLAUDE.md ## About me I run a small creative business. I am not a developer. ## How to talk to me Explain things plainly. No jargon without a short definition. ## Project rules - Always ask before deleting files. - Keep a running TODO at the top of NOTES.md.
A ready-to-edit CLAUDE.md, folder-setup scripts, and the prompt pack are in the starter files.
One folder, opened the same way every time
Keep everything for your work in one project folder, with CLAUDE.md at the top and a tidy, numbered set of subfolders below it. When you open this folder in VS Code and run Claude there, it always works inside it and reads your md files automatically. Same folder, same rules, every session, so you never have to re-explain yourself.
your-project-folder /
- CLAUDE.md
- 00 brand
- 01 projects
- 02 products
- 03 web
- 04 email
- 05 applications
- 06 correspondence
- 07 print
- 08 social
- 09 strategy
- 10 finance
Two things make this work, and they belong in your CLAUDE.md: the hard rules Claude must always follow, and a short note on where your important files live (point to the folders above rather than pasting their contents). The setup script in the starter files creates this whole structure for you, adds a one-line README to each folder and a starter CLAUDE.md, and never overwrites anything you already have.
Run Claude Code inside VS Code.
You can run Claude Code in a plain terminal, but VS Code is where it really comes alive, and it is what I use for everything. You see files change as they happen, review edits as clear before-and-after diffs, and keep your whole project in front of you. It is free, and it is far more powerful than working in the app. This is the way to learn it.
Why VS Code
See every change
Edits show up as colour-coded diffs you can read and approve, instead of scrolling text in a terminal.
One engine
Same Claude, nicer view
The terminal command and the VS Code extension share one engine, your sign-in, settings, and history. Switch any time.
Whole project
Files always in view
Your folder tree, open files, and Claude sit side by side, so you always know what it is working on.
Install VS Code
Download it free from code.visualstudio.com, pick the version for your Mac or PC, and run the installer.
Open your Claude project folder
In VS Code choose File, then Open Folder, and pick your Claude project folder, the one with CLAUDE.md inside (set that up in The brain, above, first). Opening that exact folder is what makes Claude read your rules and files automatically. Open its built-in terminal with View, then Terminal.
Run Claude, and get the extension
Type claude in that terminal and press Return. The Claude Code extension installs into VS Code automatically (or add it from the Extensions panel). Sign in with your paid plan; no API key needed.
claude
Where everything lives in the desktop app.
Once Claude is installed and you are signed in, here is the quick tour: where to find Connectors, Skills, your Project instructions, and where Cowork connects to a folder. The pins on the window match the panels beside it.
Settings + Connectors
Bottom-left, not the top. Click your name and plan, then Settings. Your account and the Connectors list (Shopify, Google, Notion) live in here; reconnect one here if it stops.
Projects
In the sidebar. A Project keeps related chats together with its own instructions. For Claude Code, that role is played by a CLAUDE.md file in your folder.
New task
Top of the sidebar. Start a fresh Cowork task here. The “+” inside a task is where you connect a folder Claude is allowed to read and write.
Surfaces toggle
At the very top: switch between Chat, Cowork, and the code view depending on the job in front of you.
you describe, it plans, you review, it executes, you stay in control
How a Cowork task runs
Skills
Repeatable moves
Skills are packaged instructions Claude follows the same way every time. In Claude Code they arrive through plugins (one install command). See the full chapter in the full guide.
Coming from ChatGPT
Carry your memory across
Ask ChatGPT: “Summarise everything you know about me and how I like to work.” Copy that summary into a Project’s instructions, or into your CLAUDE.md, so Claude starts already knowing you.
Once it is installed, make it powerful.
Each of these has a full chapter in the complete reference, with diagrams and worked examples. The complete reference is the downloadable PDF.
08 · Cowork
Your desktop agent
Describe a multi-step job; Claude plans and runs it across your files and connected tools.
09 · Plugins
Ready-made toolkits
A plugin bundles skills, subagents, and commands. Add a whole toolkit in one command.
10 · Skills + agents
Repeatable moves
Package work so Claude does it the same way every time, and hand jobs to subagents.
11 · MCP + connectors
Plug in your tools
MCP is how Claude reaches your shop, inbox, calendar, files, and design software.
12 · Shopify
Wire in your shop
Manage orders, products, inventory, and reports, with or without code.
The complete reference
All 16 chapters + appendices
VS Code, context and tokens, troubleshooting, a worked example, reference tables, and the prompt pack. Open the full guide →