原创实战指南

Claude Code 原创实战指南:新手上手、报错排查、选型和案例复盘

如果说 docs 页面更像“原文旁边的中文解释版”,那这里这几页就是另外起锅做的家常菜。

重点不在逐段对应官方原文,而在把新手真会碰到的选择、顺序、坑和判断标准拎出来说清楚。

先看哪几页

第一天上手清单

适合刚装好 Claude Code,还不知道先干什么的人。

新手最容易犯的 10 个错

适合已经开始用,但总觉得不顺手、老返工的人。

Sub-agents、Plugins、MCP 怎么选

适合看到一堆功能名词,分不清谁该在什么时候上的人。

安装对照版

适合分不清 Windows、macOS、Linux 该看哪段的人。

常见报错排查清单

适合一遇到报错就想大改配置的人。

小团队落地手册

适合想把 Claude Code 带进团队,但又不想一上来搞太重的人。

权限边界怎么拿捏

适合老是在“全开”和“全关”之间摇摆的人。

和别的工具怎么选

适合在 Claude Code、Cursor、Copilot、ChatGPT 之间拿不准的人。

新手提问模板

适合明明会打字,但不会派活的人。

这个站怎么做内容

适合想知道这个站不是怎么胡乱拼出来的人。

编辑和更新原则

适合想看这个站怎么处理同步、改写和纠错的人。

内容方法总览

适合想一页看懂这个站怎么做内容的人。

站点说明 FAQ

适合想先把“这站是什么、是不是官方、为什么这样做内容”问明白的人。

安装失败先查什么

适合装不上或装完命令找不到的人。

登录失败怎么排

适合账号、认证、入口老是卡住的人。

权限卡住怎么判断

适合老分不清读不了、写不了还是执行不了的人。

MCP 连不上时先查什么

适合一碰 MCP 就觉得它特别玄的人。

插件装不上时先查什么

适合插件来源、目录、依赖老出问题的人。

Hooks 不触发时怎么排

适合明明配了 hook,却一直没响的人。

Sub-agent 没起作用怎么办

适合分工看起来做了,结果还是一团乱的人。

设置改了却不生效

适合总觉得“明明写了怎么没吃进去”的人。

编辑器接不上时先查什么

适合 VS Code / JetBrains 集成不顺的人。

命令跑不起来时怎么排

适合命令能看见、却老跑不通的人。

第一次上手的一周会怎么走

适合想看真实上手节奏,而不只想看功能说明的人。

小团队试点怎么走最稳

适合想推进团队试点,但又不想一开始就搞很重的人。

小 bug 修复节奏案例

适合想看 Claude Code 怎么把一件小活从头收尾的人。

权限怎么一步步放开

适合不想一上来全开,但又怕卡住活的人。

现在申请 AdSense 还差什么

适合站长自己回头看站点还缺哪几步的人。

申请前最后怎么把整站过一遍

适合准备正式去申请前,再把整站门面和检查命令一起过一遍的人。

这一页怎么用

如果你只是想解决眼前一个问题,就优先看“安装失败”“登录失败”“权限卡住”“MCP 连不上”这类问题页。

如果你是想长期把 Claude Code 用顺,再回头看“内容方法总览”“编辑和更新原则”“站点说明 FAQ”“现在申请 AdSense 还差什么”“申请前最后怎么把整站过一遍”这几页,就能更清楚这站是怎么维护和扩展的。