~/ai-manual/claude-code ❯ ls claude-code

Claude Code

先完成第一次真实修改，再沿着控制、日常任务、项目规则、扩展与自动化一路进阶。

持续更新 · 保持最新官方内容核验至 2026 年 9 月 · 当前基线 Claude Code v2.1.251 查看官方更新日志

❯

选对入口并完成第一次可回退的修改

别先背概念，三篇完成从安装到第一次真实修改。

01Claude Code 是能直接操作项目的编程代理区分编程代理与聊天助手，并看懂终端、IDE、桌面和云端入口。约 13 分钟主线❯02按平台装好 Claude Code 并确认登录可用完成官方安装、登录和版本验证，并能排查 PATH 与多重安装。约 20 分钟主线❯03用一次真实修改跑通 Claude Code 最小闭环在玩具项目里完成读代码、改代码、审 Diff 和撤销的完整闭环。约 14 分钟主线会员❯

能在会话里停下、改道、撤回并安全放权

文件真的会变之后，马上学会控制过程、恢复现场和收紧权限。

04用快捷键和特殊前缀掌控高频交互掌握中断、回退、切模式、点名文件和多行输入等高频操作。约 19 分钟主线最近更新❯05按任务风险切换计划、速度与自主程度用计划、快速、Vim 和后台模式控制会话过程与自主程度。约 27 分钟主线最近更新❯06分清检查点能撤回什么、不能撤回什么检查点只能回滚编辑与对话，Bash 副作用仍需 Git 兜底。约 28 分钟主线会员❯07用模式和规则把权限放到刚刚好用权限模式控制整体自主权，再以 allow、ask、deny 精细收口。约 20 分钟主线最近更新会员❯08用沙箱、权限和人工审批守住安全边界用程序权限、沙箱和人工审批共同防范注入与敏感数据泄露。约 27 分钟主线最近更新会员❯

选定适合自己的工作入口、账号与成本组合

已经跑通过一次任务，再按工作地点、账号和预算选择长期方案。

09在 VS Code 里精准给上下文并审阅改动通过文件提及、选区和并排 Diff，在 VS Code 内精准协作。约 17 分钟选读会员❯10把 JetBrains 与 CLI、Diff 审阅正确接通插件负责连接 IDE 与 CLI，重点处理启动目录、Diff 和平台排障。约 24 分钟选读会员❯11用桌面 App 隔离并行任务并集中审阅桌面端用 Worktree 隔离并行会话，并集中审阅文件和终端结果。约 21 分钟选读最近更新会员❯12按代码运行位置选择网页、云端或远控按代码运行位置区分网页版、云端委派、远程控制和深链接。约 21 分钟选读最近更新会员❯13看清订阅、API Key 与模型的实际生效顺序订阅与 API Key 会按优先级竞争，实际身份应以状态页核验。约 18 分钟主线最近更新会员❯14按用量和上下文成本选择付费方案费用由模型、Token 和上下文共同决定，先查用量再选择套餐。约 18 分钟主线最近更新会员❯15先验证协议与鉴权，再决定是否换第三方模型第三方接入依赖兼容端点、鉴权变量和模型映射，必须实测请求。约 20 分钟进阶最近更新会员❯16在账号与设备支持时用语音输入长需求语音模式把云端听写送入输入框，但受账号、设备和语言限制。约 23 分钟选读会员❯

能稳定完成探索、修复、重构和测试

先建立可复用的任务方法，再用亲手跑过的过程理解 Agent loop。

17用范围、上下文、约束和验收减少返工把范围、上下文、约束和验收说清，才能减少猜测与返工。约 15 分钟主线会员❯18用固定流程完成四类最高频开发任务探索、修复、重构和测试各有固定顺序，终点都是可验证结果。约 14 分钟主线会员❯19用截图补足文字难以还原的现场截图适合补充报错、界面和架构现场，减少冗长而失真的描述。约 14 分钟主线最近更新会员❯20从立规矩到提交走完一次真实需求按立规矩、探索、规划、修改、验证和提交走完一次真实需求。约 26 分钟主线会员❯21从已经跑过的任务看懂代理怎样推进Claude 通过读取、执行和观察结果循环推进，用户可随时介入。约 14 分钟主线最近更新会员❯

让项目规则、上下文和偏好跨会话持续生效

当重复交代开始变成负担，再建立项目级规则、配置和记忆。

22用 `/init` 生成项目说明书初稿`/init` 只生成基于代码事实的说明书草稿，团队约定仍需补写。约 16 分钟主线会员❯23把必须持续生效的项目规则写进 CLAUDE.md把持续生效且代码无法自证的规则分层写入 CLAUDE.md。约 19 分钟主线会员❯24分清 `.claude` 中哪些配置跟项目、哪些跟个人分清项目级与用户级配置，决定哪些文件共享、哪些仅留本机。约 19 分钟主线会员❯25用层级和合并规则判断配置为何生效配置是否生效取决于层级、数组合并规则和实际加载来源。约 31 分钟主线最近更新会员❯26按作用域管理认证、网络、超时和隐私变量认证、网络、超时和隐私变量要按作用域设置，并隔离敏感值。约 25 分钟主线最近更新会员❯27主动压缩和切换任务，避免上下文衰退用 context、compact 和 clear 管住有限上下文，避免质量衰退。约 18 分钟主线最近更新会员❯28让确定性规则与自动记忆各归其位确定规则写 CLAUDE.md，经验偏好交给可审计的自动记忆。约 21 分钟主线会员❯29只用输出样式改变回应方式，不存项目规则输出样式只改变角色、语气和格式，不承担项目事实与规则。约 33 分钟主线最近更新会员❯30建立安全、可连接、可复现的开发环境在沙箱、容器、代理、终端和模型之间建立可复现开发环境。约 32 分钟进阶会员❯

把外部能力和重复流程封成可复用工具

先学会选型，再接服务、封流程、拆代理和安装整套扩展。

31按需求选择 CLAUDE.md、Skill、Hook、MCP 或代理按是否外接、强制、隔离或按需加载，选择对应扩展机制。约 22 分钟进阶会员❯32用 MCP 接入外部服务并收紧信任边界MCP 统一接入本地和云端服务，作用域与第三方信任同样重要。约 22 分钟进阶会员❯33用真实浏览器完成登录态测试与网页操作真实浏览器适合登录态测试与操作，但不可逆行为必须人工把关。约 23 分钟进阶最近更新会员❯34用渐进式披露封装可重复调用的能力Skill 以渐进式披露按需加载流程，避免常驻内容占满上下文。约 22 分钟进阶最近更新会员❯35能发现、触发、共享并排查一个 Skill先确认 Skill 可见，再用自然语言或点名触发并排查描述失配。约 19 分钟进阶会员❯36写准触发描述并验证自己创建的 Skill创建 Skill 的难点是写准触发描述，并用真实说法反复验证。约 24 分钟进阶会员❯37用子代理隔离读量大且自包含的脏活子代理用独立上下文承接自包含任务，只把结论交回主线。约 22 分钟进阶最近更新会员❯38只在代理需要协作时启用多会话团队只有任务可并行且代理需要互相沟通时，Agent Teams 才值得用。约 21 分钟实验性最近更新会员❯39用生命周期事件把关键动作变成机器保证Hook 在生命周期事件执行确定动作，把模型请求升级为机器保证。约 28 分钟进阶最近更新会员❯40用内置命令控状态，用自定义命令封流程内置命令控制产品状态，自定义命令可封装参数和现场数据。约 32 分钟进阶最近更新会员❯41安装整套能力前先看清组件和权限插件将技能、代理、Hook 与 MCP 整体安装，使用前要审查权限。约 26 分钟进阶最近更新会员❯42按规范制作、测试并发布可移植插件可发布插件必须遵守目录、变量路径、版本和依赖声明规范。约 32 分钟进阶最近更新会员❯

让并行、Git 协作和自动化稳定运行

任务规模变大以后，再进入隔离、交付、脚本化和产品嵌入。

43只把独立且不抢文件的任务并行化并行任务须彼此独立且不抢文件，再用 Worktree 或后台会话隔离。约 28 分钟进阶最近更新会员❯44把可逆 Git 操作交给 Claude，守住远端放行权本地可逆 Git 操作可委派，Push 与强推等远端动作由人放行。约 24 分钟进阶最近更新会员❯45用 CLI、管道和退出码编排非交互任务用命令、标志、管道、结构化输出和退出码把 Claude 接入脚本。约 31 分钟工具书最近更新会员❯46用仓库事件触发云端审查和修改以仓库事件或 @claude 触发审查修改，并把密钥锁进 Secrets。约 30 分钟进阶会员❯47把 Claude Code 的工具循环嵌进程序Agent SDK 复用 Claude Code 的工具循环，适合嵌入程序和自动化。约 29 分钟进阶会员❯48把规则、分工、验证与交付串成中型项目闭环把规则、规划、MCP、分工、回退和 Git 交付串成中型项目闭环。约 29 分钟进阶会员❯

出现偏差时能复盘、排障并快速查证

把方法总结、故障排查、术语和生态案例留作按需查阅。

49用上下文管理和自验证建立稳定工作法保护上下文并提供验收方式，是减少跑偏与返工的总原则。约 28 分钟主线会员❯50识别七类会系统性拖垮质量的错误用法识别任务过载、规则膨胀、长会话、盲信和过度放权七类反模式。约 31 分钟主线会员❯51先分诊问题类型，再用日志和对照定位先按安装、认证、配置、性能和 API 分诊，再用 Debug 对照定位。约 34 分钟工具书最近更新会员❯52按六类概念快速查清 Claude Code 术语按代理、上下文、扩展、MCP、安全和入口六族查询术语。约 34 分钟工具书最近更新会员❯53用程序化视频案例探索能力边界Remotion 把视频转为 React 帧动画，适合程序化和批量生成。约 29 分钟选读会员❯