凡是兼容 OpenAI/Anthropic API 协议并支持自定义服务端点的第三方客户端、IDE 插件和开发工具，均可接入云信大模型 API 平台（简称 AIHub）。

支持条件

工具需至少满足以下条件之一：

• 支持自定义 OpenAI-compatible Base URL、API Key 和模型名称配置。
• 支持自定义 Anthropic-compatible Base URL、API Key 和模型名称配置。
• 支持自定义 HTTP endpoint 和 Authorization: Bearer <token> 请求头。

如果工具仅允许选择内置官方 provider，且不能配置自定义 Base URL，则无法直接接入 AIHub。

配置接入凭证

工具支持的协议	Base URL/Endpoint	API Key	模型名称
OpenAI-compatible	$AIHUB_BASE_URL/v1	AIHUB_TOKEN	AIHub 模型名称
Anthropic-compatible	按工具字段语义填写 $AIHUB_BASE_URL、$AIHUB_BASE_URL/v1 或 $AIHUB_BASE_URL/v1/messages	AIHUB_TOKEN	AIHub 模型名称
HTTP 调试工具	完整接口路径，例如 $AIHUB_BASE_URL/v1/chat/completions	AIHUB_TOKEN	请求体中的 model 字段填写 AIHub 模型名称

AIHUB_TOKEN 是 AIHub API 密钥/访问令牌，不是上游供应商密钥。

模型名称可在控制台查看，也可通过以下命令查询：

bashcurl "$AIHUB_BASE_URL/v1/models" \
  -H "Authorization: Bearer $AIHUB_TOKEN"

响应中的 data[].id 即为可用的模型名称。

常见入口选择

场景	推荐入口
普通聊天、代码问答、IDE 对话	OpenAI Chat Completions：$AIHUB_BASE_URL/v1
工具支持 Responses API	OpenAI Responses：$AIHUB_BASE_URL/v1
工具按 Anthropic Messages 协议请求	Anthropic Messages：最终请求进入 $AIHUB_BASE_URL/v1/messages
向量化或知识库索引	Embeddings：最终请求进入 $AIHUB_BASE_URL/v1/embeddings
视频、音频、图片等任务型能力	使用 AIHub 对外开放的对应任务接口，不要假设所有能力都能通过 LLM 对话节点调用

已收录工具速查

如果目标 IDE 插件已在本指南中列出，建议优先参考对应专页：

工具	说明
Claude Code	原生 Anthropic Messages 配置，适合终端、VS Code 和 JetBrains 场景。
Cursor	通过自定义 OpenAI API Key 和 Override OpenAI Base URL 接入。
Cline	通过 OpenAI-compatible provider 接入。
Kilo CLI	通过自定义 provider 指向 AIHub OpenAI-compatible 入口。

验证配置

1. 查询模型。

   先用 curl 调用 /v1/models，确认访问令牌和模型授权正确。

2. 选择模型。

   在工具中选择 AIHub provider 和目标逻辑模型。

3. 发送测试。

   发送最小测试消息（如"只回复 OK"）。

4. 检查日志。

   在 AIHub 控制台查看请求日志，确认请求路径、模型名和用量记录符合预期。

常见问题

现象	排查方向
工具提示 API Key 无效	API Key 应填写 AIHub 访问令牌（AIHUB_TOKEN），并以 Bearer 方式发送。
Base URL 校验失败	确认工具字段需要的是根路径、/v1 路径还是完整 endpoint。
模型列表为空	当前访问令牌未授权任何模型，或工具未使用 AIHub Token 查询模型。
控制台没有请求日志	请求未进入 AIHub，优先检查工具是否仍选中默认官方 provider。
参数不兼容	工具可能发送了目标模型或渠道不支持的参数；建议减少额外参数或更换兼容模型。