5 分钟第一个任务

5 分钟第一个任务

装好了、登好了，这一页让 Claude Code 真的帮你干点活。跟着官方 quickstart 走，5 分钟跑通。

启动

cd /path/to/your/project
claude

cd 进你的项目，敲 claude。看到提示符 > 就准备好了。注意：Claude Code 默认只对你 cd 进来的目录有读写权限，别在 ~ 根目录直接敲 claude——它不知道你要干啥。

第一个问题：让 Claude 介绍你的项目

> what does this project do?

回车。Claude Code 会扫一遍目录、读 README、看入口文件，然后给你一份「这个项目是干嘛的、技术栈、入口在哪」的简介。

这一步很重要——先让 Claude 探索，再让它动手。它脑子里有了地图，后面改代码才不会瞎改。

第一个改动：加个 hello world

> add a hello world function to the main file

Claude Code 接下来会做这几件事，每一步都让你看到：

1. 找文件：读目录结构，定位「main file」是哪个（比如 src/index.ts）
2. 看现有代码：匹配现有风格——你用 function 它就用 function，你用箭头函数它就用箭头函数
3. 显示改动：用 diff 格式把要改的几行高亮出来
4. 等批准：弹一个 Yes/No 提示
5. 执行：你按 Yes，它才真的写进文件

这是 Claude Code 跟「无脑 AI 改代码」最大的区别——它不会偷偷改你的代码。每次动文件都先给你看，你点头了才动。

让 Claude 帮你 Git

接下来试试 git 操作：

> what files have I changed?

它会跑 git status，告诉你改了哪些文件、哪些是 staged、哪些没 stage。

> commit my changes

它会读 diff、自动生成一条符合 Conventional Commits 风格的 commit message，给你看一眼，按 Yes 才真的提交。

如果 commit message 你不满意，直接说「换个风格，写得更简洁」，它会重写。

修个 Bug

> add input validation to the user registration form

Claude Code 会去找注册表单在哪、看现有的校验长什么样、按相同风格补一个邮箱格式校验。改完还会顺手跑一遍相关测试，告诉你「测试 23 条全过」或者「测试挂了一条，要不要我修」。

这是它跟 Copilot 的本质差别——你描述意图，它自己跑一圈把活干完。

还能干啥

官方 quickstart 列了一串你能让它干的事：

• 重构：「refactor this function to be more readable」
• 写测试：「add unit tests for the auth module」
• 改文档：「update the README to reflect the new CLI」
• 代码审查：「review my recent changes」
• 解释报错：贴一段 stack trace，问「why is this failing?」

常用命令速查

命令	作用
claude	启动交互会话
claude "do X"	启动 + 直接给任务
claude -p "explain X"	一次性查询（headless）
claude -c	继续最近会话
claude -r <session-id>	恢复某个会话
claude commit	自动生成 commit message
/clear	清空对话历史（省 token）
/help	显示所有命令

新手技巧

1. 要具体，别含糊

❌ 「fix the bug」——什么 bug？哪个文件？ ✅ 「fix the null pointer in src/auth.ts line 42, the user object can be undefined」

越具体，Claude 越不用瞎猜，准确率越高。

2. 分步骤，别一次塞太多

❌ 「重构整个 auth 模块、加测试、改文档、提 PR」 ✅ 先「重构 auth 模块」→ 跑通 → 再「加测试」→ 跑通 → 再「改文档」

每步小、每步验证，比一次性大改动靠谱得多。

3. 先让 Claude 探索

动手前先问一句「explore this codebase and tell me how X works」。它探索完会主动问你要不要动手。这比直接喊「改 X」准多了。

4. 用 Tab 补全

打字时按 Tab 能补全文件路径、命令名。打 @ 能引用文件：

> fix the bug in @src/auth.ts

@ 会触发文件选择器，不用手敲路径。

5. Esc Esc 回退

改坏了？连按两次 Esc，回退 Claude 的上一个改动。再按两次，再退一步。这是你的安全绳。

一句话总结

先让它探索，再让它动手；每步都给你看，你点头了它才动。

下一站，去 IDE 集成 看看怎么把 Claude Code 接到 VSCode/JetBrains 里。🚀