展开知识库目录
AI + 编程开发

Claude Code 第一次任务:进项目目录、让它先读再改

Claude Code 在项目目录里运行,按需读取文件。第一次任务先进到要处理的项目,让它先介绍项目结构和构建方式,再提一个具体的小改动,改完自己打开文件核对。

Claude Code 入门含可复制模板更新 2026-08-13
先说结论

安装后进入项目目录再启动

你大概是第一次用 Claude Code,它和普通聊天不一样:你得先进入项目目录,它才能看到你的文件。第一次任务同样选小的:先进目录,让它介绍项目结构和构建命令,再提一个具体小改动。

记住一个最容易踩的坑:别在错误目录启动。先 cd 到项目根,再运行 claude;改完自己打开文件或页面核对,别只听它说“完成了”。

使用边界

这些情况适合用,另外几种先停一下

适合用
  • 第一次安装和使用 Claude Code
  • 有一个明确的小改动,希望 AI 直接进项目执行
  • 想评估 Claude Code 和 Codex 哪个顺手
先别急着用
  • 还没进入项目目录就让它“读我的项目”
  • 任务涉及未备份的关键数据或生产环境
照着做

进项目目录盘点结构,再提带边界的小任务,改完跑命令验收

为什么这样安排

Anthropic 官方首日教程(Your first day in Claude Code)建议从改代码、运行命令开始,先小后大;这里把官方建议翻译成四个可勾选的步骤。

  1. 01

    安装并进目录

    运行 npm install -g @anthropic-ai/claude-code,cd 到项目根目录,运行 claude 并确认 pwd 正确。

  2. 02

    先盘点再动手

    让 Claude 介绍项目、给出构建和测试命令,并检查 CLAUDE.md / .claude/rules 里的规矩。

  3. 03

    提带边界的小任务

    任务写成“只改 X 文件,做 Y,其他不动”,避免 AI 顺手改别处。

  4. 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 文件,其他文件一律不动”。

运行命令失败但说完成了

常见原因
没有把运行结果当验收项
怎么修
要求改完必须运行构建/测试并粘贴输出,输出不对就不算完成。
交付前检查

最后五分钟,逐项打勾

参考资料

这篇具体参考了什么

正文按公开教程和官方文档重新整理,并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新,真正执行前请再打开原始页面核对一次。