Hub Claude Code Tutorial

Getting Started · Chapter 0

First, Understand What Claude Code Is

Before you dive in, take five minutes to understand what this thing really is. There's no jargon to memorize — we'll explain it all with down-to-earth analogies.

0.1 One-Sentence Analogy: It's a Senior Engineer Living Inside Your Computer

Imagine a brilliant, endlessly patient senior engineer comes to your home and sits down right in front of your computer. You simply tell them, in plain words, "here's what I want to do," and they get to work on their own: opening files, writing code, running tests, and handing you the finished result to look at.

Claude Code is that engineer. The only difference is that it isn't a real person — it's an AI program running inside your computer's "terminal." You talk to it by typing, and it answers by actually doing the work.

Where the name comes from

"Claude" is the name of this AI (much like Siri or Alexa), and "Code" means program code. Put them together and you get "the Claude that writes code." What's a terminal? Don't worry — all of Chapter 1 is about exactly that.

0.2 What It Can Do for You

Think of it as an all-around assistant. Here are some of the things it does best:

  • Write new features: say "make me a button that switches to dark mode," and it writes the code for you.
  • Fix bugs: when something breaks and an error message pops up, hand it the situation and it'll find the problem and fix it.
  • Write tests: it writes "automatic checks" for your code, so that later changes don't accidentally break something else.
  • Tidy up and refactor files: it cleans up messy code, renames things, and moves them around to make everything easier to read.
  • Explain unfamiliar code: inherited a codebase you can't make sense of? Ask it to explain, in plain language, what each part does.

Can I use it if I can't write code?

Yes. Your job is to "describe what you want"; leave the coding details to it. Of course, the more you understand, the better you can judge whether it's doing a good job — and this guide is here to build up that judgment, little by little.

0.3 How Is It Different from the Claude Web App or ChatGPT?

You've probably used an AI chat in your browser (like the Claude web app or ChatGPT). They're great at chatting and giving advice, but they share one limitation: they can only "talk," not "act." You ask a question, they reply with some text, and after that it's all on you — where to paste it, how to change it, which file to save it in.

The biggest difference with Claude Code is that it can "roll up its sleeves and do the work." Three things set it apart:

① It can read the files on your computer directly

No copy-pasting needed. It opens and reads the files in your project itself, so it understands your project as a whole — not just the small snippet you pasted in.

② It can actually edit your files

It writes changes straight into your files (and afterward you can review them, or undo them), instead of just handing you some text to paste back in yourself.

③ It can run commands in your terminal

Need to install a package, run tests, or start up a website? It can run those commands right on your computer, see the results, and then decide what to do next.

Being able to act means you need to keep an eye on it

Because it really does change your files and run your commands, it will usually ask for your approval before doing anything that "makes a change." Build the habit of reading carefully before you click approve, just as you'd read a document before signing it. Later chapters cover this in detail.

Let's wrap up with an analogy:

  • A web-based AI = phoning a consultant who talks you through how to do it, while you do the work yourself.
  • Claude Code = that same consultant coming right to your home, rolling up their sleeves to do it for you — and asking "is this okay?" before they start.

0.4 What You Need Before You Start

Good news: there's very little to prepare.

  • A computer: Windows, Mac, or Linux all work.
  • An internet connection: it needs to be online to run.
  • An account: pick one of two options —
    • A paid Claude subscription (the Pro or Max plan), or
    • An Anthropic Console "pay-as-you-go" account (you pay for what you use).

No need to rush into signing up just yet

For this chapter, all you need to do is "get the concepts." We'll walk you through the actual installation and sign-in, step by step, in Chapter 2. Finish Chapters 0 and 1 first to build a foundation.

Before installing, confirm your account and sign-in method

Before you install Claude Code, make sure you know which account you will use and how you will sign in. Next, learn to open the terminal in Chapter 1; then continue to the installation steps.

0.5 Four Terms You're Bound to Hear (Just Get Familiar with Them)

These four words will keep coming up in the chapters ahead. Don't memorize them now — just meet each one with a plain-language sentence and an analogy, so they won't throw you when you see them later.

Terminal

A dark window that lets you "type" to command your computer to do things.

Analogy: a chat room for talking to your computer — except the other party is the computer itself, and it only understands certain commands.

Folder (Directory)

A cabinet that holds files. The "folder" you normally see on your desktop is called a "directory" in the terminal.

Analogy: a single drawer in a filing cabinet — and inside that drawer you can put even smaller drawers.

Project

The folder where you gather all the related files for one piece of work.

Analogy: a big box that holds all the materials for "this one project."

Command

A single instruction you type to the computer in the terminal, telling it to go do something.

Analogy: telling a barista "I'd like a medium latte" — one clearly stated request.

The key takeaway of this chapter

Claude Code = an engineer who lives inside your computer and does the work itself; the biggest thing that sets it apart from a chatbot is that it can read files, edit files, and run commands. Remember that much and you're set — the rest you'll pick up bit by bit. Ready? In the next chapter, we'll open that "dark window."