展开知识库目录
Claude Code 第一次任务:进项目目录、让它先读再改
Claude Code 在项目目录里运行,按需读取文件。第一次任务先进到要处理的项目,让它先介绍项目结构和构建方式,再提一个具体的小改动,改完自己打开文件核对。
安装后进入项目目录再启动
你大概是第一次用 Claude Code,它和普通聊天不一样:你得先进入项目目录,它才能看到你的文件。第一次任务同样选小的:先进目录,让它介绍项目结构和构建命令,再提一个具体小改动。
记住一个最容易踩的坑:别在错误目录启动。先 cd 到项目根,再运行 claude;改完自己打开文件或页面核对,别只听它说“完成了”。
这些情况适合用,另外几种先停一下
适合用
- 第一次安装和使用 Claude Code
- 有一个明确的小改动,希望 AI 直接进项目执行
- 想评估 Claude Code 和 Codex 哪个顺手
先别急着用
- 还没进入项目目录就让它“读我的项目”
- 任务涉及未备份的关键数据或生产环境
进项目目录盘点结构,再提带边界的小任务,改完跑命令验收
为什么这样安排
Anthropic 官方首日教程(Your first day in Claude Code)建议从改代码、运行命令开始,先小后大;这里把官方建议翻译成四个可勾选的步骤。
- 01
安装并进目录
运行 npm install -g @anthropic-ai/claude-code,cd 到项目根目录,运行 claude 并确认 pwd 正确。
- 02
先盘点再动手
让 Claude 介绍项目、给出构建和测试命令,并检查 CLAUDE.md / .claude/rules 里的规矩。
- 03
提带边界的小任务
任务写成“只改 X 文件,做 Y,其他不动”,避免 AI 顺手改别处。
- 04
跑命令并核对文件
改完要求运行构建/测试并粘贴输出,你再亲自打开改动文件,两项通过才算完成。
复制前先替换 {占位}
Claude Code 第一次任务提示词(复制后改 {占位})
我刚进入这个项目,想用一个小任务确认 Claude Code 工作正常。项目当前目录:{当前目录}
请先做:
1. 用两三句话介绍这个项目是干什么的、目录结构大概什么样;
2. 告诉我项目的构建命令和测试命令(看 package.json / README);
3. 有没有 CLAUDE.md 或 .claude/rules 规则文件,有就总结里面最关键的规矩。
然后完成这个小任务:{一句话任务,例如“把 README 标题下的副标题改成 X”}
要求:只改完成任务必需的文件,改完运行{构建/测试命令}并把结果贴给我。Claude Code 第一次任务记录(示例)
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置,别把示例数据原样交出去。
看清格式再改
Claude Code 第一次任务记录(示例)
安装:npm install -g @anthropic-ai/claude-code 启动:cd ~/my-project && claude 盘点:项目是静态站点;构建 npm run build;测试 npm test 规则:无 CLAUDE.md,建议后续补一个 任务:把 docs/index.md 标题下加一行版本说明 验收:npm run build 退出码 0;已打开 docs/index.html 核对
先对症状,别一上来重写整段提示词
claude 提示没有权限
- 常见原因
- 首次使用需要登录授权
- 怎么修
- 运行 claude 按提示登录;企业代理环境还要检查 ANTHROPIC_BASE_URL。
它改了不该改的文件
- 常见原因
- 没写边界
- 怎么修
- 任务里明确“只改 X 文件,其他文件一律不动”。
运行命令失败但说完成了
- 常见原因
- 没有把运行结果当验收项
- 怎么修
- 要求改完必须运行构建/测试并粘贴输出,输出不对就不算完成。
最后五分钟,逐项打勾
这篇具体参考了什么
原始资料Anthropic:Claude Code 首日
安装、登录、进项目目录的官方顺序
原始资料Claude Code 快速开始官方快速入门文档
原始资料claude-howto-zh-cn面向中文新手的 Claude Code 指南
正文按公开教程和官方文档重新整理,并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新,真正执行前请再打开原始页面核对一次。
