5. 快速开始:5 分钟第一次体验
本章你将学到
- 如何在你的项目中启动第一次 Claude Code 会话
- 最基础的 5 个操作
- 新手最高价值的 5 个技巧
第 1 步:启动会话
进入你的项目目录,然后启动 Claude Code:
bash
cd /path/to/your/project # 进入你的项目
claude # 启动交互式会话启动后你会看到一个对话界面,Claude Code 会扫描当前目录,准备好回答你的问题。
没有现成项目?
可以先新建一个空目录试试:
bash
mkdir my-test && cd my-test
claude第 2 步:问一个问题
在提示符后直接输入,中英文都可以:
what does this project do?
这个项目是做什么的?
主入口在哪里?
解释一下 src/auth/login.ts 的逻辑Claude 会自己决定读取哪些文件,然后给出回答。你不需要手动告诉它要读哪些文件。
第 3 步:让它改代码
在 main.js 里加一个 hello world 函数
修复登录表单能提交空值的 bug
给用户注册表单加输入验证Claude 的工作流程:
- 找到相关文件
- 展示准备做的修改(diff)
- 请求你确认
- 你批准后执行修改
改文件前一定会问你
Claude Code 修改文件前一定会先展示改动并等待你确认。你可以批准单个改动,也可以开启「全部接受」模式(权限模式)。
第 4 步:用它操作 Git
我改了哪些文件?
把我的修改提交,附上描述性的 commit 信息
新建分支 feature/quickstart
帮我解决 merge conflict第 5 步:退出
bash
exit # 输入 exit
# 或按 Ctrl+D下次进入同一目录后,运行 claude -c 即可继续刚才的对话。
新手 5 个黄金技巧
技巧 1:描述要具体
Claude 给出的结果质量直接取决于你提示词的质量。
| 模糊(差) | 具体(好) |
|---|---|
| 修复登录 bug | 修复登录后显示空白屏幕的 bug,入口在 src/auth/login.ts |
| 让代码更好 | 把 src/utils/format.js 里所有 var 改成 const,保持功能不变 |
| 加个功能 | 给 UserProfile 组件加一个「编辑头像」按钮,点击后打开文件选择器 |
技巧 2:拆分复杂任务
不要一次给太多:
# 不好:一次性描述全部
做一个用户管理系统,包括登录、注册、权限管理……
# 好:分步骤
第一步:先给用户表设计数据库 schema
第二步:做 GET/POST /users 的 API
第三步:做一个用户列表前端页面技巧 3:先让它探索,再让它动手
对陌生代码库,先观察,再改动:
# 先探索(不会修改任何东西)
阅读 src/auth/ 目录,理解我们是怎么处理 session 和登录的
# 再规划
我想加 Google OAuth。需要改哪些文件?做个计划
# 最后实施
按刚才的计划实现技巧 4:不会用就问它自己
Claude Code 怎么创建自定义命令?
CLAUDE.md 里应该写什么?
怎么让你自动跑测试后再提交?技巧 5:善用快捷键
| 快捷键 | 功能 |
|---|---|
Esc | 立即打断 Claude 的当前动作 |
Esc Esc | 回滚到上一个检查点 |
Shift+Tab | 循环切换权限模式 |
? | 查看所有快捷键 |
/ | 查看所有可用命令 |
完整的新手工作流示例
bash
# 1. 进入项目,启动会话
cd ~/projects/my-app
claude
# 2. 理解项目
> 这个项目是做什么的?用了哪些技术栈?
# 3. 让 Claude 探索具体问题
> 我想修复用户登录后看到 404 的 bug,帮我找到相关代码
# 4. 让它先规划再动手
> 先规划修复方案,不要急着改代码
# 5. 确认方案后实施
> 方案看起来不错,帮我实现,改完跑一下测试
# 6. 提交
> 写一个描述性的 commit 信息并提交