Claude Code Tutorial: From Zero to First App

What you need before you start

Claude Code has a short prerequisite list. You need one of the following: a Claude Pro subscription ($20/month) from Anthropic, or an Anthropic API key with a funded account. Either gives you access to the underlying models that Claude Code runs on.

Beyond that, you need Node.js installed on your machine. If you don't have it, download the LTS version from nodejs.org — the installer takes two minutes. Finally, you need basic comfort with a terminal: being able to open it, navigate to a folder with cd, and run a command. That's the full list. You do not need to know how to write code.

Installing Claude Code

With Node.js installed, open your terminal and run:

npm install -g @anthropic-ai/claude-code

This installs Claude Code globally on your machine. Once it completes, run:

claude

Claude Code will prompt you to authenticate. If you're on Claude Pro, sign in with your Anthropic account. If you're using an API key, paste it when asked. Authentication stores credentials locally — you only do this once. After that, every project you open can use Claude Code immediately.

To confirm the installation worked, you should see a blinking prompt waiting for your first message. You're in.

Your first Claude Code session

Navigate to a folder where you want to build something. If you don't have one, create an empty folder and move into it:

mkdir my-first-app

Then start a session:

claude

Now type a plain English request. Something like:

Create a simple web app that shows today's weather for a city I type in.

Watch what happens next. Claude Code doesn't just write code and dump it — it plans out loud, telling you what it's going to build and why, then writes the files one by one, explains what each does, and runs the app to check it works. If it hits an error, it reads the error message and fixes it without you needing to understand what went wrong.

When it finishes, it tells you how to open or run what it built. For a web app, that's usually opening a file in your browser or running a local server. The whole process for a small project typically takes under five minutes.

Core commands to know

Claude Code has a handful of commands that cover almost everything you'll do day-to-day. You don't need to memorize a long list.

Everything else is plain English. You don't need special syntax to ask Claude Code to add a feature, change a design, or fix something. Just describe what you want.

Building a real project: a step-by-step example

Let's walk through building a simple task manager web app from a completely blank folder. This is the kind of project that takes under an hour and teaches you the full build loop.

Step 1 — Give Claude Code a brief

Start with a clear, concrete description of what you want to end up with:

Build a task manager web app. It should let me add tasks, mark them as done, and delete them. Store the tasks so they persist when I refresh the page. Use plain HTML, CSS, and JavaScript — no frameworks.

Claude Code will confirm the plan and start building. It will create an index.html file, a stylesheet, and a JavaScript file that handles the task logic and localStorage persistence.

Step 2 — Review and ask for changes

Once it's done, open the app in your browser. If something looks wrong or you want a different style, describe the change:

The done tasks should have a strikethrough instead of disappearing. And make the add button green.

Claude Code edits only what needs to change. It doesn't rewrite the whole app.

Step 3 — Add a feature

Once the basics work, layer in something new:

Add the ability to set a due date on each task. Show the date next to the task name and highlight overdue tasks in red.

Claude Code reads the existing files, understands the structure, and adds the due date feature without breaking what's already there.

Step 4 — Ship it

How do I put this online so I can share it with someone?

Claude Code will walk you through the simplest deployment path for what you've built — often a drag-and-drop upload to Netlify or Vercel, both of which have free tiers. Within minutes, your app has a real URL.

Common beginner mistakes

Most early frustrations with Claude Code come from a small set of repeatable patterns. Knowing them in advance saves you time.

• Prompts that are too vague. "Make me an app" gives Claude Code nothing to work with. The more concrete your brief — what it does, what it looks like, who uses it — the better the first draft.
• Not giving Claude Code enough context. If you're working in an existing project, tell Claude Code what's already there before asking it to add something. It can read your files, but only if you point it in the right direction.
• Interrupting mid-task. Claude Code often looks like it's doing something wrong halfway through a task when it's actually in the middle of a logical sequence. Let it finish before judging the output. Use the Escape key only if it's clearly going off-track.
• Not reading the plan before confirming. When Claude Code presents a plan and asks for confirmation, read it. This is your chance to catch misunderstandings before any code is written. A two-second check saves ten minutes of reverting.

What to build next

After your first small project, the best thing you can do is build another one immediately — while the loop is fresh. A few good follow-on projects for beginners:

• A personal portfolio site — a single-page site with your bio, projects, and contact details. Design-focused and satisfying to finish.
• A simple SaaS landing page — headline, benefit bullets, pricing table, and a waitlist form. A useful template you'll reuse.
• A Telegram bot — something that sends you a daily briefing, a weather update, or a reminder. Teaches you API integrations.
• A data scraper — pull data from a public website or API and display it in a clean format. A good introduction to working with external data.

For structured project ideas and a curated list of what's worth building as a beginner, see the Claude Code projects page.

Learn at Claude Camp

A tutorial can get you started. What it can't give you is the structure of a cohort, daily accountability, and someone experienced to unblock you when you hit a wall at hour three of day two.

Claude Camp is a seven-day residential bootcamp in Pai, Thailand, built specifically for people learning to build with Claude Code. The programme is structured so that participants who arrive having never written a line of code leave with a deployed, working product. Most participants ship something by day four.

Cohorts are kept small — seven people — so instruction is personal. All meals are included. The setting is an organic farm in the mountains of northern Thailand, which turns out to be a surprisingly good environment for focused building.

If you've followed this tutorial and the feeling you want is more of this, just faster and with people alongside you, that's what the bootcamp is for.