← Claude Code, start to finish
Claude Code

What Claude Code Is — and How to Install and Start It

23 Jul 2026·5 min read

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.

The key ideaAutocomplete finishes your line. Claude Code takes on the task. That one shift — from typing every line to directing the work — is the whole point.

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 | bash
Open Terminal and run this. This installer keeps itself updated in the background.
Pick your machine — the copy button gives you that tab’s command.

There 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-project

Step 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 doctor
Start the session, then confirm the install is healthy.

Step 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.

Worth knowingClaude Code needs a Pro, Max, Team, Enterprise, or Console account. The free Claude.ai plan does not include Claude Code.

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.

What Claude Code Is — and How to Install and Start It · Ali Huzaifa