Want an AI that works for you 24/7? Get the Free Blueprint href="/blueprint">Meet your Chief AI Officer →rarr;
Tutorials

How to Build a Website with Claude Code

No coding required. Describe what you want in plain English, and Claude Code builds it for you. This step-by-step guide walks you through your first website from start to deployment.

Updated February 10, 2026 · 16 min read

You can build a complete website with Claude Code by describing what you want in plain English — no HTML, CSS, or JavaScript knowledge needed. Just tell Claude Code what your site should look like and do, and it generates all the code, ready to preview locally and deploy live.

This guide walks you through the full process from setup to deployment. You will describe your site in a prompt, iterate with natural-language feedback like "make the buttons blue" or "add a testimonials carousel," and publish a finished website — all without writing a single line of code yourself.

New to Claude Code? Watch the free CAIO Blueprint to see it in action.

What You'll Need

That's it. No design skills, no coding knowledge, no complex tools. Claude Code runs on Claude Opus 4.6 by default (or Sonnet 4.5 and Haiku 4.5, depending on your plan), which means you get the latest and most capable AI models generating your website.

Step-by-Step: Building Your Website

1 Create a Project Folder

Open Terminal and create a folder for your website:

mkdir my-website
cd my-website

This is where Claude will create all your website files.

2 Start Claude Code

Run Claude Code in your project folder:

claude

You'll see Claude's prompt, ready for your instructions. You can also use Claude Code inside VS Code by installing the official extension from the Visual Studio Marketplace—it gives you the same capabilities in a visual IDE interface with features like file @-mentions and checkpoint rollbacks.

3 Describe Your Website

Tell Claude what you want. The more detail you provide, the closer to your vision the first version will be. But even a simple description works:

Your prompt
Create a landing page for a marketing consultant. Include:
- Hero section with headline and call-to-action button
- Three services: Strategy, Campaigns, Analytics
- Testimonials from 3 clients
- Contact form at the bottom
- Professional, modern design with blue accent color

Press Enter and watch Claude work.

4 Review What Claude Creates

Claude will create an index.html file with your complete website. To see it, you have several options:

5 Iterate on the Design

Here's where the magic happens. Look at your website and tell Claude what to change:

Example iterations
> Make the hero section taller with more padding
> Change the accent color to a deeper blue
> Add icons to each service
> Make the testimonials display in a grid instead of a list
> The contact form needs a phone number field
> Add a subtle gradient to the header

Each change takes seconds. Keep going until you're happy.

If you want Claude to research and plan before making changes, press Shift+Tab twice to enter Plan Mode. Claude will analyze your site and propose improvements before editing any files.

6 Deploy Your Website

Ready to go live? Claude can deploy directly to free hosting:

Deployment prompt
Deploy this website to Vercel

Claude will guide you through connecting to Vercel (free account required) and give you a live URL where anyone can see your site.

Use a CLAUDE.md File for Consistency

If you're building multiple pages or want Claude to follow a specific style guide, create a CLAUDE.md file in your project folder. This is a markdown file that Claude reads at the start of every session, essentially onboarding material that shapes how Claude approaches your project.

Example CLAUDE.md for a website project
# Website Project

## Style Guide
- Use Tailwind CSS for all styling
- Color palette: blue-600 primary, gray-900 text, gray-50 background
- All images should have alt text
- Mobile-first responsive design
- Use Inter font from Google Fonts

## Structure
- All pages go in /pages directory
- Shared components go in /components
- Images go in /public/images

Claude remembers these instructions across your entire session, so every page it creates follows the same conventions.

Preview with Claude's Chrome Integration

Claude Code now integrates with the Claude in Chrome browser extension (beta), giving you browser automation capabilities directly from the CLI. After connecting the extension, Claude can open your site in Chrome, take screenshots, read console errors, and even interact with elements—all without you switching contexts. This is especially useful for testing responsive layouts and verifying that interactive elements work correctly.

Effective Prompts for Website Building

The better your description, the better your first result. Here are examples of effective prompts:

Landing Page

Create a landing page for an AI writing tool called "WriteFlow". Include:
- Hero with headline "Write Better, Faster" and subheadline
- Video demo placeholder
- 3 key features with icons
- Pricing table with 3 tiers (Free, Pro, Team)
- FAQ section with 5 questions
- Newsletter signup in footer
Style: Clean, minimal, lots of white space, purple accent color

Portfolio Site

Build a portfolio website for a UX designer. Include:
- Brief intro/bio section
- Project gallery showing 6 projects as cards
- Each card: thumbnail, title, brief description
- Clicking a card should show more details
- Contact section with email and LinkedIn links
Style: Dark theme, modern, subtle animations

Business Website

Create a multi-page website for a law firm:

Homepage:
- Hero with firm name and tagline
- Overview of practice areas
- Featured attorneys (3)
- Recent news/blog section

About page:
- Firm history
- Values
- Team section with photos and bios

Contact page:
- Contact form
- Office locations (2)
- Map embed
- Phone and email

Navigation should link all pages. Style: Professional, trustworthy, navy blue and gold.

Tips for Better Results

Be specific about style

Instead of "make it look good," say "modern and minimal with lots of white space" or "bold and colorful with rounded corners" or "elegant and professional with serif fonts."

Mention colors

Claude picks reasonable defaults, but specifying "blue accent color" or "dark theme with green highlights" gets you closer to your vision faster.

Describe layout structure

Say "three columns" or "full-width hero" or "sidebar on the left." This prevents Claude from guessing wrong on layout.

Reference examples

You can say "similar style to Apple's website" or "like a Medium article layout." Claude understands common design references.

Adding Functionality

Websites often need more than just static content. Here's how to add common features:

Contact Forms That Actually Work

Make the contact form actually send emails. Use Formspree
so I don't need a server. My email is contact@example.com

Mobile-Responsive Design

Make this website fully responsive. The navigation should
become a hamburger menu on mobile. The three-column layout
should stack vertically on phones.

Animations and Interactions

Add subtle animations:
- Fade in sections as you scroll down
- Buttons should have a hover effect
- Cards should lift slightly when hovered

Image Galleries

Create a photo gallery for the portfolio section. Clicking
a thumbnail should open the full image in a lightbox.
Use placeholder images for now.

Common Mistakes to Avoid

  1. Being too vague: "Make me a website" gives Claude too little to work with. Describe the purpose, audience, and key sections.
  2. Making too many changes at once: Ask for one or two changes at a time. It's easier to see what worked and what didn't.
  3. Not testing on mobile: Ask Claude to make the site responsive, then actually test it by resizing your browser or using phone simulation.
  4. Forgetting SEO basics: Ask Claude to add meta tags, proper headings, and alt text for images. "Add SEO basics to this site."

Deploying Your Website

Claude can deploy to several free hosting services:

Vercel (Recommended for beginners)

Deploy this to Vercel

Fast, free, and handles everything. You'll need to create a Vercel account (free).

Netlify

Deploy this to Netlify

Another excellent free option with similar features.

GitHub Pages

Set this up for GitHub Pages

Free hosting through GitHub. Good if you want version control too.

Custom domains: After deploying, you can connect a custom domain. Ask Claude: "How do I connect my domain example.com to this Vercel deployment?"

Real Example: Full Conversation

Here's what building a website might look like from start to finish:

> Create a landing page for a podcast called "Tech Talks Daily".
> Include a hero, episode list, about section, and newsletter signup.
> Style: Modern, dark theme, purple accents.

[Claude creates index.html]

> The episodes should show in a grid of cards, not a list

[Claude updates layout]

> Add a play button icon on each episode card

[Claude adds icons]

> Make the newsletter form wider and center it better

[Claude adjusts form]

> Add a subtle gradient to the header background

[Claude adds gradient]

> This looks great. Deploy it to Vercel.

[Claude deploys, provides URL]

> Your site is live at: https://tech-talks-daily.vercel.app

Total time: about 15 minutes for a professional-looking landing page.

FAQ

Do I own the website Claude creates?

Yes. The files are on your computer and you deploy them to hosting you control. There's no lock-in.

Can I edit the code manually later?

Absolutely. Claude generates standard HTML, CSS, and JavaScript. Any developer (or you, with some learning) can modify it later.

What if I want to use a specific framework?

Ask Claude: "Build this using React" or "Use Tailwind CSS for styling" or "Create a Next.js project." Claude works with most web technologies including React, Vue, Svelte, Astro, Next.js, and more.

How do I update the site after deployment?

Make changes in Claude Code, then say "redeploy to Vercel." It updates the live site.

Which AI model does Claude Code use?

Claude Code currently uses Claude Opus 4.6 as its default model—the most capable model in the Claude family. It also supports Claude Sonnet 4.5 (balanced speed and quality) and Claude Haiku 4.5 (fast and lightweight). The model you get depends on your subscription plan.

Can I use Claude Code in VS Code instead of the terminal?

Yes. The official Claude Code VS Code extension is available on the Visual Studio Marketplace. It provides a native graphical interface with features like file @-mentions, conversation tabs, checkpoint rollbacks, and the ability to review edits before accepting them.

Related Guides

Like Claude Code? Meet Your Chief AI Officer

Watch a 10-minute video where I build a complete website using only plain English. Then try it yourself.

Get the Free Blueprint href="/blueprint">Watch the Free Setup Video →rarr;