Skip to content

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 的工作流程:

  1. 找到相关文件
  2. 展示准备做的修改(diff)
  3. 请求你确认
  4. 你批准后执行修改

改文件前一定会问你

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 信息并提交

下一步:基础使用——3 种运行模式和更多技巧

基于官方文档整理,持续更新