Claude Code 自定义 API 配置：我踩了 3 个坑才搞明白

上周帮朋友配置 Claude Code 连接第三方 API，本以为 5 分钟搞定，结果折腾了 2 小时。

问题出在哪？Base URL 写错了。

坑 1：Base URL 多了个 /v1

Claude Code 的配置界面长这样：

API Base URL: [________________]
API Key: [________________]

我第一反应是填 https://api.example.com/v1，毕竟 OpenAI 的格式就是这样。

结果报错：404 Not Found。

查了半天才发现，Claude Code 会自动拼接 /v1/messages，所以 Base URL 应该是：

https://api.example.com

不带 /v1。

坑 2：模型名称不匹配

配置好 Base URL 后，又报错：Model not found: claude-3-5-sonnet-20241022。

第三方 API 的模型名称可能和官方不一样。比如有的叫 claude-3.5-sonnet，有的叫 claude-sonnet-3.5。

解决方法：在 Claude Code 设置里手动指定模型名称：

{
  "model": "claude-3.5-sonnet"
}

或者在环境变量里设置：

export ANTHROPIC_MODEL="claude-3.5-sonnet"

坑 3：API Key 格式问题

有些第三方 API 的 Key 格式和官方不一样。官方的 Key 是 sk-ant-...，第三方的可能是 sk-... 或者其他格式。

Claude Code 会校验 Key 格式，如果不是 sk-ant- 开头，会提示 "Invalid API Key"。

绕过方法：在配置里加一个参数：

{
  "skipKeyValidation": true
}

完整配置示例

这是我最终成功的配置：

{
  "apiBaseUrl": "https://api.example.com",
  "apiKey": "sk-xxx",
  "model": "claude-3.5-sonnet",
  "skipKeyValidation": true,
  "maxTokens": 8192
}

测试连接

配置好后，用这个命令测试：

claude --test-connection

如果返回 Connection successful，就说明配置正确。

常见问题

Q: 为什么不用官方 API？

A: 价格。第三方 API 通常比官方便宜 30-50%，而且支持支付宝/微信付款。

Q: 第三方 API 安全吗？

A: 看你选哪家。正规的第三方 API 不会存储你的请求内容，但建议不要发送敏感信息（如密码、密钥）。

Q: 配置后还是报错怎么办？

A: 检查这几点：

1. Base URL 不带 /v1

2. 模型名称和第三方 API 提供的一致

3. API Key 有余额

4. 网络能访问第三方 API（有些需要代理）

总结

Claude Code 自定义 API 配置的 3 个坑：

1. Base URL 不带 /v1

2. 模型名称要匹配

3. Key 格式可能需要跳过校验

配置好后，用 claude --test-connection 验证。

配置过程中遇到问题？欢迎留言讨论。

#ClaudeCode #API配置 #AI编程 #开发工具