How to Install and Use Claude Code: A Beginner's Guide (Windows & Mac)
Claude Code is a command-line AI coding assistant that lives in your terminal and works directly with the files in your project. Instead of copy-pasting snippets back and forth into a chat window, you tell it what you want in plain English and it reads, writes, and edits your code in place. If you've heard the buzz and want to get it running without wading through scattered docs, this beginner's guide walks you from install to your first useful command on both Windows and Mac.
What You Need Before You Start
Two things: Node.js (version 18 or newer) installed on your machine, and an Anthropic account. Claude Code runs on Node, so installing that first saves a common headache. You can grab Node from the official Node.js website; the installer handles everything.
How to Install Claude Code
On Windows
Open PowerShell or your terminal and run the install command via npm (Node's package manager):
npm install -g @anthropic-ai/claude-code
The -g flag installs it globally so you can run it from any folder. If you hit a permissions error, run your terminal as Administrator and try again. Windows users on older setups sometimes get smoother results inside WSL (Windows Subsystem for Linux), but a standard PowerShell install works for most people now.
On Mac and Linux
The command is identical:
npm install -g @anthropic-ai/claude-code
If you see permission warnings, avoid forcing it with sudo; instead, fix your npm folder permissions or use a Node version manager. Once it finishes, you're ready.
Running It for the First Time
Navigate to a project folder in your terminal and type:
claude
The first launch walks you through logging in with your Anthropic account. After that, you're dropped into an interactive session right inside your project. Anything you type is a request, and Claude can see and work with the files in that directory.
Your First Useful Commands
You don't need to memorize syntax, you just talk to it. Try things like:
- Understand a codebase: "Explain what this project does and how the files connect."
- Make a change: "Add input validation to the signup form and show an error if the email is invalid."
- Fix a bug: "The total in the cart is wrong when a discount is applied. Find and fix it."
- Write tests: "Write unit tests for the functions in utils.js."
Claude proposes the changes, you review them, and you approve before anything is written. That review step is what makes it safe to use on real projects.
Does Claude Code Cost Money?
The tool itself is free to install. Usage runs through your Anthropic account, either on a Claude subscription plan or pay-as-you-go API credits. For light, occasional use the cost is small; heavier daily use is where a subscription pays off. Check Anthropic's current pricing before you commit, since plans change.
Tips to Use It Like a Pro
Be specific, the same way you would brief a junior developer. Give it context, name the files involved, and describe the outcome you want, not just the symptom. Work in small steps and review each change. And keep a project notes file so it understands your conventions from the start. These habits turn it from a novelty into a genuine force multiplier.
Turning AI Coding Into Income
Once you're comfortable, Claude Code becomes a real edge for freelancers and side-hustlers, shipping client work faster and taking on projects you couldn't before. The piece most developers skip is the business side: clean invoices, proposals, client tracking, and pricing. A ready-made freelancer kit handles that admin layer so you can spend your hours building and billing, not formatting spreadsheets.
Keep reading
- ChatGPT Prompts for Teachers: 12 Examples That Save Hours Every Week
- Best AI Prompts to Make Money: A Practical Guide for Sellers and Agents
- AI Prompts for Real Estate Agents: Write Listings & Follow-Ups Fast