跳到主要内容

Claude Code 怎么配置第三方 API?

快速回答

Claude Code 配置第三方 API 时,核心是确认服务商是否兼容 OpenAI API 格式,然后填对 API Key、Base URL 和模型名。大多数失败都出在 Key 复制错误、Base URL 漏 /v1、模型名不存在或账号没有额度。

背景

很多工具会写“支持 OpenAI Compatible API”。这句话的意思是工具可以用类似 OpenAI 的接口格式调用第三方服务,但并不代表所有模型名、权限和错误码都完全一致。

解决方法

你需要准备三项信息:

配置项示例作用
API Keysk-...识别你的账号和额度
Base URLhttps://example.com/v1API 服务地址
Modelclaude-... 或兼容模型名指定要调用的模型

如果不想分别维护多个服务商,也可以使用已经集成多个模型的平台,再把平台提供的兼容 API 填到工具里。

进入知汇小白

操作步骤

  1. 在服务商后台创建或复制 API Key。
  2. 找到 OpenAI Compatible Base URL,确认末尾是否需要 /v1
  3. 在 Claude Code 或相关配置文件里填入 Key、Base URL 和模型名。
  4. 先用简单问题测试,例如“用一句话介绍你自己”。
  5. 如果失败,按 401、403、429、model not found 的顺序排查。
export OPENAI_API_KEY="你的 API Key"
export OPENAI_BASE_URL="https://example.com/v1"

常见错误

401

API Key 错误、Key 已失效、复制时带入空格,或服务商不接受当前认证格式。

403

账号没有访问该模型的权限,或者服务商对当前请求来源有限制。

429

频率太高、额度不足、并发过多或上游拥堵。可以参考 GPT API 429 错误怎么解决

model not found

模型名写错,或该服务商没有开放你填的模型。先到服务商模型列表复制准确名称。

总结

Claude Code 配第三方 API 时,不要先怀疑工具本身。先确认 Key、Base URL、模型名、额度和权限,绝大多数问题都能定位。

相关阅读