Claude Code for Beginners: Build Your First Web App Without Being a Developer
By Tania Ahmad, freelance Shopify & full-stack developer · Published · 10 min read
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 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 runclaude. 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
.envfile 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). 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 servicesFAQ
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.