Claude Code, Cursor и Codex CLI: подключение за 10 минут

Разработчику обычно нужна простая вещь: открыть редактор, дать агенту задачу и получить рабочий результат. Вместо этого вечер уходит на зарубежную оплату, несовместимые ключи, настройки адресов и поиск причины очередной ошибки 401.

Отдельная проблема — разные интерфейсы. Cursor ожидает OpenAI-совместимое подключение, Claude Code работает через формат Anthropic, а Codex CLI использует собственную конфигурацию и интерфейс Responses. Покупать отдельный доступ для каждого инструмента неудобно.

NeuroZal API решает эту задачу одним ключом. Это единый API-шлюз к моделям OpenAI, Anthropic, Google, xAI, DeepSeek и другим. Сервис работает напрямую из России, принимает оплату российскими картами и не требует инструкций с прокси.

Если Cursor, Claude Code или Codex CLI уже установлены, базовую настройку действительно можно выполнить примерно за десять минут. Ниже — последовательность действий и команды, которые можно проверить по шагам.

Важный дисклеймер: NeuroZal API — это API-ключ для программ, редакторов кода, ботов и автоматизации. Это не аккаунт ChatGPT или Claude с логином и паролем. Ключ не подключается в мобильном приложении ChatGPT и не заменяет подписку Plus. Пользователь сам выбирает модель: один ключ открывает весь доступный список, а не одну конкретную модель.

Что именно подключается

NeuroZal API предоставляет единый адрес:

https://api.neurozal.ru/v1

Он совместим с OpenAI SDK. Дополнительно поддерживаются:

Anthropic-совместимый /v1/messages для Claude Code;
/v1/responses для Codex CLI;
/v1/chat/completions для OpenAI-совместимых редакторов и приложений.

В каталоге заявлены 37 рабочих моделей. Среди них GPT-5.6, GPT-5.5, GPT-4.1, GPT-6 Astra, GPT-4o-mini, Claude Opus 5 и 4.8, Claude Sonnet 5 и 4.6, Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.1 и 2.5 Pro, Grok 4.5–4.7, DeepSeek V4, Qwen, GLM 5.3 и Kimi K3.

То есть один ключ можно использовать для дешёвых фоновых задач, генерации кода, анализа проекта и тяжёлого рефакторинга. Меняется название модели, а не способ оплаты или учётная запись.

Шаг 1. Получаем ключ и адрес подключения

Регистрация и личный кабинет находятся на сайте:

https://neurozal.ru

После регистрации нужно создать API-ключ вида:

sk-nz-...

Регистрация занимает минуту — код из письма на этом шаге не нужен. Новым клиентам при регистрации начисляется 35 ₽ на баланс: это стартовая квота для тестов.

Сразу сохраните три значения:

API-ключ: sk-nz-...
Base URL: https://api.neurozal.ru/v1
Модель для проверки: gpt-4o-mini

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

В кабинете отображаются остаток токенов, статистика запросов и расходы. Абонентской платы нет: списание идёт только за фактически использованные токены. Пополнение выполняется в рублях российской картой без комиссии, а остаток не сгорает в конце месяца.

Шаг 2. Проверяем ключ одним запросом curl

Не начинайте настройку с Cursor или Claude Code. Сначала проверьте ключ напрямую. Так проще отделить ошибку API от ошибки конкретного редактора.

Подставьте свой ключ вместо примера:

curl https://api.neurozal.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-nz-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "Ответь одним словом: работает"
      }
    ],
    "max_tokens": 20
  }'

Если запрос вернул ответ модели, ключ, баланс и адрес работают. После этого можно переходить к интеграции.

Почему для первого теста подходит gpt-4o-mini: у неё низкая стоимость, поэтому нет смысла проверять соединение на тяжёлой модели.

Если запрос не проходит, не меняйте одновременно ключ, модель, адрес и тело запроса. Исправляйте по одному параметру, иначе будет непонятно, что именно помогло.

Шаг 3. Проверяем OpenAI SDK через Python

Для существующего проекта обычно достаточно заменить base_url и передать ключ NeuroZal API. Остальная структура запроса остаётся OpenAI-совместимой.

Пример:

from openai import OpenAI

client = OpenAI(
    api_key="sk-nz-ВАШ_КЛЮЧ",
    base_url="https://api.neurozal.ru/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {
            "role": "user",
            "content": "Напиши функцию Python для удаления дублей из списка"
        }
    ],
    max_tokens=300
)

print(response.choices[0].message.content)

Для рабочего проекта ключ не стоит оставлять прямо в файле. Вынесите его из исходного кода и не добавляйте секрет в систему контроля версий.

Этот тест полезен ещё по одной причине: если curl работает, а Python нет, проблема обычно находится в коде клиента, значении base_url или передаче ключа. Сам API в такой ситуации уже проверен.

Шаг 4. Настраиваем Cursor

Для Cursor нужен OpenAI-совместимый адрес и API-ключ.

Последовательность настройки:

Откройте настройки Cursor.
Найдите раздел с настройками моделей и OpenAI API.
Вставьте ключ вида sk-nz-....
Включите Override OpenAI Base URL.
Укажите адрес:

https://api.neurozal.ru/v1

Выберите или укажите модель из каталога NeuroZal API.
Выполните короткий тестовый запрос в редакторе.

Начинать лучше с gpt-4o-mini или другой быстрой модели. Для проверки подключения не нужен полный анализ репозитория: достаточно попросить объяснить выделенную функцию или создать небольшой тест.

Если простой запрос выполняется, а большая агентская задача быстро расходует баланс, это не ошибка подключения. Агент читает файлы, возвращает результаты инструментов в контекст, повторно анализирует изменения и делает несколько запросов вместо одного.

Именно поэтому расход токенов в редакторе может быть кратно выше, чем в обычном чате.

Шаг 5. Подключаем Cline или Roo Code в VS Code

В расширениях Cline и Roo Code используется провайдер OpenAI Compatible.

Общая схема одинакова:

Откройте настройки расширения.
Выберите провайдер OpenAI Compatible.
В поле адреса API укажите:

https://api.neurozal.ru/v1

Вставьте ключ:

sk-nz-ВАШ_КЛЮЧ

Укажите точное имя модели, например:

gpt-4o-mini

Установите разумный предел ответа и отправьте короткую задачу.

Сначала проверьте чтение одного файла и небольшой запрос. Не стоит начинать с команды «перепиши весь проект»: при ошибке конфигурации вы получите длинный журнал, но не больше полезной информации.

После успешного теста можно переключить модель на Claude Sonnet, Claude Opus, GPT-5.6 или другую модель из каталога. Ключ при этом менять не требуется.

Шаг 6. Настраиваем Claude Code

Для Claude Code предусмотрен Anthropic-совместимый интерфейс /v1/messages.

Нужно задать две переменные окружения:

export ANTHROPIC_BASE_URL="https://api.neurozal.ru"
export ANTHROPIC_AUTH_TOKEN="sk-nz-ВАШ_КЛЮЧ"

Для PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.neurozal.ru"
$env:ANTHROPIC_AUTH_TOKEN="sk-nz-ВАШ_КЛЮЧ"

Здесь указывается адрес сервиса без добавления /v1/messages вручную: Claude Code обращается к Anthropic-совместимому маршруту /v1/messages.

После установки переменных запустите Claude Code в том же окружении терминала. Для первой проверки дайте задачу без изменения файлов, например попросите кратко описать структуру текущего проекта.

Если команда запускается из другого окна терминала, ранее заданные переменные могут быть там недоступны. Это одна из первых вещей, которую стоит проверить при ошибке авторизации.

Claude Code — агентский инструмент. Он может многократно читать контекст и обращаться к модели в рамках одной задачи. Поэтому выбор Claude Opus для рутинного переименования или генерации шаблонного теста способен оказаться неоправданно дорогим.

Шаг 7. Подключаем Codex CLI

Codex CLI работает через конфигурационный файл config.toml. Для NeuroZal API нужно определить собственный model_provider и указать base_url.

Пример конфигурации:

model = "gpt-4o-mini"
model_provider = "neurozal"

[model_providers.neurozal]
name = "NeuroZal"
base_url = "https://api.neurozal.ru/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Ключ передаётся через переменную окружения, указанную в env_key.

Для командной оболочки:

export OPENAI_API_KEY="sk-nz-ВАШ_КЛЮЧ"

Для PowerShell:

$env:OPENAI_API_KEY="sk-nz-ВАШ_КЛЮЧ"

Параметр wire_api = "responses" направляет запросы через поддерживаемый интерфейс /v1/responses.

После изменения config.toml начните с короткой задачи. Если прямой запрос curl работает, но Codex CLI возвращает ошибку, проверьте три значения: model_provider, base_url и доступность переменной окружения в текущем терминале.

Сколько стоят запросы

Тарификация идёт за 1 млн входных и выходных токенов. Выход обычно дороже входа, поэтому длинная генерация кода влияет на баланс сильнее, чем короткий ответ.

Модель	Вход, ₽ за 1 млн токенов	Выход, ₽ за 1 млн токенов
gpt-4o-mini	13	53
gpt-5.6-luna	18	107
gemini-3.8-flash	67	334
glm-5.3-flash	89	312
glm-5.3	178	623
gpt-5.6-terra	178	1068
claude-sonnet-4.6	267	1335
grok-4.6	356	1068
kimi-k3	356	1780
claude-opus-4.8	445	2225
gpt-6-astra	890	4450

Например, 100 тысяч входных и 20 тысяч выходных токенов на gpt-4o-mini обойдутся в 2,36 рубля:

100 000 / 1 000 000 × 13 = 1,30 ₽
20 000 / 1 000 000 × 53 = 1,06 ₽
Итого: 2,36 ₽

Тот же объём на claude-opus-4.8 будет стоить 89 рублей:

100 000 / 1 000 000 × 445 = 44,50 ₽
20 000 / 1 000 000 × 2225 = 44,50 ₽
Итого: 89 ₽

Это не сравнение качества моделей, а иллюстрация разницы в расходе. Claude Opus и GPT-5.6 тратят баланс заметно быстрее, чем Gemini Flash и DeepSeek. Дешёвые модели здесь не «подмена», а нормальный выбор для рутинной работы.

Как выбирать модель для редактора

Автодополнение и мелкие правки

Для шаблонного кода, объяснения одной функции, регулярных выражений, простых тестов и преобразования форматов разумно начинать с быстрой недорогой модели.

Практичный стартовый вариант — gpt-4o-mini. Также для рутинных задач имеет смысл тестировать быстрые модели из доступного каталога, включая Gemini Flash и DeepSeek.

Анализ нескольких файлов

Когда агенту нужно понять связи между модулями, исправить ошибку в нескольких местах или подготовить содержательный обзор изменений, можно перейти на модель среднего или старшего уровня.

Здесь важно смотреть не только на цену одного ответа. Если более сильная модель решает задачу за меньшее число итераций, итоговый расход иногда оказывается приемлемым. Но гарантировать это заранее нельзя: результат зависит от кода, объёма контекста и формулировки задачи.

Архитектура и тяжёлый рефакторинг

Claude Sonnet, Claude Opus, GPT-5.6 и другие тяжёлые модели имеет смысл оставлять для задач, где действительно нужен глубокий анализ: изменение архитектуры, большой рефакторинг, поиск сложной ошибки, работа с длинным контекстом.

Рабочая схема выглядит так:

Недорогая модель изучает файлы и собирает факты.
Тяжёлая модель предлагает план сложного изменения.
Недорогая модель выполняет механические правки.
Более сильная модель проверяет результат.

Так баланс расходуется осознаннее, чем при использовании самой дорогой модели для каждого шага.

Типовые ошибки подключения

Ошибка 401: проблема с ключом

Частые причины:

в ключ попал пробел в начале или конце;
вместе с ключом скопированы лишние кавычки;
передано не всё значение sk-nz-...;
переменная окружения задана в другом окне терминала;
редактор продолжает использовать старый ключ.

Скопируйте значение заново и проверьте его прямым запросом curl.

Ошибка 404: неверный адрес

Для OpenAI-совместимых клиентов используйте:

https://api.neurozal.ru/v1

Если указать адрес без /v1, клиент может отправить запрос не на тот маршрут. Не добавляйте /chat/completions в поле base_url, если программа сама формирует полный путь.

Для Claude Code используется Anthropic-совместимый /v1/messages, а Codex CLI работает через /v1/responses.

Ошибка 429: сработали лимиты

Ошибка 429 связана с лимитами запросов. Не запускайте несколько повторных попыток одновременно. Снизьте частоту обращений и повторите тест позже.

Если проблема сохраняется, подготовьте точное время запроса, название модели и текст ошибки для поддержки.

Пустой или обрезанный ответ

Проверьте max_tokens. Слишком маленькое значение может не дать модели сформировать полноценный ответ.

Для диагностики поставьте умеренное значение и задайте короткий вопрос. Не начинайте тест с генерации большого файла.

Честные минусы и ограничения

API не заменяет готовый аккаунт ChatGPT, Claude или подписку Plus. Если вам нужен именно официальный сайт или мобильное приложение с пользовательским интерфейсом, один API-ключ эту задачу не решит.

Агентские редакторы расходуют много токенов. Они передают модели файлы, историю, результаты команд и повторные инструкции. Даже короткая с точки зрения пользователя задача может состоять из серии API-запросов.

Стоимость сильно зависит от модели. Разница между gpt-4o-mini и gpt-6-astra составляет не проценты, а десятки раз по опубликованным тарифам. Без контроля статистики дорогая модель способна быстро потратить баланс.

Настройка остаётся на стороне пользователя. Нужно корректно указать ключ, адрес, модель и формат API. NeuroZal API унифицирует доступ, но не устраняет ошибки в конфигурации конкретного редактора.

Наконец, качество стоит проверять на собственном проекте. Название модели и её цена сами по себе не гарантируют лучший результат для конкретного языка, архитектуры или стиля кода.

Чек-лист перед обращением в поддержку

Перед тем как писать в чат сервиса, проверьте пять пунктов:

Прямой запрос curl к /v1/chat/completions выполняется или возвращает точный код ошибки.
В ключе нет пробелов, переносов строки и лишних кавычек.
Для OpenAI-совместимого клиента указан адрес https://api.neurozal.ru/v1.
Название модели записано точно, а max_tokens не установлен в слишком маленькое значение.
В кабинете есть баланс, видны статистика запросов и попытка обращения.

Если ошибка осталась, передайте поддержке название программы, модель, адрес без секретного ключа, код ответа и время запроса. Поддержка доступна в чате магазина или сервиса.

Практический итог

Самая надёжная последовательность настройки выглядит так: создать ключ в кабинете, проверить его через curl, затем подключать Cursor, Cline, Roo Code, Claude Code или Codex CLI.

Для OpenAI-совместимых программ используется https://api.neurozal.ru/v1. Claude Code получает доступ через Anthropic-совместимый /v1/messages, а Codex CLI — через /v1/responses. Один ключ открывает весь каталог моделей.

Начинайте с недорогой модели и короткой задачи. После проверки подключения переключайтесь на Claude Sonnet, Claude Opus, GPT-5.6 или другую тяжёлую модель только там, где её возможности оправдывают расход.

Если такой формат подходит вашему процессу, можно зарегистрироваться на neurozal.ru, получить тестовые 35 ₽ на баланс при регистрации и сначала проверить подключение одной командой curl. Дальше будет понятно, нужен ли этот API вашему редактору и реальным проектам.