运维与排错入门读者更新于

常见问题

Q: 一把 API Key 可以配置多个客户端吗?

可以。三个客户端共用一把 Key,但环境变量和配置文件各自不同。填写位置见多客户端配置。

Q: 在哪里查看当前价格、余额和用量?

价格、余额、请求日志和用量明细的入口都在价格、余额与用量。单价以页面当时显示为准。

Q: API 请求内容和隐私如何处理?

正文用于当次路由和计费,通常不长期保存;用量、状态和安全日志会保留。边界见请求数据与隐私和隐私政策。

Q: 模型支持是否等于所有客户端协议都支持?

不等于。模型、客户端和请求协议的组合可能有不同能力或限制,应先确认具体组合。请查看模型能力目录。

Q: API Key 泄露了怎么办?

请立即在 API Keys 页面点击"轮换 Key"生成新的密钥,旧 Key 将立即失效。

Q: 请求返回 401 错误?

请检查:

  1. API Key 是否正确
  2. API Key 是否已过期或被禁用
  3. 环境变量或配置文件是否正确设置
  4. 是否重新打开了终端使配置生效

Q: 请求返回 429 错误?

这表示请求频率过高,请稍后重试。建议在代码中添加重试逻辑。

Q: Windows 环境变量设置后不生效?

设置环境变量后需要重新打开 PowerShell 才能生效。

Q: api.icodeeasy.cc 连接慢怎么办?

先按连接排查确认不是 401、403 或 429。确认是网络慢之后,再把 Base URL 换成 https://jp.icodeeasy.cc 或 https://sg.icodeeasy.cc。

  • Claude Code(包括通过 Claude Code 使用 Kimi)/ GLM / MiniMax:修改 ANTHROPIC_BASE_URL
  • Kimi Code CLI:修改 ~/.kimi-code/config.toml 中对应 Provider 的 base_url,并保留 /v1
  • Codex:修改 base_url 或 OPENAI_BASE_URL
  • Gemini CLI:修改 GOOGLE_GEMINI_BASE_URL,不要追加 /v1beta

Q: 遇到问题如何反馈?

可以在 工单 页面提交工单,我们会尽快处理。