外接与兼容类问题

任何第三方外接客户端都可能与服务端存在协议、请求头或响应字段差异。本教程只能保证基础接入思路，不能保证每个模型和功能完全兼容。

外接调用返回 403

检查账号状态、Key 权限、模型权限和 provider 类型。截图反馈时请遮挡完整 API Key。

User-Agent 怎么填？

如果客户端提供 User-Agent 配置，优先保持客户端默认值。除非服务端或客户端明确要求，不要随意伪造官方客户端 User-Agent。

Base URL 要不要加 /v1？

• Claude Code / Anthropic：https://api.apixhm.com
• Codex / OpenAI 兼容：https://api.apixhm.com/v1

如果客户端会自动追加 /v1，请根据最终请求地址决定填写哪一种。

外接前需要确认哪 5 项？

1. 协议类型。
2. Base URL。
3. Key / Token 变量名称。
4. 模型 ID。
5. 客户端最终请求路径。

IDE 里能看到插件但调用报 401

IDE 插件可能读取自己的环境变量或配置文件，与终端中的配置不同。对比 IDE 和终端的最终请求地址、Key 来源和模型配置。

CLI 可用但 IDE 不可用

确认 IDE 是否继承了最新环境变量，重启 IDE 后再试；同时检查插件是否有独立的 Base URL 和 API Key 设置。