企业官网建设流程全解析

1. 这个 400 报错到底在说什么

如果你在用 Claude Code 跑任务，某天突然蹦出一行红字：

API Error: 400 Model only support text input

然后整个会话卡死，resume 也进不去，之前的上下文全断——别慌，这不是你的 Key 失效，也不是网络问题，而是请求体里混进了模型不接受的输入类型。

Claude Code 的会话记录存在~/.claude/projects/<项目编码>/*.jsonl里。当你用 Read 工具读过 PNG 截图、UI 设计稿、报错截图这类图片时，消息流里会留下imageblock。原本你用的是支持视觉输入的模型，一切正常；可一旦你切到只吃文本的模型（比如某些 glm 系列、纯文本推理模型），resume 旧会话时，这些历史 image block 会被原样塞进请求体，服务端一看：这模型只支持 text input，你塞图片干嘛？直接 400 拒绝。

关键点在于：报错发生在 resume 阶段，而不是你当次操作。所以很多人第一反应是「我这次没传图啊」，其实图是几天前留下的，藏在 jsonl 里。

这篇就围绕这个场景，给你一套可复制的排查 + 规避方案：用 TaoToken 统一 Key 通道把模型调用收敛到一个入口，配好settings.json和config.toml，再用一次最小请求验证，把「模型能力」和「会话内容」对齐，从根上绕开这个 400。

适合谁看：正在用 Claude Code 做长期编码、频繁 resume 会话、又会在多个模型之间切换的开发者。如果你只是偶尔问一句就关，可能碰不到；但只要你有跨天任务、有截图习惯，这坑迟早踩。

2. 先搞懂请求体里的 image block 从哪来

要解决问题，得先看清问题长什么样。Claude Code 的消息结构大致是这样：每条消息有role和content，content是个数组，里面可以是textblock，也可以是imageblock。当你让 Claude Code 读一张图，它会调用 Read 工具，把图片编码后作为imageblock 追加进对话历史。

我试过用 Read 读一张架构图，然后切模型 resume，立刻复现。你可以自己验证：打开会话文件看一眼。

# 找到当前项目的会话目录 ls ~/.claude/projects/ # 进去看某个 jsonl，搜 image 关键字 grep -l "image" ~/.claude/projects/<项目编码>/*.jsonl

如果 grep 命中了，说明这个会话里确实有图片内容。这时候你切到纯文本模型，resume 必炸。

那为什么换个模型就炸？因为不同模型对输入模态的支持不一样。支持视觉的模型能吞下imageblock，纯文本模型只认text。服务端在请求入口做校验，发现模态不匹配，直接返回 400，错误信息就是那句Model only support text input。

这里有个容易误解的点：不是 Claude Code 的 bug，也不是模型坏了，而是「历史内容」和「当前模型能力」之间的契约被打破了。你等于拿一份带图的简历去投一个只收纯文本的岗位，HR 直接退回。

解决思路有两条：一是清理会话里的 image block，二是把模型调用统一到一个可控通道，让能力匹配这件事变得可预期。前者治标，后者治本。下面重点讲后者，顺带给你清理的兜底手段。

3. TaoToken 统一 Key 通道：把模型入口收拢

TaoToken 在这里扮演的角色，是一个统一的模型调用入口。你不用在 Claude Code 里为每个模型单独配一套 Key 和 endpoint，而是通过一个统一 Key 走 API 通道，把「用哪个模型」这件事集中管理。官网在 https://taotoken.net ，API 入口是 https://taotoken.net/api 。

为什么这对 400 报错有帮助？因为当你的调用入口统一后，模型切换、能力对照、请求体检查都集中在一处，排查时不用在多个配置之间来回跳。你可以清楚地知道「我现在这个会话用的是哪个模型、它支不支持图片」，而不是切完模型一脸懵。

具体操作上，你需要拿到一个 API Key。进控制台创建：

https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_code_400_fix

创建完 Key，去 API Keys 页面管理：

https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_code_400_fix

拿到 Key 之后，别急着往 Claude Code 里塞。先想清楚你的模型策略：如果你经常读图，就固定用支持视觉的模型；如果你就是要用纯文本模型，那就要保证会话里没有 image block。统一通道的价值在于，你可以在一个地方切换模型，而不用改一堆环境变量。

注意：TaoToken 是模型调用通道，不是编辑器替代品。Claude Code 本身还是你的编码工具，TaoToken 负责把请求稳定地送到模型那边。

如果你做的是长期编码、Agent 类任务，建议了解一下 Coding Plan，它更适合持续性的调用场景：

https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_code_400_fix

4. 可复制配置：settings.json 与 config.toml 骨架

Claude Code 的配置分两块：一块是settings.json，管 Claude Code 自身的行为；一块是config.toml，管模型通道和参数。下面给你可直接复制的骨架，把<你的Key>换成上一步创建的 Key。

先看settings.json，一般放在项目根目录或~/.claude/下：

{ "model": "claude-sonnet-4-20250514", "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "<你的Key>" }, "permissions": { "allow": ["Read", "Write", "Bash"] } }

这里ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口，ANTHROPIC_API_KEY填你的统一 Key。model字段决定默认用哪个模型——如果你要读图，这里必须选支持视觉的模型；如果你确定只用纯文本，那就选纯文本模型，但记得别 resume 带图的旧会话。

再看config.toml，用于更细的通道参数：

[api] base_url = "https://taotoken.net/api" api_key = "<你的Key>" timeout = 120 [model] name = "claude-sonnet-4-20250514" max_tokens = 8192 supports_vision = true [retry] max_attempts = 3 backoff_ms = 500

supports_vision这个字段是我建议你显式写上的，它不一定会被程序读取，但作为配置注释，能提醒你当前模型的能力边界。当你切换模型时，先改这里，再改settings.json的model，形成肌肉记忆。

两个文件的关系：settings.json是 Claude Code 读的，config.toml是你自己维护的通道说明。实际生效以settings.json为准，config.toml作为对照和文档。

配完之后，检查一下环境变量有没有冲突：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY

如果 shell 里已经设了旧值，会覆盖配置文件。建议清掉：

unset ANTHROPIC_BASE_URL unset ANTHROPIC_API_KEY

5. 最小请求验证：一次调用确认通道通了

配置写完，别直接 resume 旧会话——那可能又触发 400。先做一次最小请求，确认通道本身是通的。

用 curl 发一个纯文本请求：

curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: <你的Key>" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [ {"role": "user", "content": "reply with ok"} ] }'

如果返回里有正常的文本内容，说明 Key、endpoint、模型名三者都对。这一步排除了「Key 错、地址错、模型名错」这三类基础问题。

接着验证「带图会不会被拒」。发一个带 image block 的请求，看目标模型是否接受：

curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: <你的Key>" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [ {"role": "user", "content": [ {"type": "text", "text": "what is this"}, {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "<base64>"}} ]} ] }'

如果这个模型支持视觉，会正常返回；如果返回 400 且提示Model only support text input，说明你选的模型不吃图。这时候你就知道：要么换模型，要么清掉会话里的图。

验证通过后，回到 Claude Code 里跑一个全新会话（别 resume 旧的），确认能正常对话。全新会话没有历史 image block，不会触发那个 400。

6. 本篇常见错排查

错误一：改了配置但没生效。最常见的原因是环境变量覆盖。Claude Code 启动时会读 shell 环境，如果ANTHROPIC_BASE_URL在 shell 里被设成旧值，配置文件里的会被忽略。用env | grep ANTHROPIC查一遍，有就 unset。

错误二：resume 旧会话仍然 400。这说明会话 jsonl 里的 image block 还在。配置只影响新请求的通道，不会自动清理历史。你需要手动处理会话文件，或者干脆开新会话。清理思路是找到含 image 的 jsonl，把 image block 删掉或整条消息移除，操作前先备份。

错误三：模型名写错。model字段必须和通道支持的模型名完全一致，大小写、日期后缀都不能错。写错了可能返回 404 或 400，错误信息不一定是Model only support text input，但同样连不上。用第 5 节的最小请求先验证模型名。

错误四：把纯文本模型和带图会话混用。这是 400 的根因。解决办法是建立习惯：切模型前先看会话里有没有图。你可以用 grep 快速检查：

grep -c "image" ~/.claude/projects/<项目编码>/<会话>.jsonl

返回大于 0 就说明有图，切纯文本模型前先处理。

错误五：以为换个 Key 就能解决。Key 只负责鉴权，不负责模态匹配。400 是请求体内容的问题，换 Key 没用。别在这上面浪费时间。

错误六：timeout 设太短导致误判。带图请求体积大，如果timeout设成 10 秒，可能还没传完就断了，报错看起来像网络问题。建议至少 120 秒，config.toml里已经给了参考值。

7. 把模型能力和会话内容对齐

回到最初那个 400。它的本质不是「通道坏了」，而是「你给模型喂了它不认的东西」。TaoToken 统一 Key 通道解决的是「入口可控、切换可预期」，但最终对齐模型能力和会话内容，还是得靠你的操作习惯。

给你三个实用建议。第一，读图用支持视觉的模型，纯文本任务用纯文本模型，别混。第二，切模型前先 grep 一下会话里有没有 image，有就先清理或开新会话。第三，把supports_vision写进你的config.toml，每次切模型先改这个字段，形成条件反射。

如果你需要长期跑编码任务，Coding Plan 那条通道更适合持续调用：

https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_code_400_fix

想直接验证模型对话行为，用模型对话入口：

https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_code_400_fix

接入细节和参数说明看文档：

https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_code_400_fix

最后说个我踩过的坑：有次我以为是模型不支持图，折腾半天换模型，结果发现是会话文件里混进了一张很早之前的截图，grep 一下就定位了。所以遇到这个 400，先 grep，再动配置，顺序别反。