Claude Code 深度学习手册

主题

快速上手 Quickstart ​

几分钟内完成安装、登录并用 Claude Code 完成首个编码任务。

是什么 ​

Quickstart 是 Claude Code 的入门指南，带你在几分钟内开始使用 AI 驱动的编码助手。本指南覆盖终端 CLI 版本；Claude Code 同时还提供 web、桌面应用、VS Code、JetBrains IDE、Slack，以及在 CI/CD 中通过 GitHub Actions 和 GitLab 使用。

读完后你将理解如何用 Claude Code 完成常见开发任务：理解代码库、修改代码、操作 Git、修 bug、加功能、重构、写测试、更新文档和代码评审。

怎么工作 ​

  • Step 1 安装 Claude Code（原生安装、Homebrew、WinGet 或 Linux 包管理器任选其一）
  • Step 2 登录账号：运行 claude，首次使用会提示在浏览器完成认证；会话内可用 /login 切换账号
  • Step 3 开启首个会话：cd 进入项目目录后运行 claude，进入欢迎界面
  • Step 4 提第一个问题：如 what does this project do?，Claude 会按需读取项目文件并总结
  • Step 5 首次改代码：如 add a hello world function to the main file，Claude 会定位文件、展示改动、请求批准后再修改
  • Step 6 用 Git：用自然语言完成查看改动、提交、建分支、查看提交、解决冲突等操作
  • Step 7 修 bug 或加功能：用自然语言描述需求，Claude 会定位代码、理解上下文、实现方案并在有测试时运行测试
  • Step 8 尝试其他常见工作流：重构、写测试、更新文档、代码评审

怎么配置 / 用法 ​

安装（macOS / Linux / WSL，推荐原生安装）：

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

Windows PowerShell：

powershell
irm https://claude.ai/install.ps1 | iex

Homebrew：

bash
brew install --cask claude-code

WinGet：

powershell
winget install Anthropic.ClaudeCode

登录并开启首个会话：

bash
cd /path/to/your/project
claude

首次提问示例：

text
what does this project do?

首次改代码示例：

text
add a hello world function to the main file

什么时候用 ​

  • 第一次安装并上手 Claude Code 时
  • 想快速理解一个陌生代码库（项目做什么、用了什么技术、入口在哪、目录结构）
  • 想让 AI 直接帮你改代码、修 bug、加功能
  • 想用自然语言完成 Git 操作
  • 想体验重构、写测试、更新文档、代码评审等常见工作流

限制 / 坑 ​

  • 本指南只覆盖终端 CLI；web、桌面、IDE、Slack、CI 等其他界面见各自文档
  • Claude Code 必须有账号才能使用（Claude 订阅、Claude Console 或受支持的云厂商）

硬事实速查（12 条） ​

  • 原生安装（推荐）macOS/Linux/WSL：curl -fsSL https://claude.ai/install.sh | bash
  • Windows PowerShell 安装：irm https://claude.ai/install.ps1 | iex
  • Homebrew 安装：brew install --cask claude-code（claude-code 为稳定通道，claude-code@latest 为最新通道）
  • WinGet 安装：winget install Anthropic.ClaudeCode
  • 原生安装会在后台自动更新；Homebrew/WinGet 不会自动更新，需手动 upgrade
  • 首个命令是 claude，首次运行会提示登录；会话内输入 /login 可切换账号或重新认证
  • 登录后凭证会保存在本机，无需重复登录
  • Claude Code 会按需读取项目文件，无需手动添加上下文
  • 修改文件前 Claude Code 总会请求许可；可逐项批准或在会话内开启 Accept all 模式
  • 常用命令：claude（交互模式）、claude "task"（一次性任务）、claude -p "query"（一次性查询后退出）、claude -c（继续当前目录最近会话）、claude -r（恢复历史会话）
  • 会话内常用：/clear 清空历史、/help 查看命令、exit 或 Ctrl+D 退出、/resume 继续上一会话
  • 快捷操作：输入 / 查看全部命令与 skills；Tab 命令补全；↑ 命令历史；Shift+Tab 切换权限模式

官方出处：https://code.claude.com/docs/en/quickstart