跳转到主要内容
本快速开始指南将在几分钟内让您使用 AI 驱动的编码辅助。完成本指南后,您将了解如何使用 Claude Code 完成常见的开发任务。

开始前

确保您拥有:
本指南涵盖终端 CLI。Claude Code 也可在网页桌面应用VS CodeJetBrains IDESlack 中使用,以及通过 GitHub ActionsGitLab 进行 CI/CD。查看所有界面

步骤 1:安装 Claude Code

To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.

步骤 2:登录您的账户

Claude Code 需要账户才能使用。当您使用 claude 命令启动交互式会话时,您需要登录:
claude
# 首次使用时系统会提示您登录
/login
# 按照提示使用您的账户登录
您可以使用以下任何账户类型登录: 登录后,您的凭证将被存储,您无需再次登录。要稍后切换账户,请使用 /login 命令。

步骤 3:启动您的第一个会话

在任何项目目录中打开您的终端并启动 Claude Code:
cd /path/to/your/project
claude
您将看到 Claude Code 欢迎屏幕,其中包含您的会话信息、最近的对话和最新更新。输入 /help 查看可用命令,或输入 /resume 继续之前的对话。
登录后(步骤 2),您的凭证将存储在您的系统上。在凭证管理中了解更多信息。

步骤 4:提出您的第一个问题

让我们从理解您的代码库开始。尝试以下命令之一:
这个项目做什么?
Claude 将分析您的文件并提供摘要。您也可以提出更具体的问题:
这个项目使用什么技术?
主入口点在哪里?
解释文件夹结构
您也可以询问 Claude 关于其自身功能的问题:
Claude Code 能做什么?
我如何在 Claude Code 中创建自定义 skills?
Claude Code 可以与 Docker 一起工作吗?
Claude Code 根据需要读取您的项目文件。您不必手动添加上下文。

步骤 5:进行您的第一次代码更改

现在让我们让 Claude Code 进行一些实际的编码。尝试一个简单的任务:
在主文件中添加一个 hello world 函数
Claude Code 将:
  1. 找到适当的文件
  2. 向您显示建议的更改
  3. 请求您的批准
  4. 进行编辑
Claude Code 在修改文件前始终请求许可。您可以批准单个更改或为会话启用”全部接受”模式。

步骤 6:在 Claude Code 中使用 Git

Claude Code 使 Git 操作变得对话式:
我更改了哪些文件?
用描述性消息提交我的更改
您也可以提示更复杂的 Git 操作:
创建一个名为 feature/quickstart 的新分支
显示我最后的 5 次提交
帮我解决合并冲突

步骤 7:修复错误或添加功能

Claude 擅长调试和功能实现。 用自然语言描述您想要的内容:
向用户注册表单添加输入验证
或修复现有问题:
有一个错误,用户可以提交空表单 - 修复它
Claude Code 将:
  • 定位相关代码
  • 理解上下文
  • 实现解决方案
  • 如果可用,运行测试

步骤 8:尝试其他常见工作流

有多种方式可以与 Claude 一起工作: 重构代码
重构身份验证模块以使用 async/await 而不是回调
编写测试
为计算器函数编写单元测试
更新文档
使用安装说明更新 README
代码审查
审查我的更改并建议改进
像与有帮助的同事交谈一样与 Claude 交谈。描述您想要实现的目标,它将帮助您实现。

基本命令

以下是日常使用中最重要的命令:
命令功能示例
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 Codeexit
有关完整的命令列表,请参阅 CLI 参考

初学者专业提示

有关更多信息,请参阅最佳实践常见工作流
不要说:‘修复错误’尝试:‘修复登录错误,用户输入错误凭证后看到空白屏幕’
将复杂任务分解为步骤:
1. 为用户配置文件创建新的数据库表
2. 创建 API 端点以获取和更新用户配置文件
3. 构建允许用户查看和编辑其信息的网页
在进行更改之前,让 Claude 理解您的代码:
分析数据库架构
构建一个仪表板,显示英国客户最常退货的产品
  • ? 查看所有可用的快捷键
  • 使用 Tab 进行命令补全
  • 按 ↑ 查看命令历史
  • 输入 / 查看所有命令和 skills

接下来呢?

现在您已经学习了基础知识,探索更多高级功能:

Claude Code 如何工作

了解代理循环、内置工具以及 Claude Code 如何与您的项目交互

最佳实践

通过有效的提示和项目设置获得更好的结果

常见工作流

常见任务的分步指南

扩展 Claude Code

使用 CLAUDE.md、skills、hooks、MCP 等进行自定义

获取帮助

  • 在 Claude Code 中:输入 /help 或询问「我如何…」
  • 文档:您在这里!浏览其他指南
  • 社区:加入我们的 Discord 获取提示和支持