诊断和解决 Claude Code 配置问题的完整指南。
诊断工具
/doctor 命令
在 Claude Code 中运行 /doctor 可以自动检测：
- 安装是否正常
- 认证是否有效
- 网络连接是否通畅
- 配置文件是否正确
常见问题排查
认证问题
症状：无法登录或认证链接无效。
解决：
- 运行
claude auth status查看当前状态 - 如果已登录，尝试
claude auth logout然后重新登录 - 如果使用 API 密钥，确认
ANTHROPIC_API_KEY环境变量已设置 - 检查密钥是否过期
网络问题
症状：请求超时或连接错误。
解决：
- 确认能访问
api.anthropic.com - 如果使用代理，检查
HTTPS_PROXY环境变量 - 运行
curl https://api.anthropic.com/v1/messages测试连接 - 检查防火墙设置
权限问题
症状：Claude 无法编辑文件或运行命令。
解决：
- 检查文件权限：
ls -la - 确认 Claude 有写权限
- 检查
.claude/settings.json中的权限设置 - 如果启用了沙箱，确认允许的路径正确
模型问题
症状：模型不可用或返回错误。
解决：
- 运行
/model查看可用模型 - 确认你的账户有访问权限
- 检查 API 额度是否充足
- 尝试切换到其他模型
日志和调试
会话日志
会话日志存储在 ~/.claude/projects/ 目录。每个会话以 JSONL 格式保存。
启用详细日志
设置环境变量 CLAUDE_CODE_VERBOSE=true 来启用更详细的日志输出。