本教程将在10分钟内带你完成从安装到第一次代码修改的全流程，适合首次接触 Claude Code 的开发者。你将学会通过 curl、Homebrew 或 WinGet 安装 Claude Code，使用 claude 命令登录并启动交互式会话，然后通过自然语言探索代码库、修改文件、操作 Git。关键命令包括 claude -c 继续最近会话、claude -p "查询" 运行一次性查询。安装前需要确保已有 Claude 订阅或 Anthropic Console 账户。

Claude Code 使用教程：快速安装、登录与入门指南

欢迎使用 Claude Code！本教程将带你从零开始，完成安装并实践第一个 AI 辅助编程任务。

前置条件

开始之前，请确保你已准备好以下内容：

一个终端或命令行窗口
- 如果不熟悉终端操作，可先阅读终端使用指南
一个可供操作的代码项目
Claude 订阅（Pro、Max、Team 或 Enterprise）、Anthropic Console 账户，或通过受支持的云服务商获得访问权限

本教程介绍终端 CLI 的使用方式。Claude Code 也提供 Web 端、桌面应用、VS Code 插件、JetBrains IDE 插件、Slack 集成，以及 GitHub Actions 和 GitLab 等 CI/CD 集成。查看所有支持的环境。

第一步：安装 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

如果在 CMD 中看到 The token '&&' is not a valid statement separator，说明你当前在 PowerShell 而非 CMD。如果在 PowerShell 中看到 'irm' is not recognized as an internal or external command，说明你当前在 CMD 而非 PowerShell。PowerShell 的提示符显示为 PS C:\，CMD 显示为 C:\。

在原生 Windows 上，建议安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows，Claude Code 会改用 PowerShell 作为 Shell 工具。WSL 环境则无需安装 Git for Windows。

原生安装方式会在后台自动更新，始终保持最新版本。

Homebrew（macOS）

brew install --cask claude-code

Homebrew 提供两个 cask：

claude-code：跟随稳定发布频道，通常滞后约一周，会跳过有严重问题的版本。
claude-code@latest：跟随最新发布频道，新版发布后立即更新。

Homebrew 安装不会自动更新。要获取最新功能和安全修复，请根据安装的 cask 运行 brew upgrade claude-code 或 brew upgrade claude-code@latest。

WinGet（Windows）

winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新。请定期运行 winget upgrade Anthropic.ClaudeCode 以获取最新特性。

你还可以在 Debian、Fedora、RHEL 和 Alpine 上通过 apt、dnf 或 apk 安装。

第二步：登录账户

Claude Code 需要账户才能使用。首次使用 claude 命令启动交互式会话时，系统会提示你登录：

claude
# 首次使用会提示登录

也可以使用登录命令：

/login
# 按提示完成登录

支持以下账户类型：

Claude Pro、Max、Team 或 Enterprise（推荐）
Anthropic Console（API 预付费额度）。首次登录时，系统会自动在 Console 中创建一个"Claude Code"工作区，用于集中追踪成本。
Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry（企业云服务商）

登录后，凭据会保存在本地，下次启动无需重复登录。如需切换账户，使用 /login 命令。

第三步：启动第一个会话

在任意项目目录中启动 Claude Code：

cd /path/to/your/project
claude

你会看到 Claude Code 欢迎界面，其中包含会话信息、最近的对话和最新的更新。输入 /help 查看可用命令，或输入 /resume 继续之前的对话。

完成登录后，你的凭据会存储在本地系统中。更多信息请查看凭据管理。

第四步：问第一个问题

先让 Claude 了解你的代码库。尝试输入以下命令：

这个项目是做什么的？

Claude 会分析你的文件并给出总结。你也可以问更具体的问题：

这个项目用了哪些技术？
主入口文件在哪里？
解释一下目录结构

也可以询问 Claude Code 自身的能力：

Claude Code 能做什么？
怎么在 Claude Code 中创建自定义技能？
Claude Code 可以和 Docker 一起使用吗？

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

第五步：做第一次代码修改

让 Claude Code 执行一个简单的编程任务：

在主文件里添加一个 hello world 函数

Claude Code 会：

找到合适的文件
展示建议的改动
等待你批准
执行编辑

Claude Code 在修改文件前始终会请求你的许可。你可以逐条批准修改，也可以在会话中启用"全部接受"(Accept all)模式。

第六步：用 Git 操作

Claude Code 让 Git 操作变得像对话一样自然：

我改了哪些文件？
用描述性的提交信息提交这些改动

也可以处理更复杂的 Git 操作：

创建一个名为 feature/quickstart 的新分支
显示最近 5 条提交记录
帮我解决合并冲突

第七步：修复 bug 或添加功能

Claude 擅长调试和功能实现。用自然语言描述你的需求：

给用户注册表单添加输入验证

或者修复现有的问题：

有个 bug：用户可以提交空表单，帮我修复它

Claude Code 会：

定位相关代码
理解代码上下文
实现解决方案
如果存在测试，运行测试进行验证

第八步：尝试更多常用操作

重构代码

把身份验证模块从回调函数重构成 async/await 风格

编写测试

给计算器函数写单元测试

更新文档

更新 README，添加安装说明

代码审查

审查我的改动并提出改进建议

像对待一个靠谱的同事一样与 Claude 交流：描述你想实现什么，它会帮你搞定。

核心命令速查（日常使用）

命令	作用	示例
`claude`	启动交互式会话	`claude`
`claude "任务"`	执行一次性任务	`claude "修复构建错误"`
`claude -p "查询"`	运行一次性查询后退出	`claude -p "解释这个函数"`
`claude -c`	继续当前目录下的最近会话	`claude -c`
`claude -r`	恢复之前的会话	`claude -r`
`/clear`	清除对话历史	`/clear`
`/help`	显示可用命令	`/help`
`exit` 或 Ctrl+D	退出 Claude Code	`exit`

完整命令列表请参考 CLI 参考。

新手实用技巧

提示词要具体

不要说：修复 bug。要说：修复登录的 bug：用户输入错误密码后看到空白页面

用分步骤的方式描述任务

将复杂任务拆分成步骤：

1. 为用户资料表创建一个新的数据库表
2. 创建用于获取和更新用户资料的 API 接口
3. 搭建一个让用户查看和编辑自己信息的页面

先让 Claude 探索，再动手修改

在做任何修改前，先让 Claude 理解你的代码：

分析数据库 schema

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

用快捷键节省时间

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

更多技巧请参考最佳实践和常见工作流。

下一步

Claude Code 工作原理：了解代理循环、内置工具以及 Claude Code 如何与你的项目交互。 → 查看详情
最佳实践：通过有效的提示和项目设置获得更好的结果。 → 查看详情
常见工作流：常见任务的分步指南。 → 查看详情
扩展 Claude Code：通过 CLAUDE.md、技能、钩子、MCP 等方式自定义你的工作流。 → 查看详情

获取帮助

在 Claude Code 内：输入 /help 或者问"如何…"
文档：你现在就在文档中！浏览其他指南。
社区：加入我们的 Discord 获取技巧和支持。

常见问题

Claude Code 怎么安装？安装步骤是什么？

Claude Code 支持多种安装方式。推荐在 macOS、Linux 或 WSL 上使用命令 curl -fsSL https://claude.ai/install.sh | bash 安装。Windows 用户可选择 PowerShell 命令 irm https://claude.ai/install.ps1 | iex 或 WinGet 命令 winget install Anthropic.ClaudeCode。macOS 用户也可通过 Homebrew 安装：brew install --cask claude-code。

Claude Code 登录失败或无法登录怎么解决？

首次启动 Claude Code 时，运行 claude 命令，系统会自动提示登录。如果登录失败，可尝试运行 /login 命令重新进行登录流程。确保你拥有有效的 Claude 订阅（Pro、Max、Team 或 Enterprise）、Anthropic Console 账户，或已配置 Amazon Bedrock / Google Vertex AI / Microsoft Foundry 等企业云服务商凭证。

Claude Code 能用来做什么？有哪些常用功能？

Claude Code 是一个 AI 编程助手，可以完成代码库分析、代码修改与编写、单元测试生成、代码重构、Git 操作（如提交、创建分支、解决合并冲突）、bug 修复以及文档更新等常见开发任务。所有操作都通过自然语言对话完成，无需手动编写具体代码。

Claude Code 使用教程：快速安装、登录与入门指南 #

前置条件 #

第一步：安装 Claude Code #

macOS、Linux、WSL #

Windows PowerShell #

Windows CMD #

Homebrew（macOS） #

WinGet（Windows） #

第二步：登录账户 #

第三步：启动第一个会话 #

第四步：问第一个问题 #

第五步：做第一次代码修改 #

第六步：用 Git 操作 #

第七步：修复 bug 或添加功能 #

第八步：尝试更多常用操作 #

核心命令速查（日常使用） #

新手实用技巧 #

下一步 #

获取帮助 #

常见问题 #

Claude Code 怎么安装？安装步骤是什么？ #

Claude Code 登录失败或无法登录怎么解决？ #

Claude Code 能用来做什么？有哪些常用功能？ #