Claude Code 的 OpenAI 替代方案:编程代理设置
Claude Code 连接的是 Anthropic 自己的 API,因此不能简单地将其指向兼容 OpenAI 的接口。以下是可行的替代方案:接受自定义 OpenAI base URL 的编码代理,以及如何将它们与此 API 连接的方法。
更新于

要点
- Claude Code 围绕 Anthropic 的 API 格式构建,而本服务采用 OpenAI 聊天补全格式。
- Aider、Continue、Cline 以及类 Cursor 的工具接受自定义的兼容 OpenAI 的 base URL 和模型名称。
- 使用 base URL https://api.minimaxapikey.com/v1,模型 ID 为 uncensored,并配合 Bearer 密钥。
- 先用 curl 测试,然后将并发请求保持在 8 个或以下,因为代理会同时发起大量调用。
简短回答
如果你搜索了Claude Code 的 OpenAI 替代方案,首先要确定的是你想替换什么。Claude Code 是 Anthropic 的终端编程代理。它设计用于与 Anthropic 自己的 API 通信,后者使用与 OpenAI 不同的请求格式。本服务实现了 OpenAI 聊天补全格式,因此仅更改 URL 无法使两者互连。
实际可行的是接受任何兼容 OpenAI 接口的编码代理和编辑器插件。你只需提供 base URL、密钥和模型名称,它们就会发送标准的 POST /v1/chat/completions 请求。Aider、Continue 和 Cline 均属于此类,许多编辑器也提供了 OpenAI 模型的 base URL 覆盖选项。对于此 API,这三个值分别是 base URL https://api.minimaxapikey.com/v1、模型 ID uncensored 以及作为 Bearer 令牌的密钥。
请保持合理的预期。该接口背后的模型是由独立提供商运行的一款开放权重模型,经过调整以在法律允许的成人使用范围内无内容拒绝地回答。它不是 Claude,也不是任何模型厂商的官方 API。它是否适合你的代码库,需要你在自己的任务中自行验证,本文展示了如何低成本运行该测试。
为什么不能仅更改 Claude Code 中的 URL
API 格式不仅仅是地址。Anthropic 的 API 拥有自己的消息结构、系统提示表达方式、工具使用块和流式事件。OpenAI 风格的服务器期望收到带有 roles 的 messages、包含函数定义的 tools 数组,以及携带 choices[0].delta 的服务器发送事件。为一种格式构建的客户端在与另一种格式的服务器通信时,即使 URL 可达,也会失败或行为异常。
有些人会在两者之间放置一个翻译层,即一个重写请求和响应的小型代理。这可行,但它是你需要自行运行和调试的独立软件,且此类层在工具调用和流式输出方面的行为往往会出现问题。Claude Code 是否提供针对第三方端点的官方设置,需查阅 Anthropic 的最新文档,因为这些选项会发生变化。
更简单的路径是选择已经支持 OpenAI 格式的代理。在基本循环方面你不会损失任何东西:代理读取你的文件,构建提示词,向模型请求编辑并应用它。你替换的是模型部分,而这部分只需要一个兼容的接口。
在接触任何工具之前,先用 curl 测试接口
如果你已经知道原始 API 有效,那么每个集成问题都更容易诊断。在 API 密钥页面 创建一个密钥,导出它,并运行一次请求。如果成功,后续的任何失败都源于工具设置,而非密钥或网络。
export UNCENSORED_KEY="paste-your-key-here"
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise coding assistant."},
{"role": "user", "content": "Write a Python function that parses an ISO date string."}
]
}'
你也可以通过 GET /v1/models 列出模型。许多工具在保存提供商时会调用此接口,以确认密钥有效,因此在配置任何内容之前看到其返回结果是值得的。文档页面 提供了完整的请求参考。
各工具在哪里输入 Base URL
设置名称各不相同,但思路在所有地方都一样。下表列出了常见的编程工具以及你需要填写的字段。菜单在不同版本间会有移动,因此请将其视为地图,并查阅每个工具自身的文档以获取当前布局。
| 工具 | 输入接口的位置 | 使用的模型名称 |
|---|---|---|
| Aider | OpenAI Base URL 和密钥的环境变量或命令行标志 | openai/uncensored |
| Continue | 配置文件中的模型条目,提供商为 openai 且包含 apiBase | uncensored |
| Cline | 提供商列表,选择兼容 OpenAI 的选项 | uncensored |
| Cursor | 模型设置,OpenAI API 密钥部分,带有 Base URL 覆盖 | uncensored 作为自定义模型 |
| 你自己的脚本 | 任何 OpenAI SDK 的 base_url 参数 | uncensored |
由于此服务仅暴露一个模型,因此无需配置模型选择器。在任何需要模型名称的地方,输入 uncensored。如果工具坚持要求已知模型列表并拒绝未知名称,请寻找“自定义模型”或“添加模型”选项。
Aider 示例
Aider 在你的终端中运行,编辑 git 仓库中的文件并提交结果,这使其在精神上最接近 Claude Code。它在底层使用 LiteLLM,因此模型名称带有提供商前缀。对于兼容 OpenAI 的服务器,该前缀为 openai/。
pip install aider-chat
export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
cd your-repo
aider --model openai/uncensored
启动后,请求对单个文件进行小更改并观察 diff。从可以在几秒钟内验证的内容开始,例如添加文档字符串或重命名函数,然后再将其交给多文件任务。Aider 会在每一步发送仓库地图和你添加到聊天中的文件,因此提示词会迅速增长。100,000 token 的上下文窗口(提示词加补全)很充裕,但对于大型仓库,你仍需要仅添加重要的文件。
如果 Aider 警告它不知道模型的上下文大小或价格,这是预期的:它没有自定义模型名称的条目。该警告不会阻止其工作。
Continue 示例
Continue 是一个编辑器扩展,在 VS Code 和 JetBrains 中添加聊天、编辑和自动补全功能。其配置列出模型,每个模型都有提供商和可选的覆盖。此 API 的模型条目如下所示。确切的文件名和架构取决于你安装的 Continue 版本,因此请将其与当前文档进行比较。
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.minimaxapikey.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
聊天和编辑请求在此类接口上表现良好。Tab 自动补全则属于不同的工作负载:它在几乎每次输入暂停时触发,并要求极低的延迟,这更适合由小型本地模型来服务。使用托管聊天模型进行内联补全会消耗你每分钟 300 次限制的配额,但效果甚微。
自行构建最小代理
如果没有现有工具适合,工具调用支持使得编写小型代理变得容易。API 接受 tools 和 tool_choice,流式返回 tool_calls,并接受带有 role: "tool" 的消息作为结果。下面的循环向模型提供一个读取文件的函数,然后Continue直到模型以纯文本回答。
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Return the text of a file in the current project.",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "Summarise what main.py does."}]
while True:
resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = resp.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"], encoding="utf-8") as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
添加一个写入函数并在运行前添加确认提示,你就拥有了一个编程代理的核心,大约五十行代码。读取或写入前始终验证路径:模型可以请求任何路径。
需要规划的限制和成本
代理的行为与人工聊天不同。它们会发送请求突发,通常是多个并发请求。完整密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个并发和每分钟 60 个请求,这对代理来说可能比较紧张。当你超出限制时,API 会返回 HTTP 429 以及错误代码 rate_limited 或 concurrency。在临时过载时,它还会返回带有 Retry-After: 5 的 429 状态码。大多数优秀的客户端会在 429 时重试,但如果你的客户端不支持,请降低其并发设置。流式请求会占用并发槽位直到流结束,因此长流式编辑会计入 8 个并发限制中。
在成本方面,计费是从预付额度按量付费,每 1M 输入 token $0.15,每 1M 输出 token $0.50。假设一个会话发送 40 个请求,每个请求携带 30,000 个输入 token,并接收 1,000 个输出 token。那就是 1,200,000 个输入 token,即 $0.18,加上 40,000 个输出 token,即 $0.02,总计 $0.20。失败或被拒绝的请求不收费,且额度永不过期。查看 定价页面 了解充值金额和奖金。
新账户可以在密钥页面一键领取 $0.50 的试用额度,无需信用卡,有效期为 7 天。这足以运行 curl 测试和几次小型 Aider 编辑。提示词不用于训练。
更多指南
问答
我能将 Claude Code 本身指向这个 API 吗?
不直接支持。Claude Code 专为 Anthropic 的 API 格式构建,而本服务实现的是 OpenAI 风格的聊天补全。请查阅 Anthropic 的最新文档以了解 Claude Code 支持的内容,若需使用此接口,请使用兼容 OpenAI 的代理。
哪些编码工具支持自定义 OpenAI base URL?
Aider、Continue 和 Cline 均允许你输入兼容 OpenAI 的 base URL、密钥和模型名称。Cursor 也为 OpenAI 风格的模型提供了 base URL 覆盖功能,不过你应检查其当前设置和计划限制。
该 API 是否支持代理的函数调用?
可以。你可以发送 tools 和 tool_choice,接收流式输出的 tool_calls,并以 role tool 返回结果。特定编辑器插件是否使用这些字段取决于插件本身。
一次编码会话的费用是多少?
定价为每 100 万输入 token $0.15,每 100 万输出 token $0.50。代理会重新发送大量上下文,因此输入 token 通常占据账单的大部分。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改base URL。这就是全部设置。