02 · 安装与让它读懂代码库
01-Claude Code 是什么 ｜ 下一篇 → 03-添加功能
安装
# 方式一：npm 全局安装（需 Node 18+）
npm install -g @anthropic-ai/claude-code
# 方式二：官方安装脚本（macOS/Linux）
curl -fsSL https://claude.ai/install.sh | bash
# 启动（在你的项目根目录）
cd your-project
claude
- 首次启动会引导登录（Claude 订阅账号或 API key 两种计费方式）。
- 运行在项目根目录很关键——它的工作范围就是当前目录。
第一件事：/init 生成 CLAUDE.md
> /init
/init 让 Claude 通读你的代码库，自动生成一份 CLAUDE.md：项目结构、技术栈、构建/测试命令、代码约定。
CLAUDE.md 是什么、为什么重要
- 它是每次对话自动加载的「项目说明书」，相当于给 Claude 的长期记忆。
- 写得好 = Claude 少犯错、少问废话、风格更贴合你的项目。
- 典型内容：
# 项目说明
- 技术栈：FastAPI + React + PostgreSQL
- 启动后端：`uvicorn app.main:app --reload`
- 跑测试：`pytest -q`
- 约定：所有 API 返回 snake_case；组件用函数式 + hooks
- 不要改：`legacy/` 目录下的代码
💡 经验：
/init生成后手动精修——补上「跑测试的命令」「不要碰的目录」「命名约定」，收益最大。
让它读懂大型代码库的技巧
- 指文件，别让它瞎找：用
@引用文件，例如给 @app/api/orders.py 的列表接口加分页 - 先让它探索再动手：
先读一遍 src/auth/ 目录，告诉我登录流程是怎么走的 - 善用斜杠命令：
-
/init初始化项目说明 -/clear清空上下文（换任务时用，省 token、防串味） -/context或/compact管理上下文窗口 -/help看所有命令
上下文管理 = 智能体编程的核心技能
- 上下文窗口有限，塞太多无关内容会让它变笨。
- 换一个不相关的新任务时，先
/clear。 - 长会话变慢/跑偏时，用
/compact压缩历史。 - 只喂当前任务需要的文件。
本节实操
- 在自己项目里
claude→/init - 手动精修
CLAUDE.md：补「跑测试命令」+「不要碰的目录」 - 用
@文件让它解释一段你不熟的代码
下一篇 → 03-添加功能