CCClaude Code中文喂饭教程

/run：让 Claude Code 启动并查看应用

/run 适合让 CC 启动应用、打开页面、观察结果。它比“你自己手动跑命令再截图”更符合 CC 工作流。

什么时候用 /run

/run 的重点不是“替用户执行命令”，而是让 CC 自己完成运行、观察、反馈这一段闭环。尤其是前端、静态站、管理后台、移动端适配这类任务，光看代码很容易漏掉布局、交互和真实页面状态。

适合用 /run 的场景：

场景应该让 CC 看什么
首页或文档页改版页面是否正常打开、布局是否错位、链接是否可点
表单或按钮修改点击后是否有反馈、错误提示是否合理
移动端适配窄屏下文字是否溢出、按钮是否挤压、菜单是否可用
构建修复应用能否启动、报错是否消失、是否引入新错误
静态站 SEO 调整页面标题、描述、canonical、链接是否生成正确

不适合直接用 /run 解决的问题：

/run 前先确认边界

问题为什么要问
是本地、测试还是生产避免误触真实服务
是否需要环境变量避免要求用户暴露密钥
是否会写数据避免测试时污染数据
是否已有启动脚本避免 CC 乱猜命令
是否端口可能占用避免误判启动失败

第一次使用

/run

请启动当前项目并观察页面。

要求：
1. 先根据 README、package.json 或项目配置判断启动方式。
2. 如果启动方式不确定，请先说明，不要猜。
3. 启动后告诉我访问地址。
4. 检查首页或本次修改页面是否正常打开。
5. 如果启动失败，请说明失败原因和下一步最小排查动作。

如果是前端页面，可以把观察目标说得更具体：

/run

请启动当前项目，并重点观察这次修改相关页面。

观察要求：
1. 页面是否能正常打开。
2. 顶部导航、主要按钮、正文内容是否有明显错位。
3. 可点击链接是否能跳转到正确页面。
4. 浏览器控制台是否有明显错误。
5. 如果能截图，请基于截图说明哪里还需要调整。

不要因为一个样式问题扩大成重构，只给出最小修改建议。

观察结果要结构化

运行起来后，让 CC 不要只说“页面正常”，而是按区域汇报：

请把运行观察结果结构化输出。

请说明：
1. 访问地址。
2. 检查了哪些页面。
3. 页面是否加载成功。
4. 有哪些控制台错误或网络错误。
5. 哪些交互已经试过。
6. 哪些还没有验证。

如果项目启动方式复杂

项目需要数据库、环境变量、多服务或特殊脚本时，/run 可能第一次推断不准。此时要让 CC 记录稳定启动方式，而不是每次重新猜。

这个项目启动方式比较复杂。

请先不要反复试错。
请总结：
1. 当前已经确认有效的启动步骤。
2. 依赖哪些环境变量或服务。
3. 哪些步骤不能自动执行。
4. 是否适合为本项目沉淀一个 run/verify 相关 Skill。

启动失败时怎么问

启动失败很常见，不要马上让 CC “把所有报错都修了”。先让它分类。

启动失败了，请先不要修改代码。

请只做分类和定位：
1. 这是依赖缺失、环境变量缺失、端口占用、脚本错误，还是代码错误？
2. 报错里最关键的 3 行是什么？
3. 是否和本次修改有关？
4. 最小排查动作是什么？
5. 哪些动作需要我确认后才能执行？

端口占用时

如果启动失败是端口占用，请不要直接结束进程。

请先说明：
1. 哪个端口被占用。
2. 当前占用进程是否可能是本项目已有服务。
3. 是否可以换端口启动。
4. 如果需要停止进程，风险是什么。
5. 等我确认后再处理。

如果失败原因是缺少环境变量，正确做法不是把密钥发给 CC，而是让它说明变量名、用途和本地示例格式。

看起来缺少环境变量。

请不要要求我提供真实密钥。
请说明：
1. 缺少哪些变量名。
2. 每个变量大概用于什么。
3. 本地示例文件应该怎么写占位值。
4. 哪些变量必须由用户自己去服务商后台获取。

运行后的人工复查

有些结果 CC 可能看不到，需要用户复查：

让 CC 明确列出人工复查点，避免把“没检查到”说成“没问题”。

运行成功后还要问什么

应用能启动，只是第一步。还要让 CC 把观察结果变成验收结论。

页面已经运行起来了。

请基于实际观察给出验收结论：
1. 本次修改是否已经生效。
2. 哪些页面或交互已经检查过。
3. 有没有控制台错误或明显视觉问题。
4. 还有哪些没有验证到。
5. 如果继续修改，最小下一步是什么。

和 /verify 怎么配合

/run 更偏“运行并观察”，/verify 更偏“按检查清单验收”。实际使用时可以这样搭配：

  1. 修改前：让 CC 说明计划和影响范围。
  2. 修改后：用 /run 启动应用，看真实页面。
  3. 页面正常后：用 /verify 做更完整的检查。
  4. 收尾前：让 CC 汇总 diff、检查结果和剩余风险。
前端任务不要只依赖代码解释。能运行就让 CC 运行，能截图就让 CC 基于截图反馈。很多布局问题、按钮状态、文字溢出，只有真实页面里才明显。

验收结果

下一篇：/verify 验收