第二章：安装与账号配置（macOS/Windows/Linux 思路一致）

2.1 安装：优先选择官方推荐方式

Claude Code 提供多种安装方式，推荐你以官方文档为准选择其中一种，并保持“升级路径一致”，避免出现多版本混装。

常见安装方式（以官方文档为准）：

• 安装脚本（原生二进制）：

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

  参考：https://claude.com/product/claude-code

• Homebrew / WinGet（需要手动升级）：
  brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode
  参考：https://code.claude.com/docs/en/setup

• npm 全局安装（老路径，注意与原生二进制不要混装）：
  npm install -g @anthropic-ai/claude-code
  参考：https://www.npmjs.com/package/@anthropic-ai/claude-code

如果你已经用 npm 安装过旧版本，而现在改用原生二进制，建议先卸载旧 npm 版本（官方文档也给出了迁移提示）。
参考：https://code.claude.com/docs/en/setup

2.2 启动：一定要在项目根目录运行

进入你的仓库根目录后启动：

cd /path/to/your-repo
claude

这样 Claude Code 才能正确读取代码结构、运行项目命令（测试/构建）并生成可审阅的 diff。

2.3 登录与账号切换

大多数界面需要 Claude 订阅或 Anthropic Console 账号，CLI 也支持第三方提供商（以官方文档为准）。
参考：https://code.claude.com/docs/en/overview

常用命令：

• /login：登录或切换账号
• /help：查看所有命令
• /resume：恢复最近会话

2.4 第一次启动前的“安全检查”

建议你在第一次把 Claude Code 用到真实项目之前，先做三件事：

• 确认仓库里没有敏感信息被误提交（.env、私钥、生产账号）
• 明确哪些目录可以改、哪些目录禁止改（例如：只改 src，不动 infra）
• 明确验收命令（必须能跑）：例如 npm test、mvn test、pytest

你会在第 9 章把这套安全与隐私基线系统化。

2.5 本章小结

你已经完成了三件关键的“起步动作”：

• 选择一种安装方式，并保证升级路径一致
• 在项目根目录启动 Claude Code
• 通过 /login、/help、/resume 掌握基本操作

下一章我们开始第一次实战：从一句话目标到一个可审阅的 diff。