The Complete Guide to Claude Code

By Robert Triebwasser Updated April 2026 ~20 min interactive module
Module Progress: 0 / 0

What is Claude Code?

Claude Code is Anthropic's tool that lets Claude — the AI — work directly on your computer. Instead of just chatting back and forth, Claude can actually read your files, write code, create documents, and run commands on your machine.

Think of it as hiring an AI assistant who can actually sit at your computer and do the work, not just talk about it.

This is the tool I use in my TikTok videos when you see me building apps, creating dashboards, and automating workflows.

Screenshot: Claude Code terminal welcome screen (coming soon)

Ways to Use Claude Code

Claude Code isn't just one thing. There are several ways to access it, depending on your comfort level:

  • Command-line tool (CLI) — the most powerful option, and what this guide covers. You type commands in a terminal.
  • Desktop app — available for Mac and Windows. A graphical interface that wraps the CLI in a more familiar window.
  • Web app — use Claude Code directly at claude.ai/code from your browser. No installation needed.
  • IDE extensions — plug-ins for VS Code and JetBrains IDEs that bring Claude Code into your code editor.
  • Claude Co-Work — the visual, no-terminal way to use Claude's agent capabilities. If the terminal feels intimidating, start here instead.

This guide focuses on the command-line installation — it's the most flexible, most powerful way to use Claude Code, and once you learn it, everything else makes more sense.

What You'll Need

  • A computer (Windows, Mac, or Linux)
  • An internet connection
  • An Anthropic account (free to create at anthropic.com)
  • About 10 minutes
Good news

You do NOT need any coding experience. If you can copy and paste a line of text, you can install Claude Code.

Install Node.js

Claude Code runs on Node.js — a free program that lets tools like Claude Code work on your computer. You only need to install it once.

What is Node.js, and why do I need it?

Node.js is a free, open-source runtime that lets JavaScript programs run on your computer (not just in a browser). Claude Code is built with JavaScript, so it needs Node.js to run. Think of it like how you need Adobe Reader to open PDFs — Node.js is the reader, Claude Code is the document. You install it once and forget about it.

Download Node.js

Go to nodejs.org in your browser. You'll see a big green button that says LTS (Long Term Support — the stable, recommended version). Click it to download the installer.

Run the installer

Open the downloaded file and click Next through each screen. The default settings are perfect — you don't need to change anything. Click Install when you reach the final screen.

Verify it worked

Open your terminal and type the following command:

node --version

You should see something like this:

Terminal
$ node --version v22.12.0

If you see a version number, Node.js is installed correctly.

Windows users

To open your terminal: click the Start menu and search for Command Prompt or PowerShell. Either one works.

Mac users

To open your terminal: press Cmd + Space, type Terminal, and hit Enter.

Install Claude Code

Run the install command

In the same terminal window, type this command and hit Enter:

npm install -g @anthropic-ai/claude-code
What does this command mean?

npm is a tool that came with Node.js — it downloads and installs software packages. install -g means "install globally" (available everywhere on your computer, not just one folder). @anthropic-ai/claude-code is the specific package name for Claude Code.

Wait for it to finish

You'll see some text scrolling by as it downloads. This usually takes 30–60 seconds. Wait until you see your cursor blinking again on a new line.

Verify the installation

claude --version
Terminal
$ claude --version claude-code v1.0.x

If you see a version number, you're ready to go.

Permission error on Mac?

If you get an error that mentions "permission denied" or "EACCES", try running the install command with sudo in front:

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

It will ask for your Mac password. Type it in (you won't see characters appear — that's normal) and hit Enter.

What does sudo mean?

sudo stands for "super user do." It temporarily gives the command admin-level permissions on your Mac. Some installations need this because they write files to system folders that are normally protected. It's safe and standard.

Knowledge Check

Which command installs Claude Code on your computer?

Launch Claude Code

Navigate to a folder

Claude Code works best when you point it at a folder on your computer. Use the cd command to go to the folder you want to work in:

cd Documents

Start Claude Code

claude

That's it — just the word "claude".

Log in (first time only)

The first time you run Claude Code, it will open a browser window asking you to log in with your Anthropic account. Log in (or create an account if you don't have one), and it will connect automatically.

You're ready

Once authenticated, you'll see a prompt where you can start typing requests to Claude.

claude
Claude Code v1.0.x Working directory: ~/Documents > What would you like to work on?

Your First Session

Let's do something practical. At the Claude Code prompt, type:

Create a file called notes.txt with a summary of what Claude Code can do

Hit Enter and watch what happens. Claude will:

  1. Read your request
  2. Create a new file called notes.txt in your current folder
  3. Write useful content into it
  4. Show you exactly what it did

You can open the file on your computer to see what Claude wrote. That's the power of Claude Code — it doesn't just tell you what to do, it actually does it.

Knowledge Check

What single command launches Claude Code in your terminal?

What Can You Actually Do With It?

Claude Code isn't just for programmers. Here are real tasks you can try right now:

Try it yourself

Research a topic and save the results:

Research the top 5 project management tools for small teams. Create a comparison table in a file called pm-tools.md with pricing, key features, and which type of team each is best for.
Try it yourself

Organize and rename files:

Look at the files in this folder. Suggest a better organization structure and explain what you'd rename or move.
Try it yourself

Draft a professional email:

Write a professional email to a client explaining a 2-week project delay. Be honest but maintain confidence. Save it to delay-email.txt.
Try it yourself

Analyze data from a spreadsheet:

Read the CSV file in this folder and tell me: what are the top 3 trends you see? Create a summary with your recommendations.

Essential Commands

Here are the commands you'll use most often inside Claude Code:

Command What It Does
/help Shows all available commands
/clear Starts a fresh conversation (clears context)
/compact Compresses the conversation to save memory
/cost Shows how many tokens you've used this session
/model Switch between Claude models (Sonnet for speed, Opus for power)
Escape Cancels the current action
Tab Accept a suggested file change
Shift+Tab Reject a suggested file change
Ctrl+C Exits Claude Code entirely

Claude Code vs Claude Chat

You might be wondering: how is this different from just talking to Claude on claude.ai? Here's the key difference:

Claude Chat (claude.ai) Claude Code
What it does Answers questions, writes text Reads files, writes code, runs commands, creates deliverables
File access Only files you paste or upload Your entire computer's filesystem
Output Text in a chat window Actual files on your computer
Best for Questions, brainstorming, writing Projects, automation, building things
Persistence Conversation disappears when you close it Files it creates stay on your computer forever

The simplest way to think about it: Claude Chat is for talking. Claude Code is for doing.

Not sure which to use?

If your task ends with a file (a document, a spreadsheet, a website, organized folders), use Claude Code. If your task ends with knowledge (an answer, an explanation, advice), use Claude Chat.

Tips for Better Results

Be specific about what you want

Instead of "fix the website," say "edit the header in index.html to change the title to 'Welcome' and make the font larger." The more specific your request, the better the result.

Let Claude read your files first

Before asking Claude to change something, ask it to look at what you already have: "Read my project and tell me what each file does." This gives Claude context to make better decisions.

Start small and build up

Don't ask Claude to build an entire application in one prompt. Start with a small piece, review it, then ask for the next piece. This gives you much more control over the result.

Use it for real work

Claude Code isn't just for experiments. Use it to write emails, organize files, create reports, build spreadsheets, and automate repetitive tasks. The more you use it, the better you'll get at communicating with it.

Common Issues & Fixes

"command not found" when typing node or claude

Node.js didn't install correctly, or your terminal needs to be restarted. Close your terminal window, open a new one, and try again. If it still doesn't work, reinstall Node.js from nodejs.org.

Permission errors during installation

On Mac, add sudo before the install command. On Windows, try running Command Prompt as Administrator (right-click → "Run as administrator").

"API key" or authentication errors

Make sure you're logged into your Anthropic account. Try running claude again — it should prompt you to log in through your browser.

Slow responses

This is normal for complex tasks. Claude is actually reading files and writing code, which takes more time than a simple chat response. Give it a moment.

Claude made a mistake

Just tell it what went wrong: "That's not quite right — I wanted the chart to show monthly data, not weekly." Claude will fix its work based on your feedback.

Pricing & Plans

Claude Code requires an Anthropic subscription. Here's the honest breakdown:

Plan Price Best For
Free $0/month Trying it out. Very limited usage — you'll hit the cap quickly.
Pro $20/month Light to moderate use. Good for a few tasks per day. Most people start here.
Max $100–200/month Heavy daily use. If Claude Code is a core part of your workflow, you'll want this.
My recommendation

Start with Pro ($20/month). Use Claude Code for a week and see how often you hit the usage cap. If you hit it regularly, upgrade to Max. If you barely use it, stay on Pro or drop to Free. Don't overthink it — you can change plans anytime.

Already paying for ChatGPT or Gemini and don't want another subscription? Check out the coding agent alternatives — both Google and OpenAI have their own versions.

What's Next?

You've installed Claude Code and run your first task. Here's where to go from here:

  • Don't want the terminal? Try Claude Co-Work — the same agent capabilities in a visual interface.
  • Want to compare AI platforms? Read the Claude vs ChatGPT vs Gemini comparison.
  • Already have ChatGPT or Gemini? Check the coding agent alternatives guide.
  • Want hands-on help? Book a free call below and I'll walk you through your specific use case.

Module Complete

You've finished the Claude Code interactive guide. You're ready to start using Claude Code for real work. If you get stuck, scroll back to the troubleshooting section or book a free call below.

Want personalized help getting set up?

Book a free 15-minute call and I'll walk you through it live.

Book a Free Call →