{"id":50717840,"url":"https://github.com/velesnitski/claude-code-quickstart","last_synced_at":"2026-06-09T20:30:29.573Z","repository":{"id":356257893,"uuid":"1231079072","full_name":"velesnitski/claude-code-quickstart","owner":"velesnitski","description":"Claude Code in 12 minutes – terminal setup, install, project structure, copy-paste examples. Markdown + auto-built PDF.","archived":false,"fork":false,"pushed_at":"2026-05-19T15:56:36.000Z","size":1718,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T19:14:07.623Z","etag":null,"topics":["ai-coding","ai-pair-programming","anthropic","claude","claude-code","claude-code-guide","claude-code-tutorial","cli-tool","coding-assistant","developer-tools","documentation","getting-started","hooks","llm","mcp-servers","onboarding","quickstart","skills","tutorial"],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/velesnitski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-06T15:51:51.000Z","updated_at":"2026-05-19T16:00:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/velesnitski/claude-code-quickstart","commit_stats":null,"previous_names":["velesnitski/claude-code-quickstart"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/velesnitski/claude-code-quickstart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velesnitski%2Fclaude-code-quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velesnitski%2Fclaude-code-quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velesnitski%2Fclaude-code-quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velesnitski%2Fclaude-code-quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/velesnitski","download_url":"https://codeload.github.com/velesnitski/claude-code-quickstart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velesnitski%2Fclaude-code-quickstart/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34125332,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","ai-pair-programming","anthropic","claude","claude-code","claude-code-guide","claude-code-tutorial","cli-tool","coding-assistant","developer-tools","documentation","getting-started","hooks","llm","mcp-servers","onboarding","quickstart","skills","tutorial"],"created_at":"2026-06-09T20:30:29.011Z","updated_at":"2026-06-09T20:30:29.566Z","avatar_url":"https://github.com/velesnitski.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code – 5-Minute Quickstart\n\n\u003e The shortest path from \"what is Claude Code?\" to \"I'm using it.\"\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/velesnitski/claude-code-quickstart/blob/main/LICENSE)\n[![PDF](https://img.shields.io/badge/PDF-download-blue.svg)](https://github.com/velesnitski/claude-code-quickstart/releases/latest)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/velesnitski/claude-code-quickstart/blob/main/CONTRIBUTING.md)\n[![macOS](https://img.shields.io/badge/macOS-supported-success)](docs/02-install.md)\n[![Windows](https://img.shields.io/badge/Windows-supported-success)](docs/02-install.md)\n\n**Languages:** **English** · [Русский](https://github.com/velesnitski/claude-code-quickstart/blob/main/README.ru.md)\n\n---\n\n## What is Claude Code?\n\nA 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.\n\nThink of it as **ChatGPT that can actually touch your computer**.\n\n![Claude Code terminal session](docs/images/hero-terminal.png)\n\n```mermaid\nflowchart LR\n    You([You]) -- \"ask in English\" --\u003e Claude[\"claude\u003cbr/\u003e(in your terminal)\"]\n    Claude -- \"reads, edits, runs\" --\u003e Files[(Your files)]\n    Files -- \"results\" --\u003e Claude\n    Claude -- \"answers\" --\u003e You\n```\n\nThat's the whole experience. You type. It works. You read.\n\n\u003e **60-second demo video** – coming soon. Want to record one? Open a PR linking it here.\n\n---\n\n## How Claude works (the safe loop)\n\nClaude doesn't just blurt out edits. Every action runs through a loop:\n\n```mermaid\nflowchart LR\n    Gather[\"Gather\u003cbr/\u003ereads your files,\u003cbr/\u003eCLAUDE.md, project\"] --\u003e Plan[\"Propose\u003cbr/\u003eshows the change\u003cbr/\u003ebefore doing it\"]\n    Plan -- \"you approve\" --\u003e Act[\"Act\u003cbr/\u003eedits, runs commands,\u003cbr/\u003ecreates files\"]\n    Act --\u003e Verify[\"Verify\u003cbr/\u003echecks output,\u003cbr/\u003eflags issues\"]\n    Verify -.-\u003e Gather\n```\n\nThree things to know:\n\n- **Nothing changes without your \"yes.\"** Claude shows the diff and asks before editing.\n- **Use Plan Mode** (`/plan`) to see the *full* plan before any work starts – good for bigger changes.\n- **Read your `CLAUDE.md`** – the more context that file gives, the less Claude has to ask.\n\n---\n\n## Install in one line\n\n| Your computer | Paste this in your terminal |\n|---|---|\n| **Mac** / Linux | `curl -fsSL https://claude.ai/install.sh \\| bash` |\n| **Windows** (PowerShell) | `irm https://claude.ai/install.ps1 \\| iex` |\n\n\u003e **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](https://claude.com/pricing).\n\u003e\n\u003e **Prefer no terminal?** Get the **[Desktop app](https://claude.com/download)** – same agent, regular app window.\n\nDon't have a terminal yet? Start at **[Step 1](docs/01-terminal.md)** below.\n\n---\n\n## The four steps\n\n| # | Section | What you'll learn | Time |\n|---|---|---|---|\n| 1 | **[Open the terminal](docs/01-terminal.md)** | What a terminal is, which one to use | 2 min |\n| 2 | **[Install Claude](docs/02-install.md)** | Get `claude` running on Mac or Windows | 2 min |\n| 3 | **[Set up a project](docs/03-folders.md)** | What folders Claude looks at, and how to help it | 3 min |\n| 4 | **[Try real examples](docs/04-examples.md)** | Five things to do today | 5 min |\n\nBonus: **[One-page cheatsheet](CHEATSHEET.md)** · **[PDF download](https://github.com/velesnitski/claude-code-quickstart/releases/latest)**\n\n---\n\n## Starter pack (drop into your project)\n\nEverything in the four steps above pays off faster if you start from the **[starter-pack](starter-pack/)** folder:\n\n- `CLAUDE.md.example` — a filled-in brand-voice file. Tweak the placeholders, save as `CLAUDE.md` at your repo root, done.\n- `prompts/` — five battle-tested copy-paste prompts: find feedback themes, blog → social, headline variants, tone-check, localize.\n\n```bash\n# get just the starter pack\ncurl -L https://github.com/velesnitski/claude-code-quickstart/archive/refs/heads/main.tar.gz \\\n  | tar -xz --strip=2 claude-code-quickstart-main/starter-pack\n```\n\nAdapt the brand voice in `CLAUDE.md`, then use the prompts as-is.\n\n---\n\n## Why this guide?\n\nThe other excellent guides – [Florian Bruniaux's Ultimate Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide), [Cranot's Guide](https://github.com/Cranot/claude-code-guide), [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) – are 10,000+ lines each. Brilliant references, overwhelming for newcomers.\n\n**This is the on-ramp.** Twelve minutes. Plain language. Pictures. When you're done, graduate:\n\n- **Free official courses** – [Anthropic on Skilljar](https://anthropic.skilljar.com/) – start with **Claude Code 101**, then **Introduction to Agent Skills** and **Introduction to Subagents**.\n- **Long-form references** – the guides linked above for exhaustive depth.\n\n---\n\n## Who is this for?\n\n- **Marketing \u0026 content folks** explaining Claude Code to others.\n- **Developers** wanting a fast on-ramp before diving into the long guides.\n- **Team leads** onboarding people to AI-assisted workflows.\n\nIf you've never opened a terminal before – **start at [Step 1](docs/01-terminal.md)**. We'll walk you through it.\n\n---\n\n## Liked it?\n\nIf this guide saved you 5 minutes, **[give the repo a star](https://github.com/velesnitski/claude-code-quickstart/stargazers)** – it's the best way to help others find it.\n\n## Contributing\n\n- **Translations** – open a PR with `README.\u003clang\u003e.md` (Russian already done at [README.ru.md](https://github.com/velesnitski/claude-code-quickstart/blob/main/README.ru.md)).\n- **Screenshots \u0026 GIFs** – real captures beat ASCII art. Drop them in `docs/images/`.\n- **Corrections** – fix a section directly, send a PR.\n- See [CONTRIBUTING.md](https://github.com/velesnitski/claude-code-quickstart/blob/main/CONTRIBUTING.md) for details.\n\n## License\n\n[MIT](https://github.com/velesnitski/claude-code-quickstart/blob/main/LICENSE) – use freely, including in commercial training material.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvelesnitski%2Fclaude-code-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvelesnitski%2Fclaude-code-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvelesnitski%2Fclaude-code-quickstart/lists"}