# 常见问题

> 灵眸 API 使用过程中常见报错、Token 用量、模型切换、Claude Code / Codex CLI 排障指南与解决方案汇总。

URL: https://docs.lmuai.ai/cn/docs/guide/faq



## 问题 1：断流超时错误 [#问题-1断流超时错误]

**错误信息：**

```
stream disconnected before completion: error sending request for url
(https://api.lmuai.ai/responses)
```

**原因：** 典型的断流现象，通常由以下原因导致：

* 本地网络环境不稳定（频繁切换 Wi-Fi / 移动网络、信号弱、丢包）
* **开启了魔法 / VPN / 系统代理**：代理自动切换出口 IP 会导致连接中断断流

**解决方案：**

1. **关闭 VPN / 系统代理后重试**——灵眸海外网关境外直连，无需额外代理
2. 检查本地网络是否稳定，必要时切换更稳定的网络环境

<Callout type="info" title="境外直连，无需额外代理">
  灵眸**国际站**接入网关，境外网络可直接调用 `api.lmuai.ai`，**无需额外代理**。直连即可获得最快速度与最稳定的连接；反之，挂着代理时，代理自动切换 IP 反而容易造成断流。
</Callout>

***

## 问题 2：429 重试错误 [#问题-2429-重试错误]

**错误信息：**

```
exceeded retry limit, last status: 429 Too Many Requests
```

**原因：** 当日额度已用完。

**解决方案：**

1. 查看「我的订阅」，确认当日额度是否已用完
2. 如需增量，前往购买**不同规格**的套餐，然后在后台 API 密钥中切换到新套餐的分组

<Callout type="warn" title="注意区分续期和增量">
  * **不要购买相同套餐**——相同套餐是续期，不是增量
  * 如需增量请购买不同套餐（如从天卡切换到月卡）
</Callout>

***

## 问题 3：401 密钥不正确 [#问题-3401-密钥不正确]

**错误信息：**

```
unexpected status 401 Unauthorized: Incorrect API key provided
```

**原因：** 请求还是走的 OpenAI 官方，没有走我们的中转站。

**解决方案：**

1. 确认已正确创建或替换 `config.toml` 和 `auth.json` 两个文件
2. 重启 IDE 工具（VS Code / Cursor 等）重新加载配置文件
3. 若之前使用官方或其他平台登录过，请先退出账号再进行配置

<Callout type="info" title="遇见报错怎么办">
  截图错误信息翻译查看，可以快速定位原因。
</Callout>

***

## 问题 4：脚本禁止运行（Windows） [#问题-4脚本禁止运行windows]

**错误信息：**

```
codex：无法加载文件，因为在此系统上禁止运行脚本。
```

**解决方案：** 在终端运行以下命令，然后重新打开新终端：

```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

***

## 问题 5：Node.js 未找到（Windows） [#问题-5nodejs-未找到windows]

**错误信息：** `CODEX` 无法识别为 cmdlet 等错误

**原因：** Node.js 未安装或环境变量配置有问题。

**解决方案：** 重新下载安装 Node.js 20+，安装完成后重新打开终端。

***

## 问题 6：503 No available accounts（环境变量覆盖密钥） [#问题-6503-no-available-accounts环境变量覆盖密钥]

**错误信息：**

```
Error code: 503 - {'error': {'message': 'No available accounts: no available accounts', 'type': 'api_error'}}
```

**原因：** 你的 `~/.zshrc`（或 `~/.bashrc`）中配置了 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` / `ANTHROPIC_MODEL` 等环境变量，Shell 启动后这些变量会全局生效，覆盖掉 IDE 工具（Cursor、VS Code 等）里配置的 API Key，导致请求使用了错误的密钥。

**解决方案（二选一）：**

**方案 A：直接移除 `.zshrc` 中的相关环境变量**

打开 `~/.zshrc`，删除以下几行：

```bash
export ANTHROPIC_AUTH_TOKEN="..."
export ANTHROPIC_BASE_URL="..."
export ANTHROPIC_MODEL="..."
```

然后执行 `source ~/.zshrc` 使修改生效，重启 IDE 工具。

**方案 B：将变量移到独立文件，仅在运行 Claude Code CLI 时加载**

1. 新建文件 `~/.claude_env`，将三行变量写入其中：

```bash
export ANTHROPIC_AUTH_TOKEN="sk-你的灵眸API密钥"
export ANTHROPIC_BASE_URL="https://api.lmuai.ai"
export ANTHROPIC_MODEL="你使用的模型"
```

2. 从 `~/.zshrc` 中删除这三行。

3. 启动 Claude Code 时手动加载：

```bash
source ~/.claude_env && claude
```

这样 IDE 工具正常使用配置文件中的密钥，Claude Code CLI 使用环境变量，互不干扰。

***

## 问题 7：400 Invalid signature in thinking block（跨分组切换模型） [#问题-7400-invalid-signature-in-thinking-block跨分组切换模型]

**错误信息：**

```
upstream error: 400 messages.<index>.content.<index>:
Invalid `signature` in `thinking` block
```

**原因：** Claude 的 Extended Thinking（思考）功能在生成 `thinking` block 时会附带一个**加密签名**，该签名与生成它的**具体上游账号**强绑定。当你在同一段对话里**跨分组切换模型**（例如从「Claude-Pro-直营组」的 `claude-sonnet-5` 切到「Claude-MAX-高倍率分组」的 `claude-fable-5`），客户端会把之前的对话历史（含带签名的 thinking block）一并发送给新分组的上游账号，而不同分组走的是**不同上游**，无法验证对方签发的签名，因此返回 400。

**典型触发场景：**

* 客户端支持在会话中切换模型，且切换后携带了此前的完整历史
* 切换前后所在分组来自**不同上游账号**（如「直营组」↔「中转组 / MAX 高倍率组」）

**解决方案（任一即可）：**

1. **切换分组时新开一个对话**——不携带旧历史，是最简单可靠的做法。
2. **同一会话固定使用一个分组**——如果需要多模型协作，尽量保持在同一分组（同一上游）之内切换。
3. **剥离历史中的 thinking block**——如果客户端支持自定义历史，切换分组前把历史消息里的 `thinking` block 去掉再发送。

<Callout type="info" title="为什么重试也没用？">
  这类错误属于**签名不可恢复的 4xx 客户端错误**，网关识别到后会按透传规则直接把 400 返回给客户端，不会切换到其他账号自动重试——因为换任何一个非同源的上游账号都会得到同样的失败。
</Callout>

***

## 问题 8：400 Unknown parameter: 'tools\[0].n'（图像接口误传参数） [#问题-8400-unknown-parameter-tools0n图像接口误传参数]

**错误信息：**

```
400 - {'error': {'code': 'unknown_parameter', 'message': "Unknown parameter: 'tools[0].n'.", 'param': 'tools[0].n', 'type': 'invalid_request_error'}}
```

**触发接口：** `/v1/images/generations`、`/v1/images/edits`（图像生成 / 图像编辑）。

**原因：** 客户端在调用图像接口时，把请求体里塞进了一个 `tools` 数组，且 `tools[0]` 里带了 `n` 字段。OpenAI 的图像端点**不接受 `tools` 参数**（工具调用是 Chat / Responses 接口的能力，图像接口没有这个概念），因此请求透传到上游后被直接拒绝，返回 400。

常见起因是客户端 / SDK 封装有误，把「生成张数 `n`」放错了位置——错误地嵌进了 `tools[0].n`，或直接套用了 Chat 接口的参数模板。

**解决方案：**

1. **去掉请求体里的 `tools` 字段**——图像 `generations` / `edits` 不支持工具调用，这个字段应当整个删除。
2. **生成多张图时，把数量放到顶层 `n`**——仅 `/v1/images/generations` 支持 `n`（一次生成多张）；`/v1/images/edits` 不支持多张，请去掉 `n`。
3. **检查客户端 SDK 版本**——如果是封装库自动拼的参数，升级或更换 SDK，确认它没有把 Chat 接口的参数模板套用到图像接口上。

<Callout type="info" title="换账号 / 重试为什么没用？">
  这是**请求体本身不合法**导致的 4xx 客户端错误，与上游账号、分组无关——网关把请求原样透传给上游，任何账号都会返回同样的 400。必须修正客户端发出的请求参数才能解决。
</Callout>

***

## 问题 9：需要科学上网吗？ [#问题-9需要科学上网吗]

**不需要。** 灵眸**国际站**网关，`api.lmuai.ai` 境外网络可直接调用，无需 VPN 或代理。

反之挂着魔法或代理时，代理自动切换出口 IP 反而容易造成断流（见[问题 1](#问题-1断流超时错误)）。直连即可获得最快速度与最稳定的连接。

***

## 问题 10：401 API\_KEY\_REQUIRED（Codex 请求未携带密钥） [#问题-10401-api_key_requiredcodex-请求未携带密钥]

**错误信息：**

```
unexpected status 401 Unauthorized: {"code":"API_KEY_REQUIRED","message":"API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"}, url: https://api.lmuai.ai/responses, request id: ...
```

**原因：** 这是 Codex 版本的 bug——自定义 model provider 使用 `wire_api = "responses"` 时，Codex 发出的请求**完全没有携带 API Key**（`Authorization`、`x-api-key`、`x-goog-api-key` 三个头一个都没发），网关校验不到密钥，返回 401 `API_KEY_REQUIRED`。

注意它和[问题 3](#问题-3401-密钥不正确) 的 `Incorrect API key provided` 不是一回事：那个是密钥发了但不对（多数因为请求走了 OpenAI 官方而非灵眸中转），这个是**压根没发密钥**。

**解决方案：** 打开 `~/.codex/config.toml`，找到你的 model provider 配置段 `[model_providers.<ID>]`（按本站教程配置的一般是 `[model_providers.codex]`），在该段内补上一行 `requires_openai_auth = true`：

```toml
[model_providers.codex]
name = "codex"
base_url = "https://api.lmuai.ai"
wire_api = "responses"
requires_openai_auth = true
```

保存后重新打开终端、重启 Codex 即可。

<Callout type="info" title="按本站教程配置的用户不受影响">
  本站 Codex 各教程（[Mac](../tools/codex-cli-mac) / [Windows](../tools/codex-cli-windows) / [服务器](../tools/codex-cli-server) / [Codex App](../tools/codex-app)）的 `config.toml` 示例里已包含 `requires_openai_auth = true`。遇到这个报错一般是因为配置复制自旧版教程或其他来源、缺了这一行，对照上面示例补齐即可。
</Callout>

***

## 仍有问题？ [#仍有问题]

安装配置过程中如有特殊环境还是无法解决，可联系客服：

* 添加客服微信
* 联系咸鱼客服

> 客服远程协助时间：**下午两点以后**（上午客服在岗帮忙忙远程解决复杂配置环境）
>
> 需要远程的宝子们请自行先下载**网易 UU 远程**，发给客服即可在下午两点会进行技术指导和远程协助。