Claude Projects — Warm Start
Claude, for humans
v2.0 · Sept 2026
warm start
← Full reference version — all ten sections, one long read Or try the guided arrival — one question, no reading →
Guide 01 · the workspace you already pay for

Claude Projects for humans.

The feature that stops you re-briefing Claude from scratch every single session. Plain language, and everything checked against Anthropic's own help centre this month.

This is for you if you keep re-explaining the same thing to Claude and you're tired of it. Not you yet? The full reference guide is one click away.

About one coffee break Works on the free plan No coding
What's different on this page quick start comes first · Claude can write your instructions for you · plainer language throughout
If you've only got twenty minutes

Three steps. You leave with a Project that works.

1

Pick the work you keep redoing

The newsletter you write every week. The client you re-brief every session. The job search. One thing.

2

Create the Project

Go to claude.ai/projects, hit + New Project, and name it something a tired version of you would recognise at 11pm.

3

One file, one line of instructions

Drop in the doc you keep re-explaining. Then type one line of rules: “I write for women 40+. Plain language. No hype.”

See the full steps →

That prompt has Claude ask you the questions instead of you staring at a blank instructions box. Paste it into any chat.

Prefer to read the whole guide? Jump to a section
Section 1

What a Project actually is

A Project is a workspace inside claude.ai with its own chats, its own uploaded files, and its own standing instructions. Every chat you start inside it begins with that context already loaded. That's the whole thing.

Why it matters: most people pay for Claude, run a 200-message chat, start over from nothing the next morning, and conclude Claude is forgetful. A Project is the difference between briefing a freelancer once and briefing them every time you speak.

The set

Your account settings

Standing identity — voice, role, how you like to be spoken to. Set once in Settings, applies everywhere, doesn't change per Project.

The play

A Project

One production: a workflow, a client, a job search. Has its own Context files and its own instructions. Lives for months.

The rehearsal

Today's chat

Where you draft badly, try things, get it wrong. Chats inside a Project can't see each other — only Instructions and Context carry across.

The shape travels: ChatGPT calls it Projects or custom GPTs, Gemini calls them Gems, Perplexity calls them Spaces. This guide uses claude.ai because that's where the details are current.

Section 2

Who this is actually for

Not every conversation needs a Project. Quick question, one-off task, idle curiosity — open a normal chat, ask, close it. Projects earn their setup time the moment you notice you're doing the same setup over and over.

If this is you, we'd call you a Chronic Re-Briefer

This is you if…

You write the same kind of thing every week and re-explain the audience every time.

You serve clients and you're tired of pasting the brand brief at the start of every session.

You're job-hunting and want one home for the resume, the target roles, the achievement library.

You're managing something ongoing — a class, a renovation, a diagnosis — with a growing pile of context.

You think “I wish Claude remembered our last conversation” more than once a week.

Skip it if…

You open Claude about once a month for one-off questions.

The work you bring is genuinely brand new each time.

You'd rather not commit to a structure. No judgement — it's twenty minutes upfront, and it's twenty minutes you can spend later instead.

Section 3

Which Claude thing do you actually want?

There are five doors now, and the names don't help. Answer two or three questions and get pointed at one.

Decision tree · step {{ stepLabel }}

{{ dtQuestion }}

{{ dtHint }}

You want

{{ dtVerdictTitle }}

{{ dtVerdictBody }}

No wrong answers here — you can switch tools later without losing anything you've built.

Regular chat

One-off. Open it, ask, close it.

Project

Same work repeatedly, same context. Set up once, use for months.

Skill

A packaged repeatable action — “format this transcript”, “score this resume”. Claude calls it when it fits, or you invoke it directly.

Claude Code

Reads and writes the real files on your computer. Paid plans only. That's guide 02.

Cowork

Claude Code's ideas in a non-terminal window: agents doing multi-step file work while you watch. Newer, paid, and worth a look once Projects feel easy.

Section 4

The cost and limits reality check

Good news first: you do not need to upgrade to try this. Projects are on every plan, including free. Free accounts get five Projects; Pro, Max, Team and Enterprise get unlimited. Verified against Anthropic's help centre in September 2026 — they move things, so check the link in the references before you quote me.

Free
$0
5 Projects, hard cap
Context files & instructions
Finds the right file on its own once Context gets big (no manual search)
No Claude Code, no Cowork
Pro · most people
$20/mo
Unlimited Projects
Claude Code included
Bigger 5-hour budget
Skills
Max
$100–200/mo
Everything in Pro
Far more usage headroom
Only worth it for daily heavy use
Team / Enterprise
Per seat
Shared Projects across the org
Per-Project visibility settings
Admin controls

The numbers worth knowing

Individual files cap at 30MB, and there's no limit on how many you add — but a Project has its own capacity meter, and it will refuse files once it's full (somewhere north of 800,000 words). Project capacity and the chat context window are two different budgets.

About the rolling 5-hour window

A regular chat starts empty. A Project starts every chat with your Context and instructions already loaded — more tokens up front, every single time. All-day client work in one heavy Project is how Pro users hit the cap before lunch.

Section 5

Six patterns that actually get used

Find the one that looks like your week and steal the structure. The shape is always identical: stock the Project with context you already have, then work inside it for months.

Newsletter writer

Stop briefing the brand every Friday

Past issues, voice guide, audience definition — already loaded. Drafts arrive in your voice instead of beige LinkedIn-speak.

Consultant

One Project per client

Brand brief, scope of work, last three sets of meeting notes. Stop pasting the same context eleven times a week.

HR & people leaders

Drafts in your voice, not corporate

Policies, culture deck, the employment law that applies where you operate. Claude handles the offer letter and the awkward email.

Job seeker

One Project for the whole search

The same context tailors the resume, drafts the cover letter, preps the interview, writes the thank-you. The achievement library survives between sessions.

Corporate writer

First drafts that need editing, not rebuilding

Memo template, board-minutes structure, your exec's voice samples, the quarterly numbers. Fix the sentences, not the bones.

Caregiver

Stop re-explaining the whole situation

Medical history, insurance details, the IEP, the contractor's estimate. Claude drafts the appeal letter and the question list without the daily re-brief.

Section 6

Setting up your first Project

About twenty minutes the first time, five every time after. You need a claude.ai account — free is fine — and the doc you keep re-explaining.

1

Go to claude.ai/projects

Or find Projects in the left sidebar, above your recent chats. If you can't see it, the sidebar is collapsed — toggle it top-left.

2

Click “+ New Project” and name it

Top right. Use a name you'll recognise when you're tired — “Mostly Human” beats “Newsletter v3 FINAL”. The description is for you, not for Claude; skipping it breaks nothing. On Team and Enterprise you also pick visibility here: private, or shared with the org.

3

Fill the Context panel

This is the file panel — Anthropic calls it Context now, older guides call it “knowledge”. Same thing. Drag and drop, or paste text straight in. Section 7 covers what belongs in there.

4

Write the instructions

The rules of the room: voice, audience, format, hard stops. One paragraph is plenty on day one. Section 8 has a pattern to copy and a prompt that writes it for you.

5

Start a chat inside the Project

Not a normal chat — one started from inside the Project view. It already knows everything. “Draft this week's newsletter” is now a complete instruction. That's a working Project.

Same prompt, two different drafts

The fastest way to see what a Project does is to run one prompt twice. Prompt both times: “Write the opening paragraph of this week's issue about AI note-taking tools.”

Before · plain chat

“In today's fast-paced digital landscape, AI note-taking tools have emerged as a transformational way to unlock productivity. Whether you're a seasoned professional or just getting started, leveraging these solutions can help you optimise your workflow…”

Generic. Every banned word in one paragraph. You'd re-brief from scratch and rewrite the whole thing.

After · inside the Project

“I tried four AI note-takers this month so you don't have to. Three of them wanted access to my whole calendar before they'd do anything useful. One of them was quietly excellent. Here's the short version, and the part nobody mentions about who owns the transcript…”

Your voice, first try. Lands the audience, skips the banned words, opens on the useful thing. You edit sentences, not structure.

Section 7

Context files: what goes in

Three to ten well-chosen files beat one giant landfill. Retrieval finds things faster, you burn less of your usage window, and your actual question doesn't drown in irrelevant context.

01 · Voice and style

What makes it sound like you and not a corporate intern. Voice guide, banned words, audience definition, the phrases only you use.

02 · Examples

Your best past work. Claude learns your patterns far faster from three real examples than from any abstract rule you write.

03 · Reference

The facts and constraints. Brand brief, scope of work, resume, medical history — whatever Claude must not invent.

04 · Templates

The shapes you reuse. Memo template, issue structure, cover-letter scaffold. In once, never rebuilt in a chat again.

Upload these

.md markdown
.txt plain text
.docx Word
.pdf text-based, not scans
.csv data

30MB per file. No cap on how many — but see “three to ten”, above.

Skip these

Scanned-image PDFs with no text layer
Photos of documents
Audio and video files
DRM-protected ebooks
Anything you can't copy text out of

The copy-paste test: open the PDF, try to copy one paragraph. Readable text means Claude can read it. Gibberish means it's a picture — run it through OCR first.

Never upload

Passwords, API keys, account numbers
Other people's medical or financial data without permission
Client material your contract won't let you share with a third-party AI
Anything you'd hate to see quoted back at you

Treat Context the way you'd treat sending the same docs to a careful but brand-new freelancer.

Section 8

Instructions, and the prompt that writes them for you

Context is what Claude can look things up in. Instructions are how Claude behaves in the room: voice, format, always, never. One screen of text, hard rules at the top. Not a manifesto — a four-screen instruction set is how the em-dash rule gets buried and ignored.

Starter pattern · project instructions
ROLE
I'm a freelance newsletter writer and AI educator. My audience is
professional women 40+ who use AI for real work. I write weekly for
Mostly Human.

TASK FOR THIS PROJECT
Drafting newsletter pieces, intros and sign-offs. I bring the topic
and rough notes; you produce a clean first draft I can edit.

VOICE
Direct, warm, slightly irreverent. Plain language. Short to medium
sentences. Hyphens with spaces, never em dashes.

WORDS I NEVER USE
leverage, optimize, unlock, harness, transformational, scalable,
cutting-edge, "in today's fast-paced world"

WORDS I LIKE
real, plain, honest, "you're not behind", "start small"

FORMAT
- Pieces: 250-450 words, one thesis, one or two concrete examples
- Intros: 2-3 sentences max, lead with the most useful thing
- Sign-offs always end with "Take care of yourself, take care of each other."

NEVER
Invent dates, quotes, statistics or sources. If it isn't in the
Project context, say so instead of filling the gap.

WHAT GREAT LOOKS LIKE
Reads like I'm talking to one specific person I trust. Specific
examples beat abstractions every time.
The meta-prompt · have Claude interview you
Interview me so you can write the instructions for a Claude Project.
The Project is for [what you'll use it for].

Ask me ONE question at a time. Don't move on until I've answered.
Cover:

1. Who I am, what I do, and the context for this Project
2. My audience - who this is for and what they need
3. My voice - words I love, words I never use, how I sound as myself
4. The shape - structure, length, format, conventions
5. The rules - things I always do, things I never do
6. What "great" looks like versus "good but not it"

When we're done, write me an instructions block I can paste straight
into the Project. Under one screen of text. No preamble - just rules.

Paste it into a normal chat, answer honestly for twenty minutes, and you'll have instructions you would never have written from a blank page. Approach adapted from Ruben Hassid's voice-interview prompt (see references).

Section 9

When Projects break

Five real failures, all fixable, all coming from the same place: the Project knows less than you think it does, or it knows the wrong thing.

“Claude wrote like a corporate intern.”

Cause

Twelve past issues uploaded, no voice guide. With examples but no rules, Claude averages toward its baseline newsletter voice.

Fix

Add a voice guide as a Context file and a banned-words list to the instructions. “Never use X” works better than “use Y”.

“Claude cited a meeting that never happened.”

Cause

The decision wasn't in any uploaded file, so the gap got filled plausibly. Hallucination 101, and Projects don't immunise you.

Fix

Add to instructions: “If you don't see it in the Project context, say so. Never invent dates, quotes or sources.” Then upload the missing source.

“Thirty minutes in, Claude told me to come back in four hours.”

Cause

Every chat in a Project loads the whole Context and instructions before you type. Big Context, more tokens up front, faster cap.

Fix

Trim to three-to-ten files. Don't run two heavy Project sessions in parallel. If you hit the cap weekly on Pro, Max is a real answer.

“I uploaded a file. Claude swore it didn't exist.”

Cause

A 200-page scanned PDF: pictures of pages, not text. Or the Project hit its capacity meter and quietly refused the file.

Fix

Run the copy-paste test, OCR if it fails. Then check the Context panel actually lists the file and the Project isn't near full.

“My instructions are being ignored.”

Cause

Four screens of rules, and the one you care about is nineteen items down. Two rules that contradict each other means only one wins.

Fix

One screen. Hard rules at the top. NEVER and ALWAYS in caps. Delete anything you wouldn't defend.

The quarterly audit nobody does

Projects pile up: the newsletter you don't write anymore, the finished client engagement, the search that ended in a job. On free they also keep eating your five slots. Once a quarter: open the list, be honest about what you've touched in ninety days, export the Context files you want to keep — chats inside a Project go away with it — then delete or archive the dead ones. One caveat on archiving: on the free plan an archived Project can become unavailable rather than merely tidy, so export first.

Section 10

References

APA 7th edition. This redesign is derived from Deb Haas's original guides, with facts re-verified against Anthropic's documentation in September 2026.

Anthropic. (2026). How can I create and manage projects? Claude Help Center. https://support.claude.com/en/articles/9519177-how-can-i-create-and-manage-projects

Anthropic. (2026). Retrieval-augmented generation (RAG) for projects. Claude Help Center. https://support.claude.com/en/articles/11473015-retrieval-augmented-generation-rag-for-projects

Anthropic. (2026). What are projects? Claude Help Center. https://support.claude.com/en/articles/9517075-what-are-projects

Haas, D. (2026). Claude Projects for humans (Version 1.0) [Web guide]. Mostly Human. https://claudeprojectsforhumans.netlify.app/

Hassid, R. (2026, January). The “taste interviewer” prompt [Post]. LinkedIn. https://www.linkedin.com/posts/ruben-hassid_how-to-make-ai-sound-exactly-like-you-forever

Meehan, C., & Stelzner, M. (2025, December). Using Claude Projects to develop quality content. Social Media Examiner. https://www.socialmediaexaminer.com/using-claude-projects-to-develop-quality-content/

Guide 02 · the one Anthropic should have written

Claude Code for humans.

Everything you'd otherwise learn the hard way — in an order that makes sense for someone who has never written a line of code. Read it top to bottom the first time; each part sets up the next.

Paid plan required No terminal necessary Touches your real files
Before you click a single link

Two things that make the whole thing safe.

Everything else is detail. These two turn “an AI is loose in my folders” into “an assistant that shows me its work”.

Plan mode before anything big

Claude tells you exactly what it intends to do and touches nothing until you say go. Reach for it before any task involving more than one file.

/rewind is a real undo

It rolls back the conversation and the file changes to an earlier checkpoint. Use it freely. It is the reason you can afford to experiment.

And a copy of the folder

Ten seconds of duplicating the folder you care about has saved more people more pain than any setting in this guide.

Section 1

What Claude Code actually is

It is not a chatbot, and that's the part nobody leads with. In claude.ai, Claude talks to you: words in, words out. Claude Code reads the files on your computer, writes and edits them, and runs commands — inside your actual folders, not a demo sandbox.

Regular Claude is a brilliant advisor on the other side of a window. Claude Code is the same advisor in the room with you, able to pick things up and move them.

It reads

Whole folders, transcripts, exports, spreadsheets. It can answer questions about material far too long to paste into a chat.

It writes and renames

Creates files, edits documents in place, restructures folders. This is the powerful part and the part that needs plan mode.

It runs things

Builds a site, converts a batch of files, runs a script. You don't need to know the command — you need to know what you want.

Why it matters if you're not a coder

You don't need to know how to code. You need to know what you want done. “Rename everything in this folder with today's date.” “Read this transcript and pull out every action item.” “Build me a one-page site for this offer.” That's the level of instruction that works — and being specific matters more than being technical.

Section 2

The cost reality check

Claude Code needs a paid plan. There is no free tier.

Installing is free; using it requires Pro, Max, Team, Enterprise, or a pay-per-token API key from the developer console. The free claude.ai plan does not include it. Nobody tells you this upfront, and it's annoying, so: now you know.

Pro · the entry point
$20/mo

Fine for personal projects and learning. You'll notice the rolling five-hour window if you work in one long session all afternoon.

Max
$100–200/mo

For multiple projects, long sessions, most of the day. Flat monthly rate — unlike per-call API billing, you know what you're paying.

The honest note

Long sessions eat context fast. Working in one never-cleared conversation is the single biggest reason people hit limits early. /context and /clear in section 6 are the fix, and they're free.

Section 3

What you can actually do with this

Every tutorial is written for developers. Here's what it looks like in the hands of someone who isn't one.

Organise years of files

Hand it the data exports from LinkedIn, Facebook and ChatGPT and have it sort every piece of your writing into one tagged, searchable vault. Days of work, one afternoon.

Turn DMs into a CRM

It reads a message export, matches names to the right contact files, and appends notes to dozens of records without you opening one of them.

Build web pages with zero code

Sales pages, resource pages, landing pages — complete builds from a description. You never touch HTML unless you want to.

Draft slide decks

From a rough idea to a structured deck: it thinks through flow, proposes a shape, writes the slide content. Good enough for client and workshop material.

Untangle a cloud drive

Messy folders, inconsistent names, things saved in the wrong place. It can audit and restructure at a scale that would make you cry by hand.

Mine transcripts

Tell it what you're after — action items, one person's comments, the decisions — and it pulls exactly that out of a pile of meeting notes.

The honest scope check

It is not magic. It makes mistakes, occasionally does something you didn't ask for, and can loop on a fix that creates the next problem. Treat it as delegating to a very capable person who needs clear direction and whose work you check. Never point it at anything with live credentials or production data while you're still learning what it does.

Section 4

Install it — pick your path

There are more ways to install this than anyone needs. Two are worth your time: the desktop app if the terminal makes you tense, or the native one-line installer if you'd rather have the full thing. Both work on Mac and Windows.

Start here

The desktop app — no terminal at all

Anthropic rebuilt the desktop app in 2026 around exactly this: a proper window for agentic file work, with a sidebar of sessions, parallel work isolated from each other, and visual diffs you approve before anything is applied. Mac and Windows only — Linux users take the terminal path.

1

Download it from claude.com/download and install it like any other app.

2

Sign in with your Pro or Max account and open the Code tab.

3

Point it at a folder and say what you want. Review the diff, then apply.

Mac, Linux, WSL

Native installer

Open Terminal (Cmd + Space, type Terminal) and paste this. No Node, no other software first. It auto-updates itself afterwards.

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

Then type claude, log in through the browser, and you're at the > prompt. Homebrew instead: brew install --cask claude-code — but Homebrew doesn't auto-update, so run brew upgrade claude-code now and then.

Windows

PowerShell installer

Claude Code runs natively on Windows now — no WSL required. Open PowerShell (not Command Prompt) and run:

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

Close and reopen the terminal, then type claude. WinGet instead: winget install Anthropic.ClaudeCode. Installing Git for Windows is optional but recommended — with it, Claude Code uses Git Bash for shell commands.

The other paths

npm and VS Code

The npm package still works (npm install -g @anthropic-ai/claude-code, needs a current Node) but it isn't the path Anthropic tests first and it won't update itself. Most old tutorials you'll find online assume it — that mismatch is where a lot of “nothing works” comes from.

If you want your files visible alongside Claude, install VS Code and add the official Claude Code extension from the Extensions panel. Good middle ground; not necessary on day one.

If it doesn't start

Close and reopen the terminal first — that solves most “command not found”. Then run claude doctor, which reports how it was installed, the version, and what's wrong. Permission errors on Windows usually mean PowerShell needs to be run as Administrator.

Section 5 · the secret weapon

CLAUDE.md, the thing nobody tells you about

If you implement one thing from this guide, make it this. CLAUDE.md is a plain text file that tells Claude Code how to work with you. It's read at the start of every session, so you stop re-explaining yourself every time you open a new one. It is the Claude Code equivalent of a Project's instructions.

Home-level

About you: how you think, how you want to be spoken to, what Claude must never do without asking. Read every session, in every folder.

Mac: ~/.claude/CLAUDE.md · Windows: the same path inside your user folder.

Project-level

Lives in a specific folder and describes that work: the goal, the files involved, the rules. Inside that folder both files are read, and this one wins any conflict.

Fastest way to make one: run /init in the folder and edit what it generates.

One honest limit

CLAUDE.md is guidance, not a guard rail. It shapes behaviour reliably; it does not enforce anything. For rules that genuinely must hold — don't touch this folder, don't publish anything — say it in the session too, and keep plan mode on.

CLAUDE.md · starter template
# [Your name] - Claude Code working instructions

## Who I am
- [Role - e.g. "freelance designer, one-person business"]
- [Where you are, or your time zone]
- [What you're focused on right now]

## How I work best
- One clear action at a time. Numbered steps. Short.
- Lead with what I need to do, not the background.
- Ask me to confirm before anything I can't easily undo.
- If I'm going off track, name it and redirect me.
- [Anything about how your brain works]

## Communication
- Keep responses short unless I ask for detail.
- No jargon without explaining it.
- Flag anything risky before doing it.

## What I'm working on
- [Project] - [one sentence: what it is, why it matters]
- [Project] - [one sentence]

## NEVER do without asking me first
- Delete files
- Send, post or publish anything
- Change anything that affects other people
- Touch [folder or file you care about most]

## Technical context
- Computer: [Mac / Windows]
- Tools I use: [Notion, Drive, Obsidian, ...]
- Secrets live in [e.g. ~/.env] - never print them in chat

Easiest way to create it: start a session, paste the filled-in template, and say “save this as CLAUDE.md in my home directory”. Claude Code puts the file in the right place for you.

Section 6

Slash commands, your control panel

Everyone mentions these; nobody explains them. Grouped by what you actually need them for. The set changes with releases — /help inside a session is always the current truth.

Managing context — the important ones

/clear

Wipes the conversation and starts fresh. Your files are untouched. Use it when a session gets long or confused — before the wheels come off, not after.

/compact

Compresses the conversation without losing the thread. For long builds you're not finished with.

/context

Shows how full the context window is. Over 80% and things get sluggish and strange — compact or clear.

/cost

Token usage for this session.

/usage

Where you stand against your plan's limits.

Review, undo and safety

/rewind

Rolls the conversation and the files back to an earlier checkpoint. Your undo button. Use it freely.

/diff

Shows exactly what changed, file by file. Run it before you call a task done.

/permissions

Review and edit what Claude Code is allowed to do without asking. Worth reading once, early.

/security-review

Scans recent changes for exposed data, injection risks and auth problems. Run it on anything that will be public-facing.

Setup, memory and diagnosis

/init

Scans the current folder and drafts a CLAUDE.md for it. First move in any new project.

/memory

Opens your CLAUDE.md files for editing without leaving the session.

/doctor

Health check on the installation that can fix what it finds. First step when something feels off.

/agents

Manage subagents — specialised helpers that take on a slice of a big job. Ignore until you want them.

/mcp

Connect outside tools — Notion, Drive, a database — so Claude Code can read live data instead of stale exports. Powerful, and the connectors you add are worth vetting.

/add-dir

Gives the session access to another folder. Better than starting over somewhere else.

/config

Settings: theme, model, output style, behaviour.

Everyday handling

/help

Every command available in your version. Type it whenever you're lost — which will be often at first, and that's fine.

/resume

Pick up a previous session from a list, instead of rebuilding context by hand.

/model

Switch model mid-session: something faster for simple work, something stronger for hard work.

/copy

Copies the last response to your clipboard, with a picker if there are several blocks.

/export

Saves the whole conversation as text, for your records or to hand to someone else.

/todos

Shows the task list Claude is working through on a longer job.

/exit

Ends the session cleanly. Closing the window also works.

The one that took longest to learn

/clear matters more than it sounds. Long sessions accumulate context, and Claude starts carrying earlier parts of the conversation into what you're asking now, muddying both. When in doubt, clear it and restate the goal. It isn't failure. It's hygiene.

Section 7

When it breaks and you have no idea why

It's confused, or going in circles

Cause

Too much accumulated context in one session. Every fix is now competing with everything said before it.

Fix

/clear, then restate the goal from scratch, specifically. Solves it about eight times in ten.

It's doing something you didn't ask for

Cause

Vague instructions. It's the number one reason sessions go sideways — the gap gets filled with a guess.

Fix

Stop it — Esc or Ctrl+C. Undo with /rewind. Then say what you want in one specific sentence.

It's editing the wrong file

Cause

Two files with similar names, or a folder you didn't realise you were in. This one bites people early.

Fix

Before any big task: “What file are you about to edit? Show me the full path.” Make it say the path out loud first.

Nothing works and you can't tell why

Cause

Usually the install, the PATH, or following a guide written for an older install method.

Fix

/doctor first, then the official troubleshooting docs (references). Restarting the terminal fixes an embarrassing share of it.

Section 8

One starter prompt to save right now

Paste this at the start of your first real session
I'm new to Claude Code and I'm not a developer. Before we start any
task, I need you to:

1. Confirm in plain English what you're about to do
2. Tell me exactly which files you'll touch, with full paths
3. Wait for my "go ahead" before changing anything

My goal today is: [what you're trying to accomplish]
My computer is a [Mac / Windows]. Ask me if you need other context.

The point is making it slow down and confirm while you're still learning what it's capable of. Once you trust the rhythm, you'll drop the training wheels on small tasks and keep them on for anything that touches files you'd hate to lose.

Section 9

References

APA 7th edition. Commands and install paths re-verified against Anthropic's documentation in September 2026; the slash-command set moves with releases, so trust /help over any page including this one.

Anthropic. (2026). Claude Code: Set up Claude Code. Claude Code documentation. https://code.claude.com/docs/en/setup

Anthropic. (2026). Claude Code: Slash commands. Claude Code documentation. https://code.claude.com/docs/en/slash-commands

Anthropic. (2026). Claude Code: Troubleshooting. Claude Code documentation. https://code.claude.com/docs/en/troubleshooting

Haas, D. (2026). The guide Anthropic should have written (Version 1.0) [Web guide]. Mostly Human. https://claudecodeforhumans.netlify.app/

Kelly, C. (2026). Claude Code troubleshooting: Five fixes that solve ninety percent of problems. Claudefast. https://claudefa.st/blog/guide/troubleshooting

r/ClaudeAI. (2026). Claude Code for non-coding projects: A complete guide [Online forum post]. Reddit. https://www.reddit.com/r/ClaudeAI/comments/1q403xw/