Getting started

Quickstart 快速上手

手把手带你把电子帮工领进门，从装工具到交第一件活，像新农具下地先试一垄。

原页来源：官方 Quickstart

一句人话

这一页讲的就是：别先研究一大堆原理，先把这个电子帮工领回家，给它开门、认路、交第一件活。像买了台新农机，先别急着琢磨齿轮怎么转，先学会加油、打火、开到地里试一圈。

官方 Quickstart 的主线很直白：先准备家伙事，再安装、登录、进项目、问问题、改代码、配合 Git，最后再学几个常用口令和少走弯路的招数。

开工前，先把三样东西备齐

1. 一个终端窗口。就像你得先把院门打开，帮工才能进来听活。

2. 一个代码项目。总得有块地、有间房，它才知道去哪儿翻土、哪儿补墙。

3. 能登录 Claude Code 的账号。官方写的是 Claude 订阅、Claude Console，或者接到支持的云服务上。

这页主要教的是终端版。不过官方也特别提醒：网页端、桌面端、VS Code、JetBrains、Slack、GitHub Actions、GitLab 这些地方也都能用，同一个电子帮工不只待在一个工棚里。

第一步：把帮工请进门

官方给了三种安装法。你不用全学，会一条顺手的就行。

原生安装，官方最推荐

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

官方还特别提醒：Windows 机器先装好 Git for Windows，不然像地里缺了扳手，后面不少活干不顺。

原生安装会自动在后台更新，省得你老惦记着“这农具是不是又过期了”。

Homebrew

brew install --cask claude-code

以后升级：

brew upgrade claude-code

WinGet

winget install Anthropic.ClaudeCode

以后升级：

winget upgrade Anthropic.ClaudeCode

第二步：先认主，再干活

装完以后，先让它认你是谁。第一次最常见就是直接敲：

claude

第一次运行时，系统会带你登录。你也可以先进程序后再敲下面这条：

/login

官方列了几条登录路子：Claude Pro、Max、Teams、Enterprise 最省心；也能用 Claude Console，或者企业常见的 Amazon Bedrock、Google Vertex AI、Microsoft Foundry。

你可以把这一步想成给帮工发门禁卡。卡没办好，再能干的人也进不了仓库。

第三步：带它进项目现场

别站在空地上瞎喊。先切到你的项目目录，再启动 Claude Code：

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

如果你还不确定这工具能干啥，也可以直接问：

what can Claude Code do?
how do I create custom skills in Claude Code?
can Claude Code work with Docker?

这一步的目的不是闲聊，是让它先把院子看明白，后面动手才不容易砸错墙。

第五步：交第一件小活，让它先露一手

官方给的示例很简单，适合第一次试手：

add a hello world function to the main file

按官方描述，它一般会先找对文件，再把改动方案给你看，问你同不同意，然后才真正下手去改。这就像靠谱的修房师傅，先指给你看“我要拆这块砖、补这道缝”，不会闷头一锤子抡下去。

第六步：让它学会跟 Git 一起干活

写代码不是单打独斗，很多活都离不开 Git。官方给了几句很实用的话：

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

你可以把 Git 想成工地账本。今天挪了哪块砖、昨天谁补了哪面墙、两个人同时改同一根梁怎么办，都记在这里。

第七步：开始修真毛病，或者加真功能

等你确认它认路没问题，就可以给像样点的活：

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

官方写得很实在：它会去找相关代码、理解上下文、想办法实现，再在有测试时顺手跑测试。

这就不是“给你出主意”，而是真进屋查漏水、补裂缝、修完再开水龙头试一试。

第八步：把它当成能干杂活的熟练工

官方还举了几类常见活，你一看就明白范围不小：

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

意思很简单：不只是修 bug，整理旧屋子、补说明书、写检查单、帮你看改动靠不靠谱，这些它都能搭把手。

几条最常用的口令，先记住这些就够用

命令	人话意思	例子
`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`
`claude commit`	帮你生成 Git 提交	`claude commit`
`/clear`	清掉当前对话上下文	`/clear`
`/help`	查看可用命令	`/help`
`exit` 或 `Ctrl+C`	退出 Claude Code	`exit`

新手少走弯路的三句提醒

第一，话要说具体。别说“帮我弄一下”。要像请人种地那样说清楚：翻哪块地，种啥，先后顺序怎么来。

1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

第二，先让它勘察，再让它动手。官方示例里先看数据库结构，再做英国客户退货看板，这就比一上来乱改稳得多。

analyze the database schema
build a dashboard showing products that are most frequently returned by our UK customers

第三，学会偷懒。按 ? 看快捷键，按 Tab 自动补全，按 ↑ 找历史命令，输入 / 看全部命令和 skills。

看完这页，接着往哪走

官方下一步推荐几页，顺序也挺合理。

1. 看 How Claude Code works ：弄明白这帮工为啥会这样看、这样改、这样问你确认。

2. 看 Best practices ：学会怎么交代活，别把好帮手使唤成瞎忙活。

3. 看 Common workflows 和 Extend Claude Code ：把常见套路和扩展玩法都补上。

如果卡住了，官方建议直接在 Claude Code 里敲 /help，或者继续翻文档、进社区问人。