这个概念/问题是什么
Claude Code 通过 Base URL 确定 API 请求的目标地址。国内用户通过中转服务使用时,需要填写中转服务提供的 Base URL,让请求先发往中转站再转发给官方 API。
检查步骤
- 1 从可靠的中转服务获取 Base URL
- 2 确认 Claude Code 要求填写的格式(是否需要 /v1)
- 3 在 Claude Code 配置文件中正确填写 Base URL
- 4 确认 model 字段填写的是模型 id(如 claude-sonnet-4-20250514)
- 5 用小额请求测试连通性
- 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 正确、连通性验证三个关键点。