Claude Code 快速上手：安装、登录与第一个任务

在 macOS、Linux、Windows 上安装 Claude Code、登录，并用它了解项目、改代码、用 Git、修 bug 和做常见工作流；含常用命令和新手技巧。

这个快速上手指南让你在几分钟内用上 AI 辅助编码。读完后，你会知道如何把 Claude Code 用于常见的开发任务。

开始之前

确保你有：

一个打开的终端或命令提示符（如果你从没用过终端，见官方的终端指南）
一个可以操作的代码项目
Claude 订阅（Pro、Max、Team 或 Enterprise）、Claude Console 账号，或通过受支持的云提供商获得的访问权

本指南讲终端 CLI。Claude Code 也可以在网页、桌面应用、VS Code 和 JetBrains IDE、Slack 里使用，以及在 CI/CD 里通过 GitHub Actions 和 GitLab 使用。各界面见官方概览。

第 1 步：安装 Claude Code

要安装 Claude Code，打开终端并运行适合你系统的命令。

原生安装（推荐）

macOS、Linux、WSL：

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

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。提示符在 PowerShell 里显示 PS C:\，在 CMD 里是没有 PS 的 C:\。如果安装命令以 syntax error near unexpected token '<'、403 或其他 curl 错误失败，见「排查安装」。原生 Windows 推荐安装 Git for Windows，让 Claude Code 能使用 Bash 工具；没装的话，Claude Code 改用 PowerShell 作为 shell 工具；WSL 设置不需要 Git for Windows。原生安装会在后台自动更新。

Homebrew

brew install --cask claude-code

Homebrew 提供两个 cask：claude-code 跟踪 stable 发布通道（通常约晚一周，并跳过有重大回归的发布），claude-code@latest 跟踪 latest 通道。Homebrew 安装不会自动更新：运行 brew upgrade claude-code 或 brew upgrade claude-code@latest。

WinGet

winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新：定期运行 winget upgrade Anthropic.ClaudeCode。你也可以在 Debian、Fedora、RHEL 和 Alpine 上用 apt、dnf 或 apk 安装（见「高级安装」）。要确认安装成功，运行：

claude --version

该命令打印版本号，后面跟着 (Claude Code)。更多安装选项（指定版本、npm、Linux 包管理器、二进制校验）见高级安装。

第 2 步：登录你的账号

使用 Claude Code 需要账号。用 claude 命令启动交互会话，首次使用时会提示你登录：

claude

对 Claude 订阅或 Console 账号，按提示在浏览器里完成认证。如果你设置了 ANTHROPIC_API_KEY 环境变量，Claude Code 会跳过登录提示，改为请你批准该密钥。之后要切换账号或重新认证，在运行中的会话里输入 /login：

/login

你可以用这些账号类型中的任何一种登录：

Claude Pro、Max、Team 或 Enterprise（推荐）
Claude Console（用预付额度的 API 访问）：首次登录时，会在 Console 里自动创建一个「Claude Code」工作区，用于集中的成本跟踪。
Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry（企业云提供商）
自托管的 Claude apps gateway（如果你的组织运行了一个）：管理员预先配置网关 URL，/login 直接打开 Cloud gateway 屏幕，让你用企业 SSO 登录。

登录之后，你的凭据被存储，不需要再次登录；更多内容见认证页的凭据管理。

第 3 步：开始你的第一个会话

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

cd /path/to/your/project
claude

把 /path/to/your/project 换成你想处理的项目的路径。你会看到 Claude Code 的提示符，上方显示版本、当前模型和工作目录。输入 /help 查看可用命令，或输入 /resume 继续之前的对话。

第 4 步：问你的第一个问题

先从了解你的代码库开始。试试这些命令：

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?

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

第 5 步：做你的第一个代码改动

现在让 Claude Code 做点实际的编码。试一个简单的任务：

add a hello world function to the main file

Claude Code 找到合适的文件并给你看改动。如果它在改动前询问，选 Yes 批准。

在 Claude Code v2.1.283 或更高版本上，auto 模式是交互式终端会话的内置起始权限模式：由分类器代替你评审操作，Claude 编辑大多数文件和运行大多数命令时不再问你；在更早的版本上，auto 模式只在 Pro、Max 和 Team 套餐上是内置的起始权限模式（以官方为准）。你的设置或你的组织可以设置不同的起始权限模式；权限模式页列出了哪些因素决定会话以哪种模式启动。随时按 Shift+Tab 切换你所在会话的权限模式。

第 6 步：把 Git 与 Claude Code 一起用

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

第 7 步：修 bug 或加功能

Claude 擅长调试和实现功能。用自然语言描述你想要什么：

add input validation to the user registration form

或者修复现有问题：

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

Claude Code 会：定位相关代码；理解上下文；实现解决方案；如果有测试就运行测试。

第 8 步：试试其他常见工作流

与 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

提示：像对待一位乐于助人的同事那样和 Claude 说话。描述你想达成什么，它会帮你做到。

必备命令

下面是日常使用最重要的命令。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`

其他常用的：/init 生成 CLAUDE.md；/model 切换模型；/compact 压缩对话历史；/status 查看账号、模型、API 地址等状态；Shift+Tab 切换权限模式（含 Plan 模式）；Esc 中断当前操作。shell 命令的完整列表见 CLI 参考，会话命令的完整列表见命令参考。

给新手的技巧

更多内容见最佳实践和常见工作流。

请求要具体。 不要说「fix the bug」，试试「fix the login bug where users see a blank screen after entering wrong credentials」。
用分步指令。 把复杂任务拆成步骤：1. 为用户资料创建新的数据库表；2. 创建获取和更新用户资料的 API 端点；3. 构建让用户查看和编辑自己信息的网页。
让 Claude 先探索。 在做改动之前，让 Claude 先理解你的代码，例如「analyze the database schema」，再提「build a dashboard showing products that are most frequently returned by our UK customers」。
用快捷键省时间。 输入 / 查看你可用的命令和 skills；用 Tab 补全命令；按 ↑ 调出命令历史；按 Shift+Tab 循环切换权限模式。

接下来？

学会基础之后，探索更高级的功能：

Claude Code 如何工作：理解智能体循环、内置工具，以及 Claude Code 如何与你的项目交互。
最佳实践：用有效的提示和项目设置得到更好的结果。
常见工作流：常见任务的分步指南。
扩展 Claude Code：用 CLAUDE.md、skills、hooks、MCP 等定制。

获取帮助

在 Claude Code 里：输入 /help 或问一个「how do I」问题。
文档：你就在这里！浏览其他指南。
课程：在 Claude Academy 学习 Claude Code 101 和其他免费的自定进度课程。
社区：加入官方 Discord 获取技巧和支持。