Back to the full guide
Claude Code
Run a terminal-based agent that can build and change files step by step.
AvailableInstall needed
What you need
- Use a paid Claude account and a supported terminal. The native installer is self-contained. Follow the official Claude Code installation guide for current requirements.
How to install
- Windows: open a normal PowerShell window and run
irm https://claude.ai/install.ps1 | iex. - macOS: open Terminal and run
curl -fsSL https://claude.ai/install.sh | bash. - Close and reopen the terminal, then run
claude --versionandclaude doctor. - On Windows, start from a short local working folder such as
C:\ai, outside Documents and OneDrive.
Nuances
- Claude Code no longer needs Node or Git, and its native installer does not need administrator rights. Git for Windows is optional but useful; without it Claude Code uses PowerShell.
- Native Windows is supported and WSL is not required. Sandboxing is not available on native Windows; use WSL 2 only when your IT policy or Linux toolchain requires it.
- The Windows installer supports Windows 10 1809 or later, installs to
%USERPROFILE%\.local\bin\claude.exeand does not need an elevated terminal. - On Windows, keep your working folder short and local, such as
C:\ai, outside Documents and OneDrive. KeepCLAUDE_CONFIG_DIRlocal too.
If it will not work
- If
claudeis not found, fully close and reopen the terminal before trying anything else. - If Git is installed but not detected, point
CLAUDE_CODE_GIT_BASH_PATHat the Git Bash executable. - If Claude reports a write as successful but no file appears, move the project to a short local path and confirm Windows long paths are enabled.
- If the installer is blocked by policy, ask IT to allow the user-space native installer.
Still blocked or need company approval?Go to the IT section in the full guide