Claude Code 接入 Models Hub:Base URL 与 API Key 配置

在 Claude Code 里使用 Models Hub 的 Claude 模型:一条命令完成配置,或手动设置 ANTHROPIC_BASE_URL 与 API Key,附验证步骤与常见报错排查。

Claude Code 是 Anthropic 官方的终端编码助手。把它的接入点换成 Models Hub,即可用 Models Hub 的额度调用 Claude 系列模型,请求格式、流式输出与工具调用完全不变。本文只讲接入,不讲 Claude Code 本身的用法。

三样东西

接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com、一个模型名。下面两种方式二选一,一键方式 30 秒完成。

准备

已安装 Claude Code。没装的话按官方安装说明操作:macOS / Linux 运行 curl -fsSL https://claude.ai/install.sh | bash,Windows 在 PowerShell 运行 irm https://claude.ai/install.ps1 | iex。装完 claude --version 能出版本号即可。
一个 Models Hub API Key。在控制台的令牌页创建,令牌所在分组要能访问你打算用的模型。

用途	模型名	定价	实时状态
日常编码,速度与质量的平衡点	`claude-sonnet-4-6`	查看价格	可用率与延迟
复杂重构、长任务	`claude-opus-4-6`	查看价格	可用率与延迟
后台轻量任务(文件搜索、摘要)	`claude-haiku-4-5`	查看价格	可用率与延迟

方式一:一键配置(推荐)

Models Hub CLI 会把 API Key、接入地址和默认模型合并写入 ~/.claude/settings.json 的 env 段,保留你已有的其它设置。

macOS / Linux:

curl -fsSL https://modelsok.com/cli/install.sh | sh

Windows(PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://modelsok.com/cli/install.ps1 | iex"

脚本装好 models 命令后会自动进入交互界面,选择 claude,按提示粘贴 API Key、选模型即可。之后想改模型或换 Key,再运行一次 models 就行。CLI 的完整用法见 CLI 一键配置。

Models Hub CLI 配置 Claude Code

方式二:手动配置

编辑 ~/.claude/settings.json(Windows 在 %USERPROFILE%\.claude\settings.json),没有就新建。在 env 段写入四个变量:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelsok.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 Models Hub API Key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}

四个变量的含义:

变量	作用
`ANTHROPIC_BASE_URL`	接入地址,不要在末尾加 `/v1`,Claude Code 自己会拼路径
`ANTHROPIC_AUTH_TOKEN`	你的 Models Hub API Key,以 Bearer 方式发送
`ANTHROPIC_MODEL`	默认模型,对应 `/model` 命令里的当前选择
`ANTHROPIC_SMALL_FAST_MODEL`	Claude Code 后台小任务用的模型,配一个便宜的

只想临时试一下,也可以在当前终端里 export 这几个变量后直接运行 claude,关闭终端即失效。

账号登录与环境变量的优先级

如果你之前用 claude.ai 账号登录过 Claude Code,设置了上面的变量后,请求会改走 Models Hub,不再消耗 claude.ai 的订阅额度。想切回官方账号,删掉这几个变量即可。

验证

在任意项目目录运行 claude,输入一句话,例如「用一句话介绍当前目录」。能正常回复即接通。两个补充判据:

在 Claude Code 里输入 /status,能看到 API Base URL 指向 modelsok.com。
打开 Models Hub 控制台的用量日志,几秒内会出现一条以你配置的模型名记录的请求。

常见报错

现象	原因	处理
`401` / `authentication_error`	Key 写错、多了空格,或令牌已被禁用	到令牌页重新复制;确认没有把 `sk-` 前缀漏掉
`model not found` / `无可用渠道`	模型名拼错,或令牌所在分组没有该模型	对照定价页核对名字;换到能访问该模型的分组
`429` / `rate_limit`	触发限流,通常是并发过高	稍后重试;持续出现联系客服提额
余额不足	令牌额度或账户余额用完	到控制台充值,或给令牌加额度
回复走了 claude.ai 账号	`settings.json` 没生效	确认文件路径正确、JSON 合法(用 `/status` 查看当前 Base URL)

更多排查见故障排查。

常见问题

计费方式? 按请求实际消耗的输入与输出 token 计费,价格在各模型的定价页,缓存命中的 token 有折扣。在用量日志里能看到每一条请求的明细。

和直接用 Anthropic 官方 API 有什么区别? 请求格式完全一致,只是把接入地址换成了 Models Hub。你不需要 Anthropic 账号,一个 Key 同时能用其它厂商的模型。

怎么切换模型? 在 Claude Code 里输入 /model 选择,或者改 ANTHROPIC_MODEL 后重启。

Claude Code 接入 Models Hub:Base URL 与 API Key 配置

准备

推荐模型

方式一:一键配置(推荐)

方式二:手动配置

验证

常见报错

常见问题

相关

本页目录