安装与登录全流程

先对硬件和系统

Claude Code 对机器的要求不高：4 GB 以上内存、x64 或 ARM64 处理器。系统层面支持 macOS 13.0+、Windows 10 1809+（或 Windows Server 2019+）、Ubuntu 20.04+、Debian 10+、Alpine 3.19+。Shell 支持 Bash、Zsh、PowerShell 和 CMD。唯一硬性要求是联网——它需要调用模型服务，离线没法用。另外它自带 ripgrep 用于代码搜索，一般不需要你单独装。

Windows 用户有一个选择题要做：原生安装还是 WSL。简单说：

原生 Windows 上强烈建议装 Git for Windows：Claude Code 会用 Git Bash 执行 Bash 工具，没装的话会退回 PowerShell 工具执行命令。两者都能用，但很多脚本语法只有 bash 下顺。如果装了 Git Bash 但 Claude Code 找不到，可以在 settings.json 里手动指定路径：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

WSL 用户注意：要在 WSL 终端里跑 Linux 安装命令，不是在 PowerShell 里跑。Alpine 这类 musl 系发行版要先补齐 bash、curl、libgcc、libstdc++、ripgrep 这些依赖，并设置 USE_BUILTIN_RIPGREP=0。

四种安装方式

方式一：原生安装脚本（官方推荐）

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装过程中下载没有进度条，别以为卡死了。装完开个新终端，运行 claude --version，能打印出版本号加 (Claude Code) 就成功了。如果提示找不到 claude 命令，是安装目录没进 PATH，按官方安装排障文档处理。

原生安装器还支持装指定版本或通道：curl -fsSL https://claude.ai/install.sh | bash -s stable 装 stable 通道，| bash -s 2.1.89 装精确版本。需要复现环境的场合很好用。

方式二：Homebrew（macOS/Linux）

brew install --cask claude-code

注意两个 cask 的区别：claude-code 跟稳定通道，claude-code@latest 跟最新通道。Homebrew 装的不会自动更新，要手动 brew upgrade；另外 brew 升级后会留旧版本占磁盘，定期跑 brew cleanup。

方式三：WinGet（Windows）

winget install Anthropic.ClaudeCode

同样不自动更新，定期跑 winget upgrade Anthropic.ClaudeCode。Windows 会锁住正在运行的 exe，所以 Claude Code 运行中升级可能失败，关掉再升即可。

方式四：npm

npm install -g @anthropic-ai/claude-code

要求 Node.js 22+。有个细节值得知道：npm 包装的其实还是原生二进制（通过平台专属的可选依赖拉取），运行时不依赖你的 Node。升级用 npm install -g @anthropic-ai/claude-code@latest，别用 npm update -g（它可能不给你升到最新）。另外千万别加 sudo 装，会带来权限和安全隐患。

版本策略：通道与锁定

原生安装默认自动更新，有两个通道可选：latest（一发布就更新）和 stable（约滞后一周，跳过有重大回退的版本）。用 autoUpdatesChannel 字段配置：

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

minimumVersion 给版本设了下限，防止 stable 通道把你降级。也可以通过 DISABLE_AUTOUPDATER=1（settings.json 的 env 里）关掉后台自动更新，claude update 命令仍然可用；要连手动更新都禁掉则用 DISABLE_UPDATES。企业统一管控版本走 managed settings，个人用户一般不用碰。

登录：五种账号入口

首次运行 claude 会弹出浏览器完成登录。支持的账号类型：

1. Claude 订阅（Pro / Max / Team / Enterprise）——推荐，按订阅额度用；
2. Claude Console（API 按量计费）——首次登录会自动建一个 "Claude Code" 工作区方便统计成本；
3. 企业云厂商——Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry；
4. 企业自建网关——管理员预配好网关地址后，/login 直接进企业 SSO；
5. API Key 环境变量——已设置 ANTHROPIC_API_KEY 的话，在提示时确认使用即可跳过浏览器登录。

免费版 claude.ai 账号不含 Claude Code 使用权，这是很多新用户踩的第一个坑。登录凭据会存下来，之后不用重复登录；想换账号在会话里跑 /login。

公司代理环境下怎么办

在企业网络里，Claude Code 遵循标准代理环境变量：

# HTTPS 代理（优先用这个）
export HTTPS_PROXY=https://proxy.example.com:8080
# 不走代理的地址，空格或逗号分隔都行
export NO_PROXY="localhost 192.168.1.1 .internal.example.com"
# 代理要认证时，把凭据写进 URL
export HTTPS_PROXY=http://user:password@proxy.example.com:8080

大小写变体都认，按 https_proxy → HTTPS_PROXY → http_proxy → HTTP_PROXY 的顺序取第一个设置的值。启动时会校验代理 URL 格式，写错会直接报错告诉你改哪个变量。除了代理，还可能要给防火墙放行 api.anthropic.com、platform.claude.com、sso.claude.com 等域名，完整清单见官方网络配置文档。

还有个企业环境的经典坑：代理、CA 证书这类变量只 export 在你当前 shell 里，后台代理进程可能继承的是别的 shell 的环境。最稳的做法是写进 settings.json 的 env 字段，让每个会话都带上。

装完先做体检

两个命令建议新装机都跑一遍：

claude --version   # 确认版本号能打出来
claude doctor      # 只读体检：安装健康度、settings 校验、更新状态

claude doctor 不启动会话，专门诊断安装与配置问题：检查安装是否健康、settings 文件有没有格式错误、上次自动更新是否成功，还能给出修复建议。以后升级遇到怪事（比如提示 Auto-update failed），第一个动作就是跑它。想手动立即更新就跑 claude update，成功会打印从旧版本到新版本的变更信息。

卸载也简单：原生安装删掉 ~/.local/bin/claude 和 ~/.local/share/claude 两个路径即可；Homebrew / WinGet / npm 各用各自的卸载命令。连带清理配置则删除 ~/.claude 目录和 ~/.claude.json——注意这会清掉全部设置、允许列表、MCP 配置和会话历史，想清楚再删。如果删完 claude 还能跑起来，说明机器上有第二份安装或旧别名残留，回排障文档处理。

本章由 WorkBuddy 原创整理，事实性内容参考 Claude Code 官方文档。