Claude Code for Dummies

No CS degree required. Curiosity will do.

← All posts

So what even is this thing?

Claude is an AI built by Anthropic. You've heard of ChatGPT. Same category, different company — and a lot of people who use both daily will tell you Claude thinks harder, writes better, and makes things up less often. (Both are impressive. Neither is a crystal ball. Don't fire your accountant.)

Claude Code is Claude with hands. Not just a chat window where you talk about problems. An AI that can actually open your files, write code, run commands, search the web, and get things done while you watch. Or while you make coffee. Either works.

The difference between "AI chat" and "Claude Code" is roughly the difference between asking someone to describe how to cook a meal and having them walk into your kitchen and cook it. Both are useful. One is considerably more useful.

How do you get in?

Three doors. Pick the one that doesn't make you nervous.

Easiest Door 1 — The browser

Go to claude.ai. Make an account. Start talking. That's it.

No installation. No terminal. No staring at a black screen wondering if you broke something. Just a chat window. Claude can't touch your files from here, but it can write, edit, explain, brainstorm, summarize, and reason through almost anything you throw at it.

Start here. You'll outgrow it faster than you expect — and that's a good sign.

Recommended Door 2 — The desktop app

Download Claude Code from claude.ai/code. Install it like any other app. Open it.

This is where the real power starts. File access, the ability to actually run things, a proper interface — without ever needing to open a terminal. If the words "command line" make you want to close this tab, this is your home. Welcome. Stay a while.

Full power Door 3 — The CLI

CLI stands for Command Line Interface — that black window full of text that developers use to look mysterious at coffee shops. Open yours and run:

npm install -g @anthropic-ai/claude-code

Then type claude. Done. You're in.

This is full power. Claude Code from the CLI can read your entire project, write and run code, check git history (every change ever made to a codebase, like a time machine for files), connect to databases, deploy to the cloud — all in one conversation. No switching tools. No copy-pasting between windows.

This site was built with this. The query optimization, the memoir pipeline, all of it. One black window. Genuinely unreasonable leverage.

The terminal is just text. Text that happens to run things. Don't be scared of it.

OK but what do I actually use it for?

Here's where people get vague and unhelpful. I'll be specific.

Fixing your writing without bruising your ego

"Rewrite this email so it doesn't sound passive-aggressive." (It does. We've all sent one. Claude won't judge you.)

"This report is 14 pages. Tell me the three things I actually need to know."

"Make this sound less like a robot wrote it." (Useful even when a robot did write it.)

Claude is a better editor than most editors. No ego. No attachment to your phrasing. No "well, I like it the way it is." It will cut what needs cutting and move on.

Building things you have no business building

"Write a Python script that reads this CSV and emails me a summary every morning."

"Build a webpage that shows my team's project status."

"Scan my inbox for meeting requests and put them in a spreadsheet."

You describe what you want. Claude builds it. You run it. If it breaks, you say what broke, Claude fixes it. No Stack Overflow. No three-hour detour into why your Python version is incompatible with a package last updated in 2019. No explaining the difference between pip and conda to a rubber duck.

I built a Snowflake optimization tool, a book distribution system, and this entire website this way. None of it was supposed to be easy. All of it got done.

🔍 Figuring out what went wrong

"This query takes 41 minutes. Here's the code. What's wrong?"

"My script crashes on line 47. I don't know what this error means."

"Why is this Excel formula not working? I've stared at it for 20 minutes."

Claude reads error messages the way a senior engineer does — not just matching the symptom to a known fix, but actually reasoning about the cause. It's not always right. It's almost always faster than Googling for an hour and ending up on a forum from 2014.

📖 Research you don't have time to do yourself

"Compare these three vendor proposals. What's missing from each one?"

"What are the tradeoffs between these two approaches? Give me the version I can explain to my team."

"Summarize the last six months of changes to this project."

With web search enabled, Claude pulls current information, thinks about it, and hands you something useful — not a list of links that you still have to read yourself.

The one thing nobody warns you about

Garbage in, garbage out. The AI version applies too.

"Help me with my report" will get you something generic and slightly useless. "I'm writing a two-page Q1 summary for a VP who hates caveats and wants the three worst problems with specific numbers" will get you something you can actually send.

You don't need technical vocabulary. You don't need to know the right terms. You just need to describe your situation like you'd describe it to a smart colleague who just walked in and has no idea what's going on. Context, constraints, who it's for, what done looks like.

"The computer will do exactly what you tell it to do. Not what you mean. Not what you want. What you said." — Every programmer's first lesson

Claude is better than a traditional computer at reading intent. But clear beats vague, every time.

Skills — the thing that makes power users dangerous

Every time you start a new Claude session, it knows nothing about you. Your preferences, your setup, your rules — gone. You're explaining from scratch. Again. Like Groundhog Day, but for your workflow.

Skills fix this.

A skill is a reusable instruction file you write once and invoke with a single command. Type /my-skill and Claude loads a whole set of context and behavior before you say your first word. It's the difference between a new employee who needs onboarding every single Monday and one who just... knows the drill.

Without a skill With a skill
Re-explain your setup every session Claude already knows it
Copy-paste context from last time One command loads everything
Hope Claude remembers your preferences Preferences are baked in
Start every session from zero Start every session from exactly where you need

What a skill actually looks like

It's a plain text file. That's really it. It lives at ~/.claude/skills/your-skill-name/skill.md and looks like this:

---
name: my-skill
description: Does the thing I need done regularly.
allowed-tools:
  - Bash
  - Read
  - Edit
---

# My Skill

You are a [whatever role makes sense].
When invoked, do [these specific things].
Follow [these rules].
Here is [all the context you need].

A name. A description. A list of tools it can use. Then instructions in plain English. That's the whole format. If you can write a paragraph explaining what you need, you can write a skill.

A real example: the PDF-to-deck skill

It's 1pm. Your boss wants a 10-slide deck from a 40-page report by 3pm. You have other things to do. This is your life now.

Without /pdf-to-deck With /pdf-to-deck
Open PDF. Read 40 pages. Take notes. Drop PDF in. Type one line.
Open PowerPoint. Build slides manually. Claude reads it, finds key sections, pulls numbers.
Slide 7 looks like someone who hates design made it. Structured deck: title, themes, summary. Done.
Run out of time. Send something embarrassing. Review, tweak, export. Make the 3pm deadline.

The skill carries everything: how many slides, what tone, what goes on each slide (headline, three bullets max, one key stat), what format to export. Write those rules once. Every PDF after that gets the same treatment. Same quality, no setup, no re-explaining.

Rule of thumb: done something twice and thought "I wish it just knew what I wanted"? That's a skill. Write it.

How to build your own (10 minutes, no coding)

1
Find the repetition. A task you do regularly that requires re-explaining context every time — standup format, deployment process, code review style. If you're copy-pasting the same backstory into every conversation, that's a skill waiting to be written.
2
Create the folder. mkdir -p ~/.claude/skills/my-skill-name
3
Create the file. ~/.claude/skills/my-skill-name/skill.md
4
Write it. Add the header block (name, description, tools), then write the instructions in plain English below it. No special syntax. No code. Just tell Claude what it needs to know.
5
Invoke it. Type /my-skill-name in Claude Code. It loads. You're done.

Skills people actually use

Here are some common ones to give you a feel for what's possible:

Every one of these replaces a task that was either tedious, easy to forget, or just painful enough that people kept putting it off. Now each is one word.

Where to go from here

Don't try to set up skills on day one. Start with the browser or the desktop app. Talk to Claude about an actual problem you have right now. When you find yourself re-explaining the same context for the third time, that's your signal — write a skill.

The full setup guides are here if you want to go deeper:

And if you want to see what this looks like when it's actually working — not a demo, not a sanitized example, but a real person solving a real problem in real time — the case studies are the place to start.

You will get it wrong at first. Ask something vague. Get something useless. Blame the AI. Then realize the question was the problem. Ask better. Get something good. Think: oh. That's what this is.

That moment happens to everyone. Usually around conversation three. Worth getting there.

← All posts

Disclosure: This post was written by Gautam Marya with Claude (Anthropic). Yes, we used Claude to write a beginner's guide to Claude. The irony is fully intended. The guide is still accurate.