通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

入门指南

快速上手

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

页面信息

对应原页

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,这里再放正式广告。

照着做一遍

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

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

终端里敲

第 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 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

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