首页 / 阶段二 / Claude Code

Claude Code：同类型，另一套安装方式

Anthropic 的编码 agent。用法和 Codex 几乎是同一个套路，但安装渠道更多、Windows 支持更完整，也有不需要碰终端的桌面版。这一页的重点不是「再学一个工具」，而是补齐你踩坑时会用到的所有官方命令：安装、验证、更新、卸载、排错。

命令行 + 桌面版需境外网络需付费订阅 Windows 支持完整

先确认这一条，能省掉几小时

Claude Code 不包含在免费的 Claude.ai 计划里。它要求 Pro、Max、Team、Enterprise 或 Console 账号之一。如果你只有免费账号，装完会卡在登录这一步——不是安装错了，是权限不够。另外也可以接第三方 API 提供方（如 Amazon Bedrock、Microsoft Foundry）来用。

01系统要求

项目	要求
macOS	13.0 及以上
Windows	10（1809+）或 Windows Server 2019 及以上
Ubuntu	20.04 及以上
Debian	10 及以上
Alpine Linux	3.19 及以上
硬件	4 GB 以上内存，x64 或 ARM64 处理器
Shell	Bash、Zsh、PowerShell 或 CMD

Windows 上建议装 Git for Windows：Claude Code 会用它提供的 Bash 来执行命令；没装的话会退回用 PowerShell，能用但行为有差异。WSL 环境不需要 Git for Windows。

02安装：五种方式

官方推荐原生安装（方式一），它会自动在后台更新。Homebrew、WinGet、npm 也都能装，但不会自动更新，需要手动升级。

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

macOS / Linux / WSL一条命令

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell不需要管理员权限

irm https://claude.ai/install.ps1 | iex

Windows CMD注意：这段只能在 CMD 里跑，不能在 PowerShell 里跑

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

怎么判断自己在哪个窗口：行首有 PS C:\Users\名字> 是 PowerShell；只有 C:\Users\名字> 是 CMD。在 PowerShell 里跑 CMD 那条会报 The token '&&' is not a valid statement separator；在 CMD 里跑 PowerShell 那条会报 'irm' 不是内部或外部命令。看到这两个报错，先换窗口，不要改命令。

装稳定版或指定版本

可选：装稳定通道 / 指定版本号默认装 latest

# macOS / Linux / WSL：装 stable 通道
curl -fsSL https://claude.ai/install.sh | bash -s stable

# 装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

# Windows PowerShell 装稳定版
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

方式二：Homebrew（macOS）

macOS Terminal两个 cask 的区别见下

brew install --cask claude-code

# 想要「发布即得」的最新通道
brew install --cask claude-code@latest

claude-code 走稳定通道，通常比最新版晚一周左右，会跳过有重大问题的版本；claude-code@latest 走最新通道。Homebrew 装的不会自动更新，要自己 brew upgrade claude-code。

方式三：WinGet（Windows）

Windows PowerShell装完不会自动更新

winget install Anthropic.ClaudeCode

# 升级
winget upgrade Anthropic.ClaudeCode

方式四：npm

任意系统需要 Node.js 18+

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

# 升级（不要用 npm update -g）
npm install -g @anthropic-ai/claude-code@latest

绝对不要用 sudo npm install -g

官方文档明确写了这一点：sudo npm install -g 会造成权限问题和安全风险。macOS 上如果遇到 EACCES 权限错误，正确做法是修 npm 的全局目录权限或改用原生安装，而不是加 sudo。Windows 上没有 sudo，别去搜「怎么提权装」。

npm 包装的其实也是原生二进制，通过平台专属的 optional dependency 拉下来，装完后 claude 本身不依赖 Node 运行。

方式五：桌面应用（不想碰终端的话）

官方提供 macOS 与 Windows 的桌面应用，可以完全不用终端就用 Claude Code。功能上比命令行版少一些高级能力，但足够日常改代码。下载入口在官方文档的安装章节里。

03验证与自检

两步确认第二步是深度自检，出问题先跑它

claude --version
claude doctor

claude doctor 会检查安装路径、配置、版本、登录状态等，并给出具体问题。安装或登录出问题时，这条命令的输出比任何教程都准——它告诉你缺什么。

04登录

在项目目录里运行 claude。
首次启动会引导你认证：打开浏览器登录 Anthropic 账号并授权。凭据存在本地。
想用 API Key 的话，设环境变量 ANTHROPIC_API_KEY（写法见第 0 课），它会自动读取。

Windows 上 Git Bash 找不到时的解法写进 settings.json

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

另外原生 Windows 也支持直接用 PowerShell 作为命令执行工具，可通过环境变量 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 主动启用（该能力在逐步放开，行为以官方文档为准）。

05基本用法

和 Codex 一样：先 cd 进项目，再启动。

标准流程Windows 示例

cd D:\projects\my-site
claude

你想要	怎么说 / 怎么做
看它有哪些能力	启动后输入 `/help`，或在对话里问「你支持哪些命令」。
只讨论、不动文件	明确说「只分析，不要修改任何文件」。
改完要审	它会先展示改动再执行。养成逐条看一眼的习惯，别一路回车。
长任务	它擅长连续多步的任务（读代码 → 改 → 跑测试 → 修）。给它一个可验证的终点。
更新	原生安装自动更新；也可以主动 `claude update`。

06三个实战

实战一：让一个陌生项目「说人话」

「读这个项目，用中文解释：它是做什么的、入口文件在哪、数据从哪来到哪去。只读，不要改文件。看不懂的地方直说不确定。」 这是接手别人代码时最省时间的用法。

实战二：给静态站点做一次完整体检

「检查所有 html 页面：有没有失效的内部链接、有没有缺 alt 的图片、移动端 viewport 是否都有。列成表格，先不要改。」 拿到清单你自己判断优先级，再让它分批修。

实战三：写脚本处理重复劳动

「写一个 Python 脚本：扫描指定目录下所有超过 30 天的日志文件，打包成 zip 后删除原文件。先只打印计划，不要真的删。」 对自己数据动手的脚本，永远先让它「空跑」一遍。

07更新与卸载

安装方式	更新	卸载
原生	自动，或 `claude update`	删 `%USERPROFILE%\.local\bin\claude.exe` 与 `%USERPROFILE%\.local\share\claude`（macOS/Linux 对应 `~/.local/bin/claude` 与 `~/.local/share/claude`）
Homebrew	`brew upgrade claude-code`	`brew uninstall --cask claude-code`
WinGet	`winget upgrade Anthropic.ClaudeCode`	`winget uninstall Anthropic.ClaudeCode`
npm	`npm install -g @anthropic-ai/claude-code@latest`	`npm uninstall -g @anthropic-ai/claude-code`

彻底清理配置（会删掉全部设置与历史）Windows PowerShell

Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# 项目级的（在项目目录里执行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

卸载后如果 claude 还能跑，说明你机器上有第二个安装，或者旧安装留下的 shell alias 还在。

08踩坑与排错

现象	原因与处理
登录时说没有权限 / 要升级	账号计划不含 Claude Code。需要 Pro/Max/Team/Enterprise/Console 之一。
PowerShell 里报 `irm 不是命令`	你在 CMD 里。换 PowerShell 窗口。
CMD 里报 `&&` 语法错误	你在 PowerShell 里。换 CMD 窗口，或改用 PowerShell 的安装命令。
npm 安装报 EACCES	不要加 sudo。改用原生安装，或修 npm 全局目录权限。
Windows 上命令执行异常	装 Git for Windows；或在 settings.json 里指定 `CLAUDE_CODE_GIT_BASH_PATH`；或改用 WSL。
Alpine 上报 ripgrep 相关错误	先装 `libgcc libstdc++ ripgrep`，并把 `USE_BUILTIN_RIPGREP` 设为 `0`。
不确定哪出问题	`claude doctor`。它会给具体诊断。

09和 Codex 选哪个

功能高度重叠，选择主要看三件事：你已经有哪个订阅、你在 Windows 上要不要少折腾、你偏好哪个模型家族的风格。两个都装也不冲突（命令名不同：codex 与 claude）。详见怎么选。

官方文档（本页命令的出处）：docs.claude.com/en/docs/claude-code/setup
系统要求、安装渠道、更新与卸载方式均以该页 2026 年 11 月版本为准。版本号请以 claude --version 的实际输出为准，本文出现的 2.1.89 只是官方示例。