#26. 常见问题 FAQ

---

#安装失败

可能原因和解决方案：

• 命令未找到：重启终端，确保 PATH 已更新
• 权限错误（macOS）：使用 nvm 安装 Node.js，不要用 sudo
• Windows PATH 问题：重新运行安装程序，或手动添加到 PATH
• 网络问题：检查网络连接，确保能访问 claude.ai

#认证失败

可能原因：

• 浏览器未正确完成登录流程
• 订阅计划不支持 Claude Code（Free 计划不可用）
• Token 过期

解决方案：

1. 运行 claude auth login 重新认证
2. 使用 --console 标志切换到 API 认证：claude auth login --console
3. 确认订阅状态

#响应质量不佳

可能原因：

• CLAUDE.md 配置不完善
• 提示词描述不够具体
• 任务过于复杂，需要拆分

解决方案：

1. 完善 CLAUDE.md，提供更多项目上下文
2. 优化提示词，更加具体
3. 将大任务拆分为小步骤
4. 使用 ultrathink 关键词激活深度推理

#触及用量限制

• Pro 用户：用量约每 5 小时重置一次
• Max 用户：按周重置
• 使用 /cost 查看当前消耗
• 简单任务使用 /effort low 减少 token 消耗
• 如果频繁触及限制，考虑升级到 Max 计划

#会话中断或卡住

1. 按 Ctrl+C 中断当前操作
2. 运行 /clear 清除会话
3. 重启 Claude Code
4. 如果问题持续，运行 /doctor 诊断
5. 使用 /bug 提交问题报告