在 Coding Agent 接入

Claude Code 安装与模型配置

使用 BetterToken API Key、Base URL 和 Model ID 接入 Claude Code。修改配置后重启，或在会话中用 /model 切换模型。

使用 BetterToken API Key、Base URL https://bettertoken.ai 和你选择的 Model ID 接入 Claude Code。从模型广场复制准确的 Model ID。

重点信息

字段	填写内容
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
Model	`YOUR_MODEL_ID`

准备工作

安装 Claude Code
使用 BetterToken Automatic setup 脚本时需安装 Node.js；通过 npm 安装需要 Node.js 22 或更高版本
创建并复制 BetterToken API Key

安装

Anthropic 推荐使用原生安装程序，无需 Node.js。如果选择 npm，请先安装 Node.js 22 或更高版本，再运行：

npm install -g @anthropic-ai/claude-code

命令行配置

BetterToken Automatic setup 脚本会写入 Claude Code 配置。脚本需要 Node.js；如果没有通过参数提供 API Key，运行时会交互式提示输入。

macOS / Linux

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

Windows

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

运行完成后检查 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json），然后完全重启 Claude Code。希望逐项控制配置时，使用下面的手动配置。

手动配置

系统	文件
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

从模型广场复制准确的 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 别名。可以使用同一个模型，也可以为各角色选择不同模型。

示例包含可选设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1。它会关闭自动更新、错误报告，以及部分可用性检查和账号功能；认证不依赖此设置。手动更新时运行 claude update；如果通过包管理器安装，请使用对应包管理器更新。参见更新说明和此设置的影响。

VS Code 扩展

扩展使用 VS Code 的 settings.json。添加独立的 claudeCode.environmentVariables 配置：

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

验证连接

进入项目目录并启动：

claude

发送一条简短消息。能够正常返回内容，且没有 401、连接失败或模型不存在错误，即表示配置成功。在交互会话中运行 /status，检查两项：

Anthropic base URL 一行应显示 BetterToken 的 Base URL：https://bettertoken.ai。如果该行不存在，说明变量没有传到当前会话。检查 settings.json 路径，并完全重启 Claude Code。
认证一行应显示 ANTHROPIC_AUTH_TOKEN，而不是 claude.ai 账号登录。

如需在脚本中验证连接，发送一条简短提示词：

claude -p "Reply with only: OK"

正常返回 OK 即表示连接可用。

与已有登录冲突

环境变量里的凭据优先于已保存的 claude.ai 登录。启动时如果出现两个凭据来源的警告，取消设置其中之一。要只保留 BetterToken API Key，运行 /logout。如果终端环境中还设置了 ANTHROPIC_API_KEY，先清除它。

切换模型

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

其他别名（例如 fable 对应 ANTHROPIC_DEFAULT_FABLE_MODEL）请按官方别名映射填写可用的 Model ID。如果 Claude Code 对自定义 ID 推断的上下文窗口不正确，请按自定义模型窗口说明设置模型已确认的上限。

在 /model 中显示 BetterToken 模型（可选）

使用较新的 Claude Code 版本。在 ~/.claude/settings.json 已有的 env 中添加 "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"，然后完全重启 Claude Code。启动时，Claude Code 会向 https://bettertoken.ai 的 /v1/models 查询可用模型。参阅官方网关配置指南。

如需确认模型发现是否成功，运行 claude --debug，在 ~/.claude/debug/<session-id>.txt 中查找包含 [gatewayDiscovery] 的日志行。出现模型已缓存的日志即表示发现成功。

根据 Claude Code 的网关协议，它只会列出 Model ID 包含 claude 或 anthropic（不区分大小写）的网关模型。/v1/models 返回的其他模型（包括 GPT 模型）即使由 BetterToken 提供，也不会出现在 /model 中。你仍可直接设置其 Model ID来调用这些模型；在 Claude Code 2.1.309 的测试中，以这种方式指定的 GPT 模型通过 Anthropic Messages 完成了文本请求和文件读取请求。

常见错误

错误	处理方式
`401` 或认证失败	检查 `ANTHROPIC_AUTH_TOKEN`，确认没有空格或过期 Key。
`ConnectionRefused`	确认 `ANTHROPIC_BASE_URL` 正好是 `https://bettertoken.ai`，不要添加 `/v1`。
Model ID	核对模型广场中的准确 Model ID，并填入客户端的模型设置。
配置未生效	检查文件路径，清除冲突的环境变量，然后完全重启 Claude Code。
启动提示两个凭据来源冲突	取消设置其中之一，或运行 `/logout`。
证书 / TLS 错误，常见于企业代理	设置 `NODE_EXTRA_CA_CERTS` 指向 CA 证书文件，然后重启 Claude Code。
`400` 且信息提到不认识的字段，例如 `Extra inputs are not permitted`	在 `env` 中加 `"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"` 后完全重启 Claude Code。仍出现则联系支持。
长会话中提示上下文过长	运行 `/compact` 压缩会话。

使用 API Key 时不可用的功能

远程控制（Remote Control）和语音输入依赖 claude.ai 账号登录，使用 BetterToken API Key 与自定义 Base URL 时不可用。这是 Claude Code 客户端的限制，不影响普通编码对话。

进阶配置

需要统一管理多个工具的配置时，可使用 CC Switch。

技术说明

协议与 endpoint

Claude Code 使用 Anthropic Messages。ANTHROPIC_BASE_URL 填写 https://bettertoken.ai，客户端会自行请求 /v1/messages，因此不要在 Base URL 后添加 /v1。