Claude Code for beginners comes down to one idea: you describe a job in plain English, and an AI works through it on the files in a folder you choose. This guide takes you from nothing to a first real task, and explains the few habits that matter more than any feature.
You do not need to be a programmer. You do need twenty minutes, a paid Claude plan, and a willingness to read what the tool proposes before you let it act. Everything below assumes you have never opened a terminal on purpose.
What Claude Code actually is
Anthropic describes Claude Code as "an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools". Strip out the developer vocabulary and it means this: Claude Code does the work instead of describing it. Ask the ordinary Claude chat app to rename thirty files and it tells you how. Ask Claude Code and the files are renamed.
That is also why it needs more care than a chat window. Changing your files is its normal behaviour, not an accident. The rest of this guide is mostly about keeping that power pointed where you want it.
If you are still deciding whether you need it at all, our comparison of Claude Code and Claude in a browser answers that in one question. And if you are wondering what it is good for when you do not write software, this guide for non-programmers lists six things it does well and three it does badly.
Where you can use it
Claude Code is not only a terminal program any more. According to the official documentation it runs in four places:
- The terminal — the full-featured command-line version, and the one most tutorials show.
- IDE extensions for VS Code and JetBrains editors.
- The Claude desktop app, which gives you the same engine with a normal window and no terminal at all.
- The web, at claude.ai/code, which needs no local installation.
For a beginner who is nervous about the command line, the desktop app is a perfectly good start. This guide uses the terminal, because it is the version every other resource assumes and because it is less mysterious than it looks: it is a text box without buttons. (If you are weighing it against an AI code editor instead, see Claude Code vs Cursor.)
What you need before you start
A paid account
The free Claude plan does not include Claude Code. You need a Pro, Max, Team or Enterprise subscription, or an Anthropic Console account billed per use. Our Claude Code pricing guide explains which of those makes sense and how usage limits work.
A supported computer
The documentation lists macOS 13 or later, Windows 10 (version 1809) or later, and recent Ubuntu, Debian and Alpine Linux, with at least 4 GB of RAM and an internet connection. Almost any computer bought in the last five years qualifies.
A practice folder
This is the one piece of preparation people skip, and it is the one that matters. Make a new folder, copy a handful of unimportant files into it — a few documents, a spreadsheet, some photos — and do your first sessions there. Mistakes in a copy cost nothing.
Install Claude Code in one command
The recommended method is Anthropic's native installer. Open a terminal and paste the line for your system.
macOS or Linux:
curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell):
irm https://claude.ai/install.ps1 | iexThen check it worked:
claude --versionA version number means you are done. If you see "command not found" or "not recognized", close the terminal, open a new one and try again — the old window does not know about the new program yet. The platform guides go step by step, including every common error: installing Claude Code on Windows and installing Claude Code on a Mac.
Sources: Claude Code documentation — Advanced setup (system requirements, install commands, account types).
Your first session, step by step
- Move into your practice folder. In the terminal, type
cd, a space, and then drag the folder onto the terminal window — most terminals paste its path for you. Press Enter. - Start Claude Code. Type
claudeand press Enter. The first time, it opens a browser window to sign in with your Claude account. - Trust the folder. It asks whether you trust the files in this folder. For your own practice folder, yes.
- Switch to manual mode while you learn. On Pro, Max and Team plans a terminal session normally starts in auto mode, where a safety classifier approves most actions for you. Press Shift+Tab until the status line reads "manual mode on", and Claude Code will ask before every change.
- Ask a question that changes nothing. Type: "What is in this folder? Summarise each file in one line." Reading is the safest possible first task, and it shows you how the tool explains what it is doing.
- Ask for a small, reversible change. Try: "Create a file called summary.md containing the list you just gave me." Watch what it proposes before it happens.
- Leave. Type
/exit, or press Ctrl+C twice.
That is the whole loop: open a folder, describe a job, review, approve. Everything else is variations on it.
The commands worth knowing on day one
Claude Code has dozens of slash commands. You need about six:
| Command | What it does | When to use it |
|---|---|---|
/help | Lists the available commands | Whenever you forget one |
/init | Writes a CLAUDE.md file describing the project | Once per folder you work in regularly |
/clear | Starts a fresh conversation | When you switch to an unrelated task |
/compact | Summarises a long conversation to free up space | When a long session starts to feel slow |
/rewind | Rolls back the conversation and Claude's file edits | When something went somewhere you did not want |
/usage | Shows usage against your plan's limits | If you are worried about running out |
One keyboard shortcut deserves a mention too: Shift+Tab cycles the permission mode, which decides how much Claude Code may do without asking. Our guide to whether Claude Code is safe explains each mode and which to pick while you are learning.
Five habits that make every session go well
1. One folder, one job
Claude Code works inside the folder you start it in. Start it in the smallest folder that contains the job. Pointing it at your whole home directory makes it slower, costs more of your allowance, and widens what it can touch.
2. Ask for a plan before a big change
"Before changing anything, tell me your plan" is the most useful sentence in this guide. A plan is cheap to correct; forty edited files are not.
3. Be specific about the result
"Tidy these files" invites guessing. "Rename every PDF to client-name_month_year.pdf using the text on its first page" does not. Our list of beginner prompts for Claude Code has fifteen worked examples of the difference.
4. Read before you approve
Every permission prompt is a chance to catch a misunderstanding. The habit costs seconds and saves hours.
5. Clear between tasks
A conversation carries everything said so far. When you move to something unrelated, /clear gives you a clean start and keeps your usage down.
Where to go after the first week
Once the basic loop feels natural, three features turn Claude Code from a helper into a system. Skills package instructions you keep repeating into a reusable command; our Skills explainer shows one being built. MCP connects Claude Code to other tools such as Notion or a database — see the Claude Code MCP guide. And subagents hand side-jobs to specialised helpers, covered in Claude Code agents explained.
For ideas about what to build with all of this, our list of ten things you can automate with Claude Code sticks to jobs ordinary people actually have.
If you would rather follow a single structured path than a set of articles, that is what Claude Code for Beginners was written to be: installation, a safe first hour, CLAUDE.md, context management, Skills, MCP and custom agents, then worked projects in writing, research, websites, data and automation.
Frequently asked questions
Do I need to know how to code?
No. You give instructions in English and review what Claude Code proposes. Knowing some code helps you judge its work on programming tasks, but documents, spreadsheets and folders need no programming at all.
Is Claude Code free?
No. It needs a paid Claude plan or a pay-per-use Console account. The free chat plan is a good way to find out whether AI helps your work before you pay for anything.
Can it break my computer?
It can only do what its permission settings allow, and by default it works inside the folder you started it in. Practising on a copy of your files removes almost all of the remaining risk.
What is the difference between Claude Code and ChatGPT?
ChatGPT and the Claude chat app are conversations: they hand you text. Claude Code is an agent: it reads and changes files and runs commands on your behalf. That difference, not the underlying model, is what matters for choosing one — and it is the thread running through the Claude Code for Beginners book.