MODULE 3: Your First Real Change

From "I Installed a Tool" to "I Built Something"

Why This Matters Now, For You

You've successfully installed Claude Code. Now, we bridge the gap between having a tool and using it effectively. This module is about building muscle memory for the single most important workflow: turning a plain English idea into a working product. For a consultant, this is the superpower that translates client needs into tangible, value-adding solutions, fast.

๐Ÿ”„PART 1: The Core Workflow

This is the pattern you will repeat for almost every task you do with Claude Code. Internalize it, and you'll be able to build anything. This isn't a linear process; it's a rapid loop. You'll cycle through these steps dozens of times to build complex tools, making small, verifiable progress at each stage.

๐Ÿ› ๏ธPART 2: Your First Button (Hands-On)

Let's walk through the cycle with a simple, tangible goal. We'll add a button to a blank HTML page. This is your first "rep" to build the muscle memory.

๐Ÿ“‹ First: Do You Have an Editor Installed?

Before we can use Claude Code, you need a code editor installed on your computer. Think of this as the workspace where you'll see files and where Claude Code will show its suggestions.

โœ“ Check: Do You Already Have VS Code or Cursor?

Let's see if you already have one of these editors installed:

๐ŸŽ On Mac:

  1. Press Command + Space to open Spotlight Search
  2. Type "Visual Studio Code" or "Cursor"
  3. If you see either app appear, you're good! Click to open it.
  4. If nothing appears, you need to install one (see below)

๐ŸชŸ On Windows:

  1. Click the Start menu (Windows icon)
  2. Type "Visual Studio Code" or "Cursor"
  3. If you see either app appear, you're good! Click to open it.
  4. If nothing appears, you need to install one (see below)

Option 1: Install VS Code (Recommended โœ“)

๐Ÿ’ฐ Cost: 100% FREE โ€” No credit card, no trial, no hidden fees!

What is VS Code? Visual Studio Code (VS Code) is a free, open-source code editor made by Microsoft. It's what most developers use worldwide, and it's perfect for learning. You get all features for free, forever.

๐Ÿ“ฅ How to Download & Install VS Code:

  1. Visit code.visualstudio.com in your web browser
  2. Click the big blue "Download for Mac" or "Download for Windows" button
  3. Wait for the download (takes 30-60 seconds)
  4. On Mac:
    • Open your Downloads folder
    • Double-click the "VSCode-darwin.zip" file to unzip it
    • Drag the "Visual Studio Code" app to your Applications folder
    • Open Applications and double-click Visual Studio Code
  5. On Windows:
    • Open your Downloads folder
    • Double-click the "VSCodeSetup.exe" file
    • Click "Yes" if Windows asks for permission
    • Click "Next" through the installation wizard
    • Check the box that says "Create a desktop icon" (helpful!)
    • Click "Install" and wait 1-2 minutes
    • Click "Finish" โ€” VS Code opens automatically!

โœ… Success looks like: VS Code opens and you see a welcome screen with "Get Started" options. You're ready to continue!

Option 2: Use Cursor (If You Already Have It)

๐Ÿ’ฐ Cost: FREE for 2 weeks, then $20/month (but you can use the free trial for this tutorial!)

What is Cursor? Cursor is a newer code editor that's built on top of VS Code with extra AI features. If you already have it installed, you can use it instead! Note: While Cursor has paid features, Claude Code itself works the same way in both editors.

๐ŸŽฏ Using Cursor Instead of VS Code:

The good news: Cursor works almost exactly the same as VS Code for our purposes! Anywhere this tutorial says "VS Code," just use "Cursor" instead.

Key differences:

  • Opening folders: In Cursor, it's File โ†’ Open Folder (same as VS Code)
  • File explorer: Same left sidebar showing your files
  • Claude Code: Works the same way in both editors
  • Extra features: Cursor has its own AI assistant, but we'll focus on Claude Code for this tutorial

๐Ÿ’ก Don't have Cursor but want to try it? Visit cursor.sh to download. Installation is similar to VS Code (download โ†’ install โ†’ open).

๐Ÿค” Which One Should I Choose?

For This Tutorial: Use VS Code. It's 100% free forever and has everything you need. It's simpler for learning, and you can always try Cursor later once you're comfortable with the basics.

If You Already Use Cursor: That's great! Cursor works identically for this tutorial. Just follow along and substitute "Cursor" anywhere you see "VS Code." The Claude Code setup and workflow are exactly the same.

โœ… Ready to Continue?

Once you have VS Code or Cursor installed and can open it, you're ready to create your practice workspace below!

๐ŸŽฏ Now Let's Create Your Practice Workspace

Now that you have an editor installed, let's create a safe place to practice. Think of this like setting up a sandbox where you can experiment without breaking anything important.

Step 1: Create Your Practice Folder

We'll create a folder called Claude_Practice on your Desktop where you can safely try things out.

๐ŸŽ On Mac:

  1. Go to your Desktop (minimize all windows or press Command + D)
  2. Right-click on an empty area
  3. Select "New Folder"
  4. Name it Claude_Practice (exactly as shown)

๐ŸชŸ On Windows:

  1. Go to your Desktop (press Windows + D to show desktop)
  2. Right-click on an empty area
  3. Select "New" โ†’ "Folder"
  4. Name it Claude_Practice (exactly as shown)
๐Ÿ’ก Can't find your Desktop or see OneDrive in the path?

If your Desktop is synced to OneDrive (common on Windows), your path might look like C:\Users\YourName\OneDrive\Desktop โ€” that's perfectly fine! The folder just needs to be somewhere you can easily find.

Alternative: Use Documents instead

If you're not comfortable with Desktop, create the folder in your Documents folder instead. Same process: just right-click in Documents โ†’ New Folder โ†’ name it Claude_Practice.

Remember: You're using Windows Explorer/Mac Finder (the normal way!), not typing commands. Just create a folder like you would for any other file.

Step 2: Create a Simple HTML File

Now let's create a basic HTML file that we can practice editing. Don't worry if you don't understand HTML โ€” you don't need to!

  1. Open Notepad (Windows) or TextEdit (Mac)
  2. Copy and paste this simple code:
    <!DOCTYPE html>
    <html>
    <head>
        <title>My Practice Page</title>
    </head>
    <body>
        <h1>Hello from Claude Practice!</h1>
    </body>
    </html>
  3. Click "File" โ†’ "Save As"
  4. Navigate to your Desktop and open the Claude_Practice folder you just created
  5. Name the file index.html (make sure it ends with .html, not .txt)
  6. Click "Save"

๐Ÿ’ก Quick test: Double-click your index.html file. It should open in your web browser and show "Hello from Claude Practice!" โ€” that means it worked!

Step 3: Open This Folder in VS Code

Now we'll open your practice folder in VS Code (the program where Claude Code lives).

Method 1: Through VS Code (Easiest)

  1. Open VS Code (search for it in your Start menu or Spotlight)
  2. Click "File" in the menu bar at the top
  3. Click "Open Folder..."
  4. Navigate to your Desktop
  5. Click on Claude_Practice folder
  6. Click "Select Folder" (Windows) or "Open" (Mac)

Method 2: Right-click the folder (If you have VS Code installed)

  1. Go to your Desktop
  2. Right-click on the Claude_Practice folder
  3. Look for "Open with Code" or "Open with VS Code"
  4. Click it โ€” VS Code opens with your folder ready!

โœ… Success looks like:

  • You see "CLAUDE_PRACTICE" at the top-left of VS Code
  • In the left sidebar (called "Explorer"), you see index.html listed
  • If you click on index.html, your code appears in the main area

๐ŸŽ‰ You're Ready to Practice!

You now have a safe sandbox where Claude Code can make changes. Nothing you do here will affect your important files. Let's make your first edit!

The Request: Your Intent into Words

๐Ÿ”ง Your VS Code Workspace โ€” Visual Guide

If you're new to VS Code or can't find where things are, hover over each numbered region below to see what it does:

Visual Studio Code - CLAUDE_PRACTICE File Edit Selection View Go Run โ‹ฏ ๐Ÿ“ ๐Ÿ” ๐ŸŒฟ โš™๏ธ EXPLORER โ–ผ CLAUDE_PRACTICE ๐Ÿ“„ index.html ๐Ÿ“„ styles.css ๐Ÿ“„ script.js ๐Ÿ“„ index.html ร— <!DOCTYPE html> <html> <head> <title> My Practice Page </head> <body> <h1> Hello from Claude Practice! ๐Ÿค– CLAUDE ๐Ÿ‘ค You: Add a blue button that says "Click Me" ๐Ÿค– Claude: I'll add that button to your HTML. Here's what I'll change: [Shows diff preview] Type your request here... โžค 1. Activity Bar (Icons) Click these icons to open different panels. The top icon opens the Explorer. 2. Extensions Icon Click here to install/update the Claude extension (Ctrl+Shift+X) 3. ๐ŸŒŸ CLAUDE ICON - TOP RIGHT! THIS IS THE MOST IMPORTANT ICON! Look in the TOP RIGHT corner (not left sidebar!) It's an ORANGE SUNBURST next to split panel and โ‹ฏ icons. Click it to open Claude chat panel! 4. Explorer Sidebar Shows your project files and folders. Click on any file (like index.html) to open it in the editor area. 5. Editor Area Where you write and edit your code. Claude's changes appear here. 6. Claude Side Panel Opens when you click the Claude icon. This is where you chat with Claude and see AI responses. 7. Chat Input Box Type your requests here in plain English, then press Enter to send!
โš ๏ธ CRITICAL: How to Start Chatting with Claude

After clicking the orange Claude icon, you'll see a screen like the one above. Here's how to ACTUALLY start chatting:

Option 1: Use the Keyboard Shortcut (Fastest)

Ctrl + Alt + I (Windows/Linux)
Cmd + Alt + I (Mac)

This opens the chat input immediately. Type your request and press Enter!

Option 2: Click "Open Chat" (Visual Method)

Look for the "Open Chat" button in the default screen (see screenshot above)

You'll also see other shortcuts like "Show All Commands" and "Go to File" โ€” ignore those for now.

Option 3: Command Palette

  1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
  2. Type: Claude: Open Chat
  3. Press Enter

๐Ÿšจ Don't get stuck here! Most new users see this screen and don't know what to do next. Use Ctrl+Alt+I to start chatting immediately!

๐Ÿ” WHERE IS THE CLAUDE ICON?

Look in the TOP RIGHT corner of VS Code!

The orange sunburst icon is NOT in the left sidebar. It's in the top right toolbar, next to the split panel icon (๐Ÿ“ฑ) and the three dots (โ‹ฏ).

It took me 15 minutes to find it too โ€” VS Code updates change the layout!

๐Ÿ”„ Can't see the orange icon at all?

If the Claude extension is not installed or needs updating:

  1. Press Ctrl+Shift+X to open Extensions
  2. Search for "Claude Code for VS Code" by Anthropic
  3. Click "Install" or "Update" if available
  4. The orange Claude icon will appear in the TOP RIGHT toolbar

๐Ÿ’ก Quick Start: Look TOP RIGHT โ†’ Click orange sunburst โ†’ Press Ctrl+Alt+I โ†’ Type request โ†’ Enter!

Open the Claude Code side panel in VS Code. In the chat input, type your request clearly and specifically:

Add a blue button that says 'Click Me' and shows an alert when clicked

See It in Action

Click below to watch the full cycle: You type โ†’ Claude generates โ†’ Diff appears โ†’ You approve:

๐ŸŽฌ Interactive Demo: Type โ†’ Diff โ†’ Approve

โ–ถ๏ธ

Click the Play button to watch the entire workflow โ€” from typing your request to reviewing and approving the changes.

Interactive Element: What Happens Next

Make this edit to c:\...\index.html?

Claude shows a diff and asks for your approval. Review the proposed edits:

<h1>Hello from Claude Practice!</h1>
+ <button onclick="alert('Button clicked!')" style="background-color: blue; color: white; padding: 10px 20px; border: none; border-radius: 5px; cursor: pointer;">Click Me</button>

Your options:

1 Yes
2 Yes, and don't ask again
3 No
Tell Claude what to do instead

Tip: Type 1 or click the blue button to approve. Green lines = added code. No files change until you say yes!

Reading the Diff (The Critical Skill)

The most important step in the cycle is reviewing the 'diff' (difference). This is your safety net and your learning tool. It shows you exactly what Claude proposes to change. Hover over each line below for an explanation.

<h1>Hello</h1> This line is unchanged context. Claude shows it to help you see WHERE the change is happening.
+ <button style="background-color: blue; ..." onclick="alert('Hello!')"> A green '+' means this entire line is being ADDED to your file.
+   Click Me This is the text that will appear inside the new button.
+ </button> This closes the new button element, completing the addition.

Make this edit to c:\Users\...\index.html?

Exactly how it appears in VS Code. Review the diff:

<h1>Hello from Claude Practice!</h1>
+ <button onclick="alert('Button clicked!')" style="...">Click Me</button>
1 Yes
2 Yes, and don't ask again
3 No
Tell Claude what to do instead

What to do: Press 1 on your keyboard or click the blue "1 Yes" button. Green lines = additions, red = deletions.

โš ๏ธ Heads Up: Claude May Ask Multiple Times!

Don't be surprised if Claude asks for approval more than once. This is NORMAL and happens when:

  • Claude finds linting errors after making changes and wants to fix them
  • Additional changes are needed to make the code work properly
  • Claude needs to create/update multiple files (each requires approval)
  • Improvements are suggested after the initial change is applied

What to do: Review each change and select "1 Yes" if it looks good.

For now, as you're learning, it's safe to approve Claude's suggestions. The iterative approval process is a safety feature, not a problem!

๐Ÿ›ก๏ธThe Heart of Claude Code: You're Always in Control

This is Claude Code's core philosophy:

AI proposes, humans decide. Every single change requires your explicit approval. No surprises, no automatic edits, no "trust me" moments.

This review step isn't a formality โ€” it's your power. You're the architect, Claude is the builder who shows you blueprints before construction.

Making Your Decision: The 3-Question Framework

Before approving, ask yourself these 3 quick questions:

1. Does it add what I requested?

Example: "A blue button that shows an alert"

โœ“ YES

2. Is it removing anything I want to keep?

Look for red lines with a '-' sign

โœ“ NO (safe)

3. Do I understand the gist of what it's doing?

You don't need to understand every detail, just the big picture

โœ“ YES (adding button code)

โœ… Decision: This is a safe and accurate change. Approve it!

Verify It Worked: Trust, but Verify

After you click Approve in the editor modal, the changes are saved. Now, verify them.

  1. Find the `Claude_Practice` folder on your Desktop.
  2. Double-click the `index.html` file to open it in your web browser.
  3. You should see your button. Click it! An alert should pop up.

Simulated Browser Preview

Hello

๐ŸŽ‰ SUCCESS! You just completed your first full cycle.

You described what you wanted in English, reviewed the code Claude suggested, approved it, and saw it work in real-time. This is the foundation for everything you will build.

โš™๏ธ The โ€œApprove Before Applyโ€ Difference

Prompting, reviewing diffs, and contextual editing feel the same across modern AI coding tools. You describe an intent, the assistant proposes a change, and you see exactly what will happen in context.

Claude Code adds an explicit approval loop: every change is presented as a diff, and no file is modified until you approve. This one step is the safety rail that keeps you in control of your codebase.

๐Ÿชถ In Cursor

  • Prompt
  • Inline edit
  • Direct write

๐Ÿ›ก๏ธ In Claude Code

  • Prompt
  • Diff view
  • Approve โ†’ write

One extra click = full control. Complianceโ€‘friendly for consultants and analysts.

๐Ÿงญ Claude Code Commands Palette

Beyond chat, Claude Code exposes common actions via your IDEโ€™s command palette for fast workflows:

  • Explain code: Summarize a file or selection to understand intent and sideโ€‘effects.
  • Edit selection: Apply a change to the highlighted code with a concise instruction.
  • Generate test: Create unit tests and basic fixtures for the selected function.

These map directly to the Request โ†’ Diff โ†’ Approve loop and keep you in flow.

๐ŸŽ“ For Non-Coders: Your Secret Learning Weapon

One of the most powerful commands for beginners is "Explain code like a 5 year old". Here's how to use it:

How to use it:

  1. Highlight any code you're curious about
  2. Right-click and select "Ask Claude..."
  3. Type: explain code like a 5 year old
  4. Press Enter

Example Response:

"Imagine you're building with LEGO blocks! Let me explain what each part does: The HTML file is like a toy box with different sections:"

  • <!DOCTYPE html> - This says "Hey, I'm making a webpage!"
  • <head> section - Like the instruction manual for your toy
  • <style> - Picking colors for your LEGO! Says the button should be blue

Why this matters: Our goal isn't to make you memorize code. But occasional encounters with simple explanations build comfort and pattern recognition. Over time, you'll start recognizing structures without needing to understand every technical detail. It's like learning to drive โ€” you don't need to know how the engine works to navigate safely!

๐Ÿ’ก Pro Tip: Use this command whenever you see code that Claude generated and you're curious "What does this actually do?" The gentle explanations help you learn by osmosis, without forcing you to study.

โœจPART 3: Iteration - Making It Better

Greatness isn't achieved in one step. The real power of this workflow is how easy it is to refine your work. Let's improve the button we just made.

The Power of Conversation

Back in your terminal, the Claude session is still active. You can continue the conversation, building on the previous context.

Request 2: Change the message

Your prompt can be short and direct because Claude remembers what you were just doing.

change the alert message to 'Welcome to my calculator!'
I'll update the onclick alert message.
Changes to index.html:
<button style="background-color: blue..."
- onclick="alert('Hello!')">
+ onclick="alert('Welcome to my calculator!')">
Click Me
Apply these changes? (y/n)

Notice how the diff is much smaller. It only shows the single line that changed. This makes reviews incredibly fast and builds confidence.

Request 3: Improve the style

make the button bigger and center it on the page
I'll add centering and increase the button size.
Changes to index.html:
<h1>Hello</h1>
+ <div style="text-align: center; margin-top: 50px;">
<button style="background-color: blue;
- padding: 10px 20px;
+ padding: 15px 40px;
+ font-size: 18px;
..."
Click Me
</button>
+ </div>
Apply these changes? (y/n)

Key Insight: Iteration is Cheap and Fast

You didn't need to know all the requirements upfront. You started with a basic version, tested it, and then refined it. This Build โ†’ Test โ†’ Refine loop is how all modern software is built. With Claude Code, each iteration costs pennies and takes seconds.

๐ŸŽจ Mini Exercise: Make Your Alert Box Beautiful

Right now, your alert box is functional but basic (plain browser alert). Let's apply what you just learned about iteration to make it feel professional with proper centering and styling!

What You'll Learn

  • How to center content both horizontally AND vertically
  • Creating a custom modal box instead of browser alert
  • Adding a title and proper message formatting
  • Understanding basic modal box patterns (you'll see these everywhere!)

Your Prompt to Claude

"Replace the alert with a custom modal box that:
- Centers horizontally and vertically on the page
- Has a dark background overlay
- Shows a white box with title 'This page says' and message 'Welcome to my calculator!'
- Has an OK button to close it
- Looks professional and modern"

โŒ Before (Browser Alert):

โ€ข Off-center, awkward positioning
โ€ข No character or style
โ€ข Can't customize look

โœ… After (Custom Modal):

โ€ข Perfect center alignment
โ€ข Professional appearance
โ€ข Full control over design

What to expect

  1. Claude will show you the diff with HTML, CSS, and JavaScript changes
  2. You'll see code for positioning (flexbox/grid - don't worry about the details!)
  3. Press 1 (Yes) to approve
  4. Refresh your browser and click the button again
  5. Notice how much more professional it looks!

๐Ÿ’ก What You're Actually Learning (Without Realizing It):

You're building intuition about modal boxes โ€” those popup overlays you see everywhere (login forms, confirmations, image viewers). By seeing how Claude structures one, you'll start recognizing the pattern: overlay + centered box + close button. Next time you want to add ANY kind of popup to your tools, you'll intuitively know how to ask Claude for it!

Bonus: Once you see the result, try clicking outside the modal box. Ask yourself: "Should that close the modal?" This kind of thinking is UX design โ€” and you're starting to develop that muscle!

โœจ Follow-Up Exercise: Modernize Your Modal

You might have noticed "This page says" sounds old-fashioned โ€” that's because it's browser language from the 1990s! Let's iterate one more time to make it sound modern and professional.

The Problem with "This page says"

โŒ Old-World Style

"This page says"
โ†’ Feels like a browser error
โ†’ Impersonal and technical

โœ… Modern Style

"Welcome!" or "Getting Started"
โ†’ Friendly and inviting
โ†’ App-like experience

Your Next Prompt

"Update the modal to be more modern and welcoming:
- Change title from 'This page says' to 'Welcome! ๐Ÿ‘‹'
- Update message to 'Ready to build something amazing? This is your practice space for creating financial tools.'
- Make the OK button say 'Let's Start!' instead
- Add a subtle animation when the modal appears"

๐Ÿ’ก Why This Matters:

Language shapes user experience! "This page says" makes users feel like something went wrong. "Welcome!" makes them feel invited. When you build tools for clients, this attention to welcoming language separates amateur-looking tools from professional ones. You're learning to think like a product designer โ€” not just making things work, but making them feel RIGHT.

What You'll Notice After This Change

  • The tool feels like a professional app, not a webpage
  • The welcoming tone makes it inviting to use
  • The animation adds polish (smooth fade-in/scale effect)
  • Your clients/colleagues will perceive higher quality

Design Insight: Every word, every animation, every color choice either builds trust or creates friction. You're developing an eye for these details!

๐Ÿ—๏ธPART 4: Building a Compound Interest Calculator

You've practiced the workflow. Now, let's build something genuinely useful for your work as a financial consultant. This project should take about 20 minutes endโ€‘toโ€‘end. This is not just practice; you are building a reusable asset.

PHASE 1: Setup Your Project Environment

It's best practice to give every new project its own folder. This keeps your work organized and prevents Claude from getting confused by unrelated files.

Choose Your Approach

Most users prefer the GUI method (left column) โ€” it's the familiar way you already know. The terminal commands (right column) are optional and included for reference.

๐Ÿ–ฑ๏ธ GUI Method (Recommended for Most Users) โŒจ๏ธ Terminal Method (Optional)

Use Windows Explorer (PC) or Finder (Mac)

  1. Navigate to your Desktop (or Documents folder โ€” your choice!)
  2. Right-click in empty space
  3. Select New โ†’ Folder
  4. Name it CompoundInterest
  5. Double-click to open it

๐Ÿ’ก Seeing OneDrive in your path?

Paths like C:\Users\YourName\OneDrive\Desktop are perfectly fine! The location doesn't matter โ€” just remember where you put it.

Use Terminal/Command Line

Step 1: Navigate to Desktop

cd ~/Desktop

Step 2: Create and enter CompoundInterest folder

mkdir CompoundInterest && cd CompoundInterest

Checklist

  • โœ“ I have a folder named CompoundInterest
  • โœ“ The folder is empty (no files inside yet)
  • โœ“ I know where this folder is located on my computer

PHASE 2: First Request (The HTML Structure)

Our first request will ask for the skeleton of the calculator: the HTML inputs and basic layout. We're not worried about the math yet, just the user interface.

In VS Code: Create an HTML file with a compound interest calculator. Include input fields for: initial investment, monthly contribution, annual interest rate, and number of years. Add a Calculate button.

What to Expect in the Diff:

Claude will propose creating a new file (e.g., `calculator.html`). The diff will be all green `+` lines. You should see:

  • Standard HTML boilerplate (<!DOCTYPE html>, etc.)
  • A <style> section with some basic, professional CSS.
  • A <body> containing a form with the four <input> fields you requested.
  • A <button> and a <div> to hold the results.

This is the structure; the logic comes next. Approve it.

PHASE 3: Second Request (The JavaScript Logic)

The page looks right, but the button does nothing. Now we add the brain: the JavaScript calculation function.

In VS Code: add the calculate() function that computes compound interest with monthly contributions and displays the result showing: future value, total contributions, and interest earned.

What to Expect in the Diff:

Claude will add a <script> tag to your HTML file, likely before the closing </body> tag. Inside, you'll see a function named calculate(). You don't need to be a math expert to approve this:

  • Scan the code: Do you see variables like `principal`, `rate`, `years`? Good, it's using your inputs.
  • Look for the output: Do you see it calculating `futureValue`, `totalContributions`, and `interestEarned`? Good, it's meeting your requirements.
  • Check the display logic: It should end by setting the `innerHTML` of your result div.

This is the "engine" of your tool. Approve it.

PHASE 4: Test Your New Tool

Open `calculator.html` in your browser. It's time to test it like you would any financial tool. Use known values to verify the logic.

Test Case 1:

  • Initial Investment: $10,000
  • Monthly Contribution: $500
  • Annual Interest Rate (%): 7
  • Number of Years: 20

Click Calculate. The results should appear. Expected Future Value: $273,915.64.

Try different values. Does it update correctly? Congratulations, you just built a functional, reusable financial tool from scratch using plain English!

PHASE 5: Refinement (Optional Improvements)

Now that it works, you can easily add professional touches. Each of these is a simple, conversational follow-up request.

  • Add Input Validation: "show an error message if any fields are empty or if values are negative"
  • Improve Formatting: "format the currency results with commas for thousands separators"
  • Add Your Branding: "add my company name 'Smith Financial Advisors' at the top and use our navy blue color (#003366) for the button and header"
  • Add a Chart: "using Chart.js, add a pie chart showing the breakdown of total contributions vs interest earned"
  • Add Print Functionality: "add a Print Results button that formats the output nicely for printing"

Each refinement is just another turn of the Request โ†’ Approve โ†’ Verify cycle, allowing you to layer on complexity with confidence.

PHASE 6: Showcase Your Creation

Share your calculator with a simple link. Think of CodePen or JSFiddle as "YouTube for code"โ€”you paste your HTML, and they give you a web page you can share.

  1. Open your calculator.html file in VS Code and copy all its contents.
  2. Go to codepen.io or jsfiddle.net in your browser.
  3. Create a new Pen/Fiddle and paste your HTML into the HTML panel. If you have inline <style> or <script>, paste them into the CSS/JS panels.
  4. Click Save/Run. Youโ€™ll get a shareable URL. Send it to a colleague or client.

Nonโ€‘coder tip

You donโ€™t need GitHub or hosting to show your work. These sites are pointโ€‘andโ€‘click. If something doesnโ€™t look right, ask Claude: โ€œMake this work on CodePen; move styles to CSS and scripts to JS.โ€ Approve the diff and paste again.

๐ŸงฉKnowledge Check (1/2)

Let's check your understanding of these core concepts before moving on.

๐Ÿ—ฃ๏ธPART 5: Communication Mastery

The quality of your output is directly tied to the quality of your input. Learning to "talk" to Claude effectively is the difference between getting a generic response and a perfect one. Let's master the art of the request.

โŒ BAD REQUESTS vs โœ… GOOD REQUESTS

Vague requests lead to vague results. Specificity is key. Click each pair below to see the difference in action.

Pair 1: Style
Pair 2: Features
Pair 3: Debugging
Pair 4: Scaffolding

โŒ Bad: "Make it better"

This is subjective. "Better" could mean bigger, faster, more colorful, or simpler. Claude has to guess.

โœ… Good: "Increase the font size to 18px and add more padding around the button"

Why it's better: It's specific, measurable, and provides clear, actionable instructions. There is no ambiguity.

โŒ Bad: "Add stuff to the calculator"

"Stuff" is meaningless. Claude doesn't know if you want more input fields, a chart, or a print button.

โœ… Good: "Add a field for inflation rate that adjusts the final value"

Why it's better: It defines exactly what feature ("inflation rate field") and what behavior ("adjusts the final value") you want.

โŒ Bad: "Fix it"

When something is broken, just saying "fix it" forces Claude to analyze the entire file. It might fix the wrong thing.

โœ… Good: "The Calculate button isn't responding when clicked - can you check the onclick handler?"

Why it's better: It describes the symptom ("button isn't responding") and suggests a location ("onclick handler"), dramatically narrowing the search space and leading to a faster, more accurate fix.

โŒ Bad: "Build me a website"

This is far too broad. The result will be a generic template that doesn't meet your needs, wasting time and tokens.

โœ… Good: "Create an HTML page with a header, a navigation menu with Home/About/Contact links, and a hero section with a headline and a call-to-action button"

Why it's better: It breaks a large, ambiguous request into specific, structural components. This allows you to build complex pages piece by piece.

The CยทLยทEยทAยทR Framework for Perfect Prompts

To make writing good prompts easy, use this memorable acronym. It structures your thoughts and ensures you provide all the information Claude needs.

C

Context

Who is the audience and what is the purpose?

Example: "Developing a financial calculator for client use."

L

Location

Specify exactly where the modification or addition should occur.

Example: "In calculator.html, within the result section."

E

Expected Outcome

Describe the desired result or output concisely.

Example: "Display results as a formatted table for readability."

A

Avoid

List any limitations, restrictions, or elements that should remain unchanged.

Example: "Do not alter existing input fields or form logic."

R

Reasoning (Optional)

Offer a brief justification or rationale for the change.

Example: "To enable clients to print clear outputs for documentation."

โœจ Example Using CยทLยทEยทAยทR:

Elegant, Claude-ready prompt:

C โ€“ Context: Enhance a loan calculator for small business clients.

L โ€“ Location: Within calculator.html's results section.

E โ€“ Expected Outcome: Display results as a styled, responsive table.

A โ€“ Avoid: Do not alter existing input fields or form logic.

R โ€“ Reasoning: Clarity and printable results are crucial for client documentation needs.

Interactive Element: Request Builder

Build Your CLEAR Request

๐Ÿš€PART 6: Becoming Productive

You know the workflow and how to communicate. Now, let's optimize the process to save time, reduce costs, and build faster.

TECHNIQUE 1: Batch Related Changes

Each request has a small overhead. Combining related changes into a single, clear request is far more efficient.

โŒ Slow Way (3 Requests)
$ "Make the button blue"
$ "Make the button bigger"
$ "Center the button"

Why it's slow: Three separate API calls, three approvals, three cycles. Takes longer and costs more.

โœ… Fast Way (1 Request)
$ "Make the button blue, larger (about the size of a standard action button), and centered on the page"

Why it's fast: One API call, one approval, one cycle. Completes in seconds.

๐Ÿ’ก Tip: Describe visually ("larger", "standard size") instead of using code terms ("padding: 15px 40px").

๐Ÿง  The Math Behind Batching: Why It Actually Matters

Let's break down what's really happening when you batch vs. split requests:

โšก Speed (Net Wait Time)

3 requests: ~15-20 seconds each = 45-60 sec total wait
1 batched: ~20-25 seconds = 20-25 sec total wait
You save: 25-35 seconds (50% faster!)

๐Ÿช™ Token Economics

3 requests: Each re-sends file context = 3ร— overhead
1 batched: Context sent once = ~40-60% fewer tokens
Your wallet: Same result, less cost

๐Ÿง˜ Cognitive Load

3 requests: Review diff 3ร—, context-switch 3ร—, approve 3ร—
1 batched: One focused review session
Your brain: Less mental overhead, fewer errors

๐ŸŽฏ Understanding

3 requests: See changes piecemeal, lose big picture
1 batched: See complete transformation in one diff
Your learning: Better grasp of how changes work together

๐Ÿ’ก The Real Insight

Each API call has fixed overhead (loading context, initializing, formatting response). It's like making 3 separate trips to the store for milk, eggs, and bread vs. one trip for all three. The per-item time is the same, but you save on travel time. Batch when changes are related; split when they're independent experiments.

TECHNIQUE 2: Use `CLAUDE.md` for Preferences

Instead of repeating style guides or constraints in every session, create a special instructions file called `CLAUDE.md` in your project's root folder. Claude reads this file automatically at the start of every conversation for context.

๐Ÿ“ What is `CLAUDE.md` and What Goes Inside?

Think of it as a sticky note for Claude. It's a simple text file where you write down preferences you want Claude to remember for THIS project (like colors, style, what NOT to change, etc.).

The .md just means "Markdown" (a way to format text). Don't worry about it โ€” you're just typing plain text with a few symbols like # for headings.

Here's What a CLAUDE.md File Looks Like

Click the button above to copy this example โ€” you'll customize it in a moment:

# Financial Calculator Project

## Style Preferences
- Use navy blue (#003366) as the primary color
- Keep the design clean and professional
- Make sure buttons are large enough to click easily

## Important Rules
- Don't change the calculation formulas
- Always show currency with 2 decimal places
- Keep all error messages friendly and helpful

## Tone
- Use professional language (avoid slang)
- Explain financial terms if you use them

The # and ## are headings, the - makes bullet points. That's it!

How to Create This File in VS Code (3 Steps)

๐Ÿ“ When VS Code Asks "Select File Type"

When you click "Save As," VS Code will show a dropdown asking for the file type. You'll see options like "Text File Built-In," "Jupyter Notebook," etc. Just type the filename directly: CLAUDE.md

๐Ÿ’ก Learning moment: The .md extension tells VS Code "this is a Markdown file." VS Code will automatically recognize it and give you nice formatting. The dropdown is just a shortcut โ€” typing the full filename with extension works perfectly!

  1. In VS Code, click File โ†’ New File (or press Ctrl+N)
  2. Copy-paste the example text above (or write your own)
  3. Click File โ†’ Save As, then:
    • Ignore the "Select File Type" dropdown (don't click it!)
    • Navigate to your project folder โ€” look for the folder that has your index.html file (probably Claude_Practice or CompoundInterest on your Desktop)
    • In the filename box, type: CLAUDE.md

      Why all caps? It's a convention (like README.md) to make it stand out in file lists. When you have 10-100 files, all caps file name helps easy finding. But honestly? claude.md or Claude.md works just fine! Claude will find it. Use what you prefer.

    • Click Save

โœ“ Success looks like: You see CLAUDE.md with a small "Mโ†“" icon in VS Code's left sidebar, next to your index.html file. The icon means VS Code recognized it as Markdown!

๐Ÿ’ก Don't want to write it yourself?

Ask Claude Code: "Create a CLAUDE.md file for this project. I want professional tone and navy blue colors." โ€” Claude will write the whole thing for you!

The Result: Automatic Consistency

With this CLAUDE.md file in your project folder, you no longer need to repeat "use navy blue" or "keep it professional" in every request. Claude reads this file automatically at the start of each conversation and remembers your preferences. This saves enormous time and ensures consistency across your entire project.

๐Ÿงญ See the Difference: With vs Without CLAUDE.md

You ask Claude the exact same question: "Write a professional email summarizing Q4 results." Watch how the response changes when you have a CLAUDE.md file with your preferences:

โŒ Without CLAUDE.md

Generic, no personality

Subject: Q4 Summary

Your Q4 summary is complete.
Highlights: revenue, costs, and net margin.
Please review.
                

โœ… With CLAUDE.md

Professional tone, client-friendly language

Subject: Clientโ€‘friendly Q4 Summary

Dear Client A โ€” your Q4 summary highlights steady growth with disciplined cost control.
We saw revenue up 6.2% and margin +90 bps. 
Next steps: confirm targets for Q1.
                

๐Ÿ’ก The Magic: Claude automatically applied your tone preferences (professional, client-friendly) and style guidelines from CLAUDE.md โ€” without you having to repeat them in your request!

๐Ÿงฉ Miniโ€‘Assignment: Write Your Own CLAUDE.md

Draft a tiny CLAUDE.md for a fictional financial client project. Use the quick reference below to format it properly.

๐Ÿ“˜ Quick Markdown Reference (Only 5 Things You Need)

What You Type What It Does Example
# Heading Big heading (title) # Project Goals
## Subheading Smaller heading (section) ## Style Preferences
- Item Bullet point (dash + space) โ€ข Use navy blue
**bold text** Makes text bold **Important:** Always be professional
[blank line] Creates space between sections Just press Enter twice

๐Ÿ’ก Pro tip: You don't need to memorize this! Just type normally and add # for headings and - for bullet points. That's 90% of what you'll use.

Try It: Write Your CLAUDE.md

Draft a CLAUDE.md for a fictional financial tool. Include: project goal, tone preferences, and 2-3 rules.

Speed Drills: Building Muscle Memory

Practice makes perfect. These timed challenges help you build speed and confidence with the core workflow.

CHALLENGE 1: The 2-Minute Button

Create an HTML file with a styled button. Can you do it in under 2 minutes?

00:00
1. In VS Code: File โ†’ Open Folder โ†’ select your Claude_Practice folder on Desktop~10 sec
2. Click the orange Claude icon (top-right corner) โ†’ Press Ctrl+Alt+I โ†’ Type: "create button.html with a green Submit button"~5 sec
3. Read the green + lines in the code preview (middle of screen) โ€” check if it looks reasonable~30 sec
4. Look for numbered options below the code โ†’ Click "1 Yes" (or type 1 and press Enter)~2 sec
5. Right-click button.html in the left file list โ†’ select "Open with Live Server" (or double-click to open in browser)~15 sec
6. Look at the browser โ€” see a green button? Click it. Does it do something? โœ“ Success!~10 sec

Target: Under 2 minutes | Your time: --:--

Milestone Badges: Track Your Progress

Celebrate your achievements! Click on each badge as you complete the milestone. Hover to see details.

0 of 6 badges earned
Created your first interactive button
๐Ÿ…
First Button
Built a working compound interest calculator
๐Ÿงฎ
First Calculator
Successfully refined a project through iteration
๐Ÿ”„
First Iteration
Debugged and fixed your first error
๐Ÿ”ง
First Error Fixed
Created a tool you actually used with a client
๐Ÿ’ผ
First Client Tool
Completed a speed drill under target time
โšก
Speed Demon
๐ŸŽ‰

Achievement Unlocked!

You earned a badge!

๐ŸŽฏPART 7: Homework Practice Exercises

You've learned the workflow. Now it's time to practice on your own! Each exercise below gives you the destination (what to build) and waypoints (key milestones to hit). Your job: Fill in the steps to get there.

๐Ÿ“ How These Exercises Work

Think of this like getting directions: "Drive from New York to Boston. You'll pass through Hartford." We tell you the start, the end, and a few landmarks. You figure out the exact route.

This is how you learn to think independently with Claude, not just follow recipes!

๐Ÿ“Š EXERCISE 1: Portfolio Rebalancing Tool

๐ŸŽฏ The Destination

Create a portfolio rebalancing calculator. Include current allocations for stocks/bonds/cash, target allocations, and show how much to buy/sell of each to rebalance.

๐Ÿ“ Waypoints (Key Milestones)

Hit these checkpoints in order. Fill in YOUR steps to get from one to the next:

1

Create a new HTML file called rebalancer.html

Your steps: _________________

2

Ask Claude to add 6 input fields: Current Stocks/Bonds/Cash % and Target Stocks/Bonds/Cash %

Your steps: _________________

3

Add a "Calculate" button that shows how much to buy/sell to rebalance

Your steps: _________________

4

Test with example: 60/30/10 current โ†’ 50/40/10 target

Your steps: _________________

5

Improve styling: professional colors, clear layout, larger buttons

Your steps: _________________

โœ“

Show it to a colleague and get feedback!

๐Ÿ’ช Challenge upgrade: Add a field for "Portfolio Value" and show dollar amounts to buy/sell, not just percentages!

๐Ÿ’ฐ EXERCISE 2: Loan Comparison Tool

๐ŸŽฏ The Destination

Build a tool that compares two loan offers side-by-side. Show monthly payment, total interest paid, and which one is better.

๐Ÿ“ Waypoints (Key Milestones)

1

Create loan-compare.html with a side-by-side layout (two columns)

Your steps: _________________

2

Each side needs: Loan Amount, Interest Rate %, Loan Term (years)

Your steps: _________________

3

Add "Compare" button that calculates monthly payment and total interest for both

Your steps: _________________

4

Highlight the better deal in green, the worse one in yellow

Your steps: _________________

5

Test with two loans: $200k @ 6% for 30y vs $200k @ 5.5% for 20y

Your steps: _________________

โœ“

Save it and use it with real clients!

๐Ÿ’ช Challenge upgrade: Add a third loan option and show all three side-by-side!

๐ŸŽ‚ EXERCISE 3: Retirement Age Calculator

๐ŸŽฏ The Destination

Create a calculator that tells clients when they can retire based on their current savings, monthly contributions, and target retirement amount.

๐Ÿ“ Waypoints (Key Milestones)

1

Create retirement.html with input fields for Current Age, Current Savings, Monthly Contribution, Target Amount, Expected Return %

Your steps: _________________

2

Add "Calculate Retirement Age" button

Your steps: _________________

3

Show result like: "You can retire at age 67" and "That's in 22 years (Year 2047)"

Your steps: _________________

4

Test with example: Age 35, $50k saved, $1k/month, $2M target, 7% return

Your steps: _________________

5

Add a visual progress bar showing "% toward goal"

Your steps: _________________

โœ“

Try different scenarios to see how contributions affect retirement age!

๐Ÿ’ช Challenge upgrade: Add a chart showing how savings grow over time!

๐Ÿ“‰ EXERCISE 4: Tax Bracket Optimizer

๐ŸŽฏ The Destination

Build a tool that shows clients which tax bracket they're in and how much they'd save by contributing to a 401k or IRA.

๐Ÿ“ Waypoints (Key Milestones)

1

Create tax-optimizer.html with input for Annual Income and Filing Status (Single/Married)

Your steps: _________________

2

Show current tax bracket (e.g., "You're in the 24% bracket")

Your steps: _________________

3

Add slider for 401k contribution amount ($0-$23,000)

Your steps: _________________

4

Show "Tax Savings" in big numbers (e.g., "Save $3,840 in taxes this year!")

Your steps: _________________

5

Test with $100k income, Single, $10k contribution

Your steps: _________________

โœ“

Show clients real dollar savings to motivate retirement contributions!

๐Ÿ’ช Challenge upgrade: Add a comparison showing take-home pay with vs without the contribution!

๐Ÿ  EXERCISE 5: Rent vs Buy Analyzer

๐ŸŽฏ The Destination

Help clients decide if they should rent or buy by comparing total 5-year costs including opportunity cost of down payment.

๐Ÿ“ Waypoints (Key Milestones)

1

Create rent-vs-buy.html with two sections: Rent Scenario and Buy Scenario

Your steps: _________________

2

Rent section: Monthly Rent, Annual Rent Increase %. Buy section: Home Price, Down Payment %, Interest Rate %, Property Tax, Maintenance

Your steps: _________________

3

Calculate total 5-year cost for both scenarios

Your steps: _________________

4

Show recommendation: "Rent saves you $XX,XXX over 5 years" or "Buying is $XX,XXX cheaper"

Your steps: _________________

5

Test with $2,500/month rent vs $500k home with 20% down

Your steps: _________________

โœ“

Use it to help clients make the biggest financial decision of their lives!

๐Ÿ’ช Challenge upgrade: Add opportunity cost calculation (what if down payment was invested instead?)

๐Ÿ’ก How to Approach These Exercises

๐Ÿ“

Write Down Your Steps FIRST

Before you open VS Code, write down (on paper or in notes) what you think each waypoint will require. "To create rebalancer.html, I'll need to... 1) Open VS Code, 2) Ask Claude..." This makes you THINK, not just follow recipes.

๐Ÿงช

Experiment Without Fear

If you get stuck, try a different prompt. If something breaks, ask Claude "what went wrong?" These are practice tools, not client work. Break things and learn!

๐ŸŽฏ

Start with Exercise 1, Don't Skip Around

These are ordered by difficulty. Master the portfolio rebalancer before attempting the rent vs buy analyzer. Each one builds skills for the next.

โฑ๏ธ

Set a Timer for 45 Minutes

If you're not done in 45 minutes, take a break. Come back fresh. Your brain processes better with rest. This isn't a race.

Project Ideas Gallery

Want more inspiration? Browse these additional project ideas and try building your own variations!

Creativity Exercises to Expand Your Thinking

EXERCISE 1: The "What If" Game

Take the calculator you built and ask "What if...?" This is how simple tools evolve into powerful applications.

  • What if... clients could save their calculations? โ†’ claude "add a 'Save as PDF' button"
  • What if... I wanted to compare scenarios? โ†’ claude "Create a comparison view with two calculators side-by-side"
  • What if... clients could share the results? โ†’ claude "add a 'Share' button that generates a unique link with the inputs"

๐Ÿ›ก๏ธPART 8: Comfort & Confidence Building

Technical skill is only half the battle. The other half is overcoming the psychological hurdles of working with a new tool. Let's address the common fears head-on.

Overcoming Common Fears

Building Confidence Rituals

DAILY RITUAL (5 minutes)

Before starting your work, open the terminal, `cd` into a project folder, and ask Claude one simple question like "what's one way to improve this file?" You don't have to implement the change. The goal is to make the terminal a familiar, non-intimidating space.

WEEKLY CHALLENGE (30 minutes)

Every Friday, spend 30 minutes building a small, non-work tool just for you. A personal budget tracker, a recipe cost calculator, a workout logger. No pressure, no stakes. Just the fun of creation. This builds fluency.

๐Ÿ”‘3 Key Tips

TIP 1: Test in Browser After EVERY Approval

This is the golden rule. Build this habit loop:

1

Approve the change (click "Approve" or type y)

โ†“
2

Switch to browser (Alt+Tab on Windows, Cmd+Tab on Mac)

โ†“
3

Refresh the page (Ctrl+R on Windows, Cmd+R on Mac)

โ†“
โœ“

Test it! Does it work as expected?

Why this matters: This catches problems when they are small and easy to fix, saving you hours of future debugging.

TIP 2: Keep a "Wins" Log

Create a simple file named `wins.md` in your main work folder. Each time you build something, log it. Reviewing this log provides a powerful psychological boost and tracks your progress when you feel stuck.

๐Ÿ“ Your Wins Tracker

Date What I Built Time What I Learned
Oct 5 Blue button 5min Reading diffs is easy
Oct 5 Calculator 20min Iteration is cheap
Oct 6 Contact form 15min Validation matters
Add your own wins here...

Pro tip: Create a file called wins.md in your projects folder and copy this table format. Update it weekly!

TIP 3: The "Good Enough" Principle

Perfection is the enemy of done. For most tools, getting to 85% "good" is the sweet spot. The final 15% of polish can take as much time as the first 85%. Get it working, get it usable, and then move on. You can always iterate later.

๐ŸงฉKnowledge Check (2/2)

One final check to solidify your learning from this module.

๐Ÿค”Reflection Questions

  1. Trust the diff: What specific signals made you comfortable approving a change today? What would make you reject?
  2. Approval discipline: How does the explicit Approve โ†’ Apply step change your sense of control versus direct write?
  3. Error containment: If the approved change misbehaved, what's your first rollback step? How would you isolate that change quickly?
  4. Review habit: Which parts of the diff do you scan first (added lines, removed lines, sensitive files)? How will you make this a repeatable habit?

โ“Common Questions

๐Ÿ“šGlossary

๐ŸŽ“What You Learned

The Core Cycle

You have internalized the core development loop: REQUEST โ†’ RESPONSE โ†’ DIFF โ†’ APPROVE โ†’ VERIFY โ†’ ITERATE. This is the fundamental pattern for building software with an AI partner.

Technical & Communication Skills

You can now confidently read diffs (green for added, red for removed), make approval decisions, test results in a browser, and use the CLEAR framework to write effective, unambiguous requests. You've learned that iteration through conversation is more powerful than trying to craft one perfect command.

Practical Results

You've moved beyond theory and built two functional pieces of software from scratch: an interactive button and a genuinely useful compound interest calculator. You know how to take a project from a blank folder to a working tool.

Mindset Shifts

Perhaps most importantly, you've shifted your mindset from "I need to know code to build things" to "I need to clearly describe what I want." You've learned that mistakes are cheap, iteration is fast, and you can't permanently break things in a practice folder. You have built a foundation of confidence.

๐ŸŽ“You've Mastered the Basics โ€” Now Scale It

โœ… Where You Are Now

You can build tools. You can iterate. You can approve changes with confidence. You've created a working compound interest calculator and practiced with 5 real financial tools.

โš ๏ธ But There's a Problem

You have to repeat your preferences every single time. "Use navy blue. Keep it professional. Don't change the formulas." This gets tedious fast when you're building real client tools.

๐Ÿš€ Where You're Going Next

Module 4: Teaching Claude About Your Project โ€” You'll learn how to create a project briefing file (CLAUDE.md) that teaches Claude your style, rules, and tone ONCE. From then on, every conversation starts with Claude already knowing your preferences. No more repeating yourself!

โ†’ Continue to Module 4: Teaching Claude About Your Project