RU ▾

Альтернатива OpenAI для Claude Code: настройка агента для кодинга

Claude Code общается с собственным API Anthropic, поэтому его нельзя просто перенаправить на эндпоинт в стиле OpenAI. Вот что работает вместо этого: агенты для кодинга, принимающие пользовательский базовый URL OpenAI, и способы их подключения к этому API.

Обновлено

Окно терминала, соединенное светящимся кабелем с сервером API, иллюстрирующее использование агента для кодинга с пользовательским эндпоинтом

Ключевые моменты

  • Claude Code построен вокруг формата API Anthropic, тогда как этот сервис использует формат chat completions OpenAI.
  • Инструменты в стиле Aider, Continue, Cline и Cursor принимают пользовательский базовый URL, совместимый с OpenAI, и имя модели.
  • Используйте базовый URL https://api.minimaxapikey.com/v1 с идентификатором модели uncensored и ключом Bearer.
  • Протестируйте с помощью curl, затем держите параллелизм не более 8 запросов, так как агенты отправляют множество вызовов одновременно.

Краткий ответ

Если вы искали альтернативу OpenAI для Claude Code, первым делом нужно решить, что именно вы хотите заменить. Claude Code — это терминальный агент для кодинга от Anthropic. Он создан для общения с собственным API Anthropic, который использует другой формат запросов, чем OpenAI. Этот сервис реализует формат chat completions OpenAI, поэтому они не подключаются друг к другу просто сменой URL.

Работает большое семейство агентов для кодинга и плагинов редакторов, принимающих любой эндпоинт, совместимый с OpenAI. Вы передаете им базовый URL, ключ и имя модели, и они отправляют обычные запросы POST /v1/chat/completions. Aider, Continue и Cline входят в эту группу, а в нескольких редакторах есть переопределение базового URL для моделей OpenAI. Для этого API три значения — это базовый URL https://api.minimaxapikey.com/v1, идентификатор модели uncensored и ваш ключ в виде токена Bearer.

Сохраняйте реалистичные ожидания. Модель за эндпоинтом — это одна модель с открытыми весами от независимого провайдера, настроенная на ответы без отказов по контенту для законного использования взрослыми. Это не Claude, и это не официальный API от любого вендора моделей. Подходит ли она для вашего репозитория, вы узнаете на своих собственных задачах, а эта статья показывает, как провести такой тест недорого.

Почему нельзя просто изменить URL в Claude Code

Формат API — это больше, чем адрес. API Anthropic имеет собственную структуру сообщений, собственный способ выражения системных промптов, собственные блоки использования инструментов и собственные потоковые события. Сервер в стиле OpenAI ожидает 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. Многие инструменты вызывают этот эндпоинт при сохранении провайдера, чтобы подтвердить, что ключ действителен, поэтому стоит увидеть его возвращающим результат, прежде чем настраивать что-либо. На странице документации есть полная справочная информация по запросам.

Где каждый инструмент принимает базовый URL

Названия настроек различаются, но идея везде одинакова. В таблице перечислены распространенные инструменты для кодинга и поле, которое вы заполняете. Меню перемещаются между версиями, поэтому воспринимайте это как карту и проверяйте документацию каждого инструмента для текущей компоновки.

ИнструментГде ввести эндпоинтИмя модели для использования
AiderПеременные среды или флаги командной строки для базового URL OpenAI и ключаopenai/uncensored
ПродолжитьЗапись модели в его файле конфигурации с провайдером openai и apiBaseuncensored
ClineСписок провайдеров, выберите вариант, совместимый с OpenAIuncensored
КурсорНастройки моделей, раздел ключа API OpenAI с переопределением базового URLuncensored как пользовательская модель
Ваш собственный скриптАргумент base_url любого SDK OpenAIuncensored

Поскольку этот сервис предоставляет ровно одну модель, настраивать выбор модели не нужно. Везде, где инструмент запрашивает имя модели, введите 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. Начните с чего-то, что вы можете проверить за секунды, например, добавления docstring или переименования функции, прежде чем поручить ему многофайловую задачу. Aider отправляет карту репозитория и добавленные вами файлы в чат на каждом шаге, поэтому промпт быстро растет. Окно в 100 000 токенов (промпт плюс завершение) щедрое, но для большого репозитория вам все равно нужно добавлять только те файлы, которые имеют значение.

Если 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". Приведенный ниже цикл дает модели одну функцию для чтения файла, а затем продолжает работу, пока модель не ответит обычным текстом.

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})

Добавьте функцию записи и запрос подтверждения перед ее запуском, и у вас будет основа Coding Agent примерно в пятьдесят строк. Всегда проверяйте пути перед чтением или записью: модель может запросить любой путь.

Лимиты и затраты, которые нужно учитывать

Агенты ведут себя иначе, чем человек в чате. Они отправляют всплески запросов, часто несколько параллельно. Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 параллельных и 60 в минуту, что может быть тесно для агента. Когда вы превышаете лимит, API отвечает HTTP 429 и кодом ошибки rate_limited или concurrency. При временной перегрузке он также возвращает 429 с Retry-After: 5. Большинство хороших клиентов повторяют попытку при 429, но если ваш клиент не делает этого, снизьте его настройку параллелизма. Потоковый запрос удерживает слот параллелизма до конца потока, поэтому длинные потоковые редактирования засчитываются в лимит 8.

Что касается стоимости, биллинг — pay as you go из предоплаченного баланса по цене $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов. Предположим, сессия отправляет 40 запросов, содержащих по 30 000 входных токенов каждый, и получает по 1 000 выходных токенов каждый. Это 1 200 000 входных токенов, или $0.18, плюс 40 000 выходных токенов, или $0.02, всего $0.20. Неудачные или отклоненные запросы не оплачиваются, а кредит не сгорает. См. страницу тарифов для сумм пополнения и бонусов.

Новые аккаунты могут получить $0.50 пробного кредита в один клик на странице ключей, без необходимости карты, действительный в течение 7 дней. Этого достаточно, чтобы запустить тест curl и несколько небольших правок Aider. Промпты не используются для обучения.

Вопросы и ответы

Можно ли направить сам Claude Code на этот API?

Не напрямую. Claude Code создан для формата API Anthropic, тогда как этот сервис реализует chat completions в стиле OpenAI. Проверьте текущую документацию Anthropic, чтобы узнать, что поддерживает Claude Code, и используйте агента, совместимого с OpenAI, если хотите использовать этот эндпоинт.

Какие инструменты для программирования работают с пользовательским базовым URL OpenAI?

Aider, Continue и Cline позволяют ввести базовый URL, совместимый с OpenAI, ключ и имя модели. Cursor также предлагает переопределение базового URL для моделей в стиле OpenAI, хотя вам следует проверить его текущие настройки и лимиты тарифных планов.

Поддерживает ли API вызов функций для агентов?

Да. Вы можете отправлять инструменты и tool_choice, получать потоковую передачу tool_calls и возвращать результаты с role tool. Использует ли данный плагин редактора эти поля, зависит от самого плагина.

Сколько стоит сеанс программирования?

Стоимость составляет $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов. Агенты часто повторно отправляют контекст, поэтому входные токены обычно составляют основную часть счёта.

Ваш ключ — всего в одной форме отсюда

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.

Получить API-ключ