MODULE 2: Setup & Installation

Getting Claude Code Running on Your Computer

🧠Understanding Claude Code: Three Ways to Talk to Claude

Before we install anything, let's understand what Claude Code actually IS.

You've probably used apps in three different ways. Let's map Claude to those experiences to build a clear mental model.

Click each panel to explore the analogy and see how it relates to Claude.

📱 Phone App

Tap & Swipe Interface

💻 Desktop App

Click & Type Interface

🔌 API Tool

Connect & Automate

Way 1: The Phone App (What You Already Know)

You interact through buttons and screens, and the result appears instantly. The Claude equivalent is the claude.ai website: a visual, chat-based interface where your browser sends a message and gets a response. It's great for conversations and summarizing pasted text.

claude.ai Claude: Compound interest is when you earn interest on both your initial investment and the interest it has already earned. It's like a snowball effect for your money, growing faster over time.

Way 2: The Desktop App (Also Familiar)

This is software installed ON your computer that works with files ON your computer (like Microsoft Excel). While there's no direct Claude equivalent, this is the feeling of Claude Code. You type commands, and it makes changes to your local files.

Excel - Spreadsheet A B 100 200 300 600 You type a formula... ...and Excel calculates instantly on YOUR computer

Way 3: The API Tool (The New Concept)

This is when one tool sends a request to an external service for data. A weather widget on your blog is a perfect example. This is what Claude Code is! Your terminal sends a request to Claude's AI brain on Anthropic's servers, gets a response (the code), and then uses that response to change your local files.

Terminal (Your Computer) + button.html + <button>Click Me</button> Approve ✓ REQUEST RESPONSE Anthropic Servers (Claude's AI Brain) 🧠 Processing your request... "Add a button" Generated Code: <button style="padding:10px"> Click Me </button> Ready to send back →

🎯 Map Your Understanding

Drag each item to the category that best describes its interaction style.

📱

Phone App Style

Tap & Swipe

💻

Desktop App Style

Click & Type

🔌

API Tool Style

Connect & Automate

🌐 claude.ai website
⚡ Claude Code in VS Code
📊 Microsoft Excel

🧩Knowledge Check

1 of 10

Q1: Claude Code is best described as what?

💲Usage & Licensing Overview

How access works

Perfect for small teams: Claude Code runs locally on your computer and connects securely to the Claude API. Whether you're a solo consultant or a 5-person team with a $20/month budget, you get the same powerful capabilities as enterprise teams.

💰 Budget-Friendly for Small Teams

No enterprise licensing required. You pay only for what you use through token-based pricing. A typical small team might spend $10-30/month on actual AI usage, making it accessible even for bootstrapped consultancies.

No hidden costs: Editing sessions inside your IDE are not billed per token directly. You only pay for the AI processing when you actually use it. Organizations can provision access through individual seats or workspace licenses, but even individual consultants can get started immediately with a personal Anthropic account.

🚀 Same Power, Any Team Size

Whether you're a solo financial consultant or part of a 50-person firm, you get access to the same Claude AI capabilities. The difference is only in how you manage access and billing, not in the features available to you.

Seats & Workspaces

  • Individual or team seats managed via Anthropic console
  • Organization policies for data handling and retention
  • Centralized billing and usage visibility

Practical guidance

  • Start with small, focused edits and review diffs
  • Use CLAUDE.md to minimize repeated instructions
  • Check admin console for usage reports when needed

⌨️Command Cheat Sheet

Editing commands

Today you can ask Claude to edit files with free‑form requests or explicit verbs. Both styles are supported and may converge over time:

  • claude "edit this file: add a button to index.html"
  • claude edit index.html "add a button"
Command What It Does Example

Before → After (Preview)


// Before
<h1>Hello</h1>

// After
<h1>Hello</h1>
+ <button id="cta">Click Me</button>

Bad vs Good Prompt

  • Bad: "fix it"
    Too vague. No file, no intent.
  • Good: "In index.html, add a blue 'Contact Us' button below the title; inline styles OK."
    File, change, placement, constraints.

Prompt‑review checklist

  • Accuracy: Does the diff match your intent?
  • Clarity: Is the request specific (file, location, behavior)?
  • Scope: Is the change minimal and reviewable?
  • Safety: Any secrets, credentials, or risky edits?
  • Readability: Names, comments, and formatting solid?

⚙️Setup & Installation — Quick Start

🎯 Get Claude Code Running — Step by Step (First Time? No Problem!)

⏱️ Time needed: 10-15 minutes | 📚 Experience required: None — we'll guide you through every click!

Step 1: Find and Open Your Terminal

What is a Terminal? Think of it as a text-based way to talk to your computer. Instead of clicking icons, you type commands. Don't worry — we'll tell you exactly what to type!

🍎 On Mac:

  1. Click the magnifying glass icon (top-right corner)
  2. Type: Terminal
  3. Press Enter
  4. A black or white window opens — that's your Terminal!

🪟 On Windows:

  1. Click the Start menu (Windows icon, bottom-left)
  2. Type: PowerShell
  3. Click Windows PowerShell (blue icon)
  4. A blue window opens — that's your PowerShell!

✅ You'll know it worked when: You see a window with text and a blinking cursor waiting for you to type.

Step 2: Check If You Have Node.js (Required Foundation)

What is Node.js? It's free software that helps run modern programs like Claude Code. Think of it as the engine that makes Claude Code work. You need this first.

📝 Copy this command to check if you already have it:

node --version

Paste it in your Terminal/PowerShell and press Enter.

✅ If you see something like:

v18.17.0, or a similar number

Great! You have Node.js. Skip to Step 3 below.

⚠️ If you see:

command not found

You need to install Node.js first. Follow the instructions below.

📦 Installing Node.js (One-Time Setup)

  1. Visit nodejs.org in your web browser
  2. You'll see a large green button that says "Get Node.js®" — click it
  3. The installer file will download automatically to your Downloads folder (takes 30-60 seconds)
  4. Find the downloaded file in your Downloads folder (it's called something like "node-v22-x64.msi" on Windows or "node-v22.pkg" on Mac)
  5. Double-click the installer file to open it
  6. Follow the installation wizard — keep clicking "Next" until you see "Install", then click it
  7. If Windows asks "Do you want to allow this app to make changes?" click "Yes"
  8. Wait 2-3 minutes for installation to complete — you'll see a progress bar
  9. When you see "Completed" or "Installation successful", click "Finish"
  10. Close and reopen your Terminal/PowerShell completely (this is important so your computer recognizes Node.js):
    • Close the window (click the X)
    • 🍎 On Mac: Click the magnifying glass icon → Type Terminal → Press Enter
    • 🪟 On Windows: Click the Start menu → Type PowerShell → Click Windows PowerShell
  11. Run node --version again to confirm it worked — you should now see something like v22.20.0

💡 Which version? The green button automatically gives you the recommended "LTS" (Long Term Support) version, which is perfect for your needs. Don't worry about version numbers — any recent version works fine with Claude Code.

Step 3: Install Claude Code

What you're doing: Now that Node.js is installed, you can download and install Claude Code, just like installing Microsoft Word or Excel.

📝 Copy this command exactly as written:

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

Now do this:

  1. Right-click inside the Terminal/PowerShell window
  2. Choose "Paste" (or press Ctrl+V on Windows, Cmd+V on Mac)
  3. Press Enter
  4. Wait 1-3 minutes — you'll see text scrolling. This is normal! The computer is downloading files.

📖 What You'll See (and What It Means)

The Terminal will show several messages. Here's what they mean:

changed 2 packages in 18s

✅ This is success! The installation worked. You might see "added 2 packages" or "changed 2 packages" — both mean the same thing. The numbers and time might be slightly different — that's completely fine.

1 package is looking for funding
  run `npm fund` for details

✅ Ignore this completely. It's just a message from the open-source community asking for donations. You don't need to do anything. Claude Code is already installed and ready to use.

found 0 vulnerabilities

✅ Nice! If you see this message, it confirms the software is safe and secure. But don't worry if you don't see it — it doesn't always appear, and that's normal.

💡 The key message: As long as you see "changed 2 packages" (or "added 2 packages") and your cursor is blinking again with no red "ERROR" text, you're done! Everything else is just informational noise you can ignore.

🎓 Learn the Lingo (Optional — But You'll Sound Like a Pro!)

Now that you've successfully installed Claude Code, let's decode what those messages actually meant. Understanding this will make you more confident next time you work with similar tools.

📦 What is a "package"?

Think of a package as a pre-built software component — like a Lego brick. Instead of building everything from scratch, developers download and use packages that others have already created and tested.

Real-world analogy: It's like buying a pre-assembled cabinet from IKEA instead of cutting wood and building from scratch. Claude Code is a package, and it might depend on other smaller packages to work.

🔧 What is "npm"?

npm stands for "Node Package Manager." It's like the App Store for developers. When you typed npm install, you told npm: "Go to the store, find Claude Code, and install it on my computer."

Real-world analogy: npm is like Amazon for software. You tell it what you want, and it downloads and sets it up for you. The difference? Almost everything on npm is free and open-source!

💰 What is "npm fund"?

Most packages on npm are created by volunteers in their free time and shared for free. "npm fund" is like a tip jar — it shows you which packages accept donations to support the developers who maintain them.

Real-world analogy: It's like a busker (street musician) playing beautiful music for free, with a hat on the ground where you can drop a coin if you want. You're not required to donate — the music (software) is free either way.

🔒 What are "vulnerabilities"?

A vulnerability is a security weakness in software that hackers could potentially exploit. When npm says "found 0 vulnerabilities," it means it scanned the packages and didn't find any known security issues.

Real-world analogy: It's like a home security inspection. "0 vulnerabilities" means all the locks work and there are no broken windows. If it finds issues, it will tell you how to fix them.

⚡ What does "-g" mean in the command?

The -g flag stands for "global." It means "install this package so I can use it anywhere on my computer, not just in one folder." That's why you can type claude from any location in your Terminal.

Real-world analogy: It's like installing Microsoft Word on your computer (global) versus saving a document to your Desktop (local). Word is available everywhere; the document is only in that one spot.

💪 Why this matters: You just learned the language of modern software development! Next time you see npm, packages, or terminal commands, you'll understand what's happening under the hood. You're not just following instructions — you're becoming tech-literate.

✅ Success looks like: You see messages like "added 2 packages" and your cursor is blinking again, waiting for your next command. No red "ERROR" text.

Step 4: Close and Reopen Your Terminal (Important!)

Why? Your computer needs to "refresh" to recognize the new program you just installed. Think of it like restarting after a software update.

How to do it:

  1. Close the Terminal/PowerShell window completely (click the X button)
  2. Open it again:
    • 🍎 On Mac: Click the magnifying glass icon (top-right) → Type Terminal → Press Enter
    • 🪟 On Windows: Click the Start menu → Type PowerShell → Click Windows PowerShell
  3. You should see a fresh window with a blinking cursor — ready for the next step!

Step 5: Log In to Claude

What you're doing: Connecting your computer to your Claude account, like logging into Gmail or Netflix.

📝 Copy this command:

claude auth login

Then:

  1. Paste it into the Terminal/PowerShell (right-click → Paste)
  2. Press Enter

⚠️ Screen 1: Security Confirmation (Don't Panic!)

You'll see an orange/yellow box with text that says:

Do you trust the files in this folder?

C:\Users\[YourName]

Claude Code may read, write, or execute files contained in this directory.
This can pose security risks, so only use files from trusted sources.

Learn more ( https://docs.claude.com/s/claude-code-security )

> 1. Yes, proceed
  2. No, exit

Enter to confirm · Esc to exit

What this means: Claude Code is asking "Can I work with files in your home folder?" This is a normal security check. Since you just installed it yourself, it's safe to proceed.

✅ What to do: The cursor is already on "1. Yes, proceed" (that's the blue text). Simply press Enter on your keyboard.

🌐 Screen 2: Browser Login (First-Time Users Only)

If this is your FIRST TIME logging in: Your web browser will automatically open and show the Anthropic login page.

What to do:

  1. If you already have an Anthropic/Claude account:
    • Enter your email and password
    • Click "Sign In"
  2. If you DON'T have an account yet:
    • Click "Create Account" or "Sign Up"
    • Enter your email address
    • Create a password
    • Follow the prompts to complete registration
    • You may need to verify your email (check your inbox)
  3. After successful login, the browser will show: "Authentication successful! You can close this tab."
  4. Close the browser tab and go back to your Terminal/PowerShell

💡 Already have an account? If you already used Claude on the website (claude.ai), you can use the same email and password here. It's the same account!

🔒 Is this safe? Yes! The Terminal opens your actual web browser (Chrome, Edge, Safari, etc.) and takes you to Anthropic's official website. Your password goes directly to Anthropic, not through the Terminal. It's as safe as logging into any website.

Note: If you've already logged in before on this computer, you might skip this step entirely and go straight to the welcome screen below.

🎉 Screen 3: Welcome to Claude Code! (You're In!)

After the browser login (or if you were already logged in), you'll see a welcome screen in the Terminal with an orange border that shows:

━━━ Claude Code v2.0.9 ━━━
Welcome back [YourName]!
🤖 [ASCII art of a robot]
Sonnet 4.5 • Claude Max
C:\Users\[YourName]
Tips for getting started
Run /init to create a CLAUDE.md file with instructions for Claude
Note: You have launched claude in your home directory...
Recent activity
No recent activity

What this means: You're logged in and Claude Code is ready! This is like the "home screen" of Claude Code.

✅ You'll also see a prompt at the bottom:

> █

This blinking cursor means Claude is listening and ready for your instructions! You can now type messages to Claude, just like chatting.

⚠️ You Might See: "I need more context..." Message

If Claude shows a message asking about "authentication":

> auth

I need more context to help you. Could you clarify what you'd like to 
do with authentication? For example:
  - Implement authentication in a project?
  - Debug an auth issue?
  - Review authentication code?
  - Set up OAuth, JWT, or another auth method?
  - Something else?

Don't panic! This is NOT an error. What happened:

  • When you typed claude auth login earlier, you were talking to your computer's Terminal
  • Now you're inside Claude Code, so you're talking to Claude AI
  • If you accidentally type just auth by itself, Claude thinks you want help with authentication coding (like building login systems for websites)

✅ What to do: Just ignore this message and move on to testing with a real instruction below. You're already logged in and ready to go!

🎓 Teaching moment: "auth" is short for "authentication" — the technical term for login systems. Programmers use this term when they're building the "Sign In" features you see on websites. Since you're not a programmer (yet!), you won't need this — just type your plain-language requests to Claude instead.

💬 Try Your First Real Command

Now let's test that everything is working! You can type anything you want, but here are some examples:

Example 1: Simple test

tell me a joke about spreadsheets

Example 2: Ask about files

what folder am I in right now?

Example 3: Get help

what can you help me with?

Type any of these (or your own message), press Enter, and Claude will respond! This confirms your installation is complete and working perfectly.

💡 Pro tip: You can chat with Claude in plain English, just like you're texting a colleague. No coding knowledge required for basic questions and tasks!

✅ How to exit Claude Code when you're done: Type exit and press Enter, or simply close the Terminal window.

🔒 Is this safe? Yes! The security prompt is Anthropic's way of making sure you understand Claude Code can work with files in that folder. Since you installed it yourself and it's working in your home directory, it's completely safe to say "Yes, proceed."

Step 6: Verify It's Working

Let's make sure everything is set up correctly!

📝 Copy this command:

claude --version

What you should see:

claude-code version 1.2.3

(The numbers might be different — that's fine! As long as you see "claude-code version" and some numbers, you're good!)

🎉 Congratulations! You're Ready!

If you saw the version number, Claude Code is successfully installed and you're authenticated. You can now use Claude to help with your work!

❌ Didn't work?

If you see "command not found" or similar, go back to Step 3 and make sure you closed and reopened your Terminal. Still stuck? Check the FAQ section below for common troubleshooting tips.

💪 You Just Did Something Amazing!

You opened the Terminal (maybe for the first time!), ran commands, and installed professional AI software. That's not "tech stuff" — that's real capability. You're now equipped to use AI tools that most consultants only dream about.

🎯Installation Checkpoint — Test Your Understanding

You just completed the installation! Before moving forward, let's make sure you understood the key concepts. This will help you feel confident using Claude Code.

1 of 6

💡3 Key Tips for This Stage

Don't Confuse claude.ai with Claude Code

The website (claude.ai) is for chatting. The terminal tool (Claude Code) is for working with your files. They are separate and use different interfaces.

Local tool, secure cloud intelligence

Claude Code runs locally and connects securely to the Claude API for intelligence. Your files remain on your machine; you review all diffs and approve before anything is written.

Keep Your API Key Like a Password

Store your API key in a password manager. Do not share it, and never save it in a public place like a GitHub repository.

🧠Reflection Questions

  1. Which mental model clicked for you? The Phone App, Desktop App, or API Tool style?
  2. What concerns do you have about the API approach? Are you worried about what gets sent over the internet?
  3. How does the "request → response" pattern of an API feel similar to or different from tools you already use?

Common Questions

📚Glossary

🪜What You Learned & What's Next

Where you are now:

You understand the mental model of how Claude Code works as an API tool and you have a step-by-step plan for installation.

Where you're going next:

In Module 3, you'll use your newly installed Claude Code to make your first real change to a file and learn the critical "review and approve" workflow.

💡 For VS Code Beginners

If you just installed VS Code and aren't familiar with it yet, here's what you need to know:

  • VS Code is a free code editor (like a fancy version of Notepad)
  • Claude Code side panel is a special area in VS Code where you can chat with Claude
  • To open it: Look for the Claude icon (👤) in the left sidebar of VS Code
  • If you don't see it, go to View → Extensions and search for "Claude" to install the extension
  • Once open, you'll see a chat box where you can type your requests in plain English

Don't worry if this sounds confusing now — Module 3 will walk you through every step!

Continue to Module 3: Your First Real Change