Skip to main content

​
Claude Code 自定义 API Endpoint：简短答案

Claude Code 自定义 API Endpoint 必须兼容 Anthropic 协议。对于本仓库的接入方式，Claude Code 的 Base URL 使用 https://bettertoken.ai，不要添加 /v1。 通用 Claude API 访问、可用模型和开始使用方式，请查看 BetterToken Claude API 页面。这篇 FAQ 只说明已有 BetterToken API Key 时，如何通过 Base URL 和环境变量配置 Claude Code，不重复介绍通用 API 产品。 API Key 是你的认证凭证，Base URL 是 Claude Code 把模型请求发往的 API 地址。两者必须属于同一个 provider 和同一种协议。 如果你使用 BetterToken 的 BetterToken API Key，通常只需要配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。如果使用 GPT 提供商，还需要按接入文档配置 Claude Code 的模型映射。

​
什么时候需要配置它

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

​
核心概念

​
推荐配置

在 Claude Code 中接入 BetterToken 时，先按 提供商选择路径。 Claude 提供商：
GPT 提供商需要额外设置 Claude Code 的模型映射。完整配置请使用 Claude Code 接入 BetterToken 指南，不要只复制本页的简化片段。 配置后重启 Claude Code，并发送一个短消息验证。如果失败，优先检查 Base URL 是否误填成 https://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://bettertoken.ai，以及 Codex / 外部工具使用的 OpenAI-compatible https://bettertoken.ai/v1。 这能让你在同一个 dashboard 中管理 API Key、余额和用量记录，但不会改变 Claude Code 对 Anthropic-compatible 请求格式的要求。

​
References