Get Claude Code installed and run your first session. Covers system requirements, all four installation paths, storage planning, and your first commands.
You need three things:
Windows users: You also need Git for Windows installed before Claude Code will work. Download and run the installer with default settings.
| Requirement | Minimum | Notes |
|---|---|---|
| OS | Windows 10 (64-bit), macOS 13+, Ubuntu 20.04+ | Latest version recommended |
| Storage -- Claude Code app | ~500 MB | One-time install |
| Storage -- working space | 2 GB free | 5 GB+ recommended for serious use |
| RAM | 4 GB | 8 GB recommended for large codebases |
| Internet | Required | Cloud-based, no local processing |
| Account | Paid Claude plan | Free tier not included |
How your storage needs grow over time:
The Claude Code app itself takes about 500 MB. But as you build out your setup, that grows:
Practical guidance: Start with 500 MB for the app. Budget 5-10 GB total free space if you plan to use Claude Code seriously across multiple projects with a full skill library.
| I want... | Best option |
|---|---|
| Simplest setup, already using VS Code | Option 1: VS Code Extension |
| Visual interface, no terminal | Option 2: Desktop App |
| Full power, comfortable in a terminal | Option 3: Command Line (CLI) |
| No installation, just try it on a GitHub repo | Option 4: Web App (cloud only) |
If you use VS Code already, this is the fastest path.
The extension bundles the full CLI. Open the VS Code integrated terminal and type claude to access all CLI features including slash commands and hooks.
Best if you want a visual interface without using a terminal.
The Desktop App auto-updates in the background -- you always have the latest version without doing anything.
Linux users: The Desktop App is not available on Linux. Use Option 3 (CLI) instead.
The CLI gives you full access to every Claude Code feature. If you are comfortable in a terminal, this is the recommended path.
Mac / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
After installation: open a new terminal window, cd into your project folder, and run claude. You will be prompted to sign in on first use.
Verify the install worked:
claude --version
claude doctor
Note: The old npm install method (npm install -g @anthropic-ai/claude-code) still exists but is deprecated. Use the native install above for automatic updates and better performance.
Go to claude.ai/code in your browser. No download needed.
Can do: Read and edit files in GitHub repos, run long tasks on Anthropic cloud infrastructure, work on repos you have not cloned locally, access from the Claude iOS app.
Cannot do: Access files on your local computer, run commands on your machine, use locally installed MCP servers or skills.
Use this to try Claude Code before committing to an installation, or when working from a device that is not your main machine.
Once installed, navigate to a project folder and open Claude Code. For the CLI: cd your-project && claude. For the app: use the file picker or drag a folder in.
Try these to get oriented:
| What to try | What it does |
|---|---|
| Ask: what files are here? | See your project structure |
| Ask: explain this codebase | Get a high-level summary |
| Ask: read [filename] and tell me what it does | Analyze a specific file |
| Shift+Tab | Cycle through modes: Normal > Auto-Accept > Plan Mode |
| /help | See all available slash commands |
| /compact | Free up context window space when conversations get long |
| Ctrl+C | Cancel the current action |
Plan Mode is worth knowing from day one: press Shift+Tab twice to enter it. Claude reads your files and outlines exactly what it plans to do -- but makes zero changes until you approve. Use it any time you are unsure what Claude might touch.
command not found: claude
Open a new terminal window. The installer adds Claude to your PATH, but the current session does not see it until you restart.
Mac: Claude cannot be opened because the developer cannot be verified
System Settings > Privacy & Security > Open Anyway.
Windows: Claude Code opens then immediately closes
Install Git for Windows (git-scm.com/downloads/win). Claude Code uses Git Bash internally and will fail silently without it.
Authentication failed or login loop
Clear your browser cookies for claude.ai and try again. If you are using an API key: set the environment variable ANTHROPIC_API_KEY to your key value.
Slow responses
Claude Code connects to Anthropic cloud. Speed depends on your internet connection and current server load. There is no local processing option.
HivePowered AI — AI Like a Pro Training