通用 OpenAI 兼容工具

Cline、Continue、Cursor、Roo Code 等支持「自定义 OpenAI 兼容服务」的工具，都可以接入 TokenHouse。通用三件套：

字段	值
Base URL / API Base	`https://api.tokenhouse.ai/v1`
API Key	`<your-key>`（在 Key 管理创建）
Model	`claude-sonnet-4-6` / `claude-opus-4-8` / `glm-4.7` 等别名，完整列表见 /models

要点：

Provider 类型选 OpenAI Compatible（或 "Custom OpenAI"）。
Base URL 用带 /v1 的形式——多数工具会直接在其后拼接 /chat/completions。
模型名填 TokenHouse 的 claude-* / glm-* 别名（规范键 anthropic.claude-* / zai.glm-* 也接受）；gpt-* 当前不可调用。
鉴权使用 Authorization: Bearer 头。OpenAI 兼容工具默认就这样发送，无需额外配置。

Cline

打开 Cline 设置，API Provider 选 OpenAI Compatible。
Base URL 填 https://api.tokenhouse.ai/v1。
API Key 填你的 TokenHouse Key。
Model ID 填 claude-sonnet-4-6（或其它 claude-* / glm-* 别名）。

Continue

在 Continue 的配置文件里新增一个 provider: openai 的模型条目，指向 TokenHouse：

models:
  - name: TokenHouse Claude
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://api.tokenhouse.ai/v1
    apiKey: <your-key>

Continue 的配置格式（YAML / JSON、字段名）随版本演进，请以 Continue 官方文档为准。不变的是三件套：apiBase 带 /v1、你的 Key、claude-* / glm-* 模型名。

Cursor

在 Cursor 的模型设置中，把你的 TokenHouse Key 填进 OpenAI API Key 一栏。
启用 Override OpenAI Base URL，填 https://api.tokenhouse.ai/v1。
以自定义模型名的方式添加 claude-sonnet-4-6 等别名，并停用内置的 gpt-* 模型——它们在 TokenHouse 上不可调用。

Roo Code

与 Cline 同源，配置方式一致：API Provider 选 OpenAI Compatible，Base URL 填 https://api.tokenhouse.ai/v1，再填入 Key 与 claude-* / glm-* 模型名即可。

验证连通

GET /v1/models 需要鉴权，正好可以一次验证网络与 Key：

curl https://api.tokenhouse.ai/v1/models \
  -H "Authorization: Bearer <your-key>"

返回 OpenAI list 格式的模型数组即配置正确；返回 401 则按下文排查 Key。

常见问题

工具默认模型名是 gpt-4o 等 gpt-* —— TokenHouse 当前不提供 gpt-* 模型，调用会得到 400 / unknown_model。把模型名改成 claude-* / glm-* 别名即可，可用模型见 /models。

401 auth_error —— 检查 Key 是否完整粘贴、工具是否以 Authorization: Bearer 或 x-api-key 头发送。若错误 code 是 key_revoked_or_disabled，说明该 Key 已被撤销，到 Key 管理确认状态或重新创建。

模型列表拉不下来 / 请求路径报错 —— 多半是表单里 Base URL 忘了加 /v1。正确值是 https://api.tokenhouse.ai/v1，不要只填 https://api.tokenhouse.ai。

402 insufficient_funds_error —— 组织余额不足（Strict 模式预扣失败）或低于 Flex 阈值，到余额与充值充值后重试。