欢迎使用 Claude Code！本教程将带你完成第一个完整的任务：从探索代码库、编写代码、运行测试，到提交修复。
第一步：打开 Claude Code
安装完成后，在任何项目目录中运行：
cd 你的项目目录
claude首次使用会提示你登录。登录成功后即可开始工作。
第二步：了解你的代码库
Claude Code 最强大的能力之一是能理解整个代码库。刚开始时，你可以让 Claude 先了解项目结构：
这个项目用了什么框架？主要结构是怎样的？Claude 会自动读取文件、搜索代码结构，然后给你一个项目概览。
第三步：用自然语言描述任务
不需要精确的提示词。直接告诉 Claude 你想做什么：
帮我给 utils.py 中的 parse_date 函数写单元测试Claude 会：
- 读取
utils.py理解parse_date的功能 - 查看已有的测试文件，了解测试风格
- 编写测试用例
- 运行测试验证
第四步：迭代和改进
如果第一次结果不理想，不需要重新开始。直接告诉 Claude 哪里不对：
这个测试用例没覆盖边界情况，当输入为空字符串时应该返回 NoneClaude 会调整方案，重新运行测试。这是一个对话过程，逐步完善。
第五步：提交更改
满意后，让 Claude 帮你提交：
提交这些更改，写一个描述性的提交信息Claude 会自动暂存更改、编写提交信息并创建 commit。
常用操作速查
| 操作 | 对 Claude 说 |
|---|---|
| 探索代码库 | "这个项目用了什么框架？" |
| 解释代码 | "解释一下 auth.py 里发生了什么" |
| 修复 Bug | "修好登录失败的问题" |
| 重构代码 | "把数据库查询提取成独立的模块" |
| 编写测试 | "给所有 API 端点写测试" |
| 生成文档 | "给这个模块写 API 文档" |
| 提交更改 | "提交我的更改" |
提示
- 第一次不需要完美的提示——从粗略描述开始，然后逐步细化
- 可以随时中断 Claude 并给它新的指引
- 用
/model可以切换不同模型（Sonnet 适合日常编码，Opus 适合复杂任务） - 用
/help查看所有可用命令