第1篇：日常开发流 — 从打开项目到提交代码

前置知识：已安装 Node.js 18+ 和 npm
学习时长：约 15 分钟

你将学到什么

• 在不同终端中正确启动 Claude Code
• 用 @ 引用文件和 # 引用代码符号
• 让 Claude Code 完成一次完整的代码修改
• 通过 Claude Code 提交 git commit
• 掌握日常开发流的完整闭环

---

1. 启动 Claude Code

在项目目录中启动

打开终端（CMD 或 Git Bash），进入你的 Android 项目目录：

cd D:/working/pancoit/learning/documents
claude

⚠️ 注意：如果你使用 PowerShell，可能会遇到执行策略限制。此时切换到 CMD 或 Git Bash 是最快的解决方法。详见仓库中的 006-Claude Code在power shell运行异常.md。

恢复上次会话

如果之前的工作没做完，用 --resume 恢复：

claude --resume

Claude Code 会自动恢复最近一次会话。如果需要指定某个历史会话：

claude --resume <session-id>

会话 ID 可以从 ~/.claude/sessions/ 目录中找到。

---

2. 快速上手：让 Claude 理解你的项目

2.1 用 CLAUDE.md 告诉 Claude 项目背景

Claude Code 启动后会自动读取项目根目录的 CLAUDE.md 文件。来看一个实际例子，这是本项目中的 CLAUDE.md 配置：

# CLAUDE.md

## Repository Overview
This is a personal documentation repository for Android development learning...

## Directory Structure
documents/
├── AI/              # AI tools and Claude Code setup documentation
├── Android/         # Android-specific technical notes
├── pan/             # Personal work-related documentation

有了这个文件，Claude 一开始就知道你的项目结构、技术栈和文档规范，不需要每次重复说明。

2.2 @ 引用文件 — 精确指定目标

当你想让 Claude 处理某个具体文件时，用 @ 直接引用：

请帮我修改 @ClaudeCode/002-Claude Code常用命令及作用.md，在表格中新增 /config 命令

Claude Code 会自动找到这个文件并读取内容。你不需要提供完整路径，只要文件名足够唯一即可。

2.3 # 引用符号 — 定位代码/方法

在 Android 项目中，用 # 引用类名或方法名：

请帮我看看 #MainActivity 中的 onCreate 方法

这对大型 Android 项目尤其有用——不需要自己翻文件定位行号。

---

3. 实战场景：一次完整的修改流程

我们现在模拟一个真实场景：在一个 Android 项目中，修改 MainActivity 的标题并新增一个按钮点击事件。

步骤 1：先问清楚需求

# 先用 Glob 工具找到相关文件
请帮我找一下项目中的 MainActivity 文件

Claude Code 会自动调用 Glob 工具搜索：

🔍 使用 Glob 搜索 **/*MainActivity*...
找到 D:/project/app/src/main/java/com/example/MainActivity.kt

步骤 2：读取并理解代码

请读取 @MainActivity.kt，帮我分析这个文件的结构

Claude Code 会读取文件内容，然后给你一个结构化的分析结果：

📄 MainActivity.kt 结构分析：
├── onCreate() - 设置布局，初始化 Toolbar
├── initToolbar() - 配置标题和导航
├── setupListeners() - 绑定按钮点击事件
└── onDestroy() - 清理资源

步骤 3：明确修改指令

关键技巧：一次性说清楚要改什么，而不是分段对话。

请帮我修改 MainActivity.kt：
1. 把 Toolbar 标题改为 "我的主页"
2. 在 layout 中新增一个 FAB 按钮
3. 点击按钮时弹出一个 Snackbar，内容为 "欢迎回来"

Claude Code 会：

1. 用 Edit 工具修改 MainActivity.kt
2. 同时修改对应的 activity_main.xml 布局文件
3. 显示修改前后的 diff

步骤 4：验证结果

帮我检查修改后的文件，确保没有语法错误

Claude 会重新读取修改后的文件，检查 import 是否完整、语法是否正确。对于 Kotlin 文件，它会特别注意空安全、协程等常见问题。

💡 最佳实践：每次让 Claude 修改后，养成立即验证的习惯。可以要求它"检查一遍修改"，避免遗漏。

---

4. 提交代码

修改完成后，直接让 Claude Code 帮你提交：

/commit

Claude Code 会自动：

1. 执行 git diff 查看所有改动
2. 执行 git status 检查文件状态
3. 分析改动的性质并生成合适的 commit message
4. 等待你确认后再执行提交

手动提交的替代方案

如果你想自己控制提交过程，也可以：

请帮我执行 git add 和 git commit，提交信息为：更新 MainActivity 布局，新增 FAB 按钮和点击事件

---

5. 日常开发流全景图

一次完整的日常开发闭环如下：

打开项目 → claude 启动 → @引用文件 → 描述需求 → 
Claude 修改代码 → 验证修改 → /commit 提交 → 继续下一个任务

这个流程覆盖了从"打开项目"到"提交代码"的完整过程。习惯之后，一次代码修改从需求到提交只需要 2-3 分钟。

---

快速回顾

要点	内容
启动命令	claude（项目目录下）
恢复会话	claude --resume
引用文件	@文件名
引用符号	#类名/方法名
提交代码	/commit
核心原则	一次性说清楚需求，减少来回对话

---

延伸阅读

• 上一篇：无（系列开篇）
• 下一篇：第2篇-核心工具实战

---

📌 下篇预告：深入 Glob/Grep/Read/Edit/Bash 五大工具，结合 Android 项目实例，教你高效搜索代码、批量重构、运行 Gradle 命令。