How Do I Get Started with Claude Code as a Beginner or Non-Developer?

Mar 22, 2026

Problem

I heard about Claude Code - an AI coding tool that runs in the terminal. I wanted to try it. But I don’t have a programming background. When I searched for installation instructions, I found terms like “terminal,” “command line,” and “shell.” I didn’t know what those meant or where to start.

I was stuck at the first step: How do I even open this “terminal” thing?

Here’s what I saw in the documentation:

curl -fsSL https://claude.ai/install.sh | bash

I had no idea where to type this. Do I paste it in a browser? In a Word document? Somewhere else?

Environment

Complete beginner with no coding experience
Never used a terminal or command line before
Want to use Claude Code to help me build things
Don’t know what “CLI” or “shell” means
Have a Claude Pro subscription

What happened?

I tried to figure this out on my own. I opened a web browser and searched for “how to open terminal.” The results were confusing - some said “command prompt,” others said “PowerShell,” and Mac users talked about something called “Terminal.app.”

I found the Claude Code documentation, but it assumed I already knew how to:

Open a terminal
Navigate to folders using text commands
Run installation scripts
Understand what claude command does

Each instruction felt like it required three more instructions to understand. I almost gave up.

How to solve it?

I found a Reddit thread where someone asked for a “toddler-level” explanation of Claude Code. The advice there helped me break through the initial barrier.

Step 1: Open Your Terminal

First, I needed to find the terminal on my computer. Here’s where it lives on different systems:

On macOS:

Press Cmd + Space (to open Spotlight Search)
Type "Terminal"
Press Enter

A window appeared with a text prompt. It looked scary at first - just a blinking cursor waiting for me to type something.

On Windows:

Press Win + X
Select "Windows PowerShell" or "Terminal"

On Linux:

Press Ctrl + Alt + T
Or search for "Terminal" in your applications

Step 2: Install Claude Code

Now I had a terminal open. The cursor was blinking. I pasted the installation command.

For macOS, Linux, or WSL (Windows Subsystem for Linux):

curl -fsSL https://claude.ai/install.sh | bash

For Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Alternative for macOS with Homebrew:

If I already had Homebrew installed (I didn’t, but some people do):

brew install --cask claude-code

After running the command, I saw text scrolling by. It downloaded and installed Claude Code. This took about 30 seconds.

Step 3: Restart the Terminal

The installation said it was complete, but when I typed claude, I got an error:

command not found: claude

I panicked. But then I read that I needed to close the terminal and open a new one. After doing that, the claude command worked.

Step 4: Log In

I typed:

claude

A browser window opened automatically, asking me to log in with my Claude account. I used my Pro subscription credentials. After logging in, the terminal showed:

Logged in successfully. Welcome to Claude Code!

Step 5: Create a Project Folder

Before using Claude Code, I needed a place to work. The Reddit thread suggested creating a dedicated folder:

mkdir ~/dev
mkdir ~/dev/my-first-project
cd ~/dev/my-first-project

This created:

A folder called dev in my home directory
A folder inside called my-first-project
Navigated into that folder

Step 6: Start Using Claude Code

Now I ran claude again from inside my project folder:

claude

The prompt changed to show I was in Claude Code mode. I typed my first question:

what can you help me with?

Claude responded with a list of things it could do:

Create files and write code
Explain code in plain English
Debug errors
Build websites
Write scripts

I decided to try something simple:

create a simple webpage that says hello world

Claude created an index.html file and showed me exactly what it was doing:

Creating index.html...
<!DOCTYPE html>
<html>
<head>
    <title>Hello World</title>
</head>
<body>
    <h1>Hello World</h1>
</body>
</html>

It asked: “Should I create this file?” I typed “yes” and it saved the file.

I opened the file in my browser and saw “Hello World” on the screen. I had just created my first webpage - without writing a single line of code myself.

The reason

Claude Code works for beginners because it removes the need to know programming syntax. Instead of memorizing HTML tags or JavaScript functions, I just describe what I want in plain English.

The key insight from my experience:

Natural language is the new programming language.

When I said “create a webpage that says hello world,” Claude Code:

Understood my intent
Wrote the correct HTML syntax
Showed me what it would create
Asked for my permission
Saved the file

I didn’t need to know:

HTML structure (<html>, <head>, <body>)
File extensions (.html)
Where to save files
How to open a file in a browser

Claude Code handled all of that.

Common mistakes I made

Mistake 1: Not having a Claude subscription

I initially tried with a free Claude.ai account. But Claude Code requires a paid subscription:

Pro
Max
Teams
Enterprise
Console account

The free plan doesn’t include Claude Code access. I upgraded to Pro and then it worked.

Mistake 2: Not restarting the terminal

After installation, the claude command didn’t work until I closed and reopened the terminal. This is because the terminal needs to reload its configuration to recognize new commands.

Mistake 3: Running Claude Code from the wrong folder

At first, I ran claude from my home directory. Claude Code thought I wanted to work on my entire user folder. The Reddit advice was helpful here:

A good convention would be to create a 'dev' folder under your home directory, and a separate project folder for each script... Open a terminal and go to that folder, and then start Claude from the terminal.

Mistake 4: Being too vague with requests

When I said “fix the bug,” Claude asked clarifying questions. I learned to be more specific:

BAD: fix the bug
GOOD: fix the login bug where users see a blank screen after entering wrong credentials

Mistake 5: Not using Plan Mode for complex tasks

For bigger projects, one Reddit user recommended starting in plan mode:

I started in plan mode and had Claude evaluate my goal and make tech recommendations for me to approve. I built a fully functional android app in 3 days.

Plan mode lets Claude analyze what you want to build and propose a plan before writing any code.

What else I learned

After getting comfortable with the basics, I discovered more capabilities:

Reading existing code:

explain what this project does

Claude read through all the files in my folder and explained the project in plain English.

Debugging:

When something didn’t work, I could paste the error:

I got this error: [paste error message]
What does it mean and how do I fix it?

Claude explained the error and suggested fixes.

Learning while building:

Explain what each line of this code does as you write it.

Claude added comments and explanations, helping me learn programming concepts naturally.

System requirements

Before installing, I confirmed my system met the requirements:

macOS: 13.0 or newer
Windows: 10 1809+ or Windows Server 2019+ (requires Git for Windows)
Linux: Ubuntu 20.04+, Debian 10+, or Alpine Linux 3.19+
Hardware: At least 4 GB RAM
Account: Claude Pro, Max, Teams, Enterprise, or Console

Important for Windows users: Claude Code on Windows requires Git for Windows. Install it from git-scm.com/downloads/win before installing Claude Code.

Summary

In this post, I showed how to get started with Claude Code as a complete beginner. The key point is that you don’t need programming knowledge - you need to know how to open a terminal, run one installation command, and describe what you want in plain English.

The barriers that initially stopped me (terminal, commands, installation) were simpler than they appeared:

Open terminal (Cmd+Space on Mac, Win+X on Windows)
Run one installation command
Restart terminal
Type claude and log in
Start describing what you want to build

Claude Code asks for permission before making changes, so you can review everything it does. You learn programming concepts naturally as you work with it.

Next steps:

Install Claude Code using the commands above
Create a ~/dev folder for your projects
Try asking Claude to create something simple
Use Plan Mode for larger projects
Ask Claude to explain code as it writes to learn programming concepts

Final Words + More Resources

My intention with this article was to help others share my knowledge and experience. If you want to contact me, you can contact by email: Email me

Here are also the most important links from this article along with some further resources that will help you in this scope:

Oh, and if you found these resources useful, don’t forget to support me by starring the repo on GitHub!