跳转到内容
控制台

帮助

故障排查

按现象排查 Claude 登录、订阅、Claude Code 和 MCP 问题

先记录完整报错、发生时间、操作步骤和系统版本。截图前遮住邮箱、验证码、SessionKey、API Key 和令牌。

现象 优先检查
网页无法登录 官方域名、登录方式、验证码是否为最新一封
登录后套餐不符 Settings 中的邮箱和套餐,订单交付说明
Claude Code 要求 API Key 当前终端中的 ANTHROPIC_* 环境变量
Claude Code 授权后仍未登录 是否在同一浏览器账号完成授权,/status 输出
提示达到用量限制 官方用量页显示的恢复时间
claude 命令不存在 安装结果、终端是否重开、PATH 配置
MCP 连接失败 传输类型、启动命令、URL、Node.js 和凭证权限
收不到验证码或登录邮件
  1. 确认邮箱拼写与交付资料一致。
  2. 查看垃圾邮件和全部邮件分类。
  3. 只使用最新一次请求对应的验证码或链接。
  4. 等待页面允许后再申请一次,不要连续点击。
  5. 仍未收到时,保留页面截图并联系交付方核对邮箱状态。
页面提示登录链接已过期

返回 Claude 官方登录页重新发起一次登录。关闭旧邮件中的链接,只打开最新链接。检查电脑的日期、时间和时区是否正确。

登录后邮箱或套餐不一致

停止修改账号设置。在 Settings 中截取已遮挡敏感信息的邮箱和套餐页面,并根据订单说明联系售后。不要通过反复退出和登录尝试修复交付错误。

页面循环登录或显示空白

先禁用会修改网页或 Cookie 的扩展,再清除 claude.ai 的站点数据并重新登录。不要清除整个浏览器的密码和数据。仍有问题时换一个受支持的最新版浏览器测试一次。

提示找不到 claude 命令

关闭终端并重新打开,然后运行:

Terminal window
claude --version

仍找不到时,重新执行官方安装步骤,并检查安装器提示的 PATH 配置。

启动后要求 API Key

你的终端很可能还保留了 API 模式配置。退出 Claude Code,按清理 API 覆盖处理当前终端,再重新启动并选择 Claude.ai 订阅账号登录。

浏览器没有自动打开授权页

复制终端显示的授权链接,粘贴到已经登录正确 Claude 账号的浏览器。检查域名后再确认授权。远程或 WSL 环境可能要求你把浏览器显示的一次性代码粘贴回终端。

授权成功但终端仍未登录

完全退出 Claude Code 并重新启动,再输入 /status。确认浏览器授权时使用的邮箱与验收邮箱一致,并检查当前终端没有自定义 ANTHROPIC_BASE_URL

响应很慢或上下文已满

/context 查看占用。先让 Claude 总结当前进度,再用 /clear 开始新任务。不要在同一会话中连续处理无关任务。

Claude 的可用量会受套餐、模型、对话长度、文件大小和功能类型影响。它不是固定消息条数。

  • 以 Claude 官方设置页显示的用量和恢复时间为准。
  • 网页版与订阅授权的 Claude Code 可能共享套餐限制。
  • 达到限制后等待恢复,不要重复发送相同任务。
  • 新任务新建对话,复杂任务才使用更高消耗的模型。

运行以下命令检查配置:

Terminal window
claude mcp list
claude mcp get <名称>
  • HTTP 服务:检查 URL、网络和认证请求头。
  • stdio 服务:在终端单独运行启动命令,查看依赖或版本错误。
  • 项目不可见:检查 localprojectuser 作用域。
  • 配置已修改:退出 Claude Code 后重新启动。
  • 订单平台和订单时间,不要公开完整订单号
  • 操作系统、浏览器和 claude --version 输出
  • 问题发生在哪一步
  • 完整报错文字或已遮挡敏感信息的截图
  • 已经尝试过的排查步骤

返回教程导航

按首次使用顺序重新检查账号和 Claude Code 配置。

加群 & 客服

AI 技术交流群二维码
AI 技术交流群
专属客服二维码
专属客服