zerotoclaude

The black window with text. It looks scary; it's actually the most honest way to talk to a computer.

The terminal is the most important tool you don't use yet. It's the black window full of text that you've seen in movies whenever someone is "hacking." In real life it's less dramatic but a hundred times more useful. It's how Claude Code lives.

What it actually is

Your operating system has a graphical interface — the desktop, the icons, the menus, the windows you click. That graphical interface is a layer over something more direct. Underneath, the computer accepts commands written as text. The terminal is the window where you type those text commands.

Every time you double-click a folder to open it, somewhere underneath the computer is running a command that means "list the contents of this folder." The terminal just lets you skip the icon and type the command yourself.

Note

You'll hear a few names for the same thing: terminal, command line, shell, console. They're overlapping but for our purposes they all mean the same thing: the text interface where you type commands.

What it looks like

Open a terminal on any computer and you'll see something like this:

terminal

harvey@laptop:~$

That blinking line is called a prompt. It's the computer waiting for you to type something. The bits before the $are usually your username and the folder you're currently in.

Type a command, press Enter, and the computer runs it and shows you the result right there.

A few real commands

Here are the four commands worth knowing on day one. You don't have to memorise them — just see them once so you recognise them later.

terminal

harvey@laptop:~$ pwd
/Users/harvey

harvey@laptop:~$ ls
Desktop  Documents  Downloads  Pictures  Projects

harvey@laptop:~$ cd Projects

harvey@laptop:~/Projects$ ls
my-website  zerotoclaude

pwd— "print working directory." Where am I right now?
ls— "list." What's in this folder?
cd— "change directory." Move into another folder.
cd .. — go up one folder (the ..means "parent folder").

That's already enough to navigate around your whole computer without ever touching the mouse.

Why this matters

The terminal isn't just for navigating. Most of the powerful tools developers use only exist in the terminal — they don't have a graphical app at all. Git, the version control system. Most package managers. Servers you run locally. And, importantly: Claude Code.

Claude Code is a terminal application. You open a terminal, type claude, hit Enter, and you're in. From that point on the terminal becomes a conversation — you type, Claude answers, Claude takes actions, you see the results inline.

The terminal is a conversation, not a wall of text

New users panic at the lack of buttons. There's nothing to click, no toolbar, no help menu. But once you stop expecting it to look like a regular app, the terminal is just a back-and-forth: you type something, the computer responds, you type something back. That's all.

How to open a terminal

Mac: Press Cmd + Space, type "Terminal," press Enter. Or install iTerm2 or Warp later for a nicer experience.
Windows:Search for "Terminal" in the Start menu (Windows 11 has a great one built in). On Windows 10, search for "PowerShell." You may also hear about WSL (Windows Subsystem for Linux), which gives you a Linux-style terminal on Windows — useful for some workflows.
Linux:You almost certainly already know how. Look for "Terminal" in your applications menu.

You will not break it

New users worry that one wrong command will destroy their computer. Almost nothing you can type by accident will cause real damage. The scary destructive commands require multiple confirmations, a password, or both. As long as you don't paste random commands from sketchy sources, you're fine to experiment.

The one rule

Never paste a command into your terminal that you don't understand or trust. The terminal will run almost anything. Treat commands like prescription medication — fine when prescribed by someone responsible, dangerous when handed to you by a stranger on the internet.

What to take with you