Claude Code

Claude Code：API Key 与 Base URL

使用 BetterToken API Key、Base URL BetterToken 和你选择的 Model ID 接入 Claude Code。

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 API Key、Base URL https://bettertoken.ai 和你选择的 Model ID 接入 Claude Code。从模型广场复制准确的 Model ID。

什么时候需要配置它

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

核心概念

字段	含义
API Key	用于认证模型 API 请求的密钥
Base URL	模型请求发送到的 API 地址
Anthropic-compatible API	兼容 Anthropic / Claude 请求格式的 endpoint
OpenAI-compatible API	兼容 OpenAI 请求格式的 endpoint，常用于 Codex、Cursor、Cline 等工具
Model ID	工具实际请求的模型名称或模型映射值

推荐配置

使用 BetterToken API Key、Base URL https://bettertoken.ai 和你选择的 Model ID 接入 Claude Code。

从模型广场复制准确的 Model ID。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

把 YOUR_MODEL_ID 替换为复制的模型 ID。ANTHROPIC_MODEL 设置主模型，三个 ANTHROPIC_DEFAULT_*_MODEL 变量分别设置 Haiku、Sonnet 和 Opus 别名。可以使用同一个模型，也可以为各角色选择不同模型。

修改配置中的 Model ID 后重启 Claude Code。需要在会话中切换时，使用 /model YOUR_MODEL_ID。

常见误区

给 Claude Code 的 Base URL 添加 /v1。Claude Code 的 Anthropic-compatible 配置不使用这个地址。
只换 API Key，不换 Base URL，导致请求仍走默认 endpoint。
把 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 请求格式的要求。