🔧 报错合集及解决方案

ERR_BAD_REQUEST

📷 点击查看图片

第1步:下载配置文件

下载链接:https://wwaue.lanzouv.com/iTLAr3fdlrhc
密码:5yds

重要:下载后必须将文件名从 claude.txt 改为 .claude.json

第2步:找到并替换配置文件

Windows 用户:

  1. 打开文件资源管理器
  2. 在地址栏输入:%USERPROFILE% 然后按回车
  3. 找到 .claude.json 文件(如果看不到,需要在"查看"选项中勾选"显示隐藏的文件")
  4. 用下载的文件替换这个文件

macOS 用户:

  1. 打开访达(Finder)
  2. Cmd + Shift + G 打开"前往文件夹"
  3. 输入:~/.claude.json 然后按回车
  4. 用下载的文件替换这个文件

替换后执行 claude,如果继续报错,新建或修改 settings.json 配置文件进行配置:

Windows 用户:

文件位置:C:\Users\你的用户名\.claude\settings.json(在文件资源管理器地址栏输入 %USERPROFILE%\.claude 回车)

macOS 用户:

文件位置:~/.claude/settings.json(终端执行 mkdir -p ~/.claude && open -e ~/.claude/settings.json

写入以下内容并保存(只需修改 key 值,其余直接复制):

点击查看 settings.json 完整配置 ▼
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "填入你在面板生成的key",
    "ANTHROPIC_BASE_URL": "https://api.xstx.info",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4.6",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "permissions": {
    "allow": [
      "Bash(stat *)",
      "Bash(ls *)",
      "Bash(cat *)",
      "Bash(head *)",
      "Bash(tail *)",
      "Bash(find *)",
      "Bash(grep *)",
      "Bash(rg *)",
      "Bash(wc *)",
      "Bash(file *)",
      "Bash(which *)",
      "Bash(echo *)",
      "Bash(pwd)",
      "Bash(cd *)",
      "Bash(python3 *)",
      "Bash(python *)",
      "Bash(pip *)",
      "Bash(pip3 *)",
      "Bash(node *)",
      "Bash(npm *)",
      "Bash(npx *)",
      "Bash(git *)",
      "Bash(docker *)",
      "Bash(mkdir *)",
      "Bash(cp *)",
      "Bash(mv *)",
      "Bash(touch *)",
      "Bash(chmod *)",
      "Bash(curl *)",
      "Bash(wget *)",
      "Bash(brew *)",
      "Bash(open *)",
      "Bash(diff *)",
      "Bash(sort *)",
      "Bash(uniq *)",
      "Bash(sed *)",
      "Bash(awk *)",
      "Bash(cut *)",
      "Bash(tr *)",
      "Bash(xargs *)",
      "Bash(tee *)",
      "Bash(env *)",
      "Bash(export *)",
      "Bash(source *)",
      "Bash(kill *)",
      "Bash(ps *)",
      "Bash(lsof *)",
      "Bash(pytest *)",
      "Bash(java *)",
      "Bash(javac *)",
      "Bash(mvn *)",
      "Bash(gradle *)",
      "Bash(cargo *)",
      "Bash(go *)",
      "Bash(make *)",
      "Bash(cmake *)",
      "Bash(gcc *)",
      "Bash(g++ *)",
      "Bash(tar *)",
      "Bash(unzip *)",
      "Bash(zip *)",
      "Bash(gh *)",
      "Read",
      "Edit",
      "Write",
      "Glob",
      "Grep",
      "WebFetch",
      "WebSearch",
      "Task",
      "NotebookEdit",
      "mcp__puppeteer__puppeteer_navigate",
      "mcp__puppeteer__puppeteer_screenshot",
      "mcp__puppeteer__puppeteer_click",
      "mcp__puppeteer__puppeteer_fill",
      "mcp__puppeteer__puppeteer_evaluate",
      "mcp__puppeteer__puppeteer_select",
      "mcp__puppeteer__puppeteer_hover",
      "mcp__filesystem__*",
      "mcp__memory__*",
      "mcp__duckduckgo__*",
      "mcp__sequential-thinking__*",
      "mcp__local-rag__*"
    ],
    "deny": []
  },
  "model": "opus[1m]",
  "hooks": {
    "Notification": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "afplay ~/.claude/notification.m4a"
          }
        ]
      }
    ]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline-mac.sh"
  },
  "enabledPlugins": {
    "ralph-loop@claude-plugins-official": true
  },
  "alwaysThinkingEnabled": true
}

注意:将 "填入你在面板生成的key" 替换为你在 api.xstx.info 面板创建的实际 API Key(以 sk- 开头),保存后重新打开终端执行 claude

400报错

首先要确定你是否有正确 Cline 插件配置

情况1:文件修改大小超限

你是在使用过程中修改文件时报错,那要确定本次文件修改大小,如果超过两千行,文件大小超过100k,那报错400是属于正常情况,在发布任务的时候加入下面的提示词即可解决:

__重要:文件操作规则__

在读取或修改任何文件之前,必须先使用 `wc -l <文件路径>` 命令检查文件行数。

__处理规则:__

- 文件 ≤ 2000 行:可以使用 `read_file` 和 `write_to_file`

- 文件 > 2000 行:
  - 禁止使用 `read_file` 读取整个文件
  - 禁止使用 `write_to_file` 覆盖整个文件
  - 必须使用 `search_files` 定位目标代码
  - 必须使用 `replace_in_file` 进行局部修改
  - 如需查看上下文,使用 `sed -n '起始行,结束行p' <文件路径>`

__操作流程:__

1. 先执行:`wc -l <文件路径>` 检查文件大小
2. 根据行数选择合适的工具
3. 对于大文件,使用 `search_files` 找到目标位置
4. 使用 `replace_in_file` 的 SEARCH/REPLACE 块进行精确修改

违反此规则会导致 API 400 错误和任务失败。

情况2:上下文长度过长

上下文长度过长,超过上限,实测设置150k,压缩后极限可达20m,但弊端是压缩会降智,压缩的原理是提取总结当前任务,使其原本200k的上下文压缩至几k。

如果当前任务已经完成,cli用户可使用/clear命令进行清除,如果是使用cline的用户则可以提示ai:

总结当前任务关键信息我要另开窗口创建新的任务,必须生成正确的提示词使新任务窗口可以继续运行。

情况3:使用了测试中的功能

添加环境变量:

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

403报错 / Missing API Key

📷 点击查看图片

此报错说明 API Key 未正确配置。请新建或修改 settings.json 配置文件:

Windows 用户:C:\Users\你的用户名\.claude\settings.json

macOS 用户:~/.claude/settings.json

写入以下内容并保存(只需修改 key 值,其余直接复制):

点击查看 settings.json 完整配置 ▼
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "填入你在面板生成的key",
    "ANTHROPIC_BASE_URL": "https://api.xstx.info",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4.6",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "permissions": {
    "allow": [
      "Bash(stat *)",
      "Bash(ls *)",
      "Bash(cat *)",
      "Bash(head *)",
      "Bash(tail *)",
      "Bash(find *)",
      "Bash(grep *)",
      "Bash(rg *)",
      "Bash(wc *)",
      "Bash(file *)",
      "Bash(which *)",
      "Bash(echo *)",
      "Bash(pwd)",
      "Bash(cd *)",
      "Bash(python3 *)",
      "Bash(python *)",
      "Bash(pip *)",
      "Bash(pip3 *)",
      "Bash(node *)",
      "Bash(npm *)",
      "Bash(npx *)",
      "Bash(git *)",
      "Bash(docker *)",
      "Bash(mkdir *)",
      "Bash(cp *)",
      "Bash(mv *)",
      "Bash(touch *)",
      "Bash(chmod *)",
      "Bash(curl *)",
      "Bash(wget *)",
      "Bash(brew *)",
      "Bash(open *)",
      "Bash(diff *)",
      "Bash(sort *)",
      "Bash(uniq *)",
      "Bash(sed *)",
      "Bash(awk *)",
      "Bash(cut *)",
      "Bash(tr *)",
      "Bash(xargs *)",
      "Bash(tee *)",
      "Bash(env *)",
      "Bash(export *)",
      "Bash(source *)",
      "Bash(kill *)",
      "Bash(ps *)",
      "Bash(lsof *)",
      "Bash(pytest *)",
      "Bash(java *)",
      "Bash(javac *)",
      "Bash(mvn *)",
      "Bash(gradle *)",
      "Bash(cargo *)",
      "Bash(go *)",
      "Bash(make *)",
      "Bash(cmake *)",
      "Bash(gcc *)",
      "Bash(g++ *)",
      "Bash(tar *)",
      "Bash(unzip *)",
      "Bash(zip *)",
      "Bash(gh *)",
      "Read",
      "Edit",
      "Write",
      "Glob",
      "Grep",
      "WebFetch",
      "WebSearch",
      "Task",
      "NotebookEdit",
      "mcp__puppeteer__puppeteer_navigate",
      "mcp__puppeteer__puppeteer_screenshot",
      "mcp__puppeteer__puppeteer_click",
      "mcp__puppeteer__puppeteer_fill",
      "mcp__puppeteer__puppeteer_evaluate",
      "mcp__puppeteer__puppeteer_select",
      "mcp__puppeteer__puppeteer_hover",
      "mcp__filesystem__*",
      "mcp__memory__*",
      "mcp__duckduckgo__*",
      "mcp__sequential-thinking__*",
      "mcp__local-rag__*"
    ],
    "deny": []
  },
  "model": "opus[1m]",
  "hooks": {
    "Notification": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "afplay ~/.claude/notification.m4a"
          }
        ]
      }
    ]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline-mac.sh"
  },
  "enabledPlugins": {
    "ralph-loop@claude-plugins-official": true
  },
  "alwaysThinkingEnabled": true
}

注意:将 "填入你在面板生成的key" 替换为你在 api.xstx.info 面板创建的实际 API Key(以 sk- 开头),保存后重新打开终端执行 claude

401 无效的令牌

📷 点击查看图片

请检查 settings.json 中的 ANTHROPIC_AUTH_TOKEN 是否填写正确(以 sk- 开头),如果 Key 已过期或无效,请到 api.xstx.info 面板重新生成。

Connection error / Request timed out

📷 点击查看图片

此问题通常由网络原因导致,建议您更换 Wi-Fi 或关闭代理后重试。

Windows清除代理:

set HTTP_PROXY=
set HTTPS_PROXY=

macOS清除代理:

unset http_proxy
unset https_proxy
unset all_proxy

报错长度不够

设置环境变量:

变量名:CLAUDE_CODE_MAX_OUTPUT_TOKENS
变量值:32000