常见问题与报错排查

已经看到错误提示时，从下方选择对应现象。其他问题按主题查找，点击问题展开答案。

按具体报错排查

先保存完整错误文字和发生时间，再按下表处理。

现象	入口
401、invalid API key	密钥验证失败
429、rate limit	请求受到限制
403、余额或额度不足	余额与权限
404、model not found、模型列表为空	地址或模型不匹配
503、Service temporarily unavailable	服务暂时不可用
模型列表没有更新	刷新模型目录
Claude Code 更新被网络检查停止	更新网络检查
官方客户端安装失败	客户端下载排查

登录和同步

登录失败时，先用同一账号登录 网页控制台。网页可以登录、WegooSwitch 失败时，核对应用填写的邮箱和网络设置，并保留错误提示。

分组列表为空时，在左侧 Wegoo点击 一键同步最新模型，等待结束。出现部分失败时，按提示处理后重试。同步成功后再点击卡片右侧的 切换图标。

切换后没有生效

确认目标分组的卡片已显示 使用中，完全退出工具并重新打开新会话。WSL、SSH 或其他远程环境需要在实际运行工具的环境中配置。

401：密钥验证失败

401 表示请求没有通过身份验证。先查看错误文字，再检查以下项目。

WegooSwitch 用户：确认账号已登录，点击 一键同步最新模型，在目标工具页启用分组。完全退出工具后重新打开，用短消息测试。

手动配置用户：在 API 密钥 重新复制完整密钥，确认没有额外空格、换行或引号，并检查密钥是否启用、是否过期。确认客户端实际读取的是刚修改的文件或终端环境。

直接调用接口时，OpenAI 接口使用 Authorization: Bearer YOUR_API_KEY，Claude 接口使用 x-api-key: YOUR_API_KEY。

查询模型，确认密钥是否有效

在终端查询这把密钥可用的模型：

Windows PowerShell

$env:WEGOO_API_KEY = "YOUR_API_KEY"
$headers = @{ Authorization = "Bearer $env:WEGOO_API_KEY" }
$models = Invoke-RestMethod -Uri "https://ai.wegoo.site/v1/models" -Headers $headers
$models.data.id

macOS / Linux / WSL

export WEGOO_API_KEY="YOUR_API_KEY"
curl --fail-with-body "https://ai.wegoo.site/v1/models" \
  -H "Authorization: Bearer $WEGOO_API_KEY"

将 YOUR_API_KEY 替换为完整密钥，从返回的 data 数组中取模型的 id。模型目录可读取后，再确认所选模型支持准备使用的接口。

模型目录也返回 401 时，通过 站内工单 提供时间、密钥名称和错误文字。目录可读取但生成失败时，再补充分组和模型；不要发送完整密钥。

429：请求受到限制

先停止连续重试，暂停其他任务，只保留一个客户端。如果响应带有 Retry-After，等待它指定的时间，再发送一条短消息，到 使用日志 查找对应请求。

错误提到什么	处理方法
请求频率或并发	减少同时运行的任务，增加重试间隔
token 用量限制	缩短单次输入，减少同时发送的大任务
额度或余额	查看 钱包 余额及 API 密钥 的剩余额度
只有一个模型持续受限	换用当前分组允许的其他模型，或稍后重试

脚本应设置最大重试次数，并逐步增加等待时间。持续失败时，提交工单并附上工具、模型、分组、并发任务数和完整错误文字。

余额与权限

403 可能来自访问权限或额度检查，应以错误文字为准。

错误提到余额时，到 钱包 查看余额；提到密钥额度时，到 API 密钥 检查剩余额度、过期时间和限制项。

错误提到模型、分组或客户端权限时，到 模型广场 核对当前分组是否支持此次调用。

地址或模型不匹配

检查完整请求地址和模型 ID：

1. Codex 和 OpenAI SDK 的服务地址填写 https://ai.wegoo.site/v1；Claude Code 和 Gemini CLI 填写 https://ai.wegoo.site。避免重复拼接 /v1或 /v1beta。
2. 模型 ID 从该密钥的可用目录复制，注意前缀和版本后缀。
3. WegooSwitch 用户先在左侧 Wegoo同步目录，再点击分组右侧的铅笔 编辑图标，在 默认模型中选择。

模型搜索框有文字时，先清空再查看完整列表。

服务暂时不可用

暂停连续重试，用短消息再次测试。先打开分组监控查看对应分组；WegooSwitch 用户也可以查看该分组的状态条；仍持续失败时，切换其他可用分组。

保留错误涉及的模型或工具名称，不要仅凭 503 就关闭客户端功能。提交工单时提供完整错误正文。

刷新模型目录

在 WegooSwitch 点击 一键同步最新模型，等待完成后重新打开目标工具。

Codex CLI 中用 /model查看模型。仍显示旧列表时，更新 Codex 后新建会话，再确认目标模型属于当前分组。

Claude 出现 challenge mismatch

保存完整报错，重新打开 Claude Code 并用新会话发送短消息。仍失败时，尝试当前分组的其他可用模型，并通过 站内工单 提供分组、模型和时间。

图片生成失败

先确认所选模型支持图片生成。客户端或脚本失败时，在 AI 生图 用相同模型做一次简短测试；该测试也可能计费。

网页成功时，检查客户端请求路径和参数；网页也失败时，保留错误信息和任务时间，查看 任务日志后提交工单。

提交问题

排查材料与联系方式统一见 隐私与客服，操作步骤见 提交工单。

按主题查找

想了解什么	打开问答
Wegoo 是什么、能做什么、设备和网络	认识 Wegoo 与使用场景
模型、分组、同步和第一次切换	模型、分组与切换
Token、费用、充值、退款和费用控制	价格、用量、充值与退款
WegooSwitch、本地配置和其他客户端	WegooSwitch 与客户端
API、密钥、地址和手动配置	API 密钥与手动配置
数据、权限、密钥保护和客服	隐私、安全与客服
卡住、断流、状态码和重试	使用中断与恢复

使用中断与恢复

多久开始回复算正常？

多久开始回复算正常？

没有适用于所有模型和任务的固定秒数。短任务、复杂思考、长上下文和高峰负载的等待时间不同。持续无响应时，应结合客户端状态和使用日志判断。

一直转圈是在思考还是卡住了？

一直转圈是在思考还是卡住了？

先查看 使用日志：没有新请求时，重点检查客户端、配置和本地网络；已有请求但长时间无结果时，记录发生时间、模型和分组，停止连续重试后再测试。

写到一半断开，已经生成的内容还在吗？

写到一半断开，已经生成的内容还在吗？

网络断开不会自动删除已经写入本地文件或显示在客户端中的内容，未完成的请求可能需要继续或重新执行。先检查文件差异和客户端记录；费用以使用日志中的最终状态和用量为准。

换分组后，前面的对话还会保留吗？

换分组后，前面的对话还会保留吗？

对话是否保留由客户端决定，新请求是否携带历史内容也由客户端决定。为避免旧配置继续生效，切换分组或模型后应新建会话。

长对话为什么越来越慢或越来越贵？

长对话为什么越来越慢或越来越贵？

客户端可能在后续请求中再次发送更多历史内容，输入量随之增加。可以新建会话、保留阶段总结，并在支持的客户端中设置上下文和压缩位置来控制用量。

电脑关机或断网后任务会继续吗？

电脑关机或断网后任务会继续吗？

本地客户端执行的任务会因进程退出或网络中断而停止。恢复后能否继续原会话取决于客户端；云端任务是否继续，则由对应产品决定。

AI 修改错文件如何撤销？

AI 修改错文件如何撤销？

优先使用 Git、客户端撤销功能或配置备份恢复，不要只依赖让模型把内容改回去。重要项目开始前先提交当前版本或建立可恢复的备份。

如何确认 AI 真的完成了任务？

如何确认 AI 真的完成了任务？

查看文件差异，运行项目测试或构建，再按原始需求操作关键流程。模型回复中的 已完成不是验收结果；未执行的检查也应明确列出。

状态、重试和计费

常见状态码是什么意思？

常见状态码是什么意思？

状态码	常见含义
401	凭据无效或会话过期
403	权限、余额或密钥额度限制
404	地址、接口或模型不匹配
429	请求频率、并发或资源受限
503	服务暂时不可用

具体原因必须结合完整错误内容判断，不能只看状态码。处理步骤见按具体报错排查。

显示健康但请求仍失败，应该相信哪个？

显示健康但请求仍失败，应该相信哪个？

分组监控中的健康状态是最近一次检查的结果，单次请求仍可能受网络、负载和上游状态影响。排查本次失败时，以具体请求的错误和使用日志为准。

自动重试会不会重复扣费？

自动重试会不会重复扣费？

有可能。客户端超时后重试时，上一请求是否已经被处理不一定能立即确认。发现同一任务出现异常重复请求时，先停止任务，再按时间核对使用日志并提交工单。

失败、断流或空响应如何计费？

失败、断流或空响应如何计费？

以服务端记录的请求状态和实际用量为准，不能把所有失败都理解为免费。对记录有疑问时，通过工单提交发生时间、模型、密钥名称和对应日志。