最近一段时间，Claude Code 确实在编程圈引发了巨大关注。作为一名深耕软件开发多年的从业者，看到这款 AI 编程助手快速崛起，内心颇多感慨——开发工具的迭代速度早已超乎想象，但越是这样，越需要我们静下心来系统掌握扎实的基础。今天，我们将官方完整中文文档重新整理，从头开始带你全面了解，读完你就能清楚它究竟能做什么、如何快速上手。
Claude Code 快速开始
欢迎使用 Claude Code！本快速开始指南将帮助您在短短几分钟内掌握 AI 驱动的编码辅助工具。学完之后，您将了解如何把它应用到日常开发任务中，显著提升效率。
开始之前
请确保您已准备好以下三项：
- 一个可用的终端或命令提示符窗口
- 已安装 Node.js 18 或更高版本
- 一个完整的编码项目（非空文件夹）
步骤 1：安装 Claude Code
安装命令极其简洁，一行即可完成：
npm install -g @anthropic-ai/claude-code
步骤 2：启动您的第一个对话
在项目根目录打开终端，然后输入：
cd /path/to/your/project claude
您将看到一个交互式提示符，界面大致如下：
✻ Welcome to Claude Code! ... > Try "create a util logging.py that..."
步骤 3：提出您的第一个问题
先别着急写代码，让 Claude 帮您快速摸清项目全貌。试试以下命令：
> 这个项目是做什么的？
Claude 会扫描您的文件结构并生成摘要。还可以进一步深入：
> 这个项目使用了哪些技术？
> 主入口点在哪里？
> 解释一下文件夹结构
顺便也可以询问它自身的能力：
> Claude Code 能做什么？
> 我如何在 Claude Code 中使用斜杠命令？
> Claude Code 可以与 Docker 一起工作吗？
注意：Claude Code 会自动根据需要读取文件——您无需手动上传上下文。它也能访问自身文档，直接回答关于功能的问题。
步骤 4：进行您的第一次代码更改
现在来点实际的。试试这个最基础的任务：
> 在主文件中添加一个 hello world 函数
Claude Code 会按以下流程工作：
- 找到合适的源文件
- 向您展示建议的更改
- 请求您的批准
- 然后执行编辑
关键点：修改文件之前它一定会征求您的同意。您可以逐个批准，也可以开启“全部接受”模式来加速。
步骤 5：在 Claude Code 中使用 Git
Git 操作在这里变成了一种对话式体验：
> 我更改了哪些文件？
> 提交我的更改并附上描述性消息
复杂操作也能轻松处理：
> 创建一个名为 feature/quickstart 的新分支
> 显示最近 5 次的提交
> 帮我解决合并冲突
步骤 6：修复错误或添加功能
调试和功能开发是 Claude 的强项。直接用自然语言描述您的需求：
> 为用户注册表单添加入口验证
或者直接告知一个已知问题：
> 有个bug，用户可以提交空表单 - 修复它
Claude Code 会自动定位相关代码、理解上下文、实现解决方案，如果项目包含测试，它还会顺手运行一下。
步骤 7：测试其他常见工作流程
您与 Claude 的协作方式非常多样化，以下列举几个高频场景：
重构代码
> 重构认证模块，使用 async/await 替代回调
编写测试
> 为计算器功能编写单元测试
更新文档
> 更新 README 文件并包含安装说明
代码审查
> 审查我的更改并提出改进建议
请牢记一条原则：Claude Code 就是您的 AI 结对编程伙伴。像与一位靠谱同事交流一样描述您要实现的目标，它会帮您一步步完成。
基本命令
日常使用中，以下几个核心命令务必熟练掌握：
| 命令 | 功能 | 示例 |
|---|---|---|
claude | 启动交互模式 | claude |
claude "task" | 运行一次性任务 | claude "fix the build error" |
claude -p "query" | 执行一次性查询后退出 | claude -p "explain this function" |
claude -c | 继续最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude commit | 创建 Git 提交 | claude commit |
/clear | 清除对话历史 | > /clear |
/help | 显示可用命令 | > /help |
exit 或 Ctrl+C | 退出 Claude Code | > exit |
初学者专业提示
尽量让请求具体明确
避免说“修复这个 bug”这样模糊的描述。不妨试试这种表达：
修复登录 bug，即用户在输入错误凭据后看到白屏的问题使用分步说明
复杂任务拆解成小块：
> 1. 为用户个人资料创建一个新的数据库表
> 2. 创建一个 API 端点以获取和更新用户个人资料
> 3. 构建一个允许用户查看和编辑其信息的网页
让 Claude 先探索一遍
动手改代码之前，先让 Claude 把项目摸清楚：
> 分析数据库模式
> 构建一个仪表板，显示我们英国客户最常退货的产品
善用快捷方式节省时间
- 按
Tab进行命令补全 - 按
↑查看命令历史 - 输入
/查看所有斜杠命令