本文适用于把卡特 Token 站 API Key 接入第三方客户端、IDE 插件或自定义程序时遇到的问题。

​
先确认协议和 Base URL

外接前先判断客户端使用哪种协议：
协议 / 客户端类型Base URL
Claude 兼容 / Anthropic Messages / Claude Codehttps://api.cutaihub.com
OpenAI 兼容 / Codex / Chat Completions / Responseshttps://api.cutaihub.com/v1
最常见错误：
  • Claude 类客户端误加 /v1。
  • OpenAI 类客户端没有加 /v1。
  • 客户端 UI 显示保存了地址，但实际请求仍然走旧地址。

​
外接前确认 5 项

配置前先逐项确认：
  • API Key 是否来自卡特 Token 站。
  • API Key 的令牌分组是否支持目标模型。
  • 客户端协议是 Claude 兼容还是 OpenAI 兼容。
  • Base URL 是否按协议填写。
  • 模型名称是否属于该分组。
如果任何一项不匹配，都可能出现 401、403、503、模型不可用或请求格式错误。

​
第三方客户端返回 403

常见现象： 
403 Forbidden
403 block
permission denied
not allowed
按顺序排查：
  1. API Key 是否复制完整。
  2. Authorization 是否是 Bearer sk-... 格式。
  3. Base URL 是否正确。
  4. 令牌分组是否支持当前模型。
  5. 客户端是否实际发送了自定义 Header。
  6. 是否有旧环境变量或旧插件配置覆盖了新配置。
如果错误是 503，优先理解为当前分组没有该模型，请回到「请求错误类问题」排查。

​
User-Agent 什么时候需要填写

大多数普通客户端不需要手动填写 User-Agent。但部分外接、插件或转发场景会根据请求头判断客户端类型，缺失或错误的 User-Agent 可能导致拒绝。 如果客户端支持自定义 Header，可按场景填写： Claude 类外接： 
{
  "User-Agent": "claude-cli/2.0.76 (external, cli)"
}
Codex 类外接： 
{
  "User-Agent": "codex_cli_rs/0.77.0"
}
浏览器型客户端： 
{
  "User-Agent": "Mozilla/5.0"
}
不要把 Claude 的 User-Agent 复用到 Codex，也不要把 Codex 的 User-Agent 复用到 Claude。

​
IDE 插件里配置了但仍然失败

Cursor、Continue、JetBrains 插件、Trae、Cherry Studio、Chatbox、Cline、Roo Code 等客户端的配置项名称可能不同。 常见问题：
  • 插件读取了旧 API Key。
  • 插件有单独的 Base URL，不读取系统环境变量。
  • 插件保存了配置，但请求时没有发送自定义 Header。
  • 插件只支持 OpenAI 兼容协议，却配置成 Claude 地址。
  • 插件模型名称固定，和卡特 Token 分组不匹配。
建议：
  • 先用 Claude Code 或 Codex CLI 验证 Key 可用。
  • 再把同一个 Key 配到第三方客户端。
  • 如果 CLI 可用但插件不可用，问题通常在插件配置，而不是 Key 本身。

​
OpenAI 兼容客户端怎么填

适用于 Codex、OpenAI SDK、Chatbox、Cherry Studio、部分 IDE 插件等。 
Base URL: https://api.cutaihub.com/v1
API Key: 你的完整 API Key
Model: 选择当前分组支持的模型
如果客户端要求填写完整 endpoint，不是 Base URL，请按它的说明确认是否会自动拼接 /chat/completions 或 /responses。

​
Claude 兼容客户端怎么填

适用于 Claude Code 或支持 Anthropic Messages 协议的客户端。 
Base URL: https://api.cutaihub.com
API Key: 你的完整 API Key
Model: 选择当前分组支持的 Claude 兼容模型
Claude 兼容客户端不要追加 /v1。

​
流式输出异常

如果普通请求能返回，但流式输出失败，常见原因是：
  • 客户端不支持当前协议的 stream 格式。
  • 代理或网络拦截了 SSE。
  • 第三方客户端把 OpenAI stream 和 Claude stream 混用了。
  • 中间代理不支持长连接。
排查建议：
  • 先关闭 stream，确认非流式请求可用。
  • 切换客户端协议，确认是 OpenAI 兼容还是 Claude 兼容。
  • 尝试换网络或关闭中间代理。

​
模型列表为空或模型不可用

如果客户端模型列表为空：
  • 客户端可能不会自动拉取模型列表，需要手动填写模型名。
  • 当前 Key 分组可能没有该模型。
  • Base URL 协议填错，导致模型接口不兼容。
如果返回 503，按卡特 Token 站语义，优先检查当前分组是否有该模型。

​
排障时提供什么

联系客服时请提供：
  • 客户端名称和版本。
  • 配置的 Base URL。
  • 使用的协议：OpenAI 兼容或 Claude 兼容。
  • API Key 分组。
  • 请求模型名称。
  • 错误截图或终端日志。
  • CLI 是否可用，第三方客户端是否不可用。
不要发送完整 API Key。