🎵 Music: Off
30%
Terminal — bash
user@mac ~ %
🎉
QUEST COMPLETE!
-
+0 XP
Auto-continuing in 5s...

Create Your Companion

Choose a color for your guide. They'll grow stronger as you progress!

Ready to learn the terminal?

Follow the instructions. Type the commands. That's it.

🏆

YOU COMPLETED THE PORTAL!

120
Total XP
5/5
Quests
Scroll to continue ↓

You now know:

echo — talk to the computer
pwd — where am I?
ls — what's here?
cd — move around
mkdir — create folders
claude — launch your AI companion

Ready to do it for real?

🚀 One-Click Installer (4-5 minutes!)
We built a smart installer that does EVERYTHING automatically. Just paste ONE command and wait. It installs Homebrew, Node.js, Claude Code, and downloads the project - all in one go!
→ 3 Simple Steps:
1

Download the project

💾 Downloads the project to your Mac (takes ~10 seconds)

git clone https://github.com/bradydward/claude-code-101.git && cd claude-code-101
2

🚀 Run the one-click installer

/bin/bash install.sh
🚨 DON'T PANIC WHEN THIS HAPPENS:

The installer will ask: Password:

When you type, NOTHING APPEARS - no dots, no asterisks, no cursor movement. This is NORMAL!

You ARE typing! Mac hides passwords for security. Just type your Mac password (the one you use to log in) and press Enter.

⏱️ Takes 4-5 minutes. The script installs Homebrew, Node.js, Claude Code, and sets everything up automatically. Just wait! If you see "Install Command Line Tools?", click Install.

3

🎮 Get your API key & launch!

a) Get FREE API key:

  1. Visit console.anthropic.com
  2. Sign up (free - includes $5 credit)
  3. Go to "API Keys" → "Create Key" → copy it

b) Open a NEW Terminal window:

Press Cmd + N (new window loads updated PATH)

c) Navigate & launch:

cd ~/Developer/projects/"Claude Code 101"
claude

✅ When Claude opens, type: start lesson

Ready to do it for real?

🚀 One-Click Installer (4-5 minutes!)

We built a smart installer that does EVERYTHING automatically. Just paste ONE command and wait. It installs Homebrew, Node.js, Claude Code, and downloads the project - all in one go!

→ 3 Simple Steps:

1

Download the project:

git clone https://github.com/your-repo/claude-code-101.git && cd claude-code-101

💾 Downloads the project to your Mac (takes ~10 seconds)

2

🚀 Run the one-click installer:

/bin/bash install.sh

🚨 DON'T PANIC WHEN THIS HAPPENS:

The installer will ask: Password:

When you type, NOTHING APPEARS - no dots, no asterisks, no cursor movement. This is NORMAL!

You ARE typing! Mac hides passwords for security. Just type your Mac password (the one you use to log in) and press Enter.

⏱️ Takes 4-5 minutes. The script installs Homebrew, Node.js, Claude Code, and sets everything up automatically. Just wait! If you see "Install Command Line Tools?", click Install.

🔍 What does the installer do?
  • ✅ Checks if Xcode Command Line Tools are installed (installs if needed)
  • ✅ Installs Homebrew (Mac package manager)
  • ✅ Installs Node.js (JavaScript runtime)
  • ✅ Installs Claude Code CLI
  • ✅ Skips anything already installed (smart!)
3

🎮 Get your API key & launch!

a) Get FREE API key:

  1. Visit console.anthropic.com
  2. Sign up (free - includes $5 credit)
  3. Go to "API Keys" → "Create Key" → copy it

b) Open a NEW Terminal window:

Press Cmd + N (new window loads updated PATH)

c) Navigate & launch:

cd ~/Developer/projects/"Claude Code 101"
claude

✅ When Claude opens, type: start lesson

🔧 Alternative: Don't have git? Download ZIP instead

If git isn't installed on your Mac, download the ZIP file:

After downloading:
1. Unzip it to your Desktop
2. Open Terminal
3. Type: cd ~/Desktop/claude-code-101
4. Continue with Step 2 above (run install.sh)

🛠️ Troubleshooting

🚨 #1 ISSUE: "It won't let me type my password!"

You ARE typing - Mac just hides it! When Terminal asks for your password, it shows NOTHING when you type (no dots, no characters, cursor doesn't move). This freaks everyone out the first time. Type your password blind and press Enter. It works!

  • "Command Line Tools" popup appears: Click "Install" and wait 10-15 minutes. This is normal for fresh Macs. Don't close it!
  • Installation seems stuck: It's not stuck! Homebrew downloads ~100MB and compiles tools. Can take 10+ minutes on slow internet. Watch for progress messages.
  • Homebrew installation fails: Open Terminal and type: xcode-select --install then retry Step 1.
  • Wrong password error: Make sure you're typing your Mac login password, not your iCloud/Apple ID password. They're often different!
  • Still stuck? The project README has detailed troubleshooting for every possible issue!