Claude Code 学习站
v2.1.206

5 分钟上手 Claude Code：官方快速入门要点摘要

官方 Quickstart 要点精译:涵盖多平台安装、账号登录、会话启动、代码修改、Git 操作、命令速查与初学者技巧,帮助开发者快速投入使用。

本页目录9
AI 摘要 · 已核查整理于 2026-06-20原文:Claude Code Quickstart(Anthropic)
要点速览
  • 支持 macOS/Linux/WSL/Windows 多平台安装,原生安装脚本可后台自动更新,Homebrew/WinGet 需手动升级
  • 支持 Claude Pro/Max/Team/Console 订阅及 Bedrock/Vertex AI/Foundry 企业云等多种账号类型,认证信息本地持久化
  • 在项目目录运行 `claude` 即可启动,Claude Code 自动读取项目文件,无需手动添加上下文
  • 用自然语言驱动代码修改、Git 提交/分支/合并冲突、调试、重构、编写测试等全流程
  • 核心 Shell 命令:`claude -p` 单次查询,`claude -c` 继续上次对话,`claude -r` 恢复历史会话
  • 初学者三大技巧:具体描述症状、拆分多步骤任务、先让 Claude 探索代码再动手修改

本文是对官方文章 Claude Code Quickstart 的中文要点摘要,完整内容以原文为准。

安装 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

也可通过 Homebrew(brew install --cask claude-code)、WinGet(winget install Anthropic.ClaudeCode)或 Linux 包管理器(apt / dnf / apk)安装。

原生安装方式在后台自动更新至最新版;Homebrew 和 WinGet 安装不自动更新,需手动执行升级命令以获取新功能和安全修复。

Windows 用户建议同时安装 Git for Windows,以便 Claude Code 使用 Bash 工具(未安装时会改用 PowerShell 作为 shell 工具);WSL 环境无需额外安装。

登录与账号类型

首次运行 claude 命令后,会跳转浏览器完成认证,支持以下账号类型:

  • Claude Pro / Max / Team / Enterprise(推荐,订阅制)
  • Claude Console(API 预付费;首次登录自动在 Console 创建「Claude Code」工作区,用于集中追踪费用)
  • Amazon Bedrock / Google Vertex AI / Microsoft Foundry(企业云服务商接入)

认证信息存储在本地,后续无需重复登录。会话内可用 /login 切换账号或重新认证。

开启第一个会话

进入任意项目目录后启动:

cd /path/to/your/project
claude

启动界面会显示版本号、当前模型和工作目录。Claude Code 会自动读取项目文件,无需手动添加上下文。常用探索性提示词:

  • what does this project do? —— 了解项目概况
  • what technologies does this project use? —— 技术栈一览
  • explain the folder structure —— 目录结构说明
  • where is the main entry point? —— 主入口定位

输入 /help 查看可用命令,/resume 继续上一次对话。

核心操作场景

修改代码:用自然语言描述需求,Claude 会定位文件、展示变更预览、征得同意后写入。默认每次修改前都会询问确认,也可开启「Accept all」模式批量接受。

add a hello world function to the main file

Git 操作:自然语言代替命令行,例如:

what files have I changed?
commit my changes with a descriptive message
create a new branch called feature/quickstart
help me resolve merge conflicts

调试与功能开发:

there's a bug where users can submit empty forms - fix it
add input validation to the user registration form

Claude Code 会定位相关代码、理解上下文、实现方案,并在有测试时自动运行测试。

其他常见场景:重构(如将 callback 改为 async/await)、编写单元测试、更新 README、代码审查,均可用一句自然语言描述完成。

命令速查

Shell 命令(在终端中运行)

命令用途
claude启动交互模式
claude [任务描述]执行单次任务后退出
claude -p [查询内容]单次查询后退出
claude -c继续当前目录最近一次对话
claude -r恢复历史会话

Session 命令(会话内使用)

命令用途
/clear清除对话历史
/help查看可用命令
/exit 或 Ctrl+D退出 Claude Code

完整命令列表见官方 CLI 参考 和 Session 命令参考。

初学者实用技巧

  • 具体描述需求:不要只说「fix the bug」,要说清楚是哪个模块、什么症状,例如「fix the login bug where users see a blank screen after entering wrong credentials」
  • 拆分复杂任务:将多步骤需求逐条列出,Claude 会按顺序执行
  • 先探索再修改:执行变更前,先让 Claude 用 analyze the database schema 等提示理解代码上下文
  • 快捷操作:输入 / 查看所有命令与技能;Tab 自动补全;↑ 查看历史;Shift+Tab 切换权限模式
  • 对话式协作:把 Claude Code 当做结对编程的同事,描述你想达成的目标,而非逐行指定操作

延伸阅读

Claude Code 还提供 Web 版、桌面 App、VS Code / JetBrains 插件、Slack 集成及 GitHub Actions / GitLab CI 等多种接入方式,具体见官方 接口总览。

查看官方原文:Claude Code Quickstart← 返回 Blog