> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 关于 BetterToken 账号、计费、用量和接入的常见问题。

## 账号与计费

<AccordionGroup>
  <Accordion title="BetterToken 是如何计费的？">
    BetterToken 按实际消耗的 token 量计费，与 Anthropic / OpenAI 官方定价保持一致，不额外收取溢价。注册即获得 ¥5 体验额度，无需绑卡。

    具体定价请参考定价页面 (`https://www.bettertoken.ai/#`)。
  </Accordion>

  <Accordion title="注册后可以退款吗？">
    充值金额支持退款，体验额度不支持退款。如有退款需求，请联系客服处理。
  </Accordion>

  <Accordion title="是否可以同时在多个工具中使用同一个 API Key？">
    可以。同一个 API Key 可以同时在 Claude Code、Codex、Cursor 等多个工具中使用，额度共享。
  </Accordion>

  <Accordion title="如何查看用量？">
    登录控制台后，在账户管理页面可以查看当前用量和消费记录。
  </Accordion>
</AccordionGroup>

## 接入与配置

<AccordionGroup>
  <Accordion title="BetterToken 的 base_url 是什么？">
    BetterToken 现在按协议区分两个地址：

    | 场景                                 | Base URL                        |
    | ---------------------------------- | ------------------------------- |
    | Claude Code / `ANTHROPIC_BASE_URL` | `https://www.bettertoken.ai`    |
    | Codex / `OPENAI_BASE_URL` / 其他外部工具 | `https://www.bettertoken.ai/v1` |

    不再使用“一个地址适配所有协议”的写法。
  </Accordion>

  <Accordion title="接入 Claude Code 时需要指定模型吗？">
    取决于你的 API Key 分组。

    如果你使用 `Claude_*` 分组，只需配置 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN`，**不需要**设置模型变量。

    如果你使用 `Codex_*` 分组，则需要通过 `ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_OPUS_MODEL` 为 Claude Code 配置模型映射。模型 ID 请从模型广场 (`https://www.bettertoken.ai/pricing`)复制当前可用的 **Codex 分组**模型 ID。
  </Accordion>

  <Accordion title="接入 Codex 时需要指定模型吗？">
    需要在配置里填一个模型 ID，但这个模型 ID 应该从模型广场 (`https://www.bettertoken.ai/pricing`)复制 **Codex 分组**下当前可用的模型。

    详细配置参考[Codex 接入文档](/ai-tools/codex)。
  </Accordion>

  <Accordion title="接入 Cursor 等其他工具时需要指定模型吗？">
    需要。Cursor、Cline、Zed、OpenClaw 等外部工具统一走 **Codex 分组**，模型名称请从模型广场 (`https://www.bettertoken.ai/pricing`)复制当前可用的 Codex 分组模型 ID。

    这些工具当前不应继续按 Anthropic / Claude 直连方式填写 Claude 系列固定模型名。

    详细配置参考 [Cursor 接入文档](/ai-tools/cursor)。
  </Accordion>

  <Accordion title="OpenClaw 和其他外部工具需要额外 headers 吗？">
    通常不需要。

    根据我们核对到的官方文档，Cursor、Cline、Zed 等常见外部工具的默认接入说明都聚焦在 `Base URL`、API Key 和模型 ID。OpenCode 与 OpenClaw 虽然支持可选 `headers`，但官方文档的定位也是自定义 headers / custom auth needs，而不是 BetterToken 默认接入的必填项。

    只有当工具官方文档，或你额外接入的上游网关、租户路由、审计、缓存服务明确要求额外 headers 时，再按对应文档补充。
  </Accordion>

  <Accordion title="配置后提示认证失败怎么办？">
    请检查以下几点：

    1. API Key 是否正确，没有多余空格
    2. Claude Code 是否使用 `https://www.bettertoken.ai`，Codex / 外部工具是否使用 `https://www.bettertoken.ai/v1`
    3. 是否存在旧的 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`OPENAI_API_KEY` 或 `OPENAI_BASE_URL` 覆盖了配置
    4. 外部工具是否存在额外的官方接入要求，例如特定版本限制、模型白名单，或上游网关明确要求的额外 headers

    如仍有问题，请联系客服。
  </Accordion>
</AccordionGroup>

## 可靠性与限流

<AccordionGroup>
  <Accordion title="BetterToken 是如何保证可靠性的？">
    BetterToken 同时接入多家供应商，并通过以下机制保障稳定性：

    * **多源供应**：某个供应商故障时自动切换，不影响你的请求
    * **动态路由**：实时检测各链路状态，选择响应最快、成功率最高的路径
    * **精选旗舰**：围绕 Claude Code 与 Codex 生态集中保障核心链路的可用性
  </Accordion>

  <Accordion title="遇到限流或超时怎么办？">
    BetterToken 的多源路由机制会自动处理单一供应商的限流和超时。如果你遇到持续的限流问题：

    1. 检查账户余额是否充足
    2. 适当增大工具的超时时间（建议设置 `API_TIMEOUT_MS=3000000`）
    3. 联系客服了解当前配额情况
  </Accordion>

  <Accordion title="BetterToken 是否适合生产环境？">
    BetterToken 主要面向 AI 编程工具的个人开发者场景（Claude Code、Codex 等）。对于大批量的生产环境 API 调用，建议结合实际情况评估。
  </Accordion>
</AccordionGroup>

## 隐私与安全

<AccordionGroup>
  <Accordion title="BetterToken 会存储我的请求内容吗？">
    BetterToken 作为 API 中转层处理请求，不会持久化存储用户的对话内容。详细的隐私条款请参考隐私政策 (`https://www.bettertoken.ai/privacy`)。
  </Accordion>

  <Accordion title="API Key 泄露了怎么办？">
    立即登录控制台，删除旧的 API Key 并重新生成一个。同时检查使用该 Key 的工具配置，替换为新 Key。
  </Accordion>
</AccordionGroup>