# Claude Code for Beginners: Build Your First Web App Without Being a Developer

By Tania Ahmad, freelance Shopify & full-stack developer · Published 2026-11-18 · Updated 2026-11-18
Source: https://www.taniaahmad.site/blog/claude-code-beginners-guide

> **Quick answer:** Claude Code is Anthropic's AI coding agent that works inside a folder on your computer: it reads, writes and runs code when you ask in plain English. It needs a **paid Claude plan** (Pro or above). Install it with one command (`curl -fsSL https://claude.ai/install.sh | bash` on Mac/Linux, `irm https://claude.ai/install.ps1 | iex` in Windows PowerShell), open a project folder, run `claude`, and describe what you want to build. Use Git, review changes, and never share secrets.

Claude in the browser is great for one-off pages. Claude Code is different: it works in a real project folder on your computer, creates and edits many files, runs commands, and can test what it builds. It's how people go from "vibe coding a page" to "vibe coding an app".

## Which plan do you need?

Claude Code needs a paid plan: Pro, Max, Team or Enterprise (or an API Console account). The free Claude plan doesn't include it. At the time of writing, Pro is $20 a month billed monthly ($17 a month billed yearly), and Max starts at $100 a month for much higher usage.

Some Pro and Max users have **guest passes**: a referral link that gives a new user 7 days of Pro, including Claude Code, to try it out. Ask a friend who uses Claude if they have one.

## Install Claude Code (5 minutes)

You'll need macOS 13+, Windows 10 (1809+) or a recent Linux, 4 GB+ of RAM and an internet connection.

- **Mac / Linux:** open Terminal and run `curl -fsSL https://claude.ai/install.sh | bash`

- **Windows:** open PowerShell and run `irm https://claude.ai/install.ps1 | iex`. Installing [Git for Windows](https://git-scm.com/download/win) first is recommended.

- Check it worked: `claude --version`

## Your first project, step by step

Let's build a small appointment-request app: a page where clients pick a service and a time and send a request, and a simple admin list to see requests.

- **Make a folder**, for example `booking-app`, open your terminal in it and run `claude`. Log in when asked.

- **Ask for a plan first**, not code:

```
I'm a beginner. I want a small web app where clients choose a service and a preferred time and send a booking request, and I can see all requests on an admin page protected by a password.
Before writing code: suggest the simplest tech stack, list the files you'll create, and explain how I'll run it on my computer. Wait for my OK.
```

- **Approve and build.** Claude Code asks permission before running commands or changing files. Read what it wants to do and approve step by step.

- **Run it locally.** Ask "how do I start it?" and open the local address it gives you in your browser.

- **Test like a user.** Try to break it: empty fields, wrong times, the admin page without a password. Describe each problem to Claude and let it fix it.

- **Ask it to explain.** "Explain how a request gets saved, in simple words." You'll learn fast and catch bad decisions early.

## Habits that keep vibe-coded apps safe

- **Use Git from day one.** Ask Claude to "set up Git and commit after each working feature". If something breaks, you can go back.

- **Add a CLAUDE.md file** with your project's rules (tech stack, style, "never delete data without asking"). Claude Code reads it every session.

- **Keep secrets out of code and chat.** API keys and passwords go in a `.env` file that is never committed. Ask Claude to set this up.

- **Review before approving.** Especially commands that delete files, install unknown packages or touch a live database.

- **Small steps.** One feature at a time, tested, then committed. Huge prompts produce huge, hard-to-check changes.

- **Ask for a security check** before going live: input validation, passwords hashed, admin routes protected, rate limiting on forms.

## Putting it online

For a static site, GitHub plus Vercel is the easiest route (see [my Vercel guide](https://www.taniaahmad.site/blog/vibe-code-website-claude-vercel)). An app with a database needs a host that runs a server and a database, and that's the point where getting a developer to review the setup is worth it.

## What Claude Code is (and isn't) good for

It's excellent for prototypes, internal tools, small business apps, automations and learning. It won't replace product thinking, testing with real users, or a careful review of security for anything handling payments or personal data. Use it to move fast, then harden what matters.

  Prototype done? Let's make it production-ready

  I build and harden web apps and AI features for small businesses: from your vibe-coded prototype to a secure, deployed product. Free discovery call.

  [See AI & app services](https://www.taniaahmad.site/ai-integration-developer)

## FAQ

**Is Claude Code free?**
No. Claude Code requires a paid Claude plan (Pro, Max, Team or Enterprise) or an API Console account. Some Pro and Max users can share guest passes that give new users 7 days of Pro, including Claude Code.

**Do I need to know programming to use Claude Code?**
No, you can build small apps by describing what you want. But learning the basics (files, the terminal, Git) helps a lot, and you should ask Claude to explain its changes as you go.

**Does Claude Code work on Windows?**
Yes. Windows 10 (1809+) and Windows 11 are supported. Install it from PowerShell, and Git for Windows is recommended.

**What's the difference between Claude and Claude Code?**
Claude in the browser or app is a chat assistant that can write code you copy out. Claude Code works directly in a project folder on your computer: it creates and edits files, runs commands and tests, with your permission.

## Sources

- [Claude Code setup (Anthropic docs)](https://code.claude.com/docs/en/setup)
- [Claude plans and pricing](https://claude.com/pricing)
- [Claude Code, Cowork and Design guest passes (Claude Help Center)](https://support.claude.com/en/articles/13456702)
