快速入门

欢迎使用 Claude Code！

本快速入门指南将在几分钟内让您使用 AI 驱动的编码辅助。完成后，您将了解如何使用 Claude Code 完成常见的开发任务。

开始前

确保您拥有：

• 打开的终端或命令提示符
• 一个要处理的代码项目
• 一个 Claude.ai（推荐）或 Claude Console 账户

步骤 1：安装 Claude Code

To install Claude Code, use one of the following methods:

```bash  theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

**Windows PowerShell:**

```powershell  theme={null}
irm https://claude.ai/install.ps1 | iex
```

**Windows CMD:**

```batch  theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

```sh  theme={null}
npm install -g @anthropic-ai/claude-code
```

步骤 2：登录您的账户

Claude Code 需要账户才能使用。当您使用 claude 命令启动交互式会话时，您需要登录：

`bash theme={null}
claude

首次使用时系统会提示您登录

```bash  theme={null}
/login
# 按照提示使用您的账户登录

您可以使用以下任一账户类型登录：

• Claude.ai（订阅计划 - 推荐）
• Claude Console（使用预付费额度的 API 访问）

登录后，您的凭证将被存储，您无需再次登录。

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

在任何项目目录中打开您的终端并启动 Claude Code：

`bash theme={null}
cd /path/to/your/project
claude

您将看到 Claude Code 欢迎屏幕，其中包含您的会话信息、最近的对话和最新更新。输入 `/help` 查看可用命令或输入 `/resume` 继续之前的对话。

<Tip>
  登录后（步骤 2），您的凭证将存储在您的系统上。在 [凭证管理](/zh-CN/iam#credential-management) 中了解更多信息。
</Tip>

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

让我们从了解您的代码库开始。尝试以下命令之一：

what does this project do?
`

Claude 将分析您的文件并提供摘要。您也可以提出更具体的问题：

> what technologies does this project use?

> where is the main entry point?

> explain the folder structure

您也可以询问 Claude 它自己的功能：

> what can Claude Code do?

> how do I use slash commands in Claude Code?

> can Claude Code work with Docker?

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

现在让我们让 Claude Code 进行一些实际的编码。尝试一个简单的任务：

> add a hello world function to the main file

Claude Code 将：

1. 找到合适的文件
2. 向您显示建议的更改
3. 请求您的批准
4. 进行编辑

步骤 6：在 Claude Code 中使用 Git

Claude Code 使 Git 操作变得对话式：

> what files have I changed?

> commit my changes with a descriptive message

您也可以提示更复杂的 Git 操作：

> create a new branch called feature/quickstart

> show me the last 5 commits

> help me resolve merge conflicts

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

Claude 擅长调试和功能实现。

用自然语言描述您想要的内容：

> add input validation to the user registration form

或修复现有问题：

> there's a bug where users can submit empty forms - fix it

Claude Code 将：

• 定位相关代码
• 理解上下文
• 实现解决方案
• 如果可用，运行测试

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

有许多方式可以与 Claude 合作：

重构代码

> refactor the authentication module to use async/await instead of callbacks

编写测试

> write unit tests for the calculator functions

更新文档

> update the README with installation instructions

代码审查

> review my changes and suggest improvements

基本命令

以下是日常使用中最重要的命令：

有关完整的命令列表，请参阅 CLI 参考。

初学者专业提示

尝试这样说："fix the login bug where users see a blank screen after entering wrong credentials"

```
> 1. create a new database table for user profiles
```

```
> 2. create an API endpoint to get and update user profiles
```

```
> 3. build a webpage that allows users to see and edit their information
```

```
> analyze the database schema
```

```
> build a dashboard showing products that are most frequently returned by our UK customers
```

接下来呢？

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

获取帮助

• 在 Claude Code 中：输入 /help 或询问”how do I…”
• 文档：您在这里！浏览其他指南
• 社区：加入我们的 Discord 获取提示和支持

To find navigation and other pages in this documentation, fetch the llms.txt file at: https://code.claude.com/docs/llms.txt