How to Install Claude Code — A Step-by-Step Guide from Terminal to Your First Conversation

To start vibe coding, the first thing you need to do is install a tool. This post walks you through installing Claude Code for the first time, step by step, from basic terminal usage all the way to your first conversation. Every step is explained in as much detail as possible so you can follow along even without any development experience.

What is a terminal

A terminal is a tool that lets you perform tasks by typing text commands into your computer. Instead of clicking icons with a mouse, you type commands on the keyboard to install or run programs.

It might feel unfamiliar at first, but the commands you’ll use for vibe coding in the terminal are limited to just a handful, so you’ll get comfortable with them quickly.

How to open a terminal

OS	Method
macOS	Open Spotlight with `Command + Space` → type “Terminal” → press Enter
Windows	Press `Windows + R` → type `cmd` → press Enter (or search for PowerShell)

Once you open the terminal, you’ll see a screen like the one below. If the cursor is blinking, it’s ready for you to type a command.

username@computername ~ %

Prerequisite: Installing Node.js

Claude Code runs in a Node.js environment. First, check whether Node.js is already installed.

Type the command below into the terminal and press Enter.

node --version

If a version number like v20.0.0 appears, it’s already installed. If nothing appears or you get an error, you’ll need to install Node.js.

How to install Node.js

Go to nodejs.org and download the LTS version (Long Term Support, the stable version). Run the installer and complete it with the default settings.

After installing, open a new terminal window and run node --version again — if a version number shows up, everything is set up correctly.

Installing Claude Code

Once Node.js is ready, install Claude Code. Type the command below into the terminal.

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

The -g flag means it’s installed globally, so you can use it from anywhere on your computer. The installation takes about 1-2 minutes.

Once it’s done, verify it with the command below.

claude --version

If a version number is printed, it’s installed correctly.

Getting an API key

Claude Code uses Anthropic’s Claude API. To use the API, you need an API key.

Step 1: Go to the Anthropic Console

Visit console.anthropic.com and create an account. Verify your email, then log in.

Step 2: Create an API key

After logging in, select API Keys from the left-hand menu. Click the Create Key button and give your key a name (e.g., my-claude-code). The generated key is a long string that starts with sk-ant-.

Note: The API key is shown only once, right after you create it. Make sure to copy it and store it somewhere safe.

Step 3: Add credits

The API charges based on usage. Add credits from the Billing menu in the Console. If you’re just getting started, $5-10 is a good amount to begin with. For light vibe coding work, $5 will last quite a while.

Running Claude Code for the first time

In the terminal, navigate to the folder you want to work in, then run Claude Code.

claude

The first time you run it, you’ll be prompted to enter your API key. Paste the API key you copied earlier and press Enter.

Once setup is complete, you’ll see a screen like this.

Claude Code
✓ API key configured

>

If the cursor is blinking after the >, you’re ready to go.

Sending your first prompt

Let’s start your first conversation with Claude Code. Type the following after the > and press Enter.

Hi. Please create a simple HTML file. The title should be "Hello, Vibe Coding," and it should display large, centered text that says "My first page made with AI."

If a permission prompt appears when Claude Code tries to create the file, type y and press Enter.

A moment later, an index.html file will be created. Open this file in your browser, and you’ll see the page you just requested.

Frequently used Claude Code commands

Here are some basic commands that are useful to know while using Claude Code.

Command	Description
`claude`	Run Claude Code
`/help`	Show the list of available commands
`/clear`	Clear the conversation history
`/exit`	Quit Claude Code
`Ctrl + C`	Stop the current task

How to navigate between folders

To move to a specific project folder in the terminal, use the cd command.

cd folder-path

For example, if you created a folder called my-project on your desktop and want to work inside it, you’d type the following.

# macOS
cd ~/Desktop/my-project

# Windows
cd C:\Users\username\Desktop\my-project

To check which folder you’re currently in, use the command below.

# macOS / Linux
pwd

# Windows
cd

Summary

So far, we’ve opened the terminal, installed Node.js and Claude Code, gotten an API key, and sent our first prompt.

In the next post, we’ll cover how to write a CLAUDE.md file so that Claude Code properly understands your project. This one file can make a huge difference in the quality of the AI’s work.