Skip to main content
本快速入门介绍终端中的 Claude Code：安装 CLI、在第一个会话中登录，以及在您自己的项目中使用它完成常见的开发任务。
默认配置下，Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中，这些端点可能无法直接访问。开始前，请先确认所在网络能够连通这些服务。企业代理配置以及 Amazon Bedrock 等第三方提供商的网络要求，请参阅网络配置。

​
开始前

确保您拥有：
以下情况在其他页面中介绍：

​
步骤 1：安装 Claude Code

要安装 Claude Code，请打开终端并运行适用于您的系统的命令。如果您之前没有使用过终端，终端指南会展示如何打开终端并粘贴命令。
macOS、Linux、WSL：
在 Windows 上，当您在 PowerShell 中时，您的提示符显示 PS C:\；当您在 CMD 中时，提示符显示 C:\（没有 PS）。Windows PowerShell：
Windows 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。
原生安装会在后台自动更新，以保持您使用最新版本。
您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 进行安装。 要确认安装成功，请运行：
该命令会打印一个版本号，后面跟着 (Claude Code)。

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

在任意项目目录中打开终端并启动 Claude Code：
将 /path/to/your/project 替换为您要处理的项目路径。 首次使用时，Claude Code 会提示您登录。对于 Claude 订阅或 Console 账户，请按照提示在浏览器中完成身份验证。如果您已设置 ANTHROPIC_API_KEY 环境变量，并且在 Claude Code 询问是否使用该密钥时予以批准，Claude Code 将跳过登录提示。 您可以使用以下任一账户类型登录： 登录后，您的凭据会被保存，无需再次登录。如需了解更多信息，请参阅凭据管理。 随后将显示 Claude Code 提示符，其上方会显示版本、当前模型和工作目录。输入 /help 查看可用命令，或输入 /resume 继续之前的对话。如需稍后切换账户或重新进行身份验证，请在运行中的会话内输入 /login。

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

尝试以下命令之一：
Claude 将分析您的文件并提供摘要。您还可以提出更具体的问题：
您还可以询问 Claude 有关其自身功能的问题：
Claude Code 会根据需要读取您的项目文件。您无需手动添加上下文。

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

尝试一个小任务：
Claude Code 会找到合适的文件并向您展示更改。如果它在进行更改前征求确认，请选择 Yes 以批准。 会话的权限模式决定了 Claude 可以在不事先询问您的情况下执行哪些操作。随时按 Shift+Tab 即可切换当前会话的权限模式。

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

Claude Code 让 Git 操作变得像对话一样简单：
您还可以通过提示词执行更复杂的 Git 操作：

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

用自然语言描述您想要的内容：
或修复现有问题：

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

再尝试几个提示词。您可以让 Claude 重构代码、编写测试、更新文档或审查您的更改：
像与一位乐于助人的同事交流一样与 Claude 对话。描述您想要实现的目标，它会帮助您达成。

​
基本命令

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

​
Shell 命令

从终端运行这些命令以启动或恢复 Claude Code。 有关完整的 shell 命令列表，请参阅 CLI 参考。

​
会话命令

在 Claude Code 启动后，在其内部运行这些命令。 有关完整的会话命令列表，请参阅 命令参考。

​
初学者专业提示

有关更多信息，请参阅最佳实践和常见工作流。
不要说：“修复错误”尝试：“修复登录错误，用户输入错误凭证后看到空白屏幕”
将复杂任务分解为步骤：
在进行更改之前，让 Claude 理解您的代码：
  • 输入 / 查看所有命令和 skills
  • 使用 Tab 进行命令补全
  • 按 ↑ 查看命令历史
  • 按 Shift+Tab 循环切换权限模式

​
接下来呢？

现在您已经学习了基础知识，探索更多高级功能： 有关安装选项、手动更新或卸载说明，请参阅高级设置。

​
获取帮助

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