Skip to content

Varela Insights

Install Claude Code without sudo

Anthropic's CLI on Linux, macOS and Windows — self-contained binary, no Node.js

Install nowGitHub

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.

curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Then open a new terminal and check:

claude --version

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.