> ## Documentation Index
> Fetch the complete documentation index at: https://docs.okab.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 按症状检查配置、密钥、模型权限、额度和订单

## 配置后仍在使用旧服务

在 CC Switch 的正确客户端标签下启用 **MeliAI**，完全退出并重启客户端。Claude Code、Codex 和 Claude Desktop 的配置需要分别设置。

仍未生效时，检查终端环境变量、项目配置和启动参数是否覆盖了设置。Claude Code 注意 `CLAUDE_CONFIG_DIR`；Codex 注意 `CODEX_HOME`、`--profile`、`--model` 和 `-c`。

收到回复后，在 [仪表盘](https://console.okab.ai/usage) 的 **调用记录** 中按时间、模型和访问密钥核对。没有记录时先确认配置，再稍后刷新；CC Switch 的用量查询失败不等于模型请求失败。

## 请求报错

| 现象 | 先检查什么 |
| - | - |
| 无效密钥或 401 | 密钥完整、已启用、未过期，且来自正确的服务入口；Codex 还需核对 [凭据存储](https://docs.okab.ai/integrations/codex.md) |
| 地址不存在或 404 | 从密钥的 **使用 → 客户端配置** 重新复制地址，不要使用控制台网页地址 |
| 模型不可用 | 模型 ID 是否准确，当前服务是否支持；[模型广场](https://console.okab.ai/models) 列出模型不代表当前密钥有权限 |
| 额度不足或限流 | 查看 [套餐各周期额度](https://docs.okab.ai/subscriptions/credits.md)；托管账号还需检查服务商额度和密钥额度上限 |
| 403 且提示 **积分钱包余额不足** | 补充 [积分包](https://console.okab.ai/point-packs)，无需更换密钥 |

地址拼接常见错误：Claude Code 不要追加 `/v1/messages`；Codex 不要重复追加 `/v1` 或 `/responses`；WorkBuddy 需要完整的 `/v1/chat/completions` 地址。

## 账号托管授权失败

使用同一次流程生成的授权链接和回调地址；过期后重新开始。已有账号在详情页 **重新授权**，具体步骤见 [账号托管](https://docs.okab.ai/byoo.md)。重新授权不会增加服务商额度。

页面提示先同意服务说明时，阅读并确认 [服务说明](https://docs.okab.ai/byoo/terms) 后再操作。

## 付款后没有到账或开通

先在 [购买记录](https://console.okab.ai/orders) 检查订单。**确认支付中**、**开通中**、**待发货** 或 **续费中** 时等待处理，避免重复付款。

订单已完成时刷新对应的套餐、积分包或成品账号页面；仍未更新，或订单显示 **待核实** 时，提供订单号联系支持人员。需要发票时，查看已完成订单是否提供 **查看发票** 入口。

## 联系支持时提供什么

提供发生时间、客户端名称、错误信息，以及相关订单号或访问密钥 ID。不要发送完整密钥、授权回调、账号密码或含凭据的配置文件。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.