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

第 7 章 · 斜杠命令指南 · 第2部分：命令参考

概述#

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

基本语法#

bash
复制
/doctor

功能说明#

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

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

检查项目#

1. 系统环境#

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

2. 安装完整性#

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

3. 网络连接#

  • Anthropic API 连接
  • 代理设置
  • DNS 解析

4. 配置文件#

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

5. 认证状态#

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

使用场景#

1. 遇到问题时诊断#

bash
复制
# 当 Claude Code 出现问题时/doctor

# 查看诊断报告

2. 安装后验证#

bash
复制
# 安装完成后验证/doctor

# 确保安装正常

3. 定期健康检查#

bash
复制
# 定期运行健康检查/doctor

# 确保系统运行正常

输出示例#

bash
复制
Claude Code Health Check
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓ System Environment
  - OS: Windows 11
  - Node.js: v18.17.0
  - Memory: 16 GB
  - Disk: 50 GB available

✓ Installation
  - Version: 1.0.124
  - Dependencies: All installed
  - Executable: Found at C:\Program Files\claude\bin\claude.exe

✓ Network Connection
  - API Connection: OK
  - Proxy: Not configured
  - DNS: Resolving correctly

✓ Configuration
  - Config File: Valid
  - Config Path: C:\Users\user\.config\claude\config.json
  - Settings: All valid

✓ Authentication
  - Status: Logged in
  - Token: Valid
  - Permissions: Full access

Overall Status: ✓ Healthy

常见问题诊断#

问题 1：网络连接失败#

bash
复制
✗ Network Connection
  - API Connection: Failed
  - Error: Connection timeout

Suggested Fix:
1. Check internet connection
2. Verify proxy settings
3. Try disabling VPN

问题 2：认证失败#

bash
复制
✗ Authentication
  - Status: Not logged in
  - Error: Invalid token

Suggested Fix:
1. Run /logout
2. Run /login
3. Verify account credentials

问题 3：配置文件错误#

bash
复制
✗ Configuration
  - Config File: Invalid syntax
  - Error: Unexpected token at line 10

Suggested Fix:
1. Check config.json syntax
2. Run /config to reset settings
3. Restore from backup

注意事项#

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

与其他命令的配合使用#

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

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

最佳实践#

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

总结#

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

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

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