SpyBara
Go Premium

quickstart.md 2026-10-06 23:59 UTC to 2026-10-07 20:01 UTC

This page contains 63 additions and 97 deletions.

2026
Tue 6 23:59 Wed 7 20:57

快速入门

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

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

开始前

确保您拥有：

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

步骤 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 Code 启动后在其内部运行。

Shell 命令

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

会话命令

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

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

初学者专业提示

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

不要说："修复错误" 
尝试："修复登录错误，用户输入错误凭证后看到空白屏幕"
使用分步说明

将复杂任务分解为步骤：

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

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

分析数据库架构

构建一个仪表板，显示英国客户最常退货的产品
使用快捷方式节省时间
  • 输入 / 查看所有命令和 skills
  • 使用 Tab 进行命令补全
  • 按 ↑ 查看命令历史
  • 按 Shift+Tab 循环切换权限模式

接下来呢？

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

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

获取帮助

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