What Is Claude Code? (vs Claude.ai)

From Chat to Coding Partner

Claude.ai (the website) is great for conversations. But it can't touch the files on your computer, run programs, or build a real application. It can describe how to build a login page — it can't actually build one in your project.

Claude Code changes that. It's a program you install on your computer that lets Claude:

• Read and write files on your machine
• Run code and terminal commands
• Look at your project's actual code
• Build and modify applications in real time
• Debug errors by running the code and seeing what happens

The shift is from advice to action. Here's the difference side by side:

---

How Claude Code Works

Claude Code runs in your terminal (also called the command line — covered in the next lesson). When you type a request, Claude can:

1. Read your project files to understand the context
2. Plan what changes need to be made
3. Write or edit files directly
4. Run commands to test that things work
5. Show you what changed and explain why

The whole thing feels like pair programming with an extremely knowledgeable collaborator who happens to never get tired or frustrated.

---

What You Can Build with Claude Code

As a non-technical person, here's what becomes possible:

Web applications

• A personal portfolio site
• A client-facing tool or dashboard
• An internal business tool
• A simple SaaS product

Automation scripts

• Scripts that process data, rename files, or send emails
• Small tools that save you hours of manual work

Proof-of-concept apps

• Turn an idea into a working demo in a day or two
• Validate a business idea before hiring developers

Real production apps

• With the skills from this course, deploy something real to the internet — with a database, authentication, and a custom domain

---

The Mindset Shift: You're the Product Manager, Claude Is the Developer

You don't need to know how to write code. You need to be able to:

1. Describe clearly what you want — "I want a page that shows a list of users from the database, with a button to delete each one."
2. Evaluate the output — Does it look right? Does it work as expected?
3. Describe what's wrong — "The delete button doesn't work," or "I want it to show the user's email, not their ID."

This is product management, not engineering. You bring the what and the why. Claude handles the how.

---

A Typical Claude Code Session

Here's what a session looks like when you're building:

1. Open your terminal and navigate to your project folder.
2. Type claude to start a session.
3. Describe what you want:

   "Add a page to this app that shows a list of blog posts from our Supabase database. Each post should show the title, date, and author. Clicking a title should navigate to the full post."

4. Claude reads your existing files, figures out the structure, and writes the code.
5. Claude runs your app to check for errors.
6. You open your browser and see the result.
7. You give feedback:

   "Looks good! But can you make the date format more readable — instead of '2024-01-15T00:00:00' show 'January 15, 2024'?"

8. Claude fixes it.

This is the core loop: describe → Claude builds → you review → you refine. You'll run it hundreds of times, and it becomes second nature fast.

---

Agentic Mode: Claude Working Autonomously

Claude Code has an agentic mode where you give it a larger goal and it works through it step by step — without you approving every single action.

You might say:

"Build me a basic task management app. It should have: a home page that lists tasks, the ability to add new tasks, mark tasks as done, and delete tasks. Use the existing project structure."

Claude will then:

• Plan the approach
• Create multiple files
• Write the code
• Fix any errors it encounters along the way
• Tell you when it's done

You come back to a working feature. The more detailed your description, the better the result.

---

What Claude Code Is Not

• Not magic. It makes mistakes. You'll debug. That's normal — and you'll learn how to handle it.
• Not a replacement for understanding. The more you understand about what you're building, the better your descriptions, and the better the result.
• Not free. Claude Code uses AI tokens. A Claude Pro subscription ($20/month) includes generous usage, but very heavy use may cost more.

---

Summary

• Claude Code is an AI coding partner that runs on your computer, in the terminal.
• It can read, write, and run your actual project files — not just chat about them.
• Your role: describe what you want, evaluate results, give feedback. You're the PM; Claude is the developer.
• Agentic mode lets Claude work through a larger goal autonomously and report back.
• The core loop is describe → build → review → refine — and by Module 4 you'll be using it to build a real app.