Claude Code for Beginners: Complete Tutorial to Get Started in 2026

You've heard about Claude Code, seen people creating entire projects using the terminal and thought: "how do I start?" This tutorial will take you from zero to being productive -- without assuming you know how to code, without skipping steps, and without unnecessary jargon.

Claude Code is, today, the most powerful tool for anyone who wants to use artificial intelligence directly on their computer. It's not a chatbot in a browser tab. And an assistant wholives in your terminal, reads your files, runs commands and builds real projects. And you will learn how to use all of this in the next few minutes.

1. What is the Claude Code (and why is everyone using it)

Claude Code is a command line tool (CLI) created by Anthropic. In simple terms: you open your computer terminal, typeclaudeand start talking to an AI that can do things on your computer.

The difference between Claude Code and Claude's browser chat (claude.ai) is fundamental:

Feature	Claude Web (claude.ai)	Claude Code (terminal)
Interface	Browser	Terminal/command line
Read files from PC	No (only uploads)	Yes, any file
Edit files	Nao	Yes, directly
Execute commands	Nao	Yes (git, npm, scripts...)
Create projects	Generate code to copy	Create files directly on your PC
Maximum context	200K tokens	window from the beginning. 1 million tokens
Extensible with skills	Nao	Yes, hundreds of skills

The Claude Code and what transforms AI from a "question and answer tool" intoreal job assistant. He doesn't tell you how to do it -- he does it together with you, in your project, in your files.

Who is using

Developers use it to write code, run tests and deploy. Marketers use it to create landing pages, set up tracking and generate copy. Designers use it to prototype interfaces. Managers use it to automate reports. The tool does not have a single target audience -- anyone who works on a computer can benefit.

2. Requirements before starting

Before installing, make sure you have everything ready:

• Operating system:macOS, Linux or Windows (via WSL). Claude Code runs natively on Mac and Linux. On Windows, you need Windows Subsystem for Linux (WSL) installed
• Node.js version 18 or higher:Claude Code is installed via npm, the Node.js package manager. If you don't have Node installed, download it fromnodejs.org
• Anthropic account:you need an account with API credits or a Claude Pro ($20/month) or Max ($100-200/month) plan
• Terminal:on Mac, use the native Terminal or iTerm2. On Linux, any terminal emulator works

Checking everything at once

3. How to install Claude Code step by step

Installation is a single command. Open the terminal and run:

Option 1: via npm (recommended)

Option 2: via Homebrew (macOS only)

If you are on macOS and already use Homebrew, option 2 is convenient. Otherwise, npm works on any system.

4. First use: authentication and configuration

With Claude Code installed, it's time to open it for the first time. Navigate to any folder (it could be your Desktop) and type:

Claude Code will open your browser with an Anthropic login page. Log in with your account (or create one if you don't have one yet). After authorizing, the terminal will show that you are connected.

Authentication methods

• Pro/Max Plan (recommended for beginners):If you subscribe to Claude Pro or Max, authentication is done through the browser automatically. Simpler, no extra configuration
• API Key:for those with setote API credits. You configure the key via environment variableANTHROPIC_API_KEY

For most beginners, the Pro plan ($20/month) is the most direct path. You log in once and that's it -- Claude Code remembers your session.

5. Interface: how the interactive terminal works

When Claude Code starts, you see something like this:

The interface is clean. You have a prompt (>) where to type instructions in natural language. No need for special syntax, no need for code. Just write what you want.

Interface elements

• Prompt>:where you type. Accepts free text, no need to be "technical"
• Working directory:the folder where Claude Code is operating. It reads and creates files in that folder
• model:which model is being used (Sonnet by default, Opus for complex tasks)
• Claude's answers:appear directly in the terminal, with colorful formatting
• Permissions:When Claude wants to execute something (create file, run command), he asks for your authorization before

6. Basic commands you need to know

Claude Code has built-in commands that start with/. You don't need to memorize them all -- just know that they exist and consult them when you need them. Here are the essentials to get started:

Command	What it does	When to use
/help	Shows all available commands	When you're lost
/clear	Clears all conversation history	To start a new subject from scratch
/compact	Summarize the conversation to save tokens	When the conversation gets too long
/cost	Shows how much you spent on tokens in the session	To control expenses
/model	Switch between models (Sonnet, Opus, Haiku)	When you need more power or savings
/init	Creates the project's CLAUDE.md file	When starting a new project

In practice

These 6 commands cover 90% of what you need in everyday life. As you use it, you will discover others naturally.

7. Your first project: creating something from scratch

The best way to learn is by doing. Let's create a simple project: a personal web page. Open the terminal, navigate to where you want to create the project and start Claude Code:

What will happen:

1. Claude Code will analyze your request
2. It will propose creating a fileindex.html(and maybe astyle.css)
3. It will ask for your permission to create the files
4. You authorize it and it creates everything
5. Done -- the files are in the foldermeu-site/

You can open theindex.htmlin the browser and see the result immediately. Didn't like something? Continue the conversation:

Note that the Claude Codeedited the existing file-- he didn't generate a new one. He knows that theindex.htmlalready exists, and the content is current and applies only the necessary changes. This is the difference: he works with your real project, not with generic code.

Other projects to practice

• "Create a BMI calculator in HTML and JavaScript"-- simple design with logic
• "Create a professional README.md for my project X"-- non-code usage
• "Analyze the files in this folder and explain what each one does"-- Claude Code reads the entire folder and explains
• "Create a script that renames all photos in this folder with today's date"-- automation

8. Understanding context and tokens (1M window)

Tokens are the “unit of measurement” of AI. Every word you send and every word Claude responds to consumes tokens. Understanding this helps you use Claude Code more efficiently and economically.

What is the context window

The context window and Claude Code's "working memory". Everything you said, everything he replied and all the files he read are in this window. Claude Code has a windowwindow from the beginning. 1 million tokens-- this is equivalent to approximately:

• 750,000 words (over 10 entire books)
• An entire project with thousands of lines of code
• Dozens of files read simultaneously

In practice, you will rarely run out of this window. But very long conversations consume more tokens and can be slower (and more expensive). That's why there are commands/compact e /clear.

How to save tokens

• Be specific:"Create a landing page to sell a photography course, with hero, benefits and CTA" is better than "Create a website"
• Use /compact:when the conversation exceeds 100K tokens, compact. Claude summarizes the history without losing important context
• Use /clear for new subjects:If you finished a project and are going to start another, I cleared the conversation
• Choose the right model:Sonnet (standard) is faster and cheaper. Opus is more powerful but costs more. Haiku is the most economical for simple tasks

9. Installing skills to enhance

So far, you're using the "raw" Claude Code -- it's powerful, but generic. Skills turn him into aspecialist on demand.

What are skills

Skills are Markdown files (SKILL.md) that contains specialized instructions. When you install an "SEO audit" skill, for example, Claude Code will have in-depth knowledge of technical SEO, on-page, schema markup and everything else. He's not "inventing" -- he's following expert instructions.

How to install

Skills stay in the folder~/.claude/skills/(for global access across all projects) or.claude/skills/(for a specific project). Installation is literally copying folders:

Your skills appear alongside native commands. You type/auditoria-seoand Claude Code already knows exactly what to do, what criteria to analyze and how to format the result.

Create vs buy skills

You cancreate your own skills-- just write a Markdown file with instructions. But creating quality skills requires deep research into each domain, extensive testing and constant maintenance. For most professionals, it makes more sense to use ready-made skills and focus their time on productive work.

O Minhaskills.io Mega Bundlebrings 748+ ready-made skills covering SEO,Google Ads, Meta Ads, copywriting, email marketing, analytics and much more. THEMega Bundle has 748+ skills for React, Next.js, APIs, databases, DevOps and dozens of other technologies. The Mega Bundle costs $9.

10. Voice mode: using by voice

Claude Code also accepts voice input. Instead of typing, you speak and Claude Code transcribes and executes your instructions.

How to activate

On the terminal with Claude Code open, press the voice activation key (usually configured via/terminal-setup). Claude Code goes into listening mode, you speak your instruction and it processes it as if you had typed it.

Claude Code - Voice Mode

> [voice mode ativo]

Voce: "Crie uma funcao JavaScript que valida email e adicione no arquivo utils.js"

Transcribing... Processing...
Claude cria a funcao e adiciona no arquivo

When to use voice

• Long instructions:It's faster to speak 2 tographs than to type
• Multitasking:you can talk to Claude Code while doing something else
• Brainstorming:ideas flow better when you speak than when you type
• Accessibility:for those who have difficulty typing

Voicemod does not replace typing for everything. Short commands (/clear, /cost) are faster to type. But for complex instructions, voice is a real productivity gain.

11. Next steps

You already know how to install, authenticate, use basic commands and create your first project. Here is the way to go further:

Week 1: practice the basics

• Create 3-5 small projects to gain fluency
• Try asking for things outside your area (if it's marketing, ask for code; if it's necessary, ask for copy)
• Use /costto understand your consumption pattern

Week 2: costmize

• Use /initto create CLAUDE.md in your projects -- this gives Claude Code permanent context
• Install specific skills for your area of ​​expertise
• Explore the command/modelto understand the difference between Sonnet and Opus

Week 3: Integrate into the workflow

• Start using Claude Code for real everyday tasks, not just practice
• Combine with Git to version your projects
• Test voice mode in long sessions

Week 4: Optimize

• Create your own skills for repetitive tasks
• Set up terminal shortcuts
• Explore integration with VS Code and other tools

The secret is to use it every day. Even if it's just for a small task. Within 30 days of daily use, Claude Code will become a natural extension of your workflow.