SpyBara
Go Premium

quickstart.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 103 additions and 135 deletions.

2026
Tue 6 23:59 Wed 7 23:59 Thu 8 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Fri 30 23:01

快速入门

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

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

[!NOTE]

默认配置下，Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中，这些端点可能无法直接访问。开始前，请先确认所在网络能够连通这些服务。企业代理配置以及 Amazon Bedrock 等第三方提供商的网络要求，请参阅网络配置。

开始前

确保您拥有：

[!NOTE]

以下情况在其他页面中介绍：

步骤 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。

[!NOTE]

原生安装会在后台自动更新，以保持您使用最新版本。

Homebrew

brew install --cask claude-code

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

[!NOTE]

Homebrew 安装不会自动更新。运行 brew upgrade claude-code 或 brew upgrade claude-code@latest（取决于您安装的 cask）以获取最新功能和安全修复。

WinGet

winget install Anthropic.ClaudeCode

[!NOTE]

WinGet 安装不会自动更新。定期运行 winget upgrade 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 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?

[!NOTE]

Claude Code 会根据需要读取您的项目文件。您无需手动添加上下文。

步骤 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

[!TIP]

像与一位乐于助人的同事交流一样与 Claude 对话。描述您想要实现的目标，它会帮助您达成。

基本命令

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

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