快速入门

在终端中安装 Claude Code，完成登录，并使用 CLI 探索您的代码库、进行第一次代码更改。

本快速入门介绍终端中的 Claude Code：安装 CLI、在第一个会话中登录，以及在您自己的项目中使用它完成常见的开发任务。

开始前

确保您拥有：

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

步骤 1：安装 Claude Code

要安装 Claude Code，请打开终端并运行适用于您的系统的命令。如果您之前没有使用过终端，终端指南会展示如何打开终端并粘贴命令。

macOS、Linux、WSL：

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

在 Windows 上，当您在 PowerShell 中时，您的提示符显示 PS C:\；当您在 CMD 中时，提示符显示 C:\（没有 PS）。

Windows PowerShell：

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

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装命令在下载 Claude Code 期间不会显示进度。安装程序完成后，打开一个新的终端窗口并运行 claude --version。正常的安装会打印一个版本号。如果您的 shell 显示找不到 claude 或无法识别，说明安装目录还不在您的 PATH 中：请参阅修复您的 PATH。

如果您看到 The token '&&' is not a valid statement separator，说明您在 PowerShell 中，而不是 CMD。如果您看到 'irm' is not recognized as an internal or external command，说明您在 CMD 中，而不是 PowerShell。

如果安装命令失败并显示 syntax error near unexpected token '<'、403 或其他任何错误，请参阅排查安装问题以匹配错误并获得修复方案和替代安装方法。

建议在原生 Windows 上安装 Git for Windows，以便 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows，Claude Code 将使用 PowerShell 作为 shell 工具。WSL 设置不需要 Git for Windows。

brew install --cask claude-code

Homebrew 提供两个 casks。claude-code 跟踪稳定发布渠道，通常比最新版本晚约一周，并跳过有重大回归的版本。claude-code@latest 跟踪最新渠道，在新版本发布时立即接收。

winget install Anthropic.ClaudeCode

您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 进行安装。

要确认安装成功，请运行：

claude --version

该命令会打印一个版本号，后面跟着 (Claude Code)。

步骤 2：开始您的第一个会话

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

cd /path/to/your/project
claude

将 /path/to/your/project 替换为您要处理的项目路径。

首次使用时，Claude Code 会提示您登录。对于 Claude 订阅或 Console 账户，请按照提示在浏览器中完成身份验证。如果您已设置 ANTHROPIC_API_KEY 环境变量，并且在 Claude Code 询问是否使用该密钥时予以批准，Claude Code 将跳过登录提示。

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

Claude Pro、Max、Team 或 Enterprise（推荐）
Claude Console（使用预付额度的 API 访问）。首次登录时，系统会在 Console 中自动创建一个"Claude Code"工作区，用于集中跟踪费用。
Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry（企业云服务提供商）
自托管的 Claude apps gateway（如果您的组织部署了该网关）：管理员会预先配置网关 URL，/login 将直接打开 Cloud gateway 界面，供您使用企业 SSO 登录

登录后，您的凭据会被保存，无需再次登录。如需了解更多信息，请参阅凭据管理。

随后将显示 Claude Code 提示符，其上方会显示版本、当前模型和工作目录。输入 /help 查看可用命令，或输入 /resume 继续之前的对话。如需稍后切换账户或重新进行身份验证，请在运行中的会话内输入 /login。

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

尝试以下命令之一：

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 create custom skills in Claude Code?

can Claude Code work with Docker?

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

尝试一个小任务：

add a hello world function to the main file

Claude Code 会找到合适的文件并向您展示更改。如果它在进行更改前征求确认，请选择 Yes 以批准。

会话的权限模式决定了 Claude 可以在不事先询问您的情况下执行哪些操作。随时按 Shift+Tab 即可切换当前会话的权限模式。

步骤 5：在 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

步骤 6：修复 bug 或添加功能

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

add input validation to the user registration form

或修复现有问题：

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

步骤 7：试用其他常见工作流

再尝试几个提示词。您可以让 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

基本命令

以下是日常使用中最重要的命令，按运行位置分组。

Shell 命令

从终端运行这些命令以启动或恢复 Claude Code。

命令	功能	示例
`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`

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

会话命令

在 Claude Code 启动后，在其内部运行这些命令。

命令	功能	示例
`/clear`	清除对话历史	`/clear`
`/help`	显示可用命令	`/help`
`/exit` 或 Ctrl+D 两次	退出 Claude Code	`/exit`

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

初学者专业提示

有关更多信息，请参阅最佳实践和常见工作流。

不要说："修复错误"

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

使用分步说明

将复杂任务分解为步骤：

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

让 Claude 先探索

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

分析数据库架构

构建一个仪表板，显示英国客户最常退货的产品

使用快捷方式节省时间

输入 / 查看所有命令和 skills
使用 Tab 进行命令补全
按 ↑ 查看命令历史
按 Shift+Tab 循环切换权限模式

接下来呢？

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

Claude Code 如何工作：了解智能体循环、内置工具以及 Claude Code 如何与您的项目交互
最佳实践：通过有效的提示和项目设置获得更好的结果
常见工作流：常见任务的分步指南
扩展 Claude Code：使用 CLAUDE.md、skill、hook、MCP 等进行自定义

有关安装选项、手动更新或卸载说明，请参阅高级设置。

获取帮助

在 Claude Code 中：输入 /help 或询问"我如何..."
文档：浏览本站的其他指南
课程：参加 Claude Code 101 和 Claude Academy 上的其他免费自学课程
社区：加入 Discord 服务器获取提示和支持

quickstart.md +16 −14

57 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd57 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

58 ```58 ```

59 59

60 安装程序完成后，打开一个新的终端窗口并运行 `claude --version`。正常的安装会打印一个版本号。如果您的 shell 显示找不到 `claude` 或无法识别，说明安装目录还不在您的 PATH 中：请参阅[修复您的 PATH](/docs/zh-CN/troubleshoot-install#command-not-found-claude-after-installation)。60 安装命令在下载 Claude Code 期间不会显示进度。安装程序完成后，打开一个新的终端窗口并运行 `claude --version`。正常的安装会打印一个版本号。如果您的 shell 显示找不到 `claude` 或无法识别，说明安装目录还不在您的 PATH 中：请参阅[修复您的 PATH](/docs/zh-CN/troubleshoot-install#command-not-found-claude-after-installation)。

61 61

62 如果您看到 `The token '&&' is not a valid statement separator`，说明您在 PowerShell 中，而不是 CMD。如果您看到 `'irm' is not recognized as an internal or external command`，说明您在 CMD 中，而不是 PowerShell。62 如果您看到 `The token '&&' is not a valid statement separator`，说明您在 PowerShell 中，而不是 CMD。如果您看到 `'irm' is not recognized as an internal or external command`，说明您在 CMD 中，而不是 PowerShell。

63 63

233 步骤 7：试用其他常见工作流233 步骤 7：试用其他常见工作流

234</h2>234</h2>

235 235

236您可以通过多种方式与 Claude 协作：236再尝试几个提示词。您可以让 Claude 重构代码、编写测试、更新文档或审查您的更改：

~~237~~

238**重构代码**

239 237

240```text wrap theme={null}238```text wrap theme={null}

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

242```240```

243 241

244**编写测试**

~~245~~

246```text wrap theme={null}242```text wrap theme={null}

247write unit tests for the calculator functions243write unit tests for the calculator functions

248```244```

249 245

250**更新文档**

~~251~~

252```text wrap theme={null}246```text wrap theme={null}

253update the README with installation instructions247update the README with installation instructions

254```248```

255 249

256**代码审查**

~~257~~

258```text wrap theme={null}250```text wrap theme={null}

259review my changes and suggest improvements251review my changes and suggest improvements

260```252```

267 基本命令259 基本命令

268</h2>260</h2>

269 261

270以下是日常使用中最重要的命令。Shell 命令从您的终端运行以启动或恢复 Claude Code。会话命令在 Claude Code 启动后在其内部运行。262以下是日常使用中最重要的命令，按运行位置分组。

271 263

272**Shell 命令**264<h3 id="shell-commands">

265 Shell 命令

266</h3>

267

268从终端运行这些命令以启动或恢复 Claude Code。

273 269

274| 命令 | 功能 | 示例 |270| 命令 | 功能 | 示例 |

275| - | - | - |271| - | - | - |

281 277

282**会话命令**278有关完整的 shell 命令列表，请参阅 [CLI 参考](/docs/zh-CN/cli-reference)。

279

280<h3 id="session-commands">

281 会话命令

282</h3>

283

284在 Claude Code 启动后，在其内部运行这些命令。

283 285

284| 命令 | 功能 | 示例 |286| 命令 | 功能 | 示例 |

285| - | - | - |287| - | - | - |

289 291

290有关完整的 shell 命令列表，请参阅 [CLI 参考](/docs/zh-CN/cli-reference)，有关完整的会话命令列表，请参阅 [命令参考](/docs/zh-CN/commands)。292有关完整的会话命令列表，请参阅 [命令参考](/docs/zh-CN/commands)。

291 293

292<h2 id="pro-tips-for-beginners">294<h2 id="pro-tips-for-beginners">

293 初学者专业提示295 初学者专业提示

quickstart.md 2026-10-07 23:59 UTC to 2026-10-08 19:01 UTC

快速入门

开始前

步骤 1：安装 Claude Code

步骤 2：开始您的第一个会话

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

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

步骤 5：在 Claude Code 中使用 Git

步骤 6：修复 bug 或添加功能

步骤 7：试用其他常见工作流

基本命令

Shell 命令

会话命令

初学者专业提示

接下来呢？

获取帮助