安装与设置 Claude Code
可靠的 Claude Code 环境，首先要选对安装方式、确认平台支持，并在打开真实仓库前先做一次快速验证。安装完成后，请在真实仓库中继续完成认证和快速开始。
- 最近核验
- 适用版本
- 适用于 Claude Code 2.1.x。本机使用 2.1.198 检查 CLI 拼写；当前官方文档可能包含更新的 2.1.x 行为。
- 核验方式
- 2026-07-19 对照官方文档、CLI reference 和 changelog。本机检查版本和 help 输出；各平台安装器、认证与更新行为依据官方文档，未冒充本机跨平台实测。
可复现实践
选择单一安装渠道，并证明实际运行的是哪个二进制
在认证和仓库配置介入前建立可重复的安装基线，避免把 PATH 或版本问题误判为项目问题。
准备
- 受支持的操作系统和 shell、网络连接以及至少 4 GB 内存。
- 明确选择 native、Homebrew、WinGet 或受支持的 Linux 包管理器之一。
- 具备软件安装权限；不要运行来自非可信镜像的安装脚本。
执行步骤
记录安装前状态
检查现有二进制或 alias 是否已经占用 PATH；新机器没有输出是正常结果。
步骤 1 command -v claude || true type -a claude 2>/dev/null || true只使用一个官方渠道安装
按官方 setup 页面选择对应平台。不要因为当前 shell 尚未刷新就叠加第二种安装方式。
打开新 shell 并确认可执行文件
路径和版本共同证明当前生效的安装。
步骤 3 command -v claude claude --version项目工作前运行只读诊断
doctor 检查安装健康和设置解析；认证状态是另一道独立关口。
步骤 4 claude doctor claude auth status --text
预期结果
PATH 首位只有预期安装，CLI 能输出版本，doctor 给出可操作诊断，认证状态明确。
验证
- 运行 type -a claude，并解释每个返回路径。
- 把 claude --version 与团队选定的 release channel 对照。
- 在日常 shell 和 IDE integrated terminal 中重复相同检查。
失败处理
command not found
先刷新 shell、检查 PATH 和官方安装位置，再考虑重新安装。
存在两个二进制
移除或降低非预期渠道的 PATH 优先级；更新其中一个不会更新另一个。
认证失败
确认二进制和网络正常后，再按账户或 provider 问题处理。
清理或回退
- 按实际安装渠道使用对应卸载说明。
- 只有确认 shell profile 改动来自本次安装后才恢复。
边界与不适用场景
- curl 或 PowerShell 安装器会执行下载代码；企业设备可能只能使用批准的包渠道。
- 原生 Windows 与 WSL 是不同环境，应在仓库和工具链实际运行的位置安装。
系统要求
Claude Code 支持 macOS 13+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+ 和 Alpine Linux 3.19+。需要 4 GB 以上内存、网络连接，以及 Bash、Zsh、PowerShell 或 CMD 等受支持 shell。
安装方式
选择一种安装渠道并保持一致，除非团队规范另有要求。推荐原生安装；Homebrew 和 WinGet 需要手动升级。
| Command | Description |
|---|---|
claude install stable | 安装或重装指定 release channel 的原生二进制。 |
claude update | 将 Claude Code 更新到当前安装方式的最新版本。 |
claude doctor | 在终端输出只读安装和设置诊断信息。 |
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexbrew install --cask claude-code
winget install Anthropic.ClaudeCode首次验证
安装完成后，确认 CLI 在 PATH 中、认证正常，且二进制版本符合团队预期，再接入 IDE 或 CI。
claude --version
claude auth login
claude auth status --text更新与卸载
更新行为取决于安装渠道。原生安装可自动更新；Homebrew 和 WinGet 需要显式执行 upgrade 命令。卸载步骤请参考官方 setup 文档中对应平台说明。