What Claude Code Is — and How to Install and Start It
In the first post I laid out the whole map — the six stages and how they fit together. As promised, this post covers the real starting point: what Claude Code actually is, and how to install it and run it for the first time. Everything here is in plain words, and every fact is checked against the official docs.
So what is Claude Code?
Straight from the docs: Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools. Most of us started with "vibe coding" — nudging an AI for one snippet at a time. A coding agent goes further. "Agentic" is the key word — you give it a task, not just a line to finish. It plans, works across many files, runs the tests, and fixes what breaks, while you review.
Where it runs
You do not have to pick just one place. The same Claude Code works across several surfaces, and your settings and CLAUDE.md files carry across all of them:
- Terminal — the full command-line tool. This is where we start.
- IDE — extensions for VS Code and JetBrains editors.
- Desktop app — a standalone window for macOS, Windows, and Linux.
- Web — right in your browser at claude.ai/code.
Step 1 — Install it
Pick your machine in the tabs below and copy that one line. The recommended way is the native installer — the first four tabs — because it updates itself in the background:
curl -fsSL https://claude.ai/install.sh | bashThere is also Homebrew (brew install --cask claude-code) and WinGet (winget install Anthropic.ClaudeCode) if that is your style. Those you update by hand.
Step 2 — Open your project
Move into the folder you want to work in:
cd your-projectStep 3 — Start it
Just run claude. That opens an interactive session right inside your terminal. To confirm the install worked, check the version — and if anything feels off, claude doctor prints a quick health check without starting a session.
# start an interactive session
claude
# confirm it works
claude --version
# quick health check (does not start a session)
claude doctorStep 4 — Log in
The first time you run claude, it opens a browser prompt to sign in. You can also point it at a provider like Amazon Bedrock, Google Vertex AI, or Microsoft Foundry if that is how your team works — but for most people, logging in with a subscription is the fastest way to start.
That's the whole setup
Install, open your project, run claude, log in. Four steps and you have an agent sitting in your terminal, ready to read your code and do real work.
Next post: the basics you actually need first — CLAUDE.md, skills, context, and the tools Claude uses to get things done.