快速开始

欢迎使用 Claude Code！

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

开始前

确保你拥有：

打开的终端或命令提示符
一个可以使用的代码项目
一个 Claude 订阅（Pro、Max、Teams 或 Enterprise）、Claude Console 账户，或通过支持的云提供商的访问权限

TIP

本指南涵盖终端 CLI。Claude Code 也可在网页、桌面应用、VS Code 和 JetBrains IDE、Slack 中使用，以及通过 GitHub Actions 和 GitLab 进行 CI/CD。

步骤 1：安装 Claude Code

原生安装（推荐）：

macOS、Linux、WSL：

bash

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

powershell

irm https://claude.ai/install.ps1 | iex

Homebrew：

bash

brew install --cask claude-code

WinGet：

winget install Anthropic.ClaudeCode

原生安装会在后台自动更新，始终保持最新版本。

步骤 2：登录你的账户

Claude Code 需要账户才能使用。启动交互式会话时，系统会提示你登录：

bash

claude
# 首次使用时系统会提示你登录

/login
# 按照提示使用你的账户登录

你可以使用以下任何账户类型登录：

Claude Pro、Max、Teams 或 Enterprise（推荐）
Claude Console（具有预付费额度的 API 访问）
Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry（企业云提供商）
第三方 API 提供商（如 WhatyAI、OpenRouter，无需翻墙）

登录后，你的凭证将被存储，无需再次登录。要稍后切换账户，请使用命令。

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

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

bash

cd /path/to/your/project
claude

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

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

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

这个项目做什么？

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

这个项目使用什么技术？
主入口点在哪里？
解释文件夹结构

Claude Code 根据需要读取你的项目文件，你不必手动添加上下文。

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

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

在主文件中添加一个 hello world 函数

Claude Code 将：

找到适当的文件
向你显示建议的更改
请求你的批准
进行编辑

Claude Code 在修改文件前始终请求许可。你可以批准单个更改或为会话启用全部接受模式。

步骤 6：在 Claude Code 中使用 Git

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

我更改了哪些文件？
用描述性消息提交我的更改
创建一个名为 feature/quickstart 的新分支
显示我最后的 5 次提交
帮我解决合并冲突

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

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

向用户注册表单添加输入验证

或修复现有问题：

有一个错误，用户可以提交空表单 - 修复它

Claude Code 将定位相关代码、理解上下文、实现解决方案，并在可用时运行测试。

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

# 重构代码
重构身份验证模块以使用 async/await 而不是回调

# 编写测试
为计算器函数编写单元测试

# 更新文档
使用安装说明更新 README

# 代码审查
审查我的更改并建议改进

基本命令

命令	功能	示例
	启动交互模式
你好！请问有什么任务需要我帮你处理？	运行一次性任务	这个目录里没有明显的项目代码。你说的 build error 是哪个项目？能告诉我具体是哪个目录或者粘贴一下错误信息吗？
你好！有什么我可以帮你的？	运行一次性查询，然后退出	I'd be happy to help explain a function, but I don't see any code in your message. Could you paste the function you'd like me to explain?
	继续最近的对话
	恢复之前的对话
需要你批准 git 操作。请批准以下命令依次执行：

git add AIMay/miniapp/
git add MBTIWriter/
git add WriterZhangZhen/
git add "bpecard/桌牌Web版/"
git add deqing/app/frontend/tsconfig.tsbuildinfo
git commit

或者你可以直接在终端运行：

bash

git add AIMay/miniapp/ MBTIWriter/ WriterZhangZhen/ "bpecard/桌牌Web版/" deqing/app/frontend/tsconfig.tsbuildinfo
git commit -m "AIMay/MBTIWriter/WriterZhangZhen/bpecard: 多项目功能更新"
``` | 创建 Git 提交 | 需要你批准 `git add` 操作。这些变更涉及 5 个项目：

- **AIMay/miniapp**: 管理后台、商品管理、首页优化
- **MBTIWriter**: SVG 头像更新、写作功能、路由改进
- **WriterZhangZhen**: CLAUDE.md、发布脚本、封面生成
- **bpecard/桌牌Web版**: imagen 脚本、依赖更新
- **deqing**: tsconfig 构建信息

请批准 git add 后我会分项目提交，或者你希望合并成一个提交？ |
|  | 清除对话历史 |  |
|  | 显示可用命令 |  |
|  或 Ctrl+C | 退出 Claude Code |  |

查看 [CLI 参考](../reference/cli-reference) 获取完整的命令列表。

## 初学者专业提示

**对你的请求要具体**

不要说：修复错误

尝试：修复登录错误，用户输入错误凭证后看到空白屏幕

**使用分步说明**

将复杂任务分解为步骤：

为用户配置文件创建新的数据库表
创建 API 端点以获取和更新用户配置文件
构建允许用户查看和编辑其信息的网页


**让 Claude 先探索**

在进行更改之前，让 Claude 理解你的代码：

分析数据库架构构建一个仪表板，显示英国客户最常退货的产品


**使用快捷方式节省时间**

- 按  查看所有可用的快捷键
- 使用 Tab 进行命令补全
- 按 ↑ 查看命令历史
- 输入  查看所有命令和 skills

## 接下来呢？

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

- **[Claude Code 如何工作](../building/troubleshooting)**：了解代理循环、内置工具以及 Claude Code 如何与你的项目交互
- **[最佳实践](common-workflows)**：通过有效的提示和项目设置获得更好的结果
- **[常见工作流](common-workflows)**：常见任务的分步指南
- **[配置](../configuration/settings)**：使用 CLAUDE.md、skills、hooks、MCP 等进行自定义

## 获取帮助

- **在 Claude Code 中**：输入  或询问「我如何…」
- **文档**：你在这里！浏览其他指南
- **社区**：加入我们的 [Discord](https://www.anthropic.com/discord) 获取提示和支持

快速开始 ​

开始前 ​

步骤 1：安装 Claude Code ​

步骤 2：登录你的账户 ​

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

步骤 4：提出你的第一个问题 ​

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

步骤 6：在 Claude Code 中使用 Git ​

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

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

基本命令 ​

快速开始

开始前

步骤 1：安装 Claude Code

步骤 2：登录你的账户

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

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

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

步骤 6：在 Claude Code 中使用 Git

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

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

基本命令