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.
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.
What You'll Need
- Claude Code installed — See installation guide if you haven't set it up
- A folder for your project — Just an empty folder on your computer
- An idea for your website — Even a rough idea works
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:
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:
- Ask Claude: "Open this in my browser"
- Manually open the HTML file in your browser
- Ask Claude to start a local server: "Start a local server so I can preview this"
5 Iterate on the Design
Here's where the magic happens. Look at your website and tell Claude what to change:
> 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:
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.
# 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
- Being too vague: "Make me a website" gives Claude too little to work with. Describe the purpose, audience, and key sections.
- 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.
- Not testing on mobile: Ask Claude to make the site responsive, then actually test it by resizing your browser or using phone simulation.
- 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
- How to Install Claude Code — get set up first
- Claude Code Prompts & Examples — effective prompting
- How to Debug Code with Claude Code — fix issues fast
- Claude Code for Non-Coders — more things you can build
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;