跳转到主要内容
在 Claude Code 中接入 BetterToken，核心配置项是 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。不要给 Claude Code 的 Base URL 加 /v1。

​
前置条件

  • 已安装 Claude Code（参考 Claude Code 官方文档 安装）
  • 已获取 BetterToken API Key（注册并获取 (https://www.bettertoken.ai/register)）
配置前请确保清除以下环境变量，避免它们覆盖配置文件中的设置：
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

​
配置步骤

你可以直接运行 BetterToken 提供的自动配置脚本。它只负责写入 BetterToken provider 配置，不替代页面上方的安装前置条件。脚本需要 Node.js。如果你没有显式传入 API Key 或模型，脚本会按工具能力提示你交互输入。按你的操作系统执行对应步骤。你只需要执行其中一项。
1

如果你使用 macOS / Linux

curl -fsSL https://www.bettertoken.ai/install-claudecode-provider.sh | bash
2

如果你使用 Windows

iwr https://www.bettertoken.ai/install-claudecode-provider.ps1 -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

​
在 VS Code 插件中使用

如果你使用 Claude Code 的 VS Code 插件，配置方式如下：
1

安装插件

在 VS Code 插件市场搜索并安装 Claude Code。
2

打开设置

点击插件设置图标，进入配置界面。
3

配置环境变量

如果你使用 Claude_* 分组，点击 Edit in settings.json，将 claudeCode.environmentVariables 修改为：
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    }
  ]
}
4

如使用 Codex_* 分组，补充模型映射

如果你的 API Key 属于 Codex_* 分组，请改为：
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "gpt-5.4"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "gpt-5.4"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "gpt-5.4"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    }
  ]
}
示例里的 gpt-5.4 仅作为 Codex 分组模型 ID 示例。请从 BetterToken 模型广场 (https://www.bettertoken.ai/pricing) 复制当前可用的 Codex 分组模型 ID。插件内默认按 Opus 级别使用时，会优先命中 ANTHROPIC_DEFAULT_OPUS_MODEL。
5

重启 VS Code 插件

修改 settings.json 后，请重启 VS Code 或重新加载 Claude Code 插件，使配置生效。

​
验证配置

启动 Claude Code 后，在终端中发送一条消息。收到正常回复即表示配置成功。 如遇到认证错误，请检查：
  1. ANTHROPIC_AUTH_TOKEN 是否填写了正确的 BetterToken API Key
  2. ANTHROPIC_BASE_URL 是否填写为 https://www.bettertoken.ai
  3. Claude_* 分组是否避免填写模型变量，Codex_* 分组是否已配置 ANTHROPIC_DEFAULT_*_MODEL
  4. 是否有旧的环境变量在覆盖配置文件

​
常见问题

这通常表示 Claude Code 没有连上 BetterToken API，一般是网络连接异常、代理异常或防火墙拦截，不是 API Key 或模型配置错误。请先检查本机网络是否正常，再确认系统代理、公司网络、路由器或安全软件是否拦截了 https://www.bettertoken.ai。如果你设置了防火墙，请允许 Claude Code 访问该地址。