Pular para o conteúdo
← Back to Skalablog

Published article

How to Use Claude Code as a Complete Beginner

Software EngineeringClaude CodeClaudeAnthropic

Claude Code is not a chat window with opinions about your code. It is an agent that works inside your project. That single distinction answers how to use Claude Code well: give it complete jobs with clear boundaries instead of one-line instructions, review what it changes, and keep your rules in a Claude.md file.

What Claude Code Is and Why Beginners Start Here

Claude Code is Anthropic agentic coding tool that reads, edits, and runs code directly inside your project folder instead of only answering questions in a chat. Anthropic released it in February 2025 as a terminal tool, and it has since expanded to desktop and web surfaces, which is the version this workflow uses.

The problem it removes is specific. In the chatbot workflow, you ask for code, copy it into an editor, run it, paste errors back into the chat, and paste fixes back again. That loop, not the code itself, is where most beginners get stuck. Because Claude Code works inside the project, it can see the whole workspace, plan changes across files, and verify its own output.

You still stay in control. The desktop app shows each file as it is created, displays before-and-after diffs for edits, and asks for approval before running any terminal command. A walkthrough of this full flow appeared in a recent video, and creators like Dev Doido do canal do youtube have published similar tool-focused tutorials; resources such as crazystack.com.br collect this kind of practical AI-coding material. This article turns that workflow into a written reference.

Installing the App and Opening a Project Folder

Setup takes three steps: install the app, confirm your plan, and point Claude Code at one folder. The video walks through the desktop app, which you download from the official download page at Claude Code; the same surface is documented on Anthropic Claude Code product page. There is also a browser version at Claude/code, but the desktop app is what the tutorial uses.

After installing and signing in, check your plan. The tutorial states you need a Pro, Max, or higher subscription to use Claude Code, and that free-plan accounts must upgrade first. Confirm current plan requirements on Anthropic own documentation before you pay.

Then open the Code tab, choose Local, and select a folder. The folder can be completely empty. Claude Code treats whatever you select as its workspace and can read, edit, and run anything inside it, so choose a clean folder dedicated to the project rather than your desktop or downloads directory. A focused workspace gives the agent the right context and makes later prompts more accurate.

Verify the connection with one question: type "what files are in this project" and send it. If Claude lists the folder contents, setup is working and you can start building.

Scaffolding Your First App With One Clear Prompt

A good first prompt contains four things: what you want to build, which technology to use, the main features, and one constraint that keeps the project simple. Vague requests like "build me a task app" force the agent to make decisions that may not match what you had in mind.

The prompt used in the video is a useful template: "Create a simple task manager web app using HTML, CSS, and vanilla JavaScript. User should be able to add a task, mark it complete, and delete it. Keep it to a single page with no external libraries."

Claude Code then plans the structure and creates the files: HTML for page structure, CSS for styling, and JavaScript for behavior. The desktop app shows each file as it appears, so you follow the build instead of receiving one code block in a chat window.

Spend about thirty seconds reviewing the scaffold before your next prompt. Separate structure, styling, and logic files are easier to change later. If something looks wrong, correct it now, before features pile on top of a bad foundation. This early check is the cheapest moment to fix course.

Editing Existing Code Without Triggering a Full Rewrite

Most of your time will go into changing code that already exists. Two habits keep that safe: understand a section before touching it, and scope every edit narrowly.

To understand code, ask for a plain-English explanation of the part you care about, for example "explain what the task completion logic does." Claude Code reads the relevant files and breaks down what triggers the behavior and how pieces connect, which matters most in projects you did not write yourself.

For edits, avoid broad requests like "rewrite this." A scoped instruction has three parts: current behavior, desired behavior, and what must stay untouched. The video's example: "Completed tasks stay in the list with a line through them. Instead, I want completed tasks to move to a separate done section at the bottom. Only change the completion behavior. Leave the add and delete functions exactly as they are."

The agent updates only the targeted logic, and the desktop app shows the before-and-after diff so you approve exactly what changed. This keeps working code intact and stops a small update from becoming an accidental rewrite.

Debugging Two Kinds of Breakage

Debugging splits into two situations, and each has its own move.

When there is an error message

Paste the entire error, including file names, line numbers, and the stack trace. Say "I'm getting this error when I click a task. Here's the full message." The full text contains the clues Claude Code needs to trace the problem; copying only the last line can remove the exact detail that identifies the source.

When nothing throws an error

Describe the symptom and the expectation: "When I delete a task, the count at the top doesn't go down. It should drop by one every time I delete." The agent investigates the relevant files and logic on its own.

Keep working in the same conversation so context from earlier attempts stays available. The video also shows a third path: pressing play and letting Claude Code run the project, which surfaced a loading bug in a recipe app and fixed it automatically. Clear evidence in, managed back-and-forth out.

Terminal Commands and the Approval Step

Claude Code runs terminal work for you: installing packages, starting local servers, running tests, and handling git. You describe the outcome in plain language and it produces the commands.

Every command passes through an approval step. In the video's example, "initialize a git repository and make a first commit" produces the exact command sequence first; you review it, approve it, and watch git initialize, stage, and commit. You can stop a running command at any point if something looks wrong.

Risk should scale with attention. Starting a dev server, running tests, or installing a trusted package is routine. Commands that delete files, modify important data, or push to production deserve a close read before you approve them. The rule of thumb from the tutorial: easy-to-reverse actions need less scrutiny, permanent actions need a second look.

Claude.md Rules and Agentic Multi-Step Builds

Two habits separate a functioning setup from a fast one: persistent project rules and full-task handoffs.

Set project rules once in Claude.md

A CLAUDE.md file in the project root acts as standing instructions that Claude Code reads every session. Anthropic documents this memory file in its Claude Code memory guide. Without one, the agent re-decides naming, structure, and style on every task. The fastest way to start is the /init command, which inspects the project and drafts the file for you; then edit it. The video's example rules: plain vanilla JavaScript with no frameworks, full-word function names, everything in a single file, and no new libraries without asking. Even three or four rules noticeably improve consistency, and requests like "add a button to clear all completed tasks" then respect your conventions without restating them.

Hand off a complete build in one brief

Agentic mode lets you give a whole multi-step job at once. A strong brief states the goal, the constraints, what counts as finished, and what you do not want. The video builds a recipe saver with one request: add a recipe with title, ingredients, and steps; list recipes; open one for details; delete one; plain HTML, CSS, and JavaScript on a single page with no libraries or login. The agent plans, builds each feature in order, and finishes without a prompt between steps. You then test the four actions in the preview and turn any miss into the next prompt.

Frequently Asked Questions

  • Do you need to know how to code to use Claude Code? No. The video's premise is that beginners can run the full workflow without reading every line first. You describe outcomes in plain English, review the files and diffs the agent produces, and approve commands. Understanding what was built still helps you steer it.
  • Is Claude Code free to use? The tutorial states Claude Code requires a Pro, Max, or higher subscription and that free-plan accounts need to upgrade. Subscription terms change, so confirm current plan requirements on Anthropic official Claude Code page before subscribing.
  • What is Claude.md and where does it go? Claude.md is a memory file that lives in your project root and carries your standing rules: language choices, naming style, structure, and limits. Claude Code reads it automatically each session. Run /init to generate a draft, then edit it to match how you work.
  • How is Claude Code different from using Claude in a chat window? The chat only answers questions; Claude Code works inside your project. It reads the whole workspace, creates and edits files, runs terminal commands with your approval, and can complete multi-step builds from one brief. The practical difference is that you give it jobs, not just questions.

Turn Your Own Walkthroughs Into Written Guides

This article exists because a 28-minute video walkthrough contained a complete beginner workflow that was hard to skim, quote, or search. If you have the same kind of knowledge sitting in your own recordings, whether a tutorial, an interview, or a lesson, that content can become a structured written page.

Skala blog turns a YouTube video into an article: paste the URL, transcribe the video, and generate a draft you can edit and publish. Your explanations deserve to be findable in text as well as on a timeline.

Source video