Complete Setup Guide · 2026

Getting Started with
Claude Code

Download the desktop app and start building in under 5 minutes — Windows & Mac

Start the Guide
~5
Minutes to Install
2
Platforms Covered
0
Prior Experience Needed
1
App to Download
💡 Introduction

What is Claude Code?

Claude Code is Anthropic's AI coding assistant — a desktop app that reads and edits real files on your machine, runs your project commands, and manages code — all from plain English, no terminal needed.

Understands Your Project

Reads your entire codebase to give accurate, contextual answers — not generic ones.

✏️

Edits Files Directly

Makes real changes to your code without you having to copy-paste anything.

🔄

Runs Commands for You

Installs packages, runs tests, and manages git — just describe what you want.

🚀

Auto-Updates

Keeps itself current in the background. No manual updates ever needed.

💬

Works in Plain English

No coding jargon required — just describe what you need in your own words.

🛡️

Full Local Access

Sees and edits your project files directly, unlike browser-based AI tools.

📋 Before You Start

What You'll Need

Check these before moving on. Everything else is handled step by step.

💳

A Credit or Debit Card

Claude Code requires a paid Claude Pro plan at $20/month. Free accounts cannot use Claude Code.

🌐

Stable Internet Connection

Claude Code connects to Anthropic's servers in real time. Wi-Fi or Ethernet both work fine.

💾

At Least 4 GB of RAM

Most computers made after 2015 already have this. Check in System Information or Task Manager.

👤 Step 1

Create Your Claude Pro Account

Claude Code only works with a paid Anthropic account. Here's how to set one up in under 3 minutes.

⚠️
Make sure to select Monthly billing

The upgrade page defaults to the annual plan. After clicking a plan above, look for the Monthly / Annual toggle at the top of the page and switch it to Monthly before entering your card details.

How to Sign Up

1
Open your browser

Go to claude.ai

Visit https://claude.ai in any web browser.

2
Create account

Click "Sign up" and register

Use your email address or sign in with Google. Verify your email before continuing.

3
Upgrade plan

Upgrade to Claude Pro

After logging in: click your name/initials in the bottom-left → "Upgrade plan" → select Claude Pro → enter payment details.

🔒 claude.ai/upgrade
Choose your plan
Upgrade to Claude Pro
Claude Pro
Best for individuals
$20
per month
→ Claude Code access (terminal AI)
→ Claude Sonnet 4.6 (powerful model)
→ Web, mobile & desktop access
→ 5× more usage than free plan
Get Claude Pro — select Monthly →
Secured by Stripe · Cancel anytime
⚙️ Step 2

Download & Install

One download, one installer — no terminal, no package managers. Both platforms take under two minutes.

🌐
Step 1 — Go to the download page

Open your browser and go to claude.ai/download. The page detects your operating system and shows the right button automatically.

🍎   Mac Installation

Step 2 — Download the Mac app

Click Download for Mac on the download page. A .dmg file will appear in your Downloads folder.

Step 3 — Open the installer

Double-click the .dmg file. A window opens showing the Claude icon and your Applications folder.

Step 4 — Drag Claude to Applications

Drag the Claude icon onto the Applications folder icon in the same window. Wait a few seconds for it to copy.

Step 5 — Install Git

Claude Code uses Git to track changes in your project. macOS doesn't ship with Git pre-installed — pick one of the two options below.

Option A — Apple Command Line Tools (recommended)

Open Terminal (press ⌘ + Space, type Terminal, press Enter), then run xcode-select --install. A window will pop up asking to install the tools — click Install and wait a few minutes for it to finish.

Option B — Download from git-scm.com

Go to git-scm.com/install/mac and follow the installer instructions for your Mac. This is a good option if Command Line Tools fails or you prefer a standalone installer.

💡
Verify Git installed: In Terminal, run git --version. You should see a version number like git version 2.39.3.

Step 6 — Open Claude Code

Open Launchpad or your Applications folder and click Claude. The first time, macOS will ask "Are you sure you want to open this app downloaded from the internet?" — click Open.

💡
Shortcut: Press ⌘ + Space, type Claude, and press Enter to launch it instantly.
🪟   Windows Installation

Step 2 — Download the Windows app

Click Download for Windows on the download page. A .exe installer will appear in your Downloads folder.

Step 3 — Run the installer

Double-click the downloaded .exe file. If Windows SmartScreen shows a warning, click More infoRun anyway. The installer runs and opens Claude Code automatically when it finishes.

⚠️
SmartScreen warning?

This is normal for newly released apps. Click More info at the bottom of the warning, then Run anyway to proceed.

Step 4 — Install Git for Windows

Claude Code uses Git to track changes in your project. Windows doesn't ship with Git, so you'll install it separately. Go to git-scm.com/download/win — the download starts automatically. Double-click the .exe and click Next through every screen — the defaults are correct. When it finishes, close the installer.

💡
Verify Git installed: Open Start menu → type cmd → press Enter, then run git --version. You should see a version number like git version 2.45.0.

Step 5 — Open Claude Code

Claude Code opens automatically after install. In future, find it in the Start menu by typing Claude.

🚀 Step 3

Sign In & Start Chatting

Open the app, connect your account, and send your first message — takes about 60 seconds.

1
Open the app

Launch Claude Code

Open Claude Code from Launchpad / Applications (Mac) or the Start menu (Windows). The app opens to a welcome screen.

2
Sign in

Click "Sign in" and log in with your Claude account

The app opens a browser tab. Sign in with the email you used for your Claude Pro account, then click Authorize to connect it to the app.

3
You're in!

Return to the app — Claude is live

Switch back to Claude Code. You'll see the chat interface with a text field at the bottom. Start typing in plain English — no commands, no syntax.

4
Optional first step

Open a project folder

Click Open Folder (or drag a folder into the app) to point Claude at your project. Then type /init in the chat — Claude will scan the project and set itself up for smarter answers.

🎉
Send your first message

Try typing: "Hello! Can you tell me what files are in my current folder?" — Claude will respond instantly.

💡 Tips & Tricks

Shortcuts & Troubleshooting

The most useful things to know once you're up and running.

slash command
/help

See all commands

Lists all available slash commands in the chat

slash command
/init

Set up your project

Generates a CLAUDE.md for smarter, context-aware responses

keyboard
Shift + Enter

New line in message

Add a line break without sending the message

keyboard
Escape

Cancel a task

Stops Claude mid-response or cancels a running command

in-app
⚙ Settings

Preferences

Theme, model selection, and account settings

in-app
+ New Chat

Fresh session

Start a new conversation with a clean context

Common Problems & Fixes

❓ "App won't open" on Mac — security warning

Go to System Settings → Privacy & Security. Scroll down and click Open Anyway next to the Claude message. You only need to do this once.

❓ SmartScreen blocks the installer on Windows

Click More info on the SmartScreen popup, then Run anyway. This is normal for newly released apps that haven't yet built up a large Windows install count.

❓ "Authentication failed" when signing in

Your Claude account must have an active Pro subscription. Free accounts cannot use Claude Code. Check your plan at claude.ai/settings.

❓ Something else is wrong

Check the official docs at docs.anthropic.com, or contact support from the app's Settings menu.

Pro Tips

🌟

Always run /init in new projects

Type /init in the chat when you open a new project folder. Claude scans your files and generates a CLAUDE.md that dramatically improves answer quality.

💬

Speak naturally

No jargon needed. Say things like "Add a save button to the form" or "Fix the login error." Claude figures out the implementation.

🔄

Auto-updates are on by default

Claude Code updates itself silently in the background. You'll always be on the latest version without doing anything.

🎉 You're all set

Ready to Start Building?

Claude Code is installed and ready. Open the app, sign in, and start describing what you want to build — in plain English.

Read the Full Docs