配置前先看这十条

按撞到的频率排。每条都带一个「判据」—— 怎么确认是这一条，而不是另一条长得像的。

已经报错了？

先去 报错对照表 按报错原文找；那一页是「我看到这个报错怎么办」， 这一页是「配之前先知道有这些坑」。两页讲的不是同一件事。

想让 AI 帮你配？

把这段发给 AI —— 那一页是同一批内容的自包含版本，可以整块复制给任意 AI。 两页从同一份数据生成，不会出现一处改了另一处没改。

1. key 的分组没选对

谁会撞上：所有人，尤其是买了卡之后直接拿旧 key 用的

每把 key 绑一个分组，分组决定这把 key 能用哪些模型。 买的是 DeepSeek 卡、key 却绑在 GPT 分组上，请求任何模型都会报「模型不存在」或 403。

修法：登录 https://cn.jichuanai.com → API 密钥 → 把这把 key 的分组改成你买的那个。 续费不用换 key，但换了卡的种类要改分组。

判据

报错里写的「本卡可用模型」和你请求的模型名对不上，就是这条。

2. 单模型时长卡，没改客户端的默认模型

谁会撞上：Codex / Claude Code / Trae 用户

这些客户端连上后会按它自己预置的模型名发请求（常见是某个 GPT 名）。 你买的是 DeepSeek 卡，一连上就 404 —— 它不会自己去用你卡里的模型。

Claude Code 系要改的不止一处：Sonnet / Opus / Haiku / Fable / Subagent 加上「默认兜底模型」，六个框填同一个模型名。

判据

漏填任何一个的症状是「聊天正常、一跑后台任务就错」——因为正常对话走 Sonnet 角色，后台子任务才踩到兜底模型。

3. 模型名写错 vs 模型不在套餐里：报错一模一样

谁会撞上：所有人

两种情况都报「模型不存在」，但修法完全相反。

判据

去模型清单里搜这个名字。搜不到 = 名字写错（多半漏了日期后缀）；搜得到但你的卡不在「可用套餐」里 = 名字没错，是卡里没有。

4. DeepSeek V4 系列不支持图片

谁会撞上：要发图片 / 截图给模型的人

deepseek-v4-flash-0731、deepseek-v4-pro-0813、deepseek-v4.1-flash 都不支持视觉，发图片会报错。

要用图片：deepseek-v4-flash-vision-exp（视觉实验版）、kimi-k2.7-code、kimi-k3 支持。 GLM 和 MiniMax 的视觉能力我们的计价目录里没有标注，不要假设它支持或不支持。

客户端里有「图片输入」开关的，用不支持视觉的模型时请关掉。

判据

（以上取自 2026-09-24 现读的计价目录 supports_vision 字段。）

5. ChatBox 连不上 → 打开「改善网络兼容性」

谁会撞上：ChatBox 用户（手机端和电脑端都有这个开关）

ChatBox 设置里有一个「改善网络兼容性」开关。 某些网络环境下不打开就是连不上，而报错看不出原因。

打开后连接速度会略降（它自己也这么提示），属正常，先保证能用。

判据

另一个相邻的坑：ChatBox 的「API 路径」保持默认 /chat/completions。你在「API 主机」里已经写了 https://api.jichuanai.com/v1，路径里再写一遍会拼成 /v1/v1/chat/completions → 404。

6. 「完整 URL」开关和地址必须成对

谁会撞上：Trae / WorkBuddy / 任何有这个开关的客户端

开关打开 = 客户端原样使用你填的地址、不再拼路径，这时要填到底： https://api.jichuanai.com/v1/chat/completions。 开关关着 = 填到 https://api.jichuanai.com/v1 为止。

判据

开关开着却只填到 /v1，POST 过去会拿到一个 HTTP 200 的网页 HTML，客户端把 HTML 当数据解析 → 报「空流 / empty stream / 解析失败」。200 很有迷惑性，看起来像通了。

7. 模型名带 [1M] 方括号，在 OpenAI 协议下必 404

谁会撞上：从 Claude Code 的配置往别的客户端复制模型名的人

[1M] 是 Claude Code 自己的长上下文标记。

• Anthropic 协议（Claude Code、CC Switch、VS Code 插件）：我们会把结尾的 [1M] / [1m] 去掉再转发，填不填都能用。
• OpenAI 协议（Codex、OpenCode、WorkBuddy、ChatBox、Trae、Zcode、SDK……）： 不处理，原样发给上游 → 404。

判据

报错只说「模型不存在」，一个字都不会提那对方括号。把报错里的模型名和模型清单逐字比，多出来的就是它。

8. 「思考模式」会拖慢甚至超时

谁会撞上：所有人

部分型号开启「思考模式 / 深度思考 / reasoning」后响应慢很多， 有时等太久被中断。

日常问答和大部分写代码的场景，开不开差别不明显。连不通时先把它关掉试。

判据

表现是：回答文不对题、重复开场白、或者只回几个字 —— 不是报错，所以容易被当成「模型变笨了」。

9. 工具调用轮数设得太大，额度烧在来回上

谁会撞上：Trae 及类似的 agent 型客户端

默认常常是 500 轮。建议改成 50～100。

判据

症状是「没干什么事但额度掉得快」。

10. Claude Code 的「声明支持 1M」不要勾

谁会撞上：Claude Code / CC Switch 用户

这个开关是告诉 Claude Code「我支持 100 万上下文」。 国产模型没有这个量级。

勾上之后 Claude Code 不会触发压缩，会一路往里塞内容，超出部分被静默截断。

判据

症状是「前面说过的话它突然不记得了」，而且不报错。

还是不行

在 控制台 联系客服，带上这四样能省掉一轮来回：

1. 完整报错原文
2. 你填的请求地址
3. 模型名（原样复制你填的）
4. key 的分组名