文档 · 接入指南

Cline 和 Roo Code 接 TopxAI：OpenAI 兼容供应商

2026-10-28

供应商选 OpenAI Compatible，基础地址填 https://api.topxai.xyz/v1，加 TopxAI 密钥和模型 ID；Claude 也可以走带自定义地址的 Anthropic 供应商。

Cline 和 Roo Code 支持通过 OpenAI Compatible 接入 TopxAI 聊天模型，也支持通过 Anthropic 加自定义地址接入 Claude。设置名称随扩展版本变化。单独的 Jev、图片和视频 API 不属于这套聊天配置；模型限制见兼容性表。

OpenAI Compatible

在扩展设置里：

API Provider：OpenAI Compatible
Base URL：https://api.topxai.xyz/v1
API Key：TopxAI 密钥（自动路由覆盖全部模型）
Model ID：claude-sonnet-5-5、gpt-6.1-sol、grok-4.7、kimi-k3.1-pro 或 GLM-5.3-Abliterated

如果界面有 Azure 和 legacy format 开关，请保持关闭。模型 ID 要和目录完全一致；选择器里没有时，手动填写。Roo Code 要求原生工具调用，因此还须确认所选模型支持你需要的工具流程。

Claude 系列走 Anthropic 供应商，能保留提示缓存和 Messages 接口特有的功能：

这里的地址是域名根，不带 /v1；扩展自己拼 /v1/messages。

这类工具可能在后续轮次中重复发送对话历史、工具定义和文件内容。Claude 线路的提示缓存可以降低重复输入的成本。缓存读取和写入分别按模型、线路定价，见当前价格和计费算例。用量日志按请求分开列出缓存与非缓存 token。