Claude Code 学习站
v2.1.201

安装 / 快速上手

把 Claude Code 装上,跑通第一个会话。包括环境要求、各平台命令、首次登录与升级。

最快的开始方式

一条命令装好 Claude Code

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

独立二进制,自带运行时,无需预装 Node

原生二进制安装完整步骤

环境要求

  • 一个能访问 anthropic.com 的网络环境。中国大陆用户可能需要配置代理(HTTPS_PROXY 环境变量)或使用镜像。
  • 一个 Claude 账号(claude.ai)或者 Anthropic API Key。两种方式二选一即可。
  • (仅 npm 方式需要) Node.js 18 或更高版本(推荐 LTS 20+)。原生二进制安装不需要 Node。

不需要 Python、Docker 或者本地大模型。所有推理在 Anthropic 云端完成。

现在有两种装法:

  • 原生二进制(推荐) —— 一条 curl / irm 命令装一个独立可执行文件,自带运行时,完全不依赖 Node,自更新也最省心。
  • npm 全局包 —— 已经在用 Node 工具链、想跟现有 npm -g 体系统一管理时用。

原生二进制安装(推荐)

macOS / Linux / WSL,一条命令:

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

它会把 claude 装到 ~/.local/bin(独立可执行文件,内置运行时,无需预装 Node)。如果该目录不在 PATH 里,脚本会提示你加上,例如:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

想装指定版本,给脚本传参即可:

# 装最新稳定版(默认)
curl -fsSL https://claude.ai/install.sh | bash -s latest
# 或锁定某个版本号
curl -fsSL https://claude.ai/install.sh | bash -s 2.0.1

验证安装,应打印类似 2.x.x (Claude Code) 的版本号:

claude --version

若提示 command not found: claude,说明 ~/.local/bin 还没进 PATH,回到上一步把它加进去再 source 一次。

Windows 用原生安装见下方 Windows 一节(PowerShell 一行命令)。

npm 安装

如果你更习惯 Node 工具链,用 npm 全局安装:

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

这种方式需要本机 Node 18+。版本太低时推荐用 nvm 或 fnm 装一个最新的 LTS,再执行上面的命令。

如果遇到 EACCES 权限错误,不要直接 sudo —— 推荐改 npm 全局目录到用户家目录:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# 加到 shell 启动脚本(~/.zshrc 或 ~/.bashrc)
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
 
npm install -g @anthropic-ai/claude-code

验证安装:

claude --version

Windows

原生 Windows 直接在 PowerShell 里一行命令装独立二进制(无需 Node):

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

同样支持指定版本:

# 指定版本号
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.0.1

如果更想要和 Linux 完全一致的体验,推荐 使用 WSL2。WSL2 装好后,在 WSL 终端里直接跑上面 原生二进制安装 的 curl ... install.sh 即可;或走 npm:

sudo apt update && sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code

首次登录

claude

第一次启动会引导你登录。两种选择:

  1. 使用 Claude 订阅(claude.ai) —— 浏览器跳转 OAuth,适合已有 Pro/Max 订阅的用户。
  2. 使用 API Key —— 从 console.anthropic.com 拿一个 key,按用量计费。

如果服务器没有浏览器,选 API Key 方式即可。

第一个会话

进入任意项目目录,启动:

cd ~/my-project
claude

试一个最简单的请求(在 Claude 提示符后直接输入,无需带 >):

这个项目是用什么写的?

Claude 会读 README.md、package.json 等关键文件,回你一段总结。

再来一个改代码的:

在 src/utils.ts 里加一个 formatDate 函数,接收 ISO 字符串,返回 YYYY-MM-DD

Claude 会:

  1. 先用 Read 工具看 src/utils.ts
  2. 用 Edit 工具改写
  3. 把 diff 给你确认

按 Enter 接受,或者 n 拒绝。

省时小贴士:输入 /init 让 Claude 给项目生成一份 CLAUDE.md,把项目结构、惯例写进去,后续会话效率会高很多。

升级与卸载

无论哪种装法,内置命令都能升级到最新版:

claude update

原生二进制安装默认会自动后台更新,一般无需手动操作。

如果是 npm 装的,也可以直接走 npm:

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

卸载:

# 原生二进制安装:删掉可执行文件
rm -f ~/.local/bin/claude
 
# npm 安装:
npm uninstall -g @anthropic-ai/claude-code
 
# 两种方式都可顺手清理配置(可选)
rm -rf ~/.claude

下一步:看 核心功能示例 → 学习文件编辑、Agent、Skills、Hooks 等能力。