中文 ▾

Claude Code 的 OpenAI 替代方案:编程代理设置

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

更新于

终端窗口通过发光电缆连接到 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

设置名称各不相同,但思路在所有地方都一样。下表列出了常见的编程工具以及你需要填写的字段。菜单在不同版本间会有移动,因此请将其视为地图,并查阅每个工具自身的文档以获取当前布局。

工具输入接口的位置使用的模型名称
AiderOpenAI Base URL 和密钥的环境变量或命令行标志openai/uncensored
Continue配置文件中的模型条目,提供商为 openai 且包含 apiBaseuncensored
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。这就是全部设置。

获取 API 密钥