从安装到第一个可交付任务

01开始之前

准备一个本地项目目录和可用的 Claude Code 访问方式。终端、IDE、桌面版和云端是不同的使用入口，本指南聚焦终端 CLI。

初次运行选择你熟悉的项目，确认工作区已有 Git 记录。这样可以逐项审查文件变化，并在必要时回到开始前的状态。

02选择安装方式

官方快速开始目前优先介绍原生安装。macOS、Linux 与 WSL 使用下方命令；Windows PowerShell 使用 irm https://claude.ai/install.ps1 | iex。请先确认终端类型。

• macOS 的 Homebrew 用户也可使用 brew install --cask claude-code。
• Windows 的 WinGet 用户可使用 winget install Anthropic.ClaudeCode。
• 原生安装与包管理器安装的更新机制不同，升级时跟随原安装方式。

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

03检查并启动

安装完成后重新打开终端。先核对版本与安装诊断，再在项目目录启动；首次运行按界面指引完成登录。

claude --version
claude doctor
cd your-project
claude

04给出可验收的第一项任务

把目标、影响范围和验证方式一起交代。以下示例适合先熟悉一个仓库；随后把实际问题缩小到一个行为，再开始修改。

• 提交前阅读 diff，确认没有无关文件与机密信息。
• 让 Claude 运行项目已有的构建或测试，并报告实际结果。
• 把可重复的项目约定记录到 CLAUDE.md。

阅读 README 和项目结构，说明如何本地运行。
找出首页组件和构建命令。
先给出发现与修改计划，暂不编辑文件。

05安装失败时，先看错误发生在哪一步

如果 claude 不在 PATH 中，重新打开终端后再次检查；不要同时安装多个来源的版本来碰运气。用 claude doctor 确认实际可执行文件和安装来源。

脚本下载返回 HTML 时，终端可能出现尖括号相关语法错误。先确认网络能访问官方下载地址；这是下载链路的问题，不是你的项目代码错误。

• Windows 中区分 PowerShell 与 CMD，不跨终端粘贴命令。
• 原生安装、Homebrew、WinGet 的升级方式分别遵循对应说明。
• 认证失败时先切到“账号、认证与计费边界”，不要重复重装。

06完成标准：一个小改动真正跑起来

选择修正一条文案、补充一个空状态或修复一个可复现的小 bug。先保存当前工作，再让 Claude 完成修改与针对性验证。

任务结束时，你应能回答：改了哪个行为、在哪里改、怎么确认成功，以及还有哪些未验证场景。终端输出“完成”本身不是验收证据。

• 阅读每个变更文件，而不是只看最后一段总结。
• 运行项目的实际页面或命令，重复最初的触发步骤。
• 确认后再提交；未达到目标时，用观察到的差异继续反馈。