The shortest path from "what is Claude Code?" to "I'm using it."
Languages: English · Русский
A smart assistant that lives in your terminal (the black-and-white text window where developers type commands). You ask it things in plain English – it reads your files, edits them, runs commands, explains errors.
Think of it as ChatGPT that can actually touch your computer.
flowchart LR
You([You]) -- "ask in English" --> Claude["claude<br/>(in your terminal)"]
Claude -- "reads, edits, runs" --> Files[(Your files)]
Files -- "results" --> Claude
Claude -- "answers" --> You
That's the whole experience. You type. It works. You read.
60-second demo video – coming soon. Want to record one? Open a PR linking it here.
| Your computer | Paste this in your terminal |
|---|---|
| Mac / Linux | curl -fsSL https://claude.ai/install.sh | bash |
| Windows (PowerShell) | irm https://claude.ai/install.ps1 | iex |
Important: Claude Code needs a paid Claude plan (Pro / Max / Team / Enterprise) or a Console account with API credits. The free Claude.ai plan doesn't include it. See pricing.
Prefer no terminal? Get the Desktop app – same agent, regular app window.
Don't have a terminal yet? Start at Step 1 below.
| # | Section | What you'll learn | Time |
|---|---|---|---|
| 1 | Open the terminal | What a terminal is, which one to use | 2 min |
| 2 | Install Claude | Get claude running on Mac or Windows |
2 min |
| 3 | Set up a project | What folders Claude looks at, and how to help it | 3 min |
| 4 | Try real examples | Five things to do today | 5 min |
Bonus: One-page cheatsheet · PDF download
The other excellent guides – Florian Bruniaux's Ultimate Guide, Cranot's Guide, awesome-claude-code – are 10,000+ lines each. Brilliant references, overwhelming for newcomers.
This is the on-ramp. Twelve minutes. Plain language. Pictures. Then graduate to the long guides if you want depth.
- Marketing & content folks explaining Claude Code to others.
- Developers wanting a fast on-ramp before diving into the long guides.
- Team leads onboarding people to AI-assisted workflows.
If you've never opened a terminal before – start at Step 1. We'll walk you through it.
If this guide saved you 5 minutes, give the repo a star – it's the best way to help others find it.
- Translations – open a PR with
README.<lang>.md(Russian already done at README.ru.md). - Screenshots & GIFs – real captures beat ASCII art. Drop them in
docs/images/. - Corrections – fix a section directly, send a PR.
- See CONTRIBUTING.md for details.
MIT – use freely, including in commercial training material.