Claude Code 入门：从安装到第一次改动

01准备账号、终端与项目

这篇教程聚焦终端 CLI。开始前准备一个可以安全修改的本地 Git 项目、一个可用的 Claude Code 访问方式，以及能运行该项目命令的终端。首次练习建议选择体量较小、已有测试或明确启动命令的仓库。

先在项目目录查看当前状态，确保你知道教程开始前有哪些改动。不要把真实 API Key、密码或其他凭证放进项目文件、截图或提交历史。

cd your-project
git status

02按操作系统安装 Claude Code

选择与你当前终端匹配的官方安装方式。macOS、Linux 与 WSL 使用安装脚本；Windows PowerShell 使用 PowerShell 命令。安装结束后重新打开终端，让新的 PATH 配置生效。

• macOS 也可以使用 brew install --cask claude-code。
• Windows 也可以使用 winget install Anthropic.ClaudeCode。
• 使用 CMD 时不要粘贴 PowerShell 命令；按官方说明选择对应终端。

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

03检查版本并完成登录

先确认命令已经安装，再进入项目启动 Claude Code。首次启动通常会打开浏览器完成认证；认证入口、订阅和 API 计费边界不同，按团队或个人实际开通的方式登录。

claude --version
claude doctor
cd your-project
claude

04先让 Claude 认识项目

第一次对话先要求 Claude 只读地了解项目，不要一上来就修改文件。这样可以确认它读到了哪些入口、约定和构建命令，也能及时纠正工作目录或技术栈判断。

• 问题要包含目标、范围和期望输出。
• 复杂任务先让 Claude 拆成几个可审查的步骤。
• 发现上下文不完整时，先补充文件路径或运行结果。

请先阅读 README、项目结构和 package.json。
说明本地开发、测试和构建命令。
只报告发现与风险，暂不编辑文件。

05提出一个边界明确的小改动

选择一个能在几分钟内验证的任务，例如修正一条文案、补充空状态或修复一个可复现的小问题。明确要求 Claude 先给计划，再申请修改所需的文件，逐步审查它提出的操作。

• 把允许修改的目录或文件范围说清楚。
• 不确定的依赖、接口和业务规则先要求 Claude 查证。
• 看到超出任务范围的修改时，暂停并重新收窄目标。

请把首页空状态的提示改得更明确。
先列出计划、涉及文件和验证命令，等待我确认后再编辑。

06运行验证并检查实际结果

修改完成后要求 Claude 运行项目已有的测试或构建命令，并亲自阅读输出。验证要覆盖最初描述的行为，而不是只接受“已完成”的文字总结。

• 测试失败时保留完整错误和触发命令，再决定是否继续修改。
• 检查 diff 中是否有无关文件、调试输出或敏感信息。
• 必要时在浏览器或终端重复最初的操作，确认用户可见行为真的改变。

npm test
npm run build
git diff --check
git diff

07让 Claude 做一次交付前审查

当改动和验证都完成后，可以让 Claude 以审查者身份重新阅读 diff，专门寻找回归、遗漏的测试和超出范围的变化。最终是否提交由你确认，Claude 的总结不能替代人工审查。

请审查当前 git diff：
1. 先列出高风险问题和遗漏测试；
2. 区分确定问题与待确认事项；
3. 不要继续编辑文件。

git status
git diff --stat

08完成第一次闭环后继续学习

你已经完成了安装、认证、项目理解、受控修改和验证的最小闭环。接下来可以阅读速查文章掌握会话命令，再用 CLAUDE.md 固化项目约定，最后按实际需要学习 Skills、MCP、权限与团队自动化。

如果安装、认证或网络连接出现问题，先记录命令、终端类型、错误原文和发生步骤，再进入对应专题排查。

• 继续阅读“从安装到第一个可交付任务”，补充更完整的任务验收清单。
• 进入“CLI 与会话操作速查”，学习恢复会话与一次性输出。
• 进入“CLAUDE.md：让项目约定持续生效”，把稳定规则带进后续会话。