Claude Code Beginner's Guide: Setup to First Project
🔑 Key Takeaways
- Claude Code is an AI coding assistant that runs in your terminal — it reads, edits, and creates files on your computer through natural language conversation.
- Installation takes under 5 minutes with the native installer. No Node.js required. Works on macOS, Windows 11, and Linux.
- You need Claude Pro ($20/month) at minimum. The free Claude plan does not include Claude Code access.
- CLAUDE.md is the single most important file — it gives Claude persistent context about your project. Run
/initto auto-generate one. - Start with /plan mode — it shows Claude's reasoning before executing anything, so you learn while it works.
What Is Claude Code (And Why Should You Care)?
Here at Thirsty Hippo, we don't do spec-sheet reviews — we live with products for weeks before writing a single word. And after using Claude Code daily since late 2025 to automate blog tasks, build web projects, and manage files, I can say this: Claude Code changed the way I use my computer.
So what is it? Claude Code is Anthropic's AI coding assistant that runs directly in your terminal. Unlike ChatGPT or regular Claude in a browser, it doesn't just talk about code — it actually reads, edits, and creates files on your machine. You describe what you want in plain English, and Claude does it.
Here's the deal: think of ChatGPT as texting a developer for advice. Claude Code is like having that developer sit down at your computer and do the work with you. It sees your entire project — every file, every folder, every dependency — and can make changes across multiple files simultaneously.
Since reaching general availability in May 2025, Claude Code has become one of the most widely adopted AI development tools. It's powered by Claude Opus 4.6 and Sonnet 4.6 — the same models that lead coding benchmarks in 2026. Whether you're an experienced developer or someone who's never written a line of code, this guide will get you from zero to your first working project.
Why You Can Trust This Review
- How tested: 4+ months of daily Claude Code use for blog automation, HTML generation, file management, and web projects. Pro subscription self-purchased.
- Sponsored? No — Anthropic has no involvement with this article.
- Update schedule: Reviewed monthly as Claude Code updates frequently.
- Limitations: Tested primarily for web development and content creation. Not tested for enterprise-scale or mobile app development.
Before You Start: Requirements & Cost
Before installing anything, let's make sure your setup is ready. Claude Code is less demanding than you'd think.
System requirements:
- macOS (Intel or Apple Silicon), Windows 11, or Linux (Ubuntu 22.04+, Debian 12+)
- At least 4 GB of available RAM
- A terminal app (built-in Terminal on Mac, PowerShell on Windows, any terminal on Linux)
- Windows users: Git for Windows installed (grab it from git-scm.com)
What you do NOT need: Node.js (the native installer handles everything), an IDE or code editor, or any prior coding experience.
Honestly speaking, $20/month felt steep before I tried it. After the first week, it felt like a bargain. But I respect that it's a real cost — and later in this series, we'll cover how to maximize every token so you get the most value from that subscription.
Step-by-Step Installation (Mac / Windows / Linux)
The native installer is the recommended method in 2026. It's the fastest path, requires no dependencies, and auto-updates in the background. Here's the exact command for each platform:
macOS / Linux
Open Terminal and run:
That's it. The script downloads the binary, installs it, and adds claude to your PATH.
Windows 11
Open PowerShell (not CMD) and run:
Important: use PowerShell specifically. CMD and Git Bash have compatibility issues. If you see permission errors, try running PowerShell as Administrator.
Alternative: Homebrew (Mac) / WinGet (Windows)
winget install Anthropic.ClaudeCode # Windows
These work but don't auto-update — you'll need to run upgrade commands manually. The native installer is better for most users.
Verify it worked by typing:
You should see a version number. If you get "command not found," your terminal hasn't picked up the new PATH entry — close and reopen your terminal, then try again.
Your First Login: Authentication Made Simple
With Claude Code installed, type claude to start your first session. It will ask you to choose a login method:
- Option 1: Claude app (recommended for Pro/Max subscribers) — Opens your browser, you click "Allow," and you're authenticated.
- Option 2: Anthropic Console — For API key users. Paste your key when prompted.
The best part? Once authenticated, Claude Code remembers your login. You won't need to re-authenticate every session — your token stays valid until it expires (more on that in a moment).
c to copy the OAuth URL, then paste it into your browser manually. On SSH or remote sessions, the browser tries to open on the wrong machine — always copy the URL and open it locally. I lost a solid 20 minutes to this the first time.
One thing that surprised me was how authentication can break. OAuth tokens expire, and when they do, sometimes even the /login command fails. If that happens to you — don't panic. We're covering the complete fix checklist in the next article in this series. For now, just know that deleting the ~/.claude folder and re-running claude is the nuclear option that always works.
Your First Project: From "Hello" to "It Works!"
This is the fun part. Let's build something in under 5 minutes.
Step 1: Navigate to a project folder
Open your terminal and go to the folder where you want to work:
cd my-first-project
claude
Claude Code launches and scans the (empty) directory. You'll see a welcome screen with your working directory and model info.
Step 2: Ask Claude to build something
Type a natural language request. Here are three beginner-friendly first prompts:
Claude will generate the file, show you exactly what it's creating, and ask for your approval before writing anything to disk. Review it, type y to approve, and the file appears in your folder.
Step 3: Open and admire your creation
Open the HTML file in your browser (double-click it, or type open index.html on Mac). You just built a web page by describing what you wanted. No HTML knowledge required.
Step 4: Iterate — this is where the magic happens
Now ask Claude to change it:
Claude reads the existing file, understands the structure, and adds to it intelligently. This back-and-forth refinement is how real projects get built with Claude Code — not in one perfect prompt, but in a conversation.
After spending four months with Claude Code, I've realized the most productive users aren't the ones who write perfect prompts. They're the ones who iterate confidently — start rough, refine with follow-ups, and let Claude handle the technical details while they focus on what they actually want.
Essential Commands Every Beginner Should Know
You don't need to memorize dozens of commands. These 10 cover 95% of daily use:
| Command | What It Does | When to Use |
|---|---|---|
/help | Shows all available commands | When you're lost |
/plan | Plan Mode — Claude shows reasoning before acting | Complex tasks, learning |
/init | Auto-generates a CLAUDE.md file for your project | Starting a new project |
/status | Shows auth status, model, and usage | Checking your session |
/compact | Summarizes conversation to save tokens | Long sessions |
/login | Re-authenticate if token expired | After auth errors |
/permissions | Manage which tools run without asking | Reducing approval fatigue |
! + command | Run a terminal command and feed output to Claude | Debugging, checking status |
Tab | Autocomplete | All the time |
Esc | Stop Claude mid-action | When it's going wrong |
Bottom line: start with /plan for anything non-trivial. It shows you Claude's thinking process before it touches any files — perfect for learning and for catching mistakes before they happen.
/plan — Plan Mode. It makes Claude explain its reasoning and show exactly what it will change before executing anything. You learn how your project works while Claude works on it. Use it for every complex task until you're comfortable letting Claude run freely.
CLAUDE.md: The File That Makes Everything Better
If there's one thing from this guide you remember, make it this: set up CLAUDE.md.
CLAUDE.md is a markdown file in your project's root folder that gives Claude persistent context — your tech stack, coding conventions, build commands, testing preferences, and anything else Claude needs to work effectively in your project. Every time you start Claude Code in a folder with a CLAUDE.md, it reads the file first.
Think of it as a cheat sheet you hand to a new team member on their first day. Without it, Claude starts every session blind. With it, Claude already knows your rules.
Generate a starter CLAUDE.md automatically:
This scans your project and creates a CLAUDE.md with detected build systems, test frameworks, and code patterns. You can (and should) edit it to add your preferences.
What to put in CLAUDE.md (keep it under 100 lines):
- Your project's tech stack and framework versions
- Build and run commands (
npm run dev,python app.py, etc.) - Coding style preferences (indentation, naming conventions)
- File structure overview (what's where)
- Known gotchas or project-specific rules
From what I've seen so far, a good CLAUDE.md improves output quality more than any prompt engineering trick. For each line in the file, ask yourself: "Would removing this cause Claude to make a mistake?" If not, cut it. Shorter is better — Claude reads the whole file every session, which costs tokens.
🔴 My Failure Moment
My first attempt was embarrassingly bad. I created a CLAUDE.md that was 400+ lines long — basically a copy of my entire project documentation. Every session burned through tokens just reading the context file, and Claude got confused by contradictory instructions buried in the wall of text. I rewrote it to 60 lines of clear, actionable rules, and the improvement was immediate. Less context, better results. That lesson applies to everything with AI: precision beats volume.
Frequently Asked Questions
Is Claude Code free to use?
The tool itself is free to install, but you need a paid account. The free Claude plan does not include Claude Code access. Claude Pro at $20/month is the minimum, and it covers both Claude Code and Claude on the web. For budget-conscious users, check our free AI tools guide — though Claude Code specifically requires the paid tier.
Do I need coding experience?
Not necessarily. Claude Code accepts plain English instructions. Understanding basic concepts (files, folders, terminal) helps, but you don't need to know any programming language. For a deeper introduction aimed at complete beginners, stay tuned for our "Absolute Beginners" guide in this series.
What's the difference between Claude Code and ChatGPT?
ChatGPT is a browser chatbot — you copy-paste code. Claude Code runs in your terminal and directly reads, edits, and creates files on your computer. It sees your entire project structure and makes changes across multiple files. Our full AI comparison covers the broader differences.
Does Claude Code work on Windows?
Yes. Native Windows 11 support via PowerShell. Install Git for Windows first, then run the PowerShell install command. WSL2 is an alternative for a Linux-like experience. Use PowerShell — CMD and Git Bash have compatibility issues.
What is CLAUDE.md and why does it matter?
It's a markdown file in your project root that gives Claude persistent context — tech stack, conventions, build commands. Run /init to auto-generate one. Think of it as onboarding docs for an AI team member. Keep it under 100 lines for best results.
📅 Last updated: March 22, 2026 — See what changed
- March 22, 2026: Original publish. Installation commands verified against official Claude Code docs (March 2026). Pricing confirmed at claude.com/pricing. All commands tested on macOS Sequoia and Windows 11.
What's Next in This Series
This guide got you installed and running. But Claude Code has layers, and the next articles in the "Claude Code Unlocked" series go deeper:
- Next: Token & Auth Errors — what to do when authentication breaks (and it will eventually)
- Coming soon: Token Saving Tips — how to do more with less and stretch your $20/month
- Coming soon: Claude Code for Absolute Beginners — starting from "what is a terminal?"
- Coming soon: How Claude Writes Professional Code — prompts that produce production-quality results
I could be wrong here, but I believe Claude Code is the most significant productivity tool to hit developers and non-developers alike since the introduction of ChatGPT itself. The difference is that this one doesn't just talk — it does.
What did you build with your first Claude Code session? Drop it in the comments — I'd love to see what people create on day one. And if you hit any snags during installation, let me know — it might end up in our troubleshooting guide.
Hashtags: #ClaudeCode #ClaudeCodeTutorial #AIForDevelopers #CodingWithAI #ClaudeCodeBeginners #AnthropicClaude #AIcoding #TerminalAI #LearnToCode #ClaudeCodeSetup #ClaudeCodeUnlocked #AIproductivity #DevTools2026 #ThirstyHippo #FallInLoveWithTheRightTech
![[Best Mechanical Keyboards 2026] Thocky or Clicky? (Custom vs Pre-built, Switch Guide)](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhYb9I1nhnI3u2R2szwFouNxROaP9kpnPHih6zHyI4uLXik3ynjDEzQB1wMOe5n8o2bIME8D4SM5-1fDFzLwfqYNXU4pWBhBuqyrznmEPTNlW3hxZ74zcet0ASdw1iaiM1FGAhSHuZRdTtTuSOnwiTV8XXgxhjfnxXlhcOJruM4H2OO44xqI5T0NPfjF9c/w72-h72-p-k-no-nu/Gemini_Generated_Image_icvghpicvghpicvg.png)
![[Stranger Things Season 5] Netflix Stock Buy? (Release Date Leaks, Spinoffs, NFLX Analysis)](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgfPt99FuYg6eKbsxBQYq9ZNUKBheXzDECPOAf54ko6NsLU7-M1o_sKYtGOgtEvkVR_Iq_pPFZBBfm1Go2u4Ybs5ZPM7REk90snsRZmo1XHIE_jEuREf5lYGC1qzmVvSrojgtUFcbORIgdZaqatGsrIfy5QLZc73HkuBVjEGBDpRhCiFybNkp36fmqzkt4/w72-h72-p-k-no-nu/Gemini_Generated_Image_f1xkx4f1xkx4f1xk.png)
![[PS5 Pro vs PC] Best for GTA 6? (Specs Comparison, Cost Analysis, Longevity)](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiITc3OIbDxQFL6UL_bdFXMapAREw5VX6Ojun0BjnjrvR_Uh33IwSyTe6N-t7kwt91WyiYPfzCf1OgcinIQV6eT6qk3JeJzyWSj9IbbG_kxRWbXtWQIbXrcn3d0gEyJ4gIEL7zlKluwd6wjPmTn1p_E12DbkFEajp3w4V1b9y_PgS5Yhk_G_h_hM13Hm-s/w72-h72-p-k-no-nu/Whisk_4e040cfae7dde69b11c493301e18acd7dr.jpeg)
0 Comments