Claude Code 快速上手：安装、登录与第一个任务

系统要求

• macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+ 或 Alpine Linux 3.19+
• 4 GB 以上内存，需要联网
• 需要 Claude Pro、Max、Team、Enterprise 订阅或 Console（API） 账号，免费版 claude.ai 不包含 Claude Code

安装

官方推荐使用原生安装脚本，装好后会在后台自动更新。

macOS / Linux / WSL：

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

Windows PowerShell：

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

也可以用包管理器安装（这些方式默认不会自动更新）：

# Homebrew（stable 通道，比 latest 大约晚一周）
brew install --cask claude-code

# WinGet
winget install Anthropic.ClaudeCode

# npm（需要 Node.js 22+）
npm install -g @anthropic-ai/claude-code

不要用 sudo npm install -g，容易引发权限问题。

装好后打开一个新终端，确认安装成功：

claude --version
claude doctor   # 更详细的安装和配置诊断

登录

进入你的项目目录，启动 Claude Code：

cd your-project
claude

第一次启动会打开浏览器让你登录 Claude 账号。如果环境变量里已经设置了 ANTHROPIC_API_KEY，它会询问你是否使用这个 Key，而不是打开浏览器。

第一个任务

1. 先让它了解项目：问一句「这个项目是做什么的？目录结构是怎样的？」
2. 生成 CLAUDE.md：运行 /init，它会把项目的命令和约定写进 CLAUDE.md，之后每次对话都会读取
3. 提一个具体的修改：例如「给 src/utils/date.ts 的 formatDate 加单元测试，写完运行测试确认通过」
4. 审查改动：它在改文件、执行命令前会请求许可；完成后用 git diff 检查

常用命令

更新

原生安装会自动更新，也可以手动执行：

claude update

Homebrew 用户执行 brew upgrade claude-code，WinGet 用户执行 winget upgrade Anthropic.ClaudeCode。