Claude Code 使用教程:从安装到实战开发
这篇教程带你完整走一遍:安装 Claude Code、完成登录、在真实项目里跑通第一个任务,并形成可持续的开发流程。
如果你还不清楚它是什么,建议先读 Claude Code 是什么?。
一、前置条件
Section titled “一、前置条件”- 安装了 Node.js(建议 LTS 版本)
- 一个 Anthropic 账号与可用凭证
- 基本命令行与 Git 使用经验
-
检查 Node 环境:
Terminal window node -v -
全局安装 Claude Code:
Terminal window npm install -g @anthropic-ai/claude-code -
验证:
Terminal window claude --version
三、登录与初始化
Section titled “三、登录与初始化”在项目目录中首次运行,按提示完成登录:
cd my-projectclaude首次进入会引导你完成认证。建议在项目根目录运行,让它能正确读取代码结构。
四、跑通第一个任务
Section titled “四、跑通第一个任务”进入交互界面后,直接用自然语言描述需求:
读取 src/utils/date.ts,给 formatDate 补充边界情况的单元测试,使用项目现有的测试框架,保持现有风格。它会读取相关文件、给出方案、在你确认后修改代码并可运行测试。
五、形成实战开发流程
Section titled “五、形成实战开发流程”把单次使用变成可靠的工作方式,关键在流程:
-
先提交再动手:
Terminal window git add -A && git commit -m "chore: 保存进度" -
小步下达任务:一次一个清晰目标,验证后再继续。
-
让它先给方案:复杂任务先要思路,确认方向再实现。
-
运行测试验证:让它跑测试或你手动验证,把改动当待 Review 代码。
-
沉淀规范:把高频要求写进
CLAUDE.md或 Prompt 模板。
六、常见问题(FAQ)
Section titled “六、常见问题(FAQ)”安装后提示找不到命令?
Section titled “安装后提示找不到命令?”通常是 npm 全局 bin 不在 PATH。检查全局安装路径并加入环境变量后重开终端。
它能记住整个项目吗?
Section titled “它能记住整个项目吗?”它会按需读取文件,并参考你提供的项目说明(如 CLAUDE.md)。把关键约定写下来比口头反复说更可靠。
改坏了怎么办?
Section titled “改坏了怎么办?”这正是坚持用 Git 的原因。git restore 或回退到上一次提交即可恢复。
任务太大它做不好?
Section titled “任务太大它做不好?”把任务拆小。一次让它实现一整个系统,难验证也容易出错。