Claude Code Bug 报告命令

/bug
命令完全指南

一键报告 Bug——自动收集环境信息、错误日志，生成标准化 Issue 帮助开发团队快速定位问题

/bug
向下滚动探索 ↓ ▽
基础语法

一行命令，精准报告

/bug 会自动收集当前环境的诊断信息，生成一份完整的 Bug 报告

/bug

参数格式说明
无参数—直接运行即可，命令会引导你描述问题并自动附加环境信息
使用场景

何时使用 /bug

当你遇到 Claude Code 行为异常时，用 /bug 快速生成标准化报告

🐛

功能异常

Claude Code 的行为与预期不符——命令不生效、输出错误、交互异常等

# 发现功能异常时报告
/bug
常见场景
💥

崩溃报告

Claude Code 突然崩溃、闪退或卡死时，自动收集崩溃日志和堆栈信息

# 崩溃后第一时间报告
/bug
高优先级
⚡

性能问题

响应过慢、内存占用异常、Token 消耗过高时，报告性能相关问题

# 性能异常时报告
/bug
需详细描述
实时演示

Bug 报告完整流程

观看 /bug 命令如何一步步收集信息并生成报告

claude — /bug report
自动收集

/bug 会收集哪些信息

运行 /bug 时，以下信息会被自动收集并附加到报告中

#信息类型收集方式
1操作系统及版本自动收集
2Node.js 版本自动收集
3Claude Code 版本号自动收集
4最近的错误日志自动收集
5当前配置摘要自动收集
6会话上下文信息自动收集
7MCP 服务器状态自动收集
8问题复现步骤你需描述
9预期 vs 实际行为你需描述
10截图或额外信息可选附加
最佳实践

写出高质量的 Bug 报告

💡

报告前先用 /doctor 排查

  • 先 /doctor 再 /bug——很多"Bug"其实是配置问题，/doctor 能帮你快速区分
  • 描述复现步骤——"做了什么 → 期望什么 → 实际发生了什么"，越具体越好
  • 第一时间报告——崩溃后尽快运行 /bug，此时错误日志最完整
  • 不要修改敏感信息——/bug 已自动脱敏 API Key 和密码，可直接提交