本章目标
这一章完成三件事：安装 Claude Code、完成登录，并在一个真实仓库中进行第一次只读探索。先建立安全、可重复的启动流程，再开始让代理修改代码。
安装 Claude Code
Anthropic 当前推荐使用原生安装方式。macOS、Linux 和 WSL 可以运行：
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell 使用：
irm https://claude.ai/install.ps1 | iex
Homebrew 用户也可以安装稳定通道：
brew install --cask claude-code
安装后先确认命令可用：
claude --version
如果终端找不到 claude，重新打开终端，或者检查安装程序提示的可执行文件目录是否已经加入 PATH。
登录与账户
第一次运行时，Claude Code 会引导你在浏览器中登录：
claude
官方文档支持 Claude 订阅账号、Claude Console 账号以及部分企业云提供商。登录信息会保存在本机；需要切换账号时，在会话中运行：
/login
不要把 API Key 写进仓库、聊天内容或 CLAUDE.md。如果组织通过代理或云平台提供认证，应遵循管理员提供的配置方式。
在正确的目录启动
Claude Code 以启动时的工作目录作为主要项目范围。先进入仓库根目录：
cd /path/to/your-project
git status --short
claude
git status 最好为空。这样后续查看差异时，可以清楚区分原有修改和 Claude Code 新增的修改。
第一次只读探索
不要把第一条指令写成“帮我完善这个项目”。先要求它说明项目结构，而且明确暂时不修改：
先阅读 README、package.json 和 src 目录。
请说明：
1. 项目的技术栈和启动命令；
2. 主要模块及它们的职责；
3. 测试、类型检查和生产构建命令；
4. 你目前还不确定的地方。
暂时不要修改文件，也不要安装依赖。
这一步的重点不是得到漂亮摘要，而是验证 Claude Code 是否进入了正确仓库、能否找到真实命令，以及是否会明确表达不确定性。
常用启动方式
| 命令 | 用途 |
|---|---|
claude | 启动交互会话 |
claude "任务" | 带一条初始任务启动 |
claude -p "问题" | 执行一次非交互查询后退出 |
claude -c | 继续当前目录最近一次会话 |
claude -r | 选择并恢复历史会话 |
进入会话后，可用 /help 查看当前版本支持的命令，用 /clear 清理不再相关的对话上下文。
完成检查
claude --version能返回版本。- 可以完成登录并进入目标仓库。
- Claude Code 能指出真实的构建和测试命令。
- 第一次探索没有产生文件修改。