1. Claude Code 报错排查
4sapi文档
  • 站点操作指南-快速上手调用大模型API(必看!!!!)
  • 快速开始
    • 国内外直连域名
    • 价格、充值与分组说明
    • 令牌管理使用指南
    • 客户端怎么选:会直接影响你的账单
  • 接入教程
    • IDE 与 AI 编程助手
      • Claude Code CLI 安装与配置 4sAPI(Windows + CC Switch)
      • Claude Code CLI 安装与配置 4sAPI(Windows / macOS / Linux)
      • Trae 配置指南(插件)
      • Gemini CLI 配置指南
      • Cursor 配置指南
      • VS Code 配置指南
      • ChatGPT(Codex)CLI 安装与配置 4sAPI
      • MiMoCode CLI 安装与配置 4sAPI
      • OpenCode CLI 配置指南(CC Switch)
      • Kilo Code 配置指南
    • 桌面客户端
      • Claude Code 桌面端安装与配置 4sAPI
      • ChatGPT(Codex)桌面端安装与配置 4sAPI
      • Hermes Agent 桌面端安装与配置 4sAPI
      • OpenCode 桌面端配置指南
      • ChatBox 接入 4sAPI 教程
      • CherryStudio 接入 4sAPI 教程
      • WorkBuddy 接入 4sAPI 教程
    • 工作流与自动化
      • CC Switch 安装与配置教程
      • CC Switch 导入 4sAPI 令牌(API Key)
      • Claude Code + CC Switch 配置 DeepSeek / GLM 模型
      • n8n 配置使用 4sAPI
      • Dify 配置使用 4sAPI
      • Coze 配置使用 4sAPI
    • 开源项目与部署
      • DeepSeek Harness 接入 4sAPI
      • Pi Coding Agent 配置 4sAPI
      • OpenClaw 接入 4sAPI
      • OpenClaw Web 界面配置 4sAPI
      • OpenClaw Linux 服务器终端配置 4sAPI
      • Hermes Agent Linux 安装接入 4sAPI
      • Hermes Agent CLI 安装与配置 4sAPI(CC Switch)
      • 腾讯云 OpenClaw 接入 4sAPI:配置 QQ 机器人
  • 模型接口
    • OpenAI
      • 文本模型
        • 文本生成
        • 上下文阅读
        • PDF文件分析
        • 联网搜索 Web Search
        • 函数调用 tools
        • Response_Format
        • v1/Responses / 通用
      • 图像模型
        • 图片理解(多模态视觉分析)
        • 图片生成(统一接口 · 支持多模型)
        • 图像编辑(统一接口 · 表单上传 / JSON 双模式)
      • Embedding 模型
        • 创建文本嵌入
        • 批量创建嵌入
    • Anthropic Claude
      • 原生接口
        • 思考强度
        • 文本生成 (思考配置)
        • 图片理解(原生)
        • 文本生成(原生)
        • 文本生成 / 强制返回思考(原生)
        • 函数调用(原生)
        • Web search / 联网搜索(原生)
      • OpenAI兼容接口
        • 文本生成(OpenAI兼容)
        • 图片理解(OpenAI兼容)
        • 文本生成 / 强制返回思考(OpenAI兼容)
        • 函数调用(OpenAI兼容)
        • Web search / 联网搜索(OpenAI兼容)
    • Google Gemini
      • OpenAI兼容接口(推荐)
        • 文本生成(OpenAI兼容)
        • 文本生成 / 强制返回思考(OpenAI兼容)
        • 图片生成
        • 图片理解(OpenAI兼容)
        • 图片理解(base64格式)
        • 图片编辑
        • 图片编辑(base64格式)
        • 音频理解
        • 视频理解
        • 文本转语音 / TTS
      • Google Gemini接口
        • 文本生成(Gemini原生)
        • 文字转语音
        • 音频转文
        • 视频转文
        • 图片理解(Gemini原生)
        • 文生图片(NanoBanana Pro)
        • 图片编辑(NanoBanana)
        • 图片编辑(NanoBanana Pro)
      • Omni 视频生成
        • 创建视频任务
        • 创建视频任务
        • 轮询任务状态
        • 下载 MP4
    • xAI Grok
      • Responses 原生接口
        • 简单对话
        • 对话历史
        • 流式输出
        • 联网搜索
        • 联网搜索(域名过滤)
        • 联网搜索(图片选项)
      • Chat Completions 接口
        • 文本对话
        • 多轮对话
        • 流式输出
        • 工具调用
        • 图片理解
      • 图像模型接口
        • 生成图片(URL 方式)
        • 生成图片(Base64 方式)
        • 批量生成
        • 自定义比例 / 分辨率 / 质量
      • 获取模型列表
    • DeepSeek
      • Chat Completions 接口
        • Chat Completions API
        • 思考模式
        • 工具调用
        • 流式输出
      • Response 接口
        • Response API
        • 思考模式
        • 工具调用
        • 流式输出
    • 通义千问 Qwen
      • Chat Completions 接口
        • 文本对话
        • 流式输出
        • 工具调用
        • 视频输入
        • 图像输入
        • 联网搜索
      • Messages 接口
        • 文本对话
        • 流式输出
        • 深度思考
        • 图片理解
        • 视频理解
        • 工具调用
      • 图像生成
        • 生成图片
      • 视频生成
        • 创建视频任务
        • 查询视频任务
        • 下载视频
    • 智谱 GLM
      • Chat Completions 接口
        • 文本对话
        • 流式输出
        • 工具调用
        • 联网搜索
      • Messages 接口
        • 文本对话
        • 流式输出
        • 深度思考
        • 工具调用
    • 月之暗面 Kimi
      • Chat Completions 接口
        • 简单对话
        • 推理对话
        • 流式输出
        • 图片输入
        • 视频输入
        • 工具调用
    • MiniMax
      • Chat Completions 接口
        • Chat Completions API
        • 图片理解
        • 视频理解
        • 深度思考
        • 流式输出
        • 工具调用
      • Responses 接口
        • Responses API
        • 简单对话
        • 对话历史
        • 流式输出
        • 工具调用
        • 多轮工具调用
      • Anthropic 接口
        • Anthropic API
        • 图片理解
        • 视频理解
        • 深度思考
        • 流式输出
        • 工具调用
    • 腾讯混元 Hunyuan
      • chat completions 接口
        • 简单对话
        • 流式请求
        • 深度思考
        • 多轮对话
        • 工具调用
    • Muse
      • Chat Completions 接口
        • Muse Chat Completions 接口
      • Messages 接口
        • Muse Messages 接口
      • 图像模型接口
        • 生成图片
        • 编辑图片
      • 模型目录
        • 获取当前令牌可用模型
  • 平台接口
    • 获取系统访问令牌(Authorization / Access-Token)指南
    • 用户信息管理
      • 获取用户可使用的模型
      • 注销当前用户
      • 获取用户可用的模型分组信息
      • 获取当前用户可用的模型分组信息
      • 获取当前用户信息
      • 更新当前用户信息
      • 更新用户设置(额度预警等)
      • 重置并生成新系统访问令牌
    • 令牌管理(API Key)
      • 获取全部令牌的信息
      • 获取指定令牌的信息
      • 获取指定令牌的使用情况
      • 搜索令牌
      • 创建令牌
      • 更新令牌
      • 删除令牌
      • 批量删除令牌
    • 用户登录注册
      • 发送密码重置邮件
      • 用户登录
      • 用户登出
    • 用户任务管理
      • 获取个人Midjourney任务
      • 获取个人任务
    • 日志与数据统计
      • 获取个人调用后具体的日志信息
      • 获取指定时间段调用模型的数据
      • 个人日志消费统计
      • 获取令牌总消耗
      • 获取令牌累计消耗前三的模型
      • 获取令牌中各个模型的总消耗
      • 导出令牌消耗数据(XLSX格式)
    • 获取系统信息
      • 获取首页内容
      • 获取通知公告
      • 获取系统状态
    • 兑换码接口
      • 使用兑换码
    • 充值接口
      • 获取充值信息
      • 获取用户充值记录
    • 其他
      • 删除Passkey
      • 获取Passkey状态
      • 开始注册Passkey
      • 完成注册Passkey
      • 开始验证Passkey
      • 完成验证Passkey
  • 常见问题
    • 问题自查方法
    • 入门必看
      • 如何在 4sAPI 充值?
      • 可以使用哪些 大模型API ?
      • 如何获取 OpenAI Key ? 如何获取 Claude Key ? 如何获取 Gemini Key ?等等
      • 我注册并且充值了,key 在哪?
      • 怎么更换模型使用?
      • 配置模型的时候 URL 用哪个?
      • 接口在中国大陆能使用吗?
      • 按量计费还是按月支付?
      • 使用日志在哪里?怎么看一次调用消耗了多少 Token?
      • 请问我余额为负了怎么回事?
    • 常见误区
      • 明明余额还有很多,为什么显示令牌无法使用?
      • Key 为什么不能用?为什么我调用 API 没反应?
      • 新建令牌参数怎么填?
      • 为什么调用接口返回“无效的令牌”?
      • API 接口返回报错,报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思?
    • Claude Code 报错排查
      • Claude-官方和企业推荐全模型分组claude模型在claude code中使用报错 400处理方法
  • 数据模型
    • ChatCompletionRequest
    • Error
    • EditImageItem
    • GenericJsonObject
    • ImagesResponse
    • ImageEditJsonRequest
    • ImageGenerationRequest
    • ImageEditMultipartRequest
    • Message
    • ModelObject
    • ModelsResponse
    • MessagesRequest
    • MetaMuseTextModel
    • MetaMuseImageModel
    • ReasoningEffort
    • ToolEnablement
  1. Claude Code 报错排查

Claude-官方和企业推荐全模型分组claude模型在claude code中使用报错 400处理方法

Claude Code 报 400 有多类原因,先对照报错原文判断是哪一种:
一、anthropic-beta 里出现不认识的值(如 advisor-tool-2026-03-01)
→ 看下面方法 1、方法 2。
二、出现 Prompt is too long
→ 会话上下文超过所在渠道上限。执行 /compact 压缩当前会话;长会话可先 /autocompact 200k 把自动压缩窗口压到 200K。
三、出现 thinking、adaptive 相关字样
→ 主模型不要用带 -thinking 后缀的名称;客户端 thinking 写法请改用官方新格式。
四、出现 system、developer、role 相关字样
→ 客户端把 OpenAI 的 developer 角色发到了 Anthropic 接口。改用 Claude 原生协议入口,或换用支持该字段的分组。

方法 1:关闭实验性 Beta 请求头#

报错原文:
API Error: 400 Unexpected value(s) 'advisor-tool-2026-03-01' for the 'anthropic-beta' header.
在 .claude 文件夹下的 settings.json 中加一行环境变量 "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"。
完整示例(claude-官方 / 企业推荐全模型分组 可用):
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你自己的4SAPI令牌",
    "ANTHROPIC_BASE_URL": "https://4sapi.org",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
如果你的令牌在 claude-max、claude-code企业级、default 或 一key官方中转全模型 分组,Sonnet 与 Haiku 两行可以换成 claude-sonnet-5-5 与 claude-haiku-5-5:
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
这两款在 claude-code、claude-官方、企业推荐全模型分组 未上架,填了会返回 503 无可用渠道。
ANTHROPIC_DEFAULT_HAIKU_MODEL 同时接管会话标题、摘要、记忆召回等后台任务,不要指向 Opus,否则后台请求会全部按 Opus 计费。

方法 2:在 CC Switch 中覆盖 header#

把 header 的 beta 参数设置为空:
{
  "anthropic-beta": ""
}
image.png
修改于 2026-10-22 03:54:58
上一页
API 接口返回报错,报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思?
下一页
ChatCompletionRequest
Built with