Skip to content
Technology

How to Use Claude Code: A Beginner's Guide

Webstarted Academy ·

Claude Code is the version of Claude that works on the files on your computer. In the Claude chat you ask for something and it answers with text. In Claude Code you ask for something and it does it: it creates files, edits them, runs commands and shows you what changed. That is why you can use it to build an app, a website or an internal tool even if you don’t know how to code.

This is the guide we share with people who sign up for our courses, so they arrive at the first class with everything installed.

What you need

  • A computer running Mac, Windows or Linux. There are ways to follow a session you already started from your phone, but to install it and work on a project you need the computer.
  • A paid Claude plan. Claude Code is included in the Pro, Max, Ultra, Team and Enterprise plans. You can also use it with an Anthropic Console account that pays per use. The free plan doesn’t include it. Pro is enough to get started, with lower usage limits than the more expensive plans.
  • An internet connection.

Two ways to use it

With the desktop app. If you have never opened a terminal, start here. Download the Claude app for Mac, Windows or Linux (on Linux, in beta for Ubuntu and Debian) from claude.com/download, sign in with your account and use Claude Code from the Code tab, without typing commands.

From the terminal. This is the original way and the one with the most options. It installs with a single command:

On Mac or Linux, open the Terminal app and paste:

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

On Windows, open PowerShell and paste:

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

On Windows it is also a good idea to install Git for Windows: it is not required, but it helps Claude Code work better.

To check that it installed correctly, open a new terminal and type claude --version. If something doesn’t work, claude doctor checks the installation and tells you what to fix.

The first time

If you use the desktop app, open the Code tab, choose to work on your computer and select the project folder. The steps below are for the terminal.

  1. Create a folder for your project, even if it is empty.
  2. In the terminal, go into that folder with cd and type claude.
  3. The first time, your browser opens so you can sign in with your Claude account.
  4. That’s it: tell it what you want to do, in your own words.

A good first request: “Build a simple web page that shows a to-do list, where I can add tasks and cross them off. Explain how to open it in the browser.”

Five things worth knowing from day one

  • It works inside the folder where you opened it. Always open it in your project folder, not in your whole home folder.
  • You choose the permissions. Depending on the mode you use, it asks for approval before editing files or running commands. At first, read each request before accepting.
  • Context matters. Every new session starts with a clean context: it can resume earlier conversations and keep some notes, but it is best to write down what matters. If you describe your project in a file called CLAUDE.md, it reads it every time it starts. The /init command creates one based on what it finds in the folder.
  • Ask for one thing at a time. One clear, focused request works better than ten at once.
  • Save versions. With Git you can go back if something breaks. If you don’t know how to use it, ask Claude Code to set it up and to save a version every time something works.

Useful commands inside a session: /help to see the help, /clear to start a new conversation, /resume to pick up an earlier one and /exit to quit.

What you can build

A landing page for your idea, a dashboard with your business numbers, a tool that organizes spreadsheets, an app prototype. This way of working, where you describe what you want and the AI writes the code, is called vibe coding. And if you connect it to your tools with MCP, it can read your calendar, your email or your database.

If you want to learn it with someone beside you

  • From idea to MVP with AI: in four live sessions you build a web app with one core feature using Claude Code, and you publish it.
  • AI for founders: to use Claude Code in depth at your startup, with context, models, Git, MCPs and n8n.

Want to try first? Check out the free workshops.

Looking for your first job in tech? Every week we hand-check junior and trainee openings in LATAM at Junior Jobs, and internships have their own list.

Workshops on this

Did you like it? Receive more content like this in your email.

Join the newsletter