快速开始
欢迎使用 Claude Code!
这个快速开始指南将让您在几分钟内使用AI驱动的编码辅助。完成后,您将了解如何使用 Claude Code 进行常见的开发任务。
开始之前
确保您有:
- 打开的终端或命令提示符
- 要使用的代码项目
- Claude.ai(推荐)或 Anthropic Console 账户
步骤 1:安装 Claude Code
NPM 安装
如果您已安装 Node.js 18 或更新版本:
原生安装
或者,尝试我们新的原生安装,现在处于测试阶段。
macOS、Linux、WSL:
Windows PowerShell:
Windows CMD:
步骤 2:登录您的账户
Claude Code 需要账户才能使用。当您使用 claude
命令启动交互式会话时,您需要登录:
您可以使用任一账户类型登录:
- Claude.ai(订阅计划 - 推荐)
- Anthropic Console(使用预付费积分的 API 访问)
登录后,您的凭据将被存储,您无需再次登录。
当您首次使用 Anthropic Console 账户验证 Claude Code 时,会自动为您创建一个名为”Claude Code”的工作区。此工作区为您组织中的所有 Claude Code 使用提供集中的成本跟踪和管理。
您可以在同一电子邮件地址下拥有两种账户类型。如果您需要再次登录或切换账户,请在 Claude Code 中使用 /login
命令。
步骤 3:开始您的第一个会话
在任何项目目录中打开终端并启动 Claude Code:
您将在新的交互式会话中看到 Claude Code 提示符:
登录后(步骤 2),您的凭据存储在您的系统上。在凭据管理中了解更多。
步骤 4:提出您的第一个问题
让我们从了解您的代码库开始。尝试以下命令之一:
Claude 将分析您的文件并提供摘要。您也可以提出更具体的问题:
您也可以询问 Claude 关于其自身功能的问题:
Claude Code 根据需要读取您的文件 - 您不必手动添加上下文。Claude 还可以访问其自己的文档,并可以回答有关其功能和能力的问题。
步骤 5:进行您的第一次代码更改
现在让我们让 Claude Code 进行一些实际的编码。尝试一个简单的任务:
Claude Code 将:
- 找到合适的文件
- 向您显示建议的更改
- 请求您的批准
- 进行编辑
Claude Code 在修改文件之前总是请求许可。您可以批准单个更改或为会话启用”全部接受”模式。
步骤 6:在 Claude Code 中使用 Git
Claude Code 使 Git 操作变得对话式:
您也可以提示更复杂的 Git 操作:
步骤 7:修复错误或添加功能
Claude 擅长调试和功能实现。
用自然语言描述您想要的内容:
或修复现有问题:
Claude Code 将:
- 定位相关代码
- 理解上下文
- 实现解决方案
- 如果可用,运行测试
步骤 8:测试其他常见工作流程
有多种方式与 Claude 一起工作:
重构代码
编写测试
更新文档
代码审查
记住:Claude Code 是您的 AI 结对程序员。像与有用的同事交谈一样与它交谈 - 描述您想要实现的目标,它将帮助您达到目标。
基本命令
以下是日常使用最重要的命令:
命令 | 作用 | 示例 |
---|---|---|
claude | 启动交互模式 | claude |
claude "任务" | 运行一次性任务 | claude "修复构建错误" |
claude -p "查询" | 运行一次性查询,然后退出 | claude -p "解释这个函数" |
claude -c | 继续最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude commit | 创建 Git 提交 | claude commit |
/clear | 清除对话历史 | > /clear |
/help | 显示可用命令 | > /help |
exit 或 Ctrl+C | 退出 Claude Code | > exit |
查看 CLI 参考 获取完整的命令列表。
初学者专业提示
下一步是什么?
现在您已经学会了基础知识,探索更高级的功能:
获取帮助
- 在 Claude Code 中:输入
/help
或询问”如何…” - 文档:您在这里!浏览其他指南
- 社区:加入我们的 Discord 获取提示和支持