Mascot Logo
ai-agents-tutorial

Part 1 · Lesson 2 of 16

Learn the Terminal Before You Run Claude Code

Open Terminal/PowerShell. Five commands you'll actually use.

10 min

Step 1 of 5 · Launch your terminal

Before you can use Claude Code, you need a way to talk to your computer via text. This tool is called the terminal (or command line).

  • On macOS: Press Cmd + Space, type Terminal, and press Enter.
  • On Windows: Press the Windows Key, type PowerShell, and press Enter.
  • On Linux: Press Ctrl + Alt + T.

You should see a window with a blinking cursor. This is your command prompt.

Step 2 of 5 · Where am I? (pwd)

The terminal always works inside a specific folder on your computer, called the current working directory.

To find out where you are, type this command and press Enter:

pwd

This stands for Print Working Directory. It will print the full path of your current folder (e.g., /Users/username or C:\Users\username).

Step 3 of 5 · What's in here? (ls)

To see the list of files and folders inside your current folder, type:

ls

(Note: If you are on Windows PowerShell, you can use ls or dir interchangeably).

This prints all visible items in the current folder.

Step 4 of 5 · Moving and creating (cd & mkdir)

To move into another folder, use cd (Change Directory) followed by the folder name:

cd Desktop

Now, let's create a new folder specifically for our workshop experiments using mkdir (Make Directory):

mkdir agent-playground

Then, move into that new folder:

cd agent-playground

Step 5 of 5 · Checkpoint & Recap

Recap

  • Terminal: A text interface for controlling your computer.
  • pwd: Shows your current folder path.
  • ls / dir: Lists files and folders in your current location.
  • cd: Changes your active folder (cd .. moves up).
  • mkdir: Creates a brand new folder.