内容纲要
一、cmd找不到claude
直接下载
npm install -g @anthropic-ai/claude-code检查
C:\Users\用户名\AppData\Roaming\npm\node_modules
去看看该目录下是否有目录：
@anthropic-ai
二、API Error: 400 System message must be at the beginning.
发生报错的主要原因是因为，调用技能时，会把一些权限请求加到system字段中，claude要求，这些请求要全部加到最开始的system字段里，而不是追加一个system字段里面。
claude code配置文件的“env”字段中加上一句：
"CLAUDE_CODE_SIMPLE": "1",按照简单模式输出
三、RBAC: Access denied
加公网ip地址到Ai网关的安全管理（白名单）即可
四、404 not found
ai网关的域名正确，basepath也正确。但是后缀的接口，比如qwen3-reranker-8b模型注册的唯一接口：v1/rerank。
域名/basepath/接口，无法找到对应的模型调用接口
网关兼容协议（OpenAI、Anthropic、vllm协议的固定注册路由、自定义http的自定义后缀）
I 情况1：
AI网关使用协议：OpenAI、Anthropic、vllm协议的固定注册接口
则是由于服务器vllm部署的服务有问题，可以观察日志打印的最后一排信息，查看是否支持该路由接口，不支持就加上对应的指令，让vllm支持该模型。
比如 Qwen3-Reranker-8B ：
--runner pooling \
--hf-overrides '{"architectures": ["Qwen3ForSequenceClassification"], "classifier_from_token": ["no", "yes"], "is_original_qwen3_reranker": true}' \II 情况2：
AI网关使用协议：自定义http的自定义后缀
则给部署模型的模型中加上这个路由后缀：
–root-path /paddleocr/predict