本指南带你在几分钟内上手 Claude Code，完成安装、登录、提问、修改代码、使用 Git 的完整流程。
前提条件
- 打开终端或命令提示符（没用过终端？先看终端入门指南）
- 有一个代码项目
- 拥有 Claude 订阅（Pro/Max/Teams/Enterprise）、Claude Console 账号，或通过 Bedrock/Vertex/Foundry 访问
第一步：安装 Claude Code
macOS / Linux / WSL：
bash
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
powershell
irm https://claude.ai/install.ps1 | iexWindows CMD：
cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHomebrew（macOS）：
bash
brew install --cask claude-codeWinGet（Windows）：
powershell
winget install Anthropic.ClaudeCodeWindows 需要先安装 Git for Windows。Native 安装自动后台更新，Homebrew/WinGet 需手动更新。
第二步：登录账号
bash
claude
# 首次启动自动提示登录支持以下账号类型登录：
- Claude Pro/Max/Teams/Enterprise（推荐）：claude.ai 账号
- Claude Console：API 计费账号，首次登录自动创建 "Claude Code" 工作区
- 云提供商：Amazon Bedrock、Google Vertex AI、Microsoft Foundry（通过环境变量配置）
登录后凭证自动保存，无需重复登录。切换账号使用 /login。
第三步：开始第一个会话
bash
cd /path/to/your/project
claude看到欢迎界面后，输入 /help 查看命令列表，或 /resume 继续上次对话。
第四步：提第一个问题
先了解项目结构：
what does this project do?
what technologies does this project use?
where is the main entry point?
explain the folder structure
Claude 会分析你的文件并给出摘要。
第五步：做第一次代码修改
add a hello world function to [filename]
fix the bug in [filename] on line [N]
refactor this function to be more readable: [paste code]
Claude 会提议修改，你可以接受或拒绝。
第六步：配合 Git 使用
show me what changed
create a commit with a descriptive message
what files have been modified?
Claude 可以创建 commit、查看 diff、管理分支。
第七步：修复 Bug 或添加功能
there's a bug where [describe what's wrong]
add a feature that [describe what you want]
write tests for [function/file]
描述你想要的效果，Claude 会处理实现细节。
第八步：探索更多工作流
review my recent changes for potential issues
explain how [feature] works
update documentation to match the code
常用命令速查
斜杠命令
| 命令 | 说明 |
|---|---|
/help | 显示所有可用命令 |
/config | 打开设置界面 |
/model | 切换 AI 模型 |
/resume | 继续上次对话 |
/login | 切换账号 |
/logout | 退出登录 |
/output-style | 切换输出风格 |
/permissions | 查看当前权限设置 |
/plugin | 插件管理 |
/bug | 报告 Bug |
/cost | 查看本次会话 Token 用量 |
/clear | 清除对话历史 |
/compact | 压缩对话历史节省 Token |
快捷键
| 快捷键 | 说明 |
|---|---|
Ctrl+C | 中断当前操作 |
Ctrl+D / /exit | 退出 Claude Code |
Esc | 清空输入框 |
↑ / ↓ | 浏览历史输入 |
文件引用
@filename.py # 引用文件
@src/ # 引用目录
给新手的实用建议
- 从简单问题开始：先问「这个项目做什么？」，让 Claude 建立上下文再进行复杂操作
- 用自然语言描述：不需要精确的技术术语，描述你想要的结果即可
- 逐步推进：每次修改一个小功能，比一次性要求大改动更容易控制
- 善用
/clear：切换任务时清除历史，避免上下文混淆 - 检查每次修改：Claude 做出更改前通常会展示预览，仔细阅读再确认
- 搭配版本控制：让 Claude 帮你写 commit，保持代码历史清晰
接下来
- 最佳实践：提升 Claude Code 使用效率的技巧
- 常用工作流：调试、重构、测试等场景的详细教程
- CLAUDE.md 指南：为项目配置持久化记忆
- 如何工作：了解 Claude 如何读取文件、执行命令和修改代码
原文：Quickstart - Claude Code Docs | 来源：Anthropic 官方文档