---
title: "How to install and update Claude Code | Bombos"
description: "Install Claude Code with one native installer command on macOS, Linux, WSL or Windows; it updates itself, and IT can pin versions with managed settings."
image: "https://bombos.ai/assets/og-en-v2.png"
---

# How do I install Claude Code, and how do I keep it updated?

Short answer

Run the native installer: curl -fsSL https://claude.ai/install.sh | bash on macOS, Linux and WSL, or irm https://claude.ai/install.ps1 | iex in Windows PowerShell. Then run claude in your project and log in with a paid Claude plan or a Console account. Native installs update themselves, npm installs too when the npm folder is writable; Homebrew and WinGet need manual upgrades by default.

*Piet Baudoin · published November 17, 2026 · November 17, 2026*

## The install command for your system

Claude Code runs on macOS 13 or later, Windows 10 1809 or later (or Windows Server 2019), Ubuntu 20.04, Debian 10 and Alpine 3.19 or later, with at least 4 GB of RAM on x64 or ARM64. These are the install routes in the docs as of November 2026:

| Route | Command | Updates |
| --- | --- | --- |
| Native, macOS, Linux, WSL | `curl -fsSL https://claude.ai/install.sh | bash` | Automatic |
| Native, Windows PowerShell | `irm https://claude.ai/install.ps1 | iex` | Automatic |
| Native, Windows CMD | `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` | Automatic |
| Homebrew | `brew install --cask claude-code` | Manual |
| WinGet | `winget install Anthropic.ClaudeCode` | Manual |
| apt, dnf, apk | Signed repositories from downloads.claude.ai | Through your system upgrades |
| npm | `npm install -g @anthropic-ai/claude-code@latest` | Automatic if the npm folder is writable |

Anthropic recommends the native installer. After it finishes:

1.  **Open a new terminal** and run `claude --version`. A version number means it worked. “Command not found” means the install folder is not on your PATH yet.
2.  **Go to your project** and run `claude`. A browser window opens to log in. You need a Pro, Max, Ultra, Team, Enterprise or Console account; the Free plan does not include Claude Code.
3.  **Check the setup** with `claude doctor` if anything feels off. It prints install health, settings errors and the result of the last update attempt without starting a session.

Prefer no terminal at all? The Claude desktop app includes Claude Code in its Code tab, so you do not need the CLI for that route. See [desktop vs CLI vs web](https://bombos.ai/en/questions/claude-code/claude-code-desktop-vs-cli-vs-web/).

## Windows: native, WSL 2 or WSL 1

| Option | Needs | Sandboxing | Use it for |
| --- | --- | --- | --- |
| Native Windows | Nothing; Git for Windows optional | Not supported | Windows projects and tools |
| WSL 2 | WSL 2 enabled | Supported | Linux toolchains, sandboxed commands |
| WSL 1 | WSL 1 enabled | Not supported | Only if WSL 2 is unavailable |

On native Windows you run the PowerShell or CMD command; no Administrator rights needed. With Git for Windows installed, Claude Code uses Git Bash for its Bash tool. Without it, Claude Code runs shell commands through its PowerShell tool. If it cannot find Git Bash, set `CLAUDE_CODE_GIT_BASH_PATH` in the `env` block of your settings.json. For WSL, open your distribution and run the Linux command inside it; you also start `claude` there, not from PowerShell.

## Updating Claude Code

A native install checks for updates at startup and while it runs, downloads them in the background, and switches to the new version the next time you start it. To update right away, run `claude update`.

Two release channels exist, set with `autoUpdatesChannel` or in `/config` under **Auto-update channel**:

1.  **`latest`**, the default: every release as soon as it ships.
2.  **`stable`**: a version that is typically about a week old and skips releases with major regressions.

Homebrew picks the channel by cask name: `claude-code` follows stable, `claude-code@latest` follows latest. Upgrade those with `brew upgrade`, WinGet with `winget upgrade Anthropic.ClaudeCode`. For npm, rerun the install command with `@latest`; the docs warn that `npm update -g` may not move you to the newest release.

To stop background checks, set `DISABLE_AUTOUPDATER` to `"1"`. That still allows `claude update`. To block every update path, for example because IT distributes versions itself, use `DISABLE_UPDATES`.

## The misunderstanding: “npm means it runs on Node”

Many guides still lead with `npm install -g`. According to the setup docs, the npm package now installs the same native binary as the installer, through a per-platform dependency, and the `claude` command does not call Node at all. npm is just another delivery route. Two related traps: never install with `sudo npm`, because Claude Code then cannot update itself, and installing the VS Code extension does not put `claude` on your PATH. The extension bundles its own copy; for the terminal you install the CLI separately.

## Rolling it out to a team

IT does not need to touch each developer’s settings. Claude Code reads managed settings, which outrank user, project and local settings:

1.  **Server-managed** from the claude.ai admin console: fetched at startup and polled hourly.
2.  **MDM or OS policy**: the `com.anthropic.claudecode` preferences domain on macOS, or a `Settings` value under `HKLM\SOFTWARE\Policies\ClaudeCode` on Windows, through Jamf, Intune or Group Policy.
3.  **A file**: `managed-settings.json` in `/Library/Application Support/ClaudeCode/` (macOS), `/etc/claude-code/` (Linux and WSL) or `%ProgramFiles%\ClaudeCode\` (Windows).

Useful keys for a rollout: `autoUpdatesChannel` to keep everyone on stable, `minimumVersion` so updates never go below a version, and `requiredMinimumVersion` and `requiredMaximumVersion` to refuse to start outside a range. Permission deny rules, such as blocking reads of `.env`, go in the same file. Verify on one machine with `/status`: the **Setting sources** line should name the managed source. Anthropic publishes starter templates for Jamf, Intune and Group Policy in the claude-code repository under `examples/mdm`. One catch: cloud sessions on Anthropic’s machines do not read a device’s MDM profile or file, so policy for those has to come from server-managed settings.

## What an install does not give a team

A managed rollout gives every developer the same binary, version and rules. It does not give them the same knowledge. What Claude Code learns in one developer’s sessions stays on that machine, and a new hire starts from the project CLAUDE.md and nothing more. See [how Claude Code memory works](https://bombos.ai/en/questions/claude-code/claude-code-memory/) and [Claude Code memory for teams](https://bombos.ai/en/knowledge-base/claude-code-memory-for-teams/).

## Where Bombos fits

Installing Claude Code is the easy part; making every install know what the team knows is the harder one. Bombos is a plugin that gives Claude Code and the team’s other AI tools one shared memory: team knowledge, rules the team has learned, and what already sits in mail, documents and repos, traceable to the source, in the cloud or on your own server. One developer can add it to their own setup first.

## Related questions

Do I need Node.js to install Claude Code?

No. The native installer, Homebrew and WinGet need no Node.js. The npm package asks for Node.js 22 or later, but it installs the same native binary, which does not use Node at runtime.

Do I need admin rights on Windows?

No. The docs say you do not need to run the install command as Administrator. Git for Windows is optional and gives Claude Code Git Bash for its Bash tool.

How do I update Claude Code by hand?

Run claude update. For Homebrew use brew upgrade claude-code, for WinGet winget upgrade Anthropic.ClaudeCode, and for npm npm install -g @anthropic-ai/claude-code@latest.

Can I use Claude Code on the Free plan?

No. Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account, or a cloud provider such as Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry.

How do I uninstall it?

For a native install on macOS, Linux or WSL, remove ~/.local/bin/claude and ~/.local/share/claude. Settings and history live in ~/.claude and ~/.claude.json; delete those only if you want them gone too.

## Sources

1.  [Claude Code docs: Advanced setup](https://code.claude.com/docs/en/setup)
2.  [Claude Code docs: Deploy managed settings](https://code.claude.com/docs/en/managed-settings)
3.  [Claude Code docs: Overview](https://code.claude.com/docs/en/overview)
4.  [Claude Code docs: Use Claude Code in VS Code](https://code.claude.com/docs/en/vs-code)

## What does your AI forget?

1.  01You tell us which AI you use and where it keeps starting over.
2.  02We show what a shared memory changes there, on your own examples.
3.  03You keep the plan, with or without Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**You talk to Piet, from the Bombos teamDutch team from Utrecht and Nijmegen · data in Europe

## More questions about Claude Code

-   [What is Everything Claude Code (ECC) and should your team install it?](https://bombos.ai/en/questions/claude-code/everything-claude-code/)
-   [What are Claude Code hooks and how do I set them up?](https://bombos.ai/en/questions/claude-code/claude-code-hooks/)
-   [How do I use Claude Code in VS Code and JetBrains?](https://bombos.ai/en/questions/claude-code/claude-code-in-vs-code-and-jetbrains/)
-   [What is Claude Code Remote Control and how do I use it?](https://bombos.ai/en/questions/claude-code/claude-code-remote-control/)
-   [What is the Claude Code SDK, now the Claude Agent SDK?](https://bombos.ai/en/questions/claude-code/claude-code-sdk/)
-   [How do I use Claude Code well? A first workflow that works](https://bombos.ai/en/questions/claude-code/how-to-use-claude-code-well/)
-   [Is Claude Code safe to use on company code?](https://bombos.ai/en/questions/claude-code/is-claude-code-safe-for-company-code/)
-   [OpenCode vs Claude Code: which coding agent should I use?](https://bombos.ai/en/questions/claude-code/opencode-vs-claude-code/)

[All questions about Claude Code →](https://bombos.ai/en/questions/claude-code/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is the memory layer under every AI your team uses. One shared memory for Claude, ChatGPT, Copilot, Cursor and your own agents, that learns how you work.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/en/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"How do I install Claude Code, and how do I keep it updated?","description":"Install Claude Code with one native installer command on macOS, Linux, WSL or Windows; it updates itself, and IT can pin versions with managed settings.","abstract":"Run the native installer: curl -fsSL https://claude.ai/install.sh | bash on macOS, Linux and WSL, or irm https://claude.ai/install.ps1 | iex in Windows PowerShell. Then run claude in your project and log in with a paid Claude plan or a Console account. Native installs update themselves, npm installs too when the npm folder is writable; Homebrew and WinGet need manual upgrades by default.","datePublished":"2026-11-17T00:00:00.000Z","dateModified":"2026-11-17T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-en-v2.png","mainEntityOfPage":"https://bombos.ai/en/questions/claude-code/how-to-install-claude-code/","inLanguage":"en-US","isPartOf":{"@type":"CollectionPage","name":"Claude Code","url":"https://bombos.ai/en/questions/claude-code/"},"citation":[{"@type":"CreativeWork","name":"Claude Code docs: Advanced setup","url":"https://code.claude.com/docs/en/setup"},{"@type":"CreativeWork","name":"Claude Code docs: Deploy managed settings","url":"https://code.claude.com/docs/en/managed-settings"},{"@type":"CreativeWork","name":"Claude Code docs: Overview","url":"https://code.claude.com/docs/en/overview"},{"@type":"CreativeWork","name":"Claude Code docs: Use Claude Code in VS Code","url":"https://code.claude.com/docs/en/vs-code"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/en/"},{"@type":"ListItem","position":2,"name":"Questions","item":"https://bombos.ai/en/questions/"},{"@type":"ListItem","position":3,"name":"Claude Code","item":"https://bombos.ai/en/questions/claude-code/"},{"@type":"ListItem","position":4,"name":"How do I install Claude Code, and how do I keep it updated?","item":"https://bombos.ai/en/questions/claude-code/how-to-install-claude-code/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Do I need Node.js to install Claude Code?","acceptedAnswer":{"@type":"Answer","text":"No. The native installer, Homebrew and WinGet need no Node.js. The npm package asks for Node.js 22 or later, but it installs the same native binary, which does not use Node at runtime."}},{"@type":"Question","name":"Do I need admin rights on Windows?","acceptedAnswer":{"@type":"Answer","text":"No. The docs say you do not need to run the install command as Administrator. Git for Windows is optional and gives Claude Code Git Bash for its Bash tool."}},{"@type":"Question","name":"How do I update Claude Code by hand?","acceptedAnswer":{"@type":"Answer","text":"Run claude update. For Homebrew use brew upgrade claude-code, for WinGet winget upgrade Anthropic.ClaudeCode, and for npm npm install -g @anthropic-ai/claude-code@latest."}},{"@type":"Question","name":"Can I use Claude Code on the Free plan?","acceptedAnswer":{"@type":"Answer","text":"No. Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account, or a cloud provider such as Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry."}},{"@type":"Question","name":"How do I uninstall it?","acceptedAnswer":{"@type":"Answer","text":"For a native install on macOS, Linux or WSL, remove ~/.local/bin/claude and ~/.local/share/claude. Settings and history live in ~/.claude and ~/.claude.json; delete those only if you want them gone too."}}]}
```
