常见问题¶
常见问题按工具分类整理，请根据你使用的工具查看对应的 FAQ：
| 分类 | 说明 | 链接 |
|---|---|---|
| Claude Code | Claude Code CLI 和 VS Code 插件相关问题 | 查看 |
| Codex | Codex CLI、插件、桌面端相关问题 | 查看 |
| Gemini | Gemini CLI 相关问题 | 查看 |
通用问题¶
以下是不限于特定工具的通用常见问题。
断流超时错误¶
错误信息：
stream disconnected before completion: error sending request for url
(https://api.yunxicodes.com/v1/responses)
原因分析：
有可能被 CF（Cloudflare）拦截了，也有可能是梯子不稳定自动切换了 IP，导致当前连接丢失断流。
解决方案：
解决步骤
- 重新开关魔法，检查自己的网络环境
- 服务器在国外，走的 CF 加速线路，优质的梯子会速度更快
- 国内也能直接访问使用
429 重试错误¶
错误信息：
原因分析：
典型的当日额度用完了，查看订阅套餐是否已经用完。或者是后台正在添加账号，稍等一会再尝试。
解决方案：
解决步骤
- 前往闲鱼店铺可以拍天卡增量
- 在后台的「API 密钥」里对当前的 KEY 分组进行切换，使用新的订阅用于增量
- 例如：你是天卡用户，再拍天卡就能增量（会变成续期），也可以选择拍月卡续期使用
401 密钥不正确¶
解决方案：
必查项
- 确认已正确创建或替换
config.toml和auth.json两个文件 - 确认请求的是中转站（
https://api.yunxicodes.com）而不是 OpenAI 官方 - 重启编辑器 / CLI 重新加载配置文件
- 如果遇到报错，请一定要截图并翻译，这样自己也知道是什么原因报错了