Claude Code Base URL 配置教程

Claude Code 配置 Base URL 时需要填写中转服务的 API 地址前缀,注意是否需要加 /v1、末尾斜杠是否需要,以及 model 字段的正确填写。

适合: Claude Code 用户 · 配置 Base URL 时遇到问题的用户

这个概念/问题是什么

Claude Code 通过 Base URL 确定 API 请求的目标地址。国内用户通过中转服务使用时,需要填写中转服务提供的 Base URL,让请求先发往中转站再转发给官方 API。

检查步骤

  1. 1 从可靠的中转服务获取 Base URL
  2. 2 确认 Claude Code 要求填写的格式(是否需要 /v1)
  3. 3 在 Claude Code 配置文件中正确填写 Base URL
  4. 4 确认 model 字段填写的是模型 id(如 claude-sonnet-4-20250514)
  5. 5 用小额请求测试连通性
  6. 6 查看 LinkAI 模型价格,确认支持的模型

常见错误

  • Base URL 末尾多加了 /v1 导致路径重复
  • model 字段填写了模型名称而非模型 id
  • Base URL 使用了 http 而非 https
  • 中转服务本身不可用(先检查中转站状态)

安全 / 扣费 / 权限风险

  • 用 /v1/models 确认模型是否可见。
  • 检测结果用于辅助判断,不等于绝对安全结论。
  • 先小额测试。

什么时候用 AI API Doctor 检测

Base URL 配置后,用 AI API Doctor 检测该地址是否可访问、/v1/models 是否返回数据。

什么时候用 LinkAI 小额测试

在 LinkAI 获取中转 Base URL,注册后领取 $2 免费福利进行测试。

AI Summary

Claude Code Base URL 配置需要注意格式正确、model id 正确、连通性验证三个关键点。

FAQ

Claude Code 的 Base URL 和普通 API 客户端一样吗?
基本相同,都是指向 API 入口的地址。区别在于 Claude Code 可能对格式有额外要求(如不能加 /v1,由客户端自动追加),需要仔细阅读 Claude Code 的配置说明。
Base URL 配置后没有反应怎么办?
先确认 Base URL 是否正确,然后用 AI API Doctor 检测该地址是否可访问,检查 /v1/models 是否返回数据,最后确认 API Key 是否有权限。

不确定 API 能不能跑?先别直接接进长任务。

先检测 Base URL、API Key、模型权限和 usage 信号;确认基础可用后,再用小额预算测试 Claude Code、Cursor 或 Cline。