Operations manual¶
Step-by-step procedures to install and maintain Claude Code in a controlled way.
Install¶
# Native installer (recommended)
curl -fsSL https://claude.ai/install.sh | bash # Linux / macOS
# or the repo wrapper (verifies macOS 13 + PATH):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/varelaia/Claude-Installer/main/scripts/install_claude.sh)"
Windows: irm https://claude.ai/install.ps1 | iex (PowerShell).
Verify (mandatory before signing off)¶
claude --version # prints version → binary on PATH
claude doctor # installation, config and last-update status
Real test: go into a project, run claude, complete the login and confirm it responds.
Update¶
- Native: automatic. Force a check: reopen
claudeor runclaude doctor. - Homebrew:
brew upgrade claude-code(orclaude-code@latest). - npm:
npm install -g @anthropic-ai/claude-code@latest. - WinGet:
winget upgrade Anthropic.ClaudeCode.
Clean up old versions (free disk space)¶
The auto-update accumulates previous binaries (~238 MB each) in
~/.local/share/claude/versions/.
./scripts/claude_cleanup.sh # dry-run: shows what it would delete
./scripts/claude_cleanup.sh --apply # deletes the old ones, keeps the active one
Roll back / clean reinstall¶
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
curl -fsSL https://claude.ai/install.sh | bash
Uninstall¶
Windows: delete %USERPROFILE%\.local\bin\claude.exe and %USERPROFILE%\.local\share\claude.
If you installed via a manager (brew/npm/winget), uninstall through that manager.
Deployment checklist for a new machine¶
- Verify requirements (OS/version, 4 GB RAM). On macOS:
sw_vers≥ 13.0. - Install (native).
claude --version→ logical 2xx (prints version).claude doctorwith no errors.claude+ real login in a test project.