7.11 /doctor - 检查安装健康状况

约 578 字大约 2 分钟

概述

/doctor 命令用于检查 Claude Code 的安装健康状况，诊断常见问题，并提供修复建议。

基本语法

功能说明

执行 /doctor 命令后，Claude Code 会：

检查系统环境
验证安装完整性
测试网络连接
检查配置文件
提供诊断报告和修复建议

检查项目

1. 系统环境

操作系统版本
Node.js 版本
内存和磁盘空间

2. 安装完整性

Claude Code 版本
依赖包完整性
可执行文件路径

3. 网络连接

Anthropic API 连接
代理设置
DNS 解析

4. 配置文件

配置文件语法
配置文件路径
配置项有效性

5. 认证状态

登录状态
令牌有效性
账户权限

使用场景

1. 遇到问题时诊断

# 当 Claude Code 出现问题时
/doctor

# 查看诊断报告

2. 安装后验证

# 安装完成后验证
/doctor

# 确保安装正常

3. 定期健康检查

# 定期运行健康检查
/doctor

# 确保系统运行正常

输出示例

常见问题诊断

问题 1：网络连接失败

问题 2：认证失败

问题 3：配置文件错误

注意事项

/doctor 不会修改任何文件或设置
诊断报告会保存到日志文件中
某些检查可能需要网络连接
修复建议需要手动执行

与其他命令的配合使用

# 诊断问题，然后修复
/doctor
/login
/doctor

# 执行流程：
# 1. 运行诊断检查
# 2. 根据建议执行修复
# 3. 再次运行诊断确认修复

最佳实践

安装后检查：安装完成后立即运行 /doctor
问题诊断：遇到问题时首先运行 /doctor
定期检查：定期运行健康检查，确保系统正常
备份配置：在修改配置前，先备份配置文件

总结

/doctor 命令是 Claude Code 中用于诊断问题的重要工具。通过使用此命令，你可以：

检查系统环境
验证安装完整性
测试网络连接
检查配置文件
获取修复建议

合理使用 /doctor 命令可以帮助你快速诊断和解决 Claude Code 的问题。