通俗版 Claude Code 文档

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

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

入门指南

Claude Code 是个啥

Claude Code 是个啥 这一页讲的,就是 Claude Code 是个啥 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

Overview

页面性质

第三方中文解释页

使用建议

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

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

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

这一页先讲明白

Claude Code 不是只会聊天的机器人,它更像能下地干活的电子帮工。

它能进项目里看代码、改文件、跑命令、验结果,而且终端、编辑器、网页这些地方都能接着用。

你可以把 Claude Code 当成一个识字快、腿脚也快的帮工。你交代“去看看这屋哪漏雨”,它真会去翻梁、看瓦、找裂缝,不是只站在旁边空出主意。

更关键的是,它改完还能自己试。比如修了代码,会顺手跑构建、跑测试、看报错,像师傅补完水管自己先开阀门试一遍。

这一页最想告诉你的就一句话:别把它当问答机,要把它当能看现场、能动手、能验活的帮手。

第一次接触它,先知道它能在哪些地方用,再挑一个你最顺手的入口开工,通常是终端或编辑器。

交代任务时尽量像报修一样说清楚:哪儿坏了、你想修成什么样、改完怎么验收。

如果你后面准备继续深用,下一步就该去看 Quickstart、Memory、Best practices 这些更实操的页。

预留广告位

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

Documentation Index

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

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

Get started

这一段是在帮你从几个选项里挑 your environment to get started. Most surfaces require a Claude subscription or Anthropic Console account. The Terminal CLI and VS Code also support third-party providers.。重点不只是知道有哪些,更是看代价和场景。

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

终端里敲

Get started 1

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

curl -fsSL https://claude.ai/install.sh | bash
终端里敲

Get started 2

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

irm https://claude.ai/install.ps1 | iex
终端里敲

Get started 3

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

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
终端里敲

Get started 4

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

brew install --cask claude-code

What you can do

这里不是让你背"What you can do"这个词,而是让你看它真干活时怎么使。

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

终端里敲

What you can do 1

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

claude "write tests for the auth module, run them, and fix any failures"
终端里敲

What you can do 2

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

claude "commit my changes with a descriptive message"
终端里敲

What you can do 3

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

# Analyze recent log output
tail -200 app.log | claude -p "Slack me if you see any anomalies"

# Automate translations in CI
claude -p "translate new strings into French and raise a PR for review"

# Bulk operations across files
git diff main --name-only | claude -p "review these changed files for security issues"

Use Claude Code everywhere

这一段主要是在把"Use Claude Code everywhere"讲实,不是只摆个标题给你看。

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

Next steps

这里不是让你背"Next steps"这个词,而是让你看它真干活时怎么使。

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

照着做一遍

这页属于“Claude Code 是个啥”这类活,最稳的办法还是一小步一小步来。

下面这三步不一定华丽,但通常最不容易绕晕。

第 1 步:先起步

第一次接触它,先知道它能在哪些地方用,再挑一个你最顺手的入口开工,通常是终端或编辑器。

第 2 步:边做边看

交代任务时尽量像报修一样说清楚:哪儿坏了、你想修成什么样、改完怎么验收。

第 3 步:收尾防出错

如果你后面准备继续深用,下一步就该去看 Quickstart、Memory、Best practices 这些更实操的页。

一眼看懂它怎么干活

你负责把活说明白,它负责看现场、动手修、再回来汇报。

你开口派活
   |
   v
[Claude Code]
/   |   \
看代码 改文件 跑命令
   |
   v
把结果回给你

文末提醒

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

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