Claude Code 安装与第一个项目

背景与动机#

第一次使用 Claude Code，不要急着让它做大需求。更稳的入口是选择一个小项目，让它先完成“读懂项目 -> 做一个小改动 -> 运行验证”的最小闭环。

这样可以同时确认三件事：

• 本地环境是否可用。
• Claude Code 能否正确读取项目规则。
• 项目里的测试、构建、启动命令是否能跑通。

基础准备#

进入项目根目录前，先确认这些信息：

1
pwd
2
git status --short
3
ls

重点看：

• 当前目录是不是项目根目录。
• 工作区是否已经有未提交改动。
• 是否存在 README、package.json、go.mod、pyproject.toml、AGENTS.md、CLAUDE.md 等入口文件。

如果工作区本来就有改动，要先告诉 Claude Code：

1
当前工作区可能有用户未提交改动。不要回滚、覆盖或清理不属于本次任务的文件。

第一次让 Claude Code 读项目#

建议先用只读任务建立上下文：

1
请先阅读项目根目录规则、README、依赖配置和主要目录结构。
2
只总结项目技术栈、启动方式、测试方式和内容目录，不要修改文件。

输出应该能回答：

• 这是一个什么项目。
• 主要代码放在哪里。
• 常用命令是什么。
• 内容、配置、测试分别在哪里。

如果它一开始就想改文件，说明任务边界还不够清楚，需要马上纠正。

第一个小任务怎么选#

适合作为第一次任务的改动：

• 修复一个明显拼写。
• 补充一小段文档。
• 调整一个局部样式。
• 给已有函数补一个缺失测试。

不适合第一次任务的改动：

• 大规模重构。
• 数据迁移。
• 部署配置改造。
• 涉及外部服务写入。
• 多页面交互系统。

最小闭环示例#

可以这样下任务：

1
请在不改动功能逻辑的前提下，修复 README 中明显过期的启动命令。
2
先读取 package.json 和 README，确认真实命令。
3
只修改 README 相关段落。
4
完成后说明改了什么，并运行不会写文件的校验命令。

这个任务小，但包含了完整工程链路：

1
读取证据 -> 判断差异 -> 修改文档 -> 验证 -> 汇报

常见陷阱#

• 在错误目录启动，导致 Claude Code 读到无关项目。
• 忽略已有工作区改动，误把用户改动当成自己的上下文。
• 第一次就给大型需求，排查问题时缺少基线。
• 只让它“看一下”，但没有要求输出项目启动和验证方式。

最小练习任务#

可以照这个顺序练：

1
练习 1：让 Claude Code 只读项目，不改文件，输出项目结构。
2
练习 2：让 Claude Code 找出项目里的测试和构建命令。
3
练习 3：让 Claude Code 修复一处文档里的明显错误。
4
练习 4：让 Claude Code 运行校验命令并总结结果。

每一步都要检查它是否遵守“不改无关文件”和“修改后验证”。

一句话总结#

第一次使用 Claude Code 的目标不是追求复杂任务，而是确认它能在当前项目里稳定完成一个小而完整的工程闭环。