跳转到主要内容

​
简短答案

在 Claude Code 中配置第三方 API 时，要先确认你使用的是 Anthropic-compatible endpoint。对于本仓库的接入方式，Claude Code 的 Base URL 使用 https://www.bettertoken.ai，不要添加 /v1。 API Key 是你的认证凭证，Base URL 是 Claude Code 把模型请求发往的 API 地址。两者必须属于同一个 provider 和同一种协议。 如果你使用 BetterToken 的 Claude 分组 API Key，通常只需要配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。如果使用 GPT 分组，还需要按接入文档配置 Claude Code 的模型映射。

​
什么时候需要配置它

  • 你想让 Claude Code 使用自定义 API gateway
  • 你拿到了 API Key，但不知道 Base URL 应该填什么
  • 你在 Claude Code 里看到认证失败或 endpoint 不匹配
  • 你不确定 https://www.bettertoken.ai 和 https://www.bettertoken.ai/v1 的区别
  • 你需要在 Claude 分组和 GPT 分组之间选择

​
核心概念

​
推荐配置

在 Claude Code 中接入 BetterToken 时，先按 API Key 分组选择路径。 Claude 分组：
GPT 分组需要额外设置 Claude Code 的模型映射。完整配置请使用 Claude Code 接入 BetterToken 指南，不要只复制本页的简化片段。 配置后重启 Claude Code，并发送一个短消息验证。如果失败，优先检查 Base URL 是否误填成 https://www.bettertoken.ai/v1。

​
常见误区

  • 给 Claude Code 的 Base URL 添加 /v1。Claude Code 的 Anthropic-compatible 配置不使用这个地址。
  • 只换 API Key，不换 Base URL，导致请求仍走默认 endpoint。
  • 把 GPT 分组模型 ID 当作 Claude 分组模型来用。
  • 把 OpenAI-compatible endpoint 填进 Claude Code 的 Anthropic-compatible 字段。
  • 在多个 shell profile、系统环境变量和配置文件里重复设置，导致旧变量覆盖新配置。

​
关于 BetterToken

BetterToken 提供两类 endpoint：Claude Code 使用的 Anthropic-compatible https://www.bettertoken.ai，以及 Codex / 外部工具使用的 OpenAI-compatible https://www.bettertoken.ai/v1。 这能让你在同一个 dashboard 中管理 API Key、余额和用量记录，但不会改变 Claude Code 对 Anthropic-compatible 请求格式的要求。

​
References