常见问题

配置后客户端没有生效

先完整退出客户端或终端，再重新打开。Codex、OpenCode、OpenClaw 等客户端通常需要重新打开终端后才会读取新配置。

通常是 Token 配错。

确认复制的是 Xmodel「令牌管理」里的 Token。

确认没有多复制空格、换行或引号。

确认 Token 没有被禁用或删除。

通常是模型 ID 或 Base URL 不匹配。

确认模型 ID 来自模型广场或模型列表接口。

如果 Token 设置了模型限制，确认该模型在允许范围内。

进入「钱包管理」查看当前余额，进入「使用日志」查看最近请求消耗。

如果是测试 Token，检查是否设置了 Token 额度上限。

部分客户端会自动拉取模型列表。如果失败，可以先手动填写模型 ID。

常见检查项：

Token 是否正确。

Base URL 是否正确。

当前 Token 是否有对应分组权限。

建议每个客户端单独创建 Token，例如 Codex、Claude Code、Qoder、生产服务分别创建。之后在「使用日志」里按令牌名称筛选即可。

立即进入「令牌管理」禁用或删除该 Token，然后重新创建新的 Token 并更新客户端配置。