Claude Code 教程

按官方文档整理的 Claude Code 安装步骤：三种系统各用哪条命令、装完怎么验证、第一次怎么登录、怎么更新和卸载，以及安装时最常见的几个报错是什么意思。

装好 Claude Code 之后做什么：本站在一台 Linux 服务器上，用 Express 的源码把三件事实际做了一遍，让它讲清楚项目、找到并修好一个 bug、提交改动。文中是真实的终端输出，以及第一次启动会看到的界面、auto 模式的表现和这一趟花了多少。

CLAUDE.md 是 Claude Code 每次开工都会读的项目说明。本站在 Express 的源码上实测：/init 生成了什么，加三条规矩后它照没照做，按路径生效的规则什么时候加载，AGENTS.md 怎么被读到。并整理了官方对写什么、不写什么、放在哪的说明。

Claude Code 能改文件、跑命令，什么时候该先问你，由权限模式决定。本站把几种模式逐个实测了一遍：Shift+Tab 的切换顺序、两种确认框、plan 模式怎么出方案、auto 模式遇到危险动作怎么处理，以及按两下 Esc 能退回什么、退不回什么。

Claude Code 的对话存在本机，关掉终端也能接着干。本站实测了 --continue、--resume、给会话起名、/branch 开分支，以及 /clear 和 /compact 前后上下文占用的变化：读了四个文件后消息占 41k，压缩后降到 13.8k，并验证了压缩之后哪些细节还在、哪些没了。

根据 Claude Code 团队的三篇官方文章整理：一个任务的花费由什么决定，effort 五个档位各适合什么活，什么时候该换模型，怎么不让缓存白白失效，以及怎么用 /usage 看自己的用量。

按 Claude Code 官方文档整理：不想整天待在终端里，还有三个图形入口。VS Code 扩展自带一份命令行；JetBrains 插件不带，要先装命令行；桌面应用什么都不用装，但要订阅。讲清各自怎么装、怎么打开、和命令行比少了什么、配置和会话是不是通用，以及通过中转站用时各自在哪里设置。本站尚未实测。

一个启动就崩的应用，报错出在依赖包里，根因在自己的代码里。本站用同一个 bug 实测了两种问法：把现象、复现办法和做完的标准说清楚，和只说一句“修一下”。两次都修对了，差别在有没有回归测试、改动能不能回退。附一份提 bug 的提示词模板。

让 AI 补测试，最怕补出一堆只为凑覆盖率的用例。本站在 Express 的源码上实测了一个两步的做法：先让它找出没测到的代码并按风险排序，再补测试，并要求每个用例都通过“把代码改坏、确认测试会失败”的验证。附真实过程、它自己纠正的一处误判和我们的复核。

重构怕的是改着改着范围失控、改坏了又退不回去。本站在 Express 的源码上实测了一次 var 到 const/let 的迁移：plan 模式下它查出 222 处声明和两处不能直接替换的地方，计划里有一处和源码不符被我们核对出来；执行时一步一个提交。还验证了一点：用命令批量改的文件，回退菜单退不回去，要靠 git。

测试全绿不等于没问题。本站在 Express 的源码里放了一处“测试和 lint 都过、但条件写反了”的改动，用本地的 /code-review 审了两轮：第一轮 24 秒查出写反的条件，修完再审，又查出一个要人来定的设计问题。讲清这个命令审什么、怎么用，以及让它起草带风险说明的 PR 描述。

按 Claude Code 官方文档整理：装上 Claude in Chrome 扩展，Claude Code 就能自己打开页面、点按钮、填表单、读控制台报错，改完前端代码当场验证。讲清怎么开启、站点权限怎么管、常见用法和连不上怎么查。先说一条限制：它要求用 Claude 订阅账号登录，通过中转站用不了。本站尚未实测。

仓库一大，Claude Code 的上下文容易被无关的约定和文件占满。本站在一个三个包的示例仓库上实测了官方的几样办法：分层的 CLAUDE.md、排除不相干的包、拒绝读第三方代码、追加兄弟目录、稀疏 worktree。要留意：拒绝读取的规则挡不住 grep -r；auto 模式下它会改启动目录以外的文件。

改了设置没反应，多半是写错了文件，或者被更高一层盖住了。本站实测了项目共享、项目本地和命令行三层的先后，权限规则跨文件合并，哪些值写在项目文件里不生效，以及设置写坏时的表现：多一个逗号整份文件作废，键名拼错则一声不吭。附 ~/.claude 目录里它自己存了哪些数据。

状态栏是输入框下面的一行，内容由你写的脚本决定。本站实测了从零配一个：先看 Claude Code 实际发来哪些数据，再显示模型、分支、上下文进度条和花费，加一行提示缓存的倒计时。附它什么时候刷新、脚本出错时为什么整行消失、怎么从调试日志里找原因，以及通过中转站用时少了哪些数据。

Claude Code 默认就能用，但有几处天天碰到的小别扭：想换行却发出去了，跑完了没人提醒，屏幕闪，回答太啰嗦。本站逐项实测了对应的开关：两种不用配置的换行办法、自定义快捷键、全屏渲染、四种内置输出风格和自己写一种。要留意：快捷键写错了不报错，只记在调试日志里。

官方的工具、命令、环境变量三张参考表加起来五百多项。本站按用途各挑出最常用的一批，并实测了几件容易弄错的事：这台 Linux 上实际只加载了 21 个工具，没有 Glob 和 Grep；Bash 里 export 的变量留不到下一条命令；模型的环境变量盖过设置文件，命令行参数又盖过环境变量。

从零写一个 Claude Code skill：建目录、写 SKILL.md、测试；再讲放在哪里、怎么传参数、怎么带脚本和参考文件、怎么控制谁能调用，以及 Claude Code 团队总结的写 skill 的几条经验。

Mods 让你用几行 JavaScript 改写 Claude Code 的行为和界面。本文说明它和 hooks、skills 的区别，怎么安装和关闭，以及安装前要注意的安全问题。

跟着官方教程的思路，从一个空文件夹写出一个 Claude Code mod：在输入框上方实时显示上下文窗口的占用。讲清目录结构、怎么画界面、数据为什么要放在 $.state、怎么校验和测试、怎么分享。

Hooks 是你写的 shell 命令，Claude Code 在固定时机一定会执行，不取决于模型愿不愿意。本站实测了三个：改完文件自动跑 eslint --fix，拦下对受保护文件的修改，等待批准时提醒你。附配置、脚本、真实的拦截画面，和它管不到的地方。

MCP 让 Claude Code 用到内置工具以外的东西：查文档、查工单、查数据库。本站实测了三件事：一条命令接上官方的文档服务器；用三十多行代码写一个自己的服务器并接上；改成项目级配置给团队共用，以及第一次打开时的批准提示。附每一步的真实输出和排错办法。

子代理是一份 Markdown 文件：给它一个名字、一段说明、一份工具清单，Claude Code 就能把一类任务交给它在独立的上下文里做。本站实测了一个只读的测试评审员，它查出了上一篇里补的测试的真问题。还试了让子代理换用便宜的模型，并记下通过中转站时遇到过的一条报错。

Claude Code 的扩展方式有六七种，名字相近，容易用错地方。按官方的选型说明整理：每一种解决什么问题、什么信号出现时该加哪一种、相近的几种怎么区分、各占多少上下文。占用的数字用的是本站这个系列实测到的。

插件是一个带清单文件的目录，把 skill、子代理、hook、MCP 服务器装在一起，可以整包分享和安装。本站把本系列前面做的三样东西打成了一个插件，实测了校验、单次加载、建本地市场、按项目安装和移除。要留意的一个结果：把 skills 目录放错位置，校验照样通过，但 skill 不会加载。

代码智能插件把语言服务器接给 Claude：改完代码自动拿到类型错误，按符号找定义和引用。本站用 TypeScript 实测，连踩三个坑才跑通，并发现第一次编辑的诊断要等到下一步才到。后半篇讲装一个插件之前怎么看清它会在你机器上运行什么，以及卸载之后还留下什么。

插件给团队用起来之后，改一句 skill 的描述都可能让它不再被触发。本站实测了 claude plugin eval：给示例插件写两个用例，带插件和不带插件各跑三遍，12 次运行 27 秒、0.28 美元，直接看出插件贡献了多少。后半篇整理怎么看插件占多少上下文、怎么声明依赖、怎么发版本和托管自己的市场。

mod 出了错不会让会话崩掉，它只是被悄悄跳过，看上去像什么都没做。本站用官方教程的示例 mod 实测了两件事：用 claude plugin test 写不开会话、不联网的测试，三个测试 0.67 秒跑完；再把 mod 故意弄坏五种方式，记下静态检查查得出哪几种、哪几种要到运行时才报、报错出现在哪。

channels 让外面的事件自己进到一个开着的 Claude Code 会话里：CI 挂了、监控报警、你在 Telegram 上发的一句话。本文整理它是什么、和远程控制等方式的区别、官方插件怎么配、怎么自己写一个、安全上要守住什么。本站通过中转站试了一次，结果是用不了，文中给出看到的提示。

云端会话让 Claude Code 在一台全新的云端虚拟机上干活，合上电脑也不会停，可以同时开好几个。本文说明谁能用、怎么开始、怎么连接 GitHub、适合的七种用法，以及有哪些限制。

Projects 是 Claude Code 的新功能，目前对 Pro 和 Max 公测：一个长期的对话里，Claude 把你交代的事拆成一个个并行的云端会话来做，并跟踪每一个的进度。本文说明它适合什么、怎么建、怎么看进度、用量怎么算，以及有哪些限制。

根据 @N01ennn 的长文整理并逐条对照它引用的来源：让模型的产出稳定下来，靠的是提示词外面的三样东西，每次都读的规则文件、必须过关的检查、跑到过关为止的循环。以用代码做动画为例，讲清怎么在 Claude Code 里用 CLAUDE.md、skill、/goal 和 /loop 把它们搭起来。

两个 Claude Code 会话同时改同一个仓库，文件会互相覆盖。加一个 --worktree 参数，每个会话就有自己的一份文件和自己的分支。本站实测了两个会话同时改同一个文件：各自提交、互不影响、最后合并无冲突。讲清它从哪个提交开始、依赖怎么办、退出时怎么清理。

代理团队是一项实验功能：一个会话当组长，开出几个各有独立上下文的队友，队友之间能直接互发消息。本站实测了一个三人的评审团队：三个队友互发了 20 条消息，推翻了组长清单里的一条错误结论。也记下了协调上的毛病：有人没等别人的发现就交了报告，行号要组长复核。整个会话估算 1.51 美元。

claude -p 让 Claude Code 不带界面运行，可以放进脚本和 CI。本站实测了管道、JSON 输出、按结构返回、dontAsk 加允许列表、轮数上限和 --bare。要留意：操作被拒绝时退出码仍是 0；--bare 把一次最简单调用的估算花费从 0.14 美元降到 0.008 美元。附验证过的检查脚本。

按 Claude Code 官方文档整理：把 Claude Code 装进 GitHub 仓库的工作流，在 issue 或 PR 里 @claude 就能让它分析、改代码、推提交，也可以开 PR 时自动审查、按计划定时跑。讲清两种安装方式、凭据怎么放、谁能触发、怎么控制花费，文末带 GitLab 的做法。本站尚未实测。

手上有几件互不相干的事要交给 Claude Code，不想开一排终端盯着。agent view 把它们变成一张表：谁在干活、谁在等你回答、谁做完了。本站在服务器上实测了派发、回答提问、进入对话、删除会话，以及让一个会话去问另一个会话。通过中转站都能用。

四样东西都把 Claude Code 接到终端以外：点一个链接就打开带好提示的会话；把结果发布成一个能分享的网页；让它操作你 Mac 上的图形界面；在 Slack 里 @ 它干活。本文整理每一样做什么、要什么账号和系统。走中转站时只有深链接能用，本站在服务器上核对了这一点。

Remote Control 让你在手机或另一台电脑的浏览器上，接着操作自己电脑上正在跑的 Claude Code 会话，代码和文件都留在本机。本文整理它的条件、三种启动方式、推送通知、安全上要知道的事，以及手机端能做的四件事。它要求 claude.ai 账号并且直连官方接口，走中转站用不了。

沙箱是操作系统替你看住的一道边界：Claude 跑的命令只能写工作目录，联网要过一个只放行指定域名的代理。本站在 Ubuntu 24.04 上从安装开始实测：Ubuntu 上多出来的一步、默认读得到凭据怎么堵、命令在哪几种情况下会跑到沙箱外面，以及一个 Linux 上的坑：沙箱里 git add -A 会失败。

security-guidance 是官方的一个插件，装上后在 Claude 改文件、每轮结束、提交时各做一次安全检查。本站把三层都实测了：它查出了我们故意留的 SSRF、开放重定向和凭据外泄。也记下两个让后两层悄悄失效的坑：缺 Python 依赖，以及中转站拦了插件的请求。失效时会话里没有提示，附从日志确认的办法。

Claude Security 是官方的深度扫描插件：几个代理分头读代码找漏洞，再由三个评审各自投票，通过的才进报告。本站在一个埋了问题的小应用上跑了两次：都找到了路径穿越，还找出一个我们没埋的崩溃问题并验证属实；但两次的结论数量和评级不一样，出补丁两轮都被它自己的评审否决。合计 3.70 美元。

报错分三类：装不上、请求报错、配置不生效。本站用假地址和假 key 把常见的请求报错逐个复现，记下原文和原因。两个容易误判的：接口地址多写一级 /v1，报的是“模型有问题”；settings.json 写坏了，claude -p 照常运行、没有提示。附 claude doctor、--debug 的用法。

/usage 只看得到当前会话。Claude Code 能把花费、token、每次模型请求和工具调用通过 OpenTelemetry 导出来。本站用一个五十行的脚本当接收端做了实测，记下三件容易弄错的事：指标是增量不是累计，默认不带提示词和命令内容，写在项目设置里不生效。

advisor 让便宜的主模型在关键时刻请教一个更强的模型：定方案之前、同一个错反复出现时、宣布做完之前。本文整理它怎么开、哪些模型能配对、怎么计费。本站通过中转站实测的结果是用不了：命令不存在，启动参数被悄悄忽略，没有任何报错。原因在文档里能找到，附三种替代办法。

根据 Claude Code 团队的文章整理：他们怎么决定给模型什么工具。提问工具试了三次才做对，待办清单因为模型变强反而成了束缚，检索从向量库换成让模型自己搜索，以及不加新工具就能加功能的“渐进式披露”。

根据 Claude Code 团队的文章整理：他们把整个产品围绕提示词缓存来设计。缓存按前缀匹配，所以提示词的顺序、会话中途换模型、增减工具、压缩上下文的做法，都会决定缓存还在不在。讲清这五条经验，以及对使用者和开发者各有什么用。

根据 Claude Code 团队的文章整理：计划、代码评审、设计稿和报告，为什么让 Claude 写成 HTML 文件比 Markdown 更好读、更好分享，还能做成可以交互的小工具。附五类用法和可以直接改的提示词。

根据 Claude Code 团队的文章整理：动态工作流让 Claude 为眼前的任务临时写一段编排脚本，调度很多个各有独立上下文的子代理。讲清它解决什么问题、六种常见的编排方式、适合和不适合的场景，以及控制用量、保存和分享的办法。

根据 Claude Code 团队的文章整理：他们为 Opus 5、Fable 5 删掉了八成以上的系统提示词，编码评测没有可测的下降。讲清六条“以前和现在”的变化，以及 CLAUDE.md、skill 和参考资料现在该怎么写。

根据 Anthropic 工程师的文章整理：他们在一个 Slack 频道里和 Claude 协作，两周合并三千多个改动，把 claude.ai 的核心体验提速约 3 倍，没有出过事故。讲清“先找到能数的指标”的思路、每个线程的循环、护栏和人的分工。

根据 Claude Code 团队的文章整理：claude-api skill 新增 build-eval 和 hillclimb 两个命令，一个在你的代码库里建评测，一个对着评测一轮改一处地提分。讲清好评测的四个特征、怎么防止过拟合，以及官方的两个例子。

根据 Anthropic 的文章整理：用 Claude Managed Agents 做一个定时读取 Slack 和 GitHub、把要点发到 Slack 的智能体。按来源、去向、代理、定时、记忆、护栏六个部分，讲清每一处常见的失败和官方的六条规则。

根据 @xilo2991 的长文整理并核对了案例原帖、skill 仓库和官方文档：Opus 5.5 不会生成视频，它写代码把画面一帧帧画出来。讲清七类代码方案各适合什么画面、五个公开案例怎么组合、七块结构的提示词怎么写，以及让出片更稳的 CLAUDE.md 和自查办法。