Claude Code 诊断命令

/doctor
命令完全指南

一键诊断 Claude Code 安装与配置问题——API 连接、版本兼容、权限状态，所有疑点一目了然

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

一个命令，全面体检

/doctor 会自动检测 Claude Code 运行环境的各项指标，帮你快速定位问题根源

/doctor

参数格式说明
无参数—直接运行即可，命令会自动检测所有诊断项并输出报告
使用场景

三大诊断场景

遇到问题先跑 /doctor，它能帮你解决大部分环境配置问题

🏥

首次安装检查

安装 Claude Code 后运行 /doctor，确认所有组件配置正确，环境依赖就绪

# 安装后第一次体检
/doctor
初次使用必跑
🌐

连接问题排查

API 无法连接、响应超时时，用 /doctor 快速定位是网络、认证还是服务端问题

# 连接异常时排查
/doctor
遇问题先跑
📦

版本兼容性

升级后遇到异常？用 /doctor 检查当前版本和依赖是否兼容，是否有已知问题

# 升级后检查兼容性
/doctor
升级后推荐
实时演示

诊断报告长什么样

运行 /doctor 后你会看到一份完整的系统健康报告

claude — /doctor diagnostic
诊断项目

/doctor 检查什么

以下是 /doctor 会逐一检查的所有诊断项

🌐

API 连接状态

测试与 Anthropic API 的连通性，检查认证和响应延迟

自动检测
⬢

Node.js 版本

检查 Node.js 版本是否满足 Claude Code 最低要求（≥ 18）

版本校验
🔧

Git 配置

验证 Git 是否安装、用户信息是否配置、SSH 密钥是否可用

自动检测
🔐

权限状态

检查文件系统权限、工具执行权限、沙箱配置是否正确

权限验证
🔌

MCP 服务器

检查配置的 MCP 服务器连接状态、工具注册是否正常

连接测试
📋

Claude Code 版本

显示当前版本号，检查是否为最新版本，提示可用更新

版本比对
📁

配置文件完整性

验证 settings.json、CLAUDE.md 等配置文件格式是否正确

格式校验
最佳实践

诊断命令使用建议

💡

遇到异常先跑 /doctor

  • 首步排查利器——遇到任何异常先跑 /doctor，它能快速定位大部分问题的根源
  • 报告反馈给别人——/doctor 的输出是标准格式，直接复制到 GitHub Issue 或社区提问
  • 升级后必跑——每次升级 Claude Code 后运行 /doctor，确保新版本环境正常
  • 配合 /bug 使用——如果 /doctor 确认环境正常但问题仍在，再用 /bug 报告具体问题