Claude API Base URL 设置：各客户端自定义接口地址速查

几乎每个 AI 客户端——命令行工具、代码编辑器、桌面聊天应用、编排框架——都允许你把它指向一个自定义 base url，而不是官方默认的接口地址。这个字段填对了，同一个工具就会把请求发到 ApiTopMix；只要填得稍有偏差——多了一个 /v1、结尾多了斜杠、用了 http 而不是 https——你就会盯着一个不知所以然的 404 或 401 发呆。这个页面就是帮你省掉试错的速查表：对每个常见客户端，直接告诉你该填哪个 base url、填在哪里、以及 API Key 放哪里。

base url（也叫接口地址、API 端点、主机地址、服务器地址）说白了就是客户端拼在每个 API 路径前面的那段根地址。客户端出厂时，这段根地址指向模型官方；把它改掉（也就是自定义 base url），正是让 ApiTopMix 这样的聚合网关站到模型前面的官方入口。你改的只是地址，而不是应用本身：提示词、项目、工作流都不受影响，而且随时可以改回去。

ApiTopMix 的两个 base url

ApiTopMix 提供两个 base url，选对哪个是关键。区别在于你的客户端走哪种协议：

• OpenAI 兼容 base url —— https://apitopmix.com/v1。凡是基于 OpenAI SDK，或设置里让你填「OpenAI Base URL」「API Base」「OpenAI 兼容端点」的客户端，都用这个。它提供 /v1/chat/completions、/v1/models 等路径，也是大多数客户端要的那个 openai base_url 修改值。
• Anthropic 原生 base url —— https://apitopmix.com。作为 ANTHROPIC_BASE_URL 用于 Claude Code 及其它 Anthropic SDK 客户端。它走真正的 Anthropic 协议，提供 /v1/messages，工具调用、流式输出、长上下文都跟 Anthropic 客户端预期的完全一致。

两个地址都用同一个 ApiTopMix sk- 密钥。一句话口诀：客户端的 API 设置里凡是提到「OpenAI」，就用带 /v1 的地址；如果是 Claude 原生、提到 ANTHROPIC_BASE_URL，就用不带 /v1 的主机名。

各客户端 base_url 配置速查表

这是本页的核心。找到你的客户端，用第二列的 base url，按第三列的位置填进去，把 ApiTopMix 密钥放到第四列的位置。OA 标签代表 OpenAI 兼容地址 https://apitopmix.com/v1，AN 标签代表 Anthropic 原生地址 https://apitopmix.com。

十四个客户端，一个规律：OpenAI 形态的工具填 https://apitopmix.com/v1，Claude 原生工具把 https://apitopmix.com 填进 ANTHROPIC_BASE_URL。如果你的客户端不在表里，但有「OpenAI 兼容 base url」字段，就完全按上面的 OA 行来处理。

最常用客户端的复制即用片段

OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://apitopmix.com/v1",   # 注意 /v1
    api_key="sk-你的ApiTopMix密钥",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好，帮我确认接入是否成功"}],
)
print(resp.choices[0].message.content)

curl（OpenAI 兼容端点）

curl https://apitopmix.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的ApiTopMix密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"ping"}]}'

Claude Code（Anthropic 原生环境变量）

export ANTHROPIC_BASE_URL=https://apitopmix.com      # 不带 /v1
export ANTHROPIC_AUTH_TOKEN=sk-你的ApiTopMix密钥
claude

Cursor（覆盖 Base URL）

Settings → Models → 启用 OpenAI API Key → 打开 Override OpenAI Base URL：

# Base URL 框：
https://apitopmix.com/v1
# API Key 框：
sk-你的ApiTopMix密钥
# 添加的自定义模型：
claude-sonnet-4-6

Claude Code 与 Cursor 的完整接入教程，见 用 ApiTopMix 接 Claude Code、Cursor，以及单独的 在 Cursor 里用 Claude 指南。

配置 base url 的常见错误

• 重复的 /v1 —— 在一个已经会自动补 /v1 的客户端里填了 https://apitopmix.com/v1，结果拼成 /v1/v1/...。改法：填不带 /v1 的主机名，或去掉你手填的 /v1。
• 缺少 /v1 —— OpenAI SDK 类客户端拿到的是 https://apitopmix.com，请求 /chat/completions 时返回 404。改法：补上 /v1。
• 结尾多斜杠 —— https://apitopmix.com/v1/ 在严格的客户端里可能拼成 /v1//chat/completions。除非客户端提示要求，否则去掉结尾斜杠。
• 用了 http 而非 https —— 始终用 https。明文 http 会失败或被重定向，还可能丢掉鉴权头。
• 请求头格式错 —— OpenAI 风格客户端要用 Authorization: Bearer sk-...。如果手写请求，别把密钥当成 x-api-key 发给 OpenAI 兼容端点。
• 协议对错了地址 —— 把带 /v1 的地址填进 ANTHROPIC_BASE_URL，或把主机名填进 OpenAI 字段。地址要与客户端所走协议匹配。
• 占位符密钥没换 —— 地址能通却报 401，说明路由是对的、只是密钥不对。粘贴真实的 ApiTopMix 密钥，别带多余空白。

常见问题

ApiTopMix 的 Claude API base url 是哪个？

有两个。OpenAI 兼容 base url 是 https://apitopmix.com/v1，用于 OpenAI SDK 风格的客户端。Anthropic 原生地址 是 https://apitopmix.com，作为 ANTHROPIC_BASE_URL 用于 Claude Code 和 Anthropic SDK。两者用同一个 ApiTopMix 密钥，选哪个只取决于客户端走哪种协议。

base_url 到底要不要加 /v1？

OpenAI SDK 客户端默认 base url 已以 /v1 结尾并自己拼 /chat/completions，所以填 https://apitopmix.com/v1。Claude Code 这类 Anthropic 客户端要填不带 /v1 的主机名 https://apitopmix.com，由它自己补 /v1/messages。报错里出现 /v1/v1 就去掉你手填的 /v1；主机名报 404 就把它补回去。

OpenAI 兼容 base url 和 anthropic base url 有什么区别？

OpenAI 兼容地址（https://apitopmix.com/v1）走 OpenAI 协议，提供 /v1/chat/completions。Anthropic 原生地址（https://apitopmix.com）走 Anthropic 协议，提供 /v1/messages。Cursor、Cline、ChatBox、Cherry Studio、Open WebUI、Dify 用 OpenAI 兼容地址；Claude Code 和 Anthropic SDK 用原生地址。

Cursor 里的 base url 怎么填？

打开 Cursor 设置 → Models，启用 OpenAI API Key 一栏，打开 Override OpenAI Base URL，填 https://apitopmix.com/v1（保留 /v1 后缀），把 ApiTopMix 密钥填进 API Key 框，再添加一个自定义模型名如 claude-sonnet-4-6。完整流程见 Cursor 指南。

Claude Code 用哪个 base url？

Claude Code 读取 ANTHROPIC_BASE_URL。设为 https://apitopmix.com（不带 /v1），ANTHROPIC_AUTH_TOKEN 设为 ApiTopMix 密钥，然后运行 claude。它会自己补 /v1/messages，全程走 Anthropic 原生协议。

改完 base url 后为什么报 401？

地址能连上却报 401，几乎都是密钥或请求头的问题，而不是 base url。OpenAI 风格客户端要用 Authorization: Bearer sk-你的密钥。确认粘贴了完整的 ApiTopMix 密钥、无多余空格换行、无遗留占位符。地址能通但返回 401，反而说明路由是对的。

同一个 base url 能同时调 Claude 和其它模型吗？

可以。OpenAI 兼容地址 https://apitopmix.com/v1 通过一个端点提供多种模型。你用请求里的 model 字段选模型，所以同一个 base url、同一个密钥，只改 model 就能调用不同模型。

base url 用 http 还是 https？

始终用 https。ApiTopMix 的地址是 https://apitopmix.com/v1 和 https://apitopmix.com。明文 http 会失败或被重定向，部分客户端也拒绝用它传密钥。不要加端口，除非客户端明确要求，否则结尾不要加斜杠。若修好 base url 后 Claude Code 或其它客户端仍报错，可参考 base URL 排错指南。

相关指南

• 用 ApiTopMix 接 Claude Code、Cursor —— 两个工具的完整接入教程。
• 在 Cursor 里用 Claude —— Cursor Base URL 覆盖的详解。
• Claude Code base URL 排错 —— 404、401、/v1/v1 及连接错误的修复。
• ApiTopMix 定价 —— 各模型的实时价格表。
• ApiTopMix API 文档 —— 端点、请求头和完整示例。

结语

配置自定义 base url，是使用各类 AI 客户端时最值钱的一项通用技能，因为到哪都是同一个动作：找到 base url 字段，判断这个客户端要 OpenAI 兼容的 https://apitopmix.com/v1 还是 Anthropic 原生的 https://apitopmix.com，注意 /v1 的惯例，再填上密钥。一旦你把「OpenAI 与 Anthropic 两套协议」和「/v1 加不加」这两件事想清楚，之后遇到任何新工具——今年的编辑器、明年的框架——都只是两分钟的配置，而不是一下午的反复试错。

把这个页面收藏成你的端点速查表。客户端不在表里时，对照最接近的那一行、套用同样的 base url 和密钥位置，它就会以同样的方式接到 ApiTopMix。此后你唯一需要改的，只剩模型名。