Varela Insights
Install Claude Code without sudo
Anthropic's CLI on Linux, macOS and Windows — self-contained binary, no Node.js
How to install Claude Code¶
Claude Code is Anthropic's command-line tool (CLI) for coding with Claude directly in your terminal: it reads and edits your code, runs commands and works on your project agentically.
This guide explains how to install it simply and verifiably on Linux, macOS and Windows, without administrator privileges.
In one sentence
Claude Code installs with a single command. The native installer downloads a
self-contained binary to ~/.local/bin — no Node.js required — and updates itself
automatically.
Quick install (native installer — recommended)¶
Then open a new terminal and check:
To get started, go to your project folder and run claude. The first time, the browser will
open to sign in (see Authentication).
What do I need before starting?¶
| System | Requirement |
|---|---|
| Linux | Ubuntu 20.04+/Debian 10+ (or equivalent), 4 GB RAM, x64 or ARM64 |
| macOS | macOS 13.0 (Ventura) or later, 4 GB RAM |
| Windows | Windows 10 1809+ (native) or WSL 2 for Linux toolchains |
| Node.js | Only if you install via npm (Node 22+). The native installer does not need it. |
Other ways to install¶
| Method | Command | Note |
|---|---|---|
| npm | npm install -g @anthropic-ai/claude-code |
requires Node 22+; installs the same binary |
| Homebrew | brew install --cask claude-code |
macOS/Linux; manual update (brew upgrade) |
| WinGet | winget install Anthropic.ClaudeCode |
Windows |
Details per system: Linux · macOS · Windows.
Authentication¶
The first time you run claude, the browser opens to sign in. It works with:
- A Claude Pro, Max, Team or Enterprise subscription (recommended).
- A Claude Console account with API access.
- Enterprise providers: Amazon Bedrock, Google Vertex AI, Microsoft Foundry.
The free plan does NOT include Claude Code
You need a paid subscription (Pro/Max/Team/Enterprise) or a Console account with API.
To re-authenticate within a session: type /login.
Verify and diagnose¶
claude --version # installed version
claude doctor # diagnostic of installation, configuration and updates
Scripts in this repo¶
Besides the official commands, this repository includes lightweight wrappers that persist the
PATH and verify the result — see the README.
The installation is minimal by design: only the claude binary, no tool suites.
Something failing? Check Troubleshooting.