入门指南

快速上手

快速上手这一页讲的，就是快速上手这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

Quickstart

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这一页就是带你把 Claude Code 领进门，从安装、登录到交第一件活。

重点不是把所有概念一口气背熟，而是尽快在自己项目里跑通第一次完整操作。

像新买一台农机，你别先研究发动机原理，先学会怎么打火、怎么挂挡、怎么下地试一小垄。

Quickstart 也是这个思路：装好工具，进到项目目录，让它先认门，再给一个不大的活，看它会不会按规矩干。

只要第一次跑通了，后面修 bug、补测试、整理文档，都是同一路数往上加。

最稳的路线就是：安装 Claude Code，进入项目目录，敲 `claude`，先问项目结构，再交一个小任务。

第一次不要直接让它大改。先让它解释目录、指出入口文件、描述技术栈，确认它没有认错门。

等它能把小活做对，再逐步让它修 bug、写测试、整理 Git 提交。

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

第一次开工

进到你的项目目录后，直接敲 `claude`。第一次它会带你登录，认完主就能开始问和改。

cd your-project
claude

先让它看明白现场

不要一上来就扔大活，先让它介绍项目、入口文件和目录结构。

what does this project do?
where is the main entry point?
explain the folder structure

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

Before you begin

这一块主要是在说"Before you begin"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Step 1: Install Claude Code

看到这里，就把"Step 1: Install Claude Code"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

终端里敲

Step 1: Install Claude Code 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

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

终端里敲

Step 1: Install Claude Code 2

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

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

终端里敲

Step 1: Install Claude Code 3

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

终端里敲

Step 1: Install Claude Code 4

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

brew install --cask claude-code

终端里敲

Step 1: Install Claude Code 5

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

winget install Anthropic.ClaudeCode

Step 2: Log in to your account

这一段主要是在把"Step 2: Log in to your account"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Step 2: Log in to your account 1

先别急着往下翻，下面这条命令跑完，心里才有底。

claude
# You'll be prompted to log in on first use

直接对 Claude 说

Step 2: Log in to your account 2

最省事的做法，就是把下面这句原样说给 Claude。

/login
# Follow the prompts to log in with your account

Step 3: Start your first session

这里不是让你背"Step 3: Start your first session"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Step 3: Start your first session

真到动手的时候了，下面这条直接敲一遍，看它回什么。

cd /path/to/your/project
claude

Step 4: Ask your first question

这一段主要是在把"Step 4: Ask your first question"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

直接对 Claude 说

Step 4: Ask your first question 1

最省事的做法，就是把下面这句原样说给 Claude。

what does this project do?

直接对 Claude 说

Step 4: Ask your first question 2

最省事的做法，就是把下面这句原样说给 Claude。

what technologies does this project use?

直接对 Claude 说

Step 4: Ask your first question 3

最省事的做法，就是把下面这句原样说给 Claude。

where is the main entry point?

直接对 Claude 说

Step 4: Ask your first question 4

最省事的做法，就是把下面这句原样说给 Claude。

what can Claude Code do?

Step 5: Make your first code change

这一块主要是在说"Step 5: Make your first code change"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Step 6: Use Git with Claude Code

这里不是让你背"Step 6: Use Git with Claude Code"这个词，而是让你看它真干活时怎么使。

直接对 Claude 说

Step 6: Use Git with Claude Code 1

这里不用敲命令，直接把下面这句话发给 Claude 就行，让它按"Step 6: Use Git with Claude Code"这一段的意思去办。

what files have I changed?

关键片段

Step 6: Use Git with Claude Code 2

下面这块是这一段最值钱的原文样板，先对着看一眼。

create a new branch called feature/quickstart

Step 7: Fix a bug or add a feature

这里不是让你背"Step 7: Fix a bug or add a feature"这个词，而是让你看它真干活时怎么使。

终端里敲

Step 7: Fix a bug or add a feature

真到动手的时候了，下面这条直接敲一遍，看它回什么。

add input validation to the user registration form

Step 8: Test out other common workflows

看到这里，就把"Step 8: Test out other common workflows"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

关键片段

Step 8: Test out other common workflows

先看下面这块原始片段，等会儿再回头看解释会顺得多。

refactor the authentication module to use async/await instead of callbacks

Essential commands

这里不是让你背"Essential commands"这个词，而是让你看它真干活时怎么使。

Pro tips for beginners

这一块主要是在说"Pro tips for beginners"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

关键片段

Pro tips for beginners

"Pro tips for beginners"这一段里最要紧的原始写法在下面，先看它怎么落地。

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

What’s next?

这里不是让你背"What’s next?"这个词，而是让你看它真干活时怎么使。

How Claude Code works

这里讲底层是怎么运转的。你把它看明白，后面遇到异常时就知道该往哪儿查。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Best practices

这段算经验活，听劝通常能省事。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Common workflows

看到这里，就把"Common workflows"当成一件真要上手的活来看。

Extend Claude Code

这一块主要是在说"Extend Claude Code"真到手上该怎么用，哪里最容易踩坑。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

Getting help

看到这里，就把"Getting help"当成一件真要上手的活来看。

照着做一遍

如果你只想今天就把它跑起来，最省事的路就是按这四步来，不要东跳西跳。

每做完一步就验一下，确认没偏，再往下走。

终端里敲

第 1 步：先装工具

挑跟你机器对应的安装命令。装完别急着干别的，先确认命令能认出来。

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

终端里敲

第 2 步：进到你的项目目录

Claude 最怕认错门。你先站到项目根目录，再开工。

cd your-project
pwd

终端里敲

第 3 步：启动并登录

第一次会先认主。登录跑通后，后面才能正常派活。

claude

直接对 Claude 说

第 4 步：先交一个很小的活

别一上来让它大改。先让它介绍项目、找入口、讲目录，确认它没有看错现场。

what does this project do?
where is the main entry point?
explain the folder structure

上手路线图

别一上来就扔大工程，先让它认门、认地、认工具。

装工具 -> 登录 -> 进项目
        |
        v
先问路 -> 交小活 -> 看结果
        |
        v
再让它修真问题

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。