type
status
date
slug
summary
tags
category
icon
password
priority
概览：从 Vibe Coding 到 Agentic Engineering第一部分：Context 是一切CLAUDE.md：最高杠杆点Context 管理的实战纪律第二部分：命令体系与工作流日常高频命令快捷输入CLI 参数与自动化第三部分：Skills 系统内置 Skills自定义 Skill社区资源第四部分：Hooks——确定性自动化层实用 Hook 模式验证放在 Commit 而非 Write第五部分：Subagents 与多 Agent 协作"Master-Clone" vs "Lead-Specialist" 之争Agent Teams 与任务管理第六部分：MCP 服务器生态第七部分：辅助工具生态Agent 编排工具辅助与监控状态栏与 IDE第八部分：核心工作流——Explore, Plan, Implement, Verify第九部分：Agentic Engineering——新的工程范式工业数据点第十部分：Vibe Coding 的是非功过第十一部分：Claude Code vs Cursor第十二部分：值得关注的信号附录附录 A：斜杠命令完整列表附录 B：键盘快捷键完整列表附录 C：CLI 启动参数完整列表附录 D：配置文件层级附录 E：Hook 生命周期事件完整列表附录 F：权限模式
概览：从 Vibe Coding 到 Agentic Engineering
2025 年 2 月，Andrej Karpathy 在 X 上随手创造了 "vibe coding"——"完全交给 AI，不看 diff，连代码都不用看"（原推）。一年后的 2026 年 2 月，他自己宣布这个词过时了，取而代之的是 agentic engineering——"99% 的时间你不是在写代码，而是在协调 agent"（The New Stack）。Simon Willison 随即写了一系列关于 Agentic Engineering Patterns 的文章，将这些实践模式系统化。
这不是简单的术语更替。从 vibe coding 到 agentic engineering，反映的是整个行业从"AI 写代码真酷"到"如何系统性地用 AI agent 做工程"的认知跃迁。Claude Code 作为目前最成熟的 agentic coding 工具之一，正处于这场变革的中心。Anthropic 的研究也表明，AI agent 在软件开发领域的渗透远超其他行业（The Decoder）。
本文从实操出发，系统梳理 Claude Code 的命令体系、Skills 系统、辅助工具生态，以及 agentic engineering 的核心实践模式。
第一部分：Context 是一切
使用 Claude Code 最容易犯的错误，是把它当聊天机器人。它不是。它是一个 agentic 环境——能读文件、跑命令、改代码、自主解决问题。但它有一个根本性的约束：context window 是有限资源，用完即降级。
Anthropic 把这叫做 context engineering——"在 LLM 推理时筛选和维护最优 token 集合的策略"（Anthropic Engineering Blog）。Martin Fowler 也专门写了一篇长文讨论 coding agent 的 context engineering（martinfowler.com）。所有 Claude Code 的最佳实践，本质上都是在围绕这一约束做优化。
SFEIR Institute 的分析发现，最成功的 Claude Code 用户都有一个共同特征：强迫症般地管理 context——通过 CLAUDE.md、积极使用
/clear、文档系统、以及 token 高效的工具设计（SFEIR）。CLAUDE.md：最高杠杆点
但这里有一个反直觉的事实：Claude Code 的系统提示已经包含约 50 条指令，而前沿 LLM 能稳定遵循的指令总量大约在 150-200 条。也就是说，留给 CLAUDE.md 的指令预算只有 100-150 条。塞太多，Claude 反而会开始选择性忽略（HumanLayer）。
CLAUDE.md 有多层文件层级，从企业托管到子目录级逐层叠加（详见附录 D：配置文件层级）。核心写作原则：
- 写 Claude 猜不到的东西：特殊的 bash 命令、非默认的代码风格、项目特有的架构决策。不要写"保持代码整洁"这种废话——Claude 已经知道了。
- 用正面指令替代负面约束：把"不要用 --flag"改成"使用 --other-flag"。LLM 更容易遵循正面指导。
- 渐进式披露：不要把所有内容塞进一个文件。主 CLAUDE.md 只放最核心的信息，详细文档放在
agent_docs/目录中，用@引用指针。CLAUDE.md 支持@import语法引入外部文件。
- 像代码一样维护：如果 Claude 的某个行为已经是正确的默认行为，删掉对应指令。定期 review、定期裁剪。
一位在大型 monorepo（30%+ 工程师使用 Claude Code）工作的工程师把 CLAUDE.md 比作"广告位"——每个团队的工具必须能在有限空间内讲清楚自己，否则就不配出现在这个文件里。他的 monorepo CLAUDE.md 严格控制在 13KB 以内（Shrivu Shankar）。
Arize 的研究用元提示（LLM 评估 LLM）方法优化 CLAUDE.md 指令，在跨仓库泛化上获得 +5.19% 准确率提升，在特定仓库专精上获得 +10.87% 提升。所有改进纯粹来自更好的指令措辞——不需要微调模型（Arize）。
反模式提醒：不要用
/init 自动生成后就不管——CLAUDE.md 是"最高杠杆点"，坏指令的影响会指数级放大。也不要把 CLAUDE.md 当 linter 用，该用工具自动化的事情交给工具（HumanLayer）。对于大型项目，还可以用
.claude/rules/ 目录做模块化规则——基于 glob 模式，让 Claude 在操作特定目录时只加载相关规则，避免 context 浪费。Context 管理的实战纪律
Context 退化是 Claude Code 的首要失败模式。具体的操作纪律：
/clear是肌肉记忆：在不相关的任务之间，无条件/clear。不要让一个"厨房水槽式"的 session 混杂多种无关任务。
/compact <指令>做有控制的压缩：比如/compact 聚焦 API 变更部分，让 Claude 只保留你指定方向的上下文。在 CLAUDE.md 中加压缩指令："压缩时必须保留所有已修改文件列表和测试命令"。
- 两次修正失败就重来：如果同一个问题纠正了两次还不对，不要继续在污染的 context 里挣扎。
/clear，写一个更好的初始 prompt 重新开始。
- 写者-审阅者模式：一个 session 写代码，另一个新鲜 context 的 session 做 review。这避免了 Claude 在同一个 context 里对自己的代码产生确认偏差（Shrivu Shankar）。
/context可视化 context 消耗：随时查看当前 context 使用比例，用彩色网格展示各类 token 占比。
第二部分：命令体系与工作流
Claude Code 内置 50+ 斜杠命令（完整列表见附录 A），覆盖 session 管理、context 控制、配置、调试、协作全流程。这里只讲日常使用中最关键的几组。
日常高频命令
Session 生命周期：
/clear 清空对话是最常用的操作，但很多人不知道 /compact 可以带指令做有方向的压缩而非简单清空。/resume 可以恢复之前的 session，/fork 可以在决策分叉点创建新会话——这对"先试方案 A，不行再试方案 B"的场景特别有用。代码审查：
/review 可以直接审查 PR，/security-review 专注安全漏洞分析。Anthropic 还提供了一个官方的 GitHub Action 安全审查工具，可以在 CI 中自动运行。模式切换：
Shift+Tab 在 Normal / Auto-Accept / Plan 三种权限模式间循环。Plan Mode 是探索阶段的利器——Claude 可以读文件、搜索代码，但不能修改任何东西。快捷输入
三个前缀值得肌肉记忆化：
/ 触发命令和 Skills，! 进入 Bash 模式（直接运行 shell 命令并将输出带入 context），@ 触发文件路径自动补全。其中 ! 前缀特别实用——比如 ! git log --oneline -5 可以直接看 git 日志，不需要等 Claude 用工具去查。键盘快捷键方面（完整列表见附录 B），几个最值得记住的：
Ctrl+G 在外部编辑器打开（编辑长 prompt 或审阅 response），Esc+Esc 打开 rewind 菜单回滚到之前的状态，Ctrl+O 切换详细输出（查看工具调用细节和思考过程），Alt+T 切换 extended thinking。CLI 参数与自动化
Claude Code 的 CLI 参数体系（完整列表见附录 C）使它可以嵌入 CI/CD 管线和自动化脚本。几个关键用法：
claude -p "review this PR" --output-format json --max-turns 5 是一个可脚本化的 PR 审查调用。--allowedTools 可以预授权特定工具免去交互式许可，--max-budget-usd 可以设花费上限防止 agent 失控。--json-schema 可以强制输出匹配特定 JSON schema，适合需要结构化数据的自动化场景。第三部分：Skills 系统
Skills 是 Claude Code 的可扩展命令系统——用 Markdown 文件定义自定义斜杠命令，从简单的 prompt 模板到完整的多 agent 工作流都能实现。
内置 Skills
Claude Code 自带三个 bundled skills：
/simplify：代码质量审查。自动生成 3 个并行 review agent，分别检查代码复用、代码质量、执行效率，汇总发现并应用修复。可以加焦点：/simplify focus on memory efficiency。/batch <instruction>：大规模并行变更。研究代码库 → 分解为 5-30 个独立单元 → 每个单元一个 agent 在隔离 git worktree 中工作 → 各自跑测试、开 PR。比如 /batch migrate src/ from Solid to React 可以并行迁移多个文件。/debug [description]：Session 诊断。读取当前 session 的 debug 日志，分析问题。自定义 Skill
每个 Skill 是一个包含
SKILL.md 文件的目录，由 YAML frontmatter 和 Markdown 指令体组成。Frontmatter 支持 name、description（控制何时触发）、allowed-tools（此 skill 激活时免权限的工具）、model（模型覆盖）、context: fork（在隔离 subagent 中运行）等字段。Markdown body 中可以用 $ARGUMENTS 获取用户输入，用 !shell command 注入动态上下文。Skill 可以存放在个人目录（
~/.claude/skills/，跨项目生效）或项目目录（.claude/skills/，仅本项目）。旧版 .claude/commands/ 仍然兼容，但 skills 优先。社区资源
Anthropic 官方的 skills 仓库（80.2k stars）提供了文档处理技能（docx、pdf、pptx、xlsx 解析）。社区方面，awesome-claude-skills (travisvn) 和 awesome-claude-skills (ComposioHQ) 收录了大量实用 skills，涵盖 Git 工作流、测试生成、API 文档、CI/CD、代码审查等类别。
第四部分：Hooks——确定性自动化层
与 CLAUDE.md 的"建议"不同，Hooks 保证每次都执行——这是 Claude Code 确定性自动化的关键机制。Hooks 有四种类型：Command（执行 shell 脚本）、HTTP（发请求）、Prompt（用 LLM 做判断）、Agent（生成多轮 subagent）。
Claude Code 提供 15+ 个生命周期事件（完整列表见附录 E），覆盖 session 启动/结束、工具调用前后、权限请求、subagent 启停等关键时刻。其中
PreToolUse 和 UserPromptSubmit 是可阻断的——退出码 2 表示阻断，stderr 内容会显示给 Claude。实用 Hook 模式
自动格式化：PostToolUse 拦截 Edit/Write 后自动跑 Prettier。阻止危险命令：PreToolUse 拦截
rm -rf、DROP TABLE 等破坏性操作。保护敏感文件：阻止对 .env、secrets/、.git/ 的修改。压缩后注入上下文：PreCompact 在压缩后重新注入关键规则，防止丢失。验证放在 Commit 而非 Write
一个巧妙的高级实践：用 PreToolUse hook 拦截
Bash(git commit)，检查一个标志文件（只有测试通过才创建 /tmp/agent-pre-commit-pass）。这比在每次写文件时阻断要好——agent 可以自由探索实现方案，但在提交之前必须通过验证。在写入阶段阻断会"让 agent 在执行计划的过程中感到困惑"（Shrivu Shankar）。第五部分：Subagents 与多 Agent 协作
Subagent 架构解决 context 膨胀问题：主 agent 协调全局，subagent 在独立 context window 中探索，返回浓缩结果（几万 token 的探索压缩为 1000-2000 token 的总结）（Anthropic Context Engineering）。
Claude Code 内置三种 subagent 类型：Explore（Haiku 模型，只读，代码库搜索）、Plan（继承主模型，只读，规划上下文收集）、general-purpose（继承主模型，全部工具，复杂多步任务）。自定义 subagent 在
.claude/agents/<name>.md 中定义，支持自定义 prompt、工具限制、模型选择、独立权限模式、hooks 隔离、worktree 隔离等。最佳实践是不超过 3-4 个 subagent，每个有明确的单一目标（PubNub）。社区有一个 100+ subagent 配置集合。"Master-Clone" vs "Lead-Specialist" 之争
自定义 subagent 有一个争议：它可能"对主 agent 隐藏上下文"、"强制使用人类定义的刚性工作流而非 agent 驱动的委托"。替代思路是 Master-Clone 模式——让主 agent 生成通用 agent 克隆，核心上下文放在 CLAUDE.md 中共享，由主 agent 自主决定何时何如何委托（Shrivu Shankar）。
Agent Teams 与任务管理
更进一步的多 agent 协作模式（实验功能）：一个 session 作为 team lead 协调全局，其他 session 作为 teammate 独立工作，彼此可以直接通信。每个 teammate 可以在独立 git worktree 中运行。
Claude Code 还内置了任务管理工具 Tasks API（v2.1.19+ 默认启用），支持 pending / in_progress / completed 状态流转和 blockedBy / blocks 依赖关系。
Ctrl+T 切换任务列表显示，CLAUDE_CODE_TASK_LIST_ID=my-project claude 可以跨 session 共享任务列表。第六部分：MCP 服务器生态
MCP（Model Context Protocol）是 AI 工具集成的开放标准，Claude Code 通过它连接外部工具和数据源。安装方式支持三种传输协议：HTTP（推荐）、SSE（已废弃）、Stdio（本地进程）。安装作用域分 Local（默认，个人凭证）、Project（
.mcp.json 提交到 git，团队共享）、User（跨项目）、Managed（组织级部署）。常用的 MCP 服务器包括：GitHub MCP（Claude Code 内置）、Notion MCP（工作空间读写）、Context7（实时获取库的版本特定文档）、PostgreSQL MCP、Brave Search、Desktop Commander、Puppeteer 等。建议安装 2-3 个匹配你工作流的就够了，太多会拖慢启动速度。
高级特性方面：服务器可发送
list_changed 通知动态更新工具列表，MCP Prompts 自动发现为 /mcp__<server>__<prompt> 命令，.mcp.json 支持 ${VAR} 和 ${VAR:-default} 环境变量展开，当 MCP 工具超过 context 10% 时自动启用工具搜索。第七部分：辅助工具生态
围绕 Claude Code 已经形成了丰富的工具生态。主要 awesome list：awesome-claude-code（25.7k stars）。我们的 GitHub Trending 数据库中也追踪到了多个相关项目。
Agent 编排工具
多 agent 编排是当前工具生态中最活跃的方向。superset 自称"AI Agent 时代的 IDE"，可以管理多个 Claude Code / Codex 实例（知识库 GitHub Trending, score: 4）。ruflo 和其前身 claude-flow 是专门的 Claude agent 编排平台，支持智能 agent 集群部署（均为知识库 GitHub Trending, score: 4）。社区还有 Claude Squad（终端多实例管理）和 Auto-Claude（看板式 UI 的多 agent 框架）。
辅助与监控
cc-switch 是跨平台桌面一体化助手，支持 Claude Code / Codex 切换（知识库 GitHub Trending, score: 3）。CodexBar 在菜单栏显示 Codex / Claude Code 使用统计（知识库 GitHub Trending）。社区还有 ClaudeCTX（一条命令切换整个配置）、Dippy（通过 AST 解析自动批准安全 bash 命令）、claude-rules-doctor（检测死规则文件和 glob 模式错误）等工具。
状态栏与 IDE
状态栏可高度定制：运行脚本读取 JSON session 数据后输出文本。用
/statusline 加自然语言描述即可配置，或手动在 ~/.claude/settings.json 中设置。Claude Code 支持 VS Code（官方扩展）、JetBrains（官方集成）、Cursor、Zed（内置支持）、Neovim（社区插件）等 IDE 集成。Simon Willison 专门写了一篇关于 Claude Code Remote Control 的文章，展示了如何远程控制 Claude Code session。Chrome 集成（
claude --chrome）支持网站测试、表单自动化、截图捕获等浏览器自动化场景。第八部分：核心工作流——Explore, Plan, Implement, Verify
Anthropic 官方推荐的标准四步流程：
Explore（探索）：进入 Plan Mode（
Shift+Tab 或 /plan），让 Claude 读文件、回答问题，但不做任何修改。先理解，再动手。Plan（规划）：让 Claude 写一个详细的实现计划。用
Ctrl+G 在文本编辑器中打开计划进行人工审阅。这一步是 agentic engineering 与 vibe coding 的分水岭——规划意味着人在掌控方向。Implement（实现）：切回 Normal Mode（
Shift+Tab），Claude 按计划编码。人监督关键节点。Verify（验证）：这是 Anthropic 强调的最高杠杆实践——"让 Claude 有办法验证自己的工作"。提供测试、截图、预期输出。没有明确的成功标准，Claude 可能产出看起来正确但实际有问题的代码。
Claude Code 提供五种权限模式控制 agent 自主程度（详见附录 F），从最严格的
dontAsk（未预批准自动拒绝）到最宽松的 bypassPermissions（仅限隔离环境）。Extended Thinking 是另一个重要工具：Opus 4.6 支持自适应推理，通过
/model 或 CLAUDE_CODE_EFFORT_LEVEL 环境变量配置 low / medium / high 三档。对于复杂架构决策、疑难 bug、多步实现规划、安全分析等场景，extended thinking 显著提升质量。Ctrl+O 可以查看思考过程。第九部分：Agentic Engineering——新的工程范式
CodeScene 的研究提出了一个显式的工作流状态机：
意图 → 规格 → 计划 → 实现 → 验证 → 文档 → 审查 → 发布 → 监控 → 迭代。每一步都有明确的准入和准出标准（CodeScene）。核心实践模式：
风险前移（Pull Risk Forward）：保持代码健康度 9.5+（满分 10）。CodeScene 发现，低代码健康度显著增加 agent 失败的概率或消耗过多 token。给 AI 一个干净的代码库比给它更好的 prompt 更重要。
持续护栏（Safeguard Generated Code）：三层防护——生成过程中的健康度审查、pre-commit 暂存文件检查、PR 级预飞检查。"速度放大好设计也放大坏决策——工程纪律才是真正的使能器，而非 AI 本身"。
重构先行（Refactor to Expand AI-Ready Surface）：把大型遗留函数拆分为小的、内聚的单元，再交给 agent。这不是代码洁癖，而是实际影响 agent 的成功率。
原则编码（Encode Principles in AGENTS.md）：文档化预期的工具使用顺序和决策逻辑。当工程原则变成可执行的指南时，agent 的行为从随机变为可预测。
Simon Willison 在其 Agentic Engineering Patterns 系列中总结了两个特别有价值的模式：Interactive explanations——让 agent 用交互式方式解释它做了什么；Linear walkthroughs——让 agent 线性逐步展示工作流程，而非一次性给出最终结果。核心思想是：人和 agent 之间需要有可理解的中间状态。
工业数据点
Anthropic 2026 年的行业报告显示（Anthropic）：60% 的开发者已在使用 AI，但能"完全委托"的任务只有 0-20%。Rakuten 用 Claude Code 在 7 小时内完成复杂 vLLM 实现，数值精度 99.9%。TELUS 构建 13,000+ 定制 AI 解决方案，代码交付速度提升 30%，节省 500,000+ 小时。Zapier 全组织 89% AI 采纳率，内部部署 800+ agent。
华为的 CLI-Gym 工作也表明，环境交互类任务的 agent 能力正在快速提升——Terminal-Bench 解决率暴涨 20%（机器之心）。用 Claude Code 构建内部工具的深度实践也值得参考（Towards Data Science）。
第十部分：Vibe Coding 的是非功过
Vibe coding 在 2025 年的文化影响力是惊人的：Collins 年度词汇、Y Combinator 2025 冬季批次 25% 的创业公司代码库 95% 由 AI 生成、甚至有了 Wikipedia 词条。Simon Willison 最近记录了一个典型案例：他用 AI 从头 vibe coded 一个 macOS 演示应用，展示了这种方式在原型开发中的实际可行性。
但实践中的问题同样突出。一篇深入的安全分析文章指出了 vibe coding 导致的安全债务危机——AI agent 产出的代码中安全漏洞密度显著偏高（Towards Data Science）。CodeRabbit 2025 年 12 月对 470 个 GitHub PR 的分析也发现，AI 联合编写的代码包含约 1.7x 更多的"重大问题"和 2.74x 更高的安全漏洞（Hackaday）。
Simon Willison 做了一个影响深远的区分：Vibe coding = LLM 写代码，你不审查；AI-assisted programming = LLM 写代码，你 review 并理解每一行。"如果 LLM 写了代码、你 review 了——那不是 vibe coding，那是正常的软件开发。"他认为 vibe coding 适合低风险项目、初学者学习、原型和实验——但不应与专业开发混为一谈。
Google Chrome 工程负责人 Addy Osmani 在 O'Reilly 出版了 Beyond Vibe Coding 一书，系统论述了 AI 辅助开发是一个从 vibe coding 到 production-ready engineering 的光谱。一篇关于数据科学家在 AI coding agent 时代的必备知识的文章也指出，"理解代码"的能力在 agent 时代反而更重要了（Towards Data Science）。
最有意思的是 Karpathy 本人的转向：2026 年 2 月他承认自己的新项目是手写代码做的（Futurism），随后提出 agentic engineering 概念取代 vibe coding。COBOL 现代化的故事从另一个角度说明了 AI coding 的影响力：Claude 被证明能写 COBOL 代码的消息直接导致 IBM 股价单日蒸发 310 亿美元（机器之心，AI News）。
第十一部分：Claude Code vs Cursor
当前 AI 编程工具的两极代表了两种截然不同的哲学。
Claude Code 是 agent-first：假设 AI 应该自主驱动大部分工作流，人做监督。独占 Anthropic Claude 模型，200K 可靠 context（1M beta，在 MRCR v2 benchmark 76% 得分）。Qodo 的测试发现它完成相同任务的 token 消耗仅为 Cursor 的 1/5.5，产出代码的返工率低约 30%（Qodo）。独特能力包括 Python/TypeScript SDK、GitHub Actions 集成、Hooks 系统、Extended Thinking、Subagent 架构、Agent Teams、CLI 原生工作流。
Cursor 是 IDE-first：假设人应该掌控编辑流程，AI 做辅助。支持多模型切换（GPT-5.3、Claude Sonnet、Gemini 3 Pro），Tab 补全体验高度打磨。独特能力包括原生 Tab 补全（专用模型）、BugBot PR 审查、多模型切换、专有 Composer 模型（号称快 4x）。
越来越多开发者两者并用：Claude Code 做大型重构、框架迁移、CI/CD 自动化、复杂调试；Cursor 做日常逐行编码、交互式修改（Builder.io）。两个工具也在相互靠近——Cursor 加了后台 agent，Claude Code 加了 VS Code 扩展——但核心哲学差异短期不会消失。
第十二部分：值得关注的信号
Context engineering 成为独立学科。Martin Fowler、Anthropic 都在把"如何为 AI agent 构建最优上下文"系统化。这可能是 2026 年软件工程最重要的新技能。Latent Space 播客也在讨论 Claude Code 的 context 管理和金融应用，以及闭环反馈的不合理有效性。
代码健康度变成 AI 时代的基础设施。CodeScene 的发现——代码健康度直接影响 agent 成功率——意味着技术债不再只是"开发者体验"问题，而是直接影响 AI 工具 ROI 的硬指标。
Ladybird 浏览器用 AI 辅助采用 Rust。Ladybird 团队在 AI 的帮助下将浏览器引擎从 C++ 迁移到 Rust，展示了 agentic engineering 在大型系统迁移中的实际应用（Simon Willison）。
插件系统正在形成生态。Skills、Hooks、MCP 服务器、LSP 服务器可以打包为插件分发，从 GitHub、npm 或本地路径安装。这预示着 Claude Code 正在从"工具"向"平台"演进。
数据来源：多源信息聚合分析，综合 Anthropic 官方文档、技术博客、社区实践与本知识库追踪数据。
附录
附录 A：斜杠命令完整列表
Session 管理：
命令 | 功能 |
/clear | 清空对话历史（别名 /reset、/new） |
/compact [instructions] | 有指导的上下文压缩 |
/resume [session] | 恢复之前的会话（交互式选择器） |
/fork [name] | 在当前对话点分叉出新会话 |
/rename [name] | 重命名当前 session |
/export [filename] | 导出对话为纯文本 |
/rewind | 回滚到之前的对话/代码状态（别名 /checkpoint） |
/exit | 退出（别名 /quit） |
代码与文件：
命令 | 功能 |
/diff | 交互式 diff 查看器（未提交变更 + 每轮 diff） |
/copy | 复制上一条回复到剪贴板（代码块交互选择） |
/add-dir <path> | 添加额外工作目录到当前 session |
/review | 代码审查 PR（可传 PR 号） |
/security-review | 安全审查待提交的变更 |
/pr-comments [PR] | 获取 GitHub PR 评论 |
模型与模式：
命令 | 功能 | ㅤ |
/model [model] | 切换模型（可上下箭头调 effort level） | ㅤ |
`/fast [on\ | off]` | 切换快速模式（同模型，更快输出） |
/plan | 进入 Plan Mode（只读分析） | ㅤ |
/output-style [style] | 切换输出风格（Default / Explanatory / Learning / 自定义） | ㅤ |
/vim | 切换 Vim 编辑模式 | ㅤ |
配置与诊断：
命令 | 功能 |
/config | 打开设置界面（别名 /settings） |
/permissions | 查看/更新权限规则（别名 /allowed-tools） |
/doctor | 诊断安装健康状态 |
/memory | 编辑 CLAUDE.md / 管理自动记忆 |
/init | 初始化项目 CLAUDE.md |
/mcp | 管理 MCP 服务器连接 |
/hooks | 管理 Hook 配置 |
/agents | 管理 subagent 配置 |
/skills | 列出可用 Skills |
/plugin | 管理插件 |
/keybindings | 编辑键盘快捷键配置 |
/statusline | 配置状态栏 |
/theme | 切换颜色主题 |
协作与平台：
命令 | 功能 |
/desktop | 在 Desktop 应用中继续（别名 /app） |
/mobile | 显示移动端 QR 码（别名 /ios、/android） |
/remote-control | 让 session 可被远程控制（别名 /rc） |
/remote-env | 配置默认远程环境 |
/ide | 管理 IDE 集成 |
/install-github-app | 设置 Claude GitHub Actions |
/install-slack-app | 安装 Claude Slack 应用 |
/tasks | 查看/管理后台任务 |
信息与统计：
命令 | 功能 |
/help | 显示帮助 |
/context | 可视化 context 使用率 |
/cost | 显示 token 使用统计 |
/usage | 显示计划使用限制 |
/stats | 可视化使用统计 |
/status | 版本、模型、账户信息 |
/release-notes | 查看完整更新日志 |
/insights | 分析 session 模式和摩擦点 |
/feedback [report] | 提交反馈（别名 /bug） |
内置 Skills：
命令 | 功能 |
/simplify | 并行代码质量审查（复用、质量、效率） |
/batch <instruction> | 大规模并行变更（每单元独立 agent + worktree） |
/debug [description] | Session 诊断（读取 debug 日志） |
附录 B：键盘快捷键完整列表
核心操作：
快捷键 | 功能 |
Ctrl+C | 中断当前输入或生成 |
Ctrl+D | 退出 Claude Code |
Ctrl+L | 清屏（保留对话历史） |
Ctrl+G | 在默认文本编辑器中打开 |
Ctrl+O | 切换详细输出（工具调用细节和思考过程） |
Ctrl+R | 反向搜索命令历史 |
Ctrl+B | 后台运行任务（tmux 用户按两次） |
Ctrl+T | 显示/隐藏任务列表 |
Ctrl+F | 终止所有后台 agent（3 秒内按两次确认） |
Ctrl+V | 粘贴图片（从剪贴板） |
Esc + Esc | 回滚 / rewind 菜单 |
Shift+Tab | 切换权限模式（Normal → Auto-Accept → Plan） |
Alt+P | 切换模型（不清空 prompt）。macOS 为 Option+P |
Alt+T | 切换 extended thinking。macOS 为 Option+T |
多行输入：
方式 | 快捷键 |
快速转义 | \ + Enter |
macOS 默认 | Option+Enter |
Shift+Enter | iTerm2、WezTerm、Ghostty、Kitty 开箱即用 |
控制序列 | Ctrl+J |
文本编辑（readline 风格）：
快捷键 | 功能 |
Ctrl+K | 删除到行尾 |
Ctrl+U | 删除整行 |
Ctrl+Y | 粘贴已删除的文本 |
Alt+B / Alt+F | 光标按词移动 |
macOS 上 Option/Alt 快捷键需在终端中配置 Option 键为 Meta（iTerm2：Settings → Profiles → Keys → Left Option key → "Esc+"）。
附录 C：CLI 启动参数完整列表
运行模式：
参数 | 功能 |
-p, --print | 非交互式 / headless 模式 |
-c, --continue | 继续最近一次对话 |
-r, --resume | 恢复指定 session |
-w, --worktree | 在隔离的 git worktree 中启动 |
--remote | 在 claude.ai 上创建 web session |
--teleport | 在本地终端恢复 web session |
--init / --init-only | 运行初始化 hooks |
工具与权限：
参数 | 功能 |
--allowedTools | 免许可执行的工具（如 "Bash(git *)" "Read"） |
--disallowedTools | 从模型上下文中完全移除的工具 |
--tools | 限制可用的内置工具 |
--permission-mode | 以指定权限模式启动 |
--dangerously-skip-permissions | 跳过所有权限提示（仅限隔离环境） |
输出与自动化：
参数 | 功能 |
--output-format | 输出格式（ text、json、stream-json） |
--json-schema | 验证结构化输出（print 模式） |
--max-turns | 限制 agentic 轮次 |
--max-budget-usd | 最大花费限制 |
--no-session-persistence | 不保存 session 到磁盘 |
模型与 Prompt：
参数 | 功能 |
--model | 指定模型（ sonnet、opus 或完整名称） |
--system-prompt | 替换整个系统 prompt |
--append-system-prompt | 追加到默认系统 prompt |
--fallback-model | 主模型过载时的备选模型 |
Agent 与 MCP：
参数 | 功能 |
--agent | 指定 agent 配置 |
--agents | 通过 JSON 动态定义 subagent |
--mcp-config | 从 JSON 文件加载 MCP 服务器 |
--strict-mcp-config | 只使用 --mcp-config 中的服务器 |
--add-dir | 添加额外工作目录 |
--chrome / --no-chrome | 启用/禁用 Chrome 集成 |
--debug | Debug 模式（可指定过滤类别） |
附录 D：配置文件层级
CLAUDE.md 加载顺序（优先级从高到低）：
层级 | 路径 | 用途 |
企业托管 | Managed settings | 组织级强制策略 |
用户级 | ~/.claude/CLAUDE.md | 个人跨项目偏好 |
项目级 | ./CLAUDE.md | 团队共享，提交到 git |
本地级 | ./CLAUDE.local.md | 个人覆盖，gitignore |
子目录级 | ./src/CLAUDE.md | 按需加载，进入该目录时生效 |
Settings 优先级（从高到低）：
- Managed settings（IT 部署）
- 命令行参数
.claude/settings.local.json（本地项目）
.claude/settings.json（项目级）
~/.claude/settings.json（用户级）
其他配置文件：
文件 | 位置 | 用途 |
.claude/rules/ | 项目/用户 | 基于 glob 的模块化规则 |
.mcp.json | 项目根 | 项目级 MCP 服务器 |
~/.claude/keybindings.json | 用户 | 键盘快捷键自定义 |
.claude/agents/ | 项目/用户 | 自定义 subagent 定义 |
.claude/skills/ | 项目/用户 | 自定义 skill 定义 |
附录 E：Hook 生命周期事件完整列表
事件 | 触发时机 | 可阻断 |
SessionStart | Session 初始化 | 否 |
UserPromptSubmit | 用户提交输入前 | 是 |
PreToolUse | 工具执行前 | 是 |
PostToolUse | 工具成功执行后 | 否 |
PostToolUseFailure | 工具失败后 | 否 |
PermissionRequest | 权限提示 | 是 |
PreCompact | Context 压缩前 | 否 |
SubagentStart | Subagent 启动 | 否 |
SubagentStop | Subagent 完成 | 是 |
Stop | Session 即将结束 | 是 |
Notification | Claude 需要注意 | 否 |
TaskCompleted | 后台任务完成 | 否 |
ConfigChange | 设置变更 | 否 |
WorktreeCreate | Worktree 创建 | 否 |
WorktreeRemove | Worktree 删除 | 否 |
SessionEnd | Session 结束 | 否 |
可阻断事件退出码约定：0 = 允许/通过；2 = 阻断（stderr 内容显示给 Claude）；其他非零 = 非阻断错误。
附录 F：权限模式
模式 | 行为 | 适用场景 |
default | 首次使用每个工具时提示许可 | 标准安全模式 |
acceptEdits | 自动接受文件编辑权限 | 信任场景，加速工作流 |
plan | 只读分析，禁止修改 | 探索阶段 |
dontAsk | 未预批准的工具自动拒绝 | 最大安全 |
bypassPermissions | 跳过所有权限提示 | 仅限隔离/容器环境 |
权限规则支持 glob 匹配：
Bash(npm run *)、Read(src/**)、WebFetch(domain:example.com) 等。