Claude Code против Windsurf

Claude Code и Windsurf решают одну и ту же задачу — агент, который правит код по описанию задачи, а не по клику мышью, — но устроены на разных уровнях стека. Первый — это CLI-инструмент без своего редактора, второй — самостоятельная IDE, форк VS Code со встроенным агентом Cascade.

Где живёт агент

Claude Code запускается в терминале и работает поверх любого редактора или вообще без него: открывает проект, читает файлы, предлагает правки в виде diff, запускает команды по запросу. Ему всё равно, в каком редакторе разработчик потом смотрит результат — VS Code, Vim, JetBrains, — потому что сам он не редактор, а процесс, работающий с файловой системой и терминалом.

Windsurf — отдельное приложение. Агент Cascade встроен в редактор и видит открытые вкладки, структуру проекта и историю правок напрямую через интерфейс IDE, без необходимости объяснять контекст заново в каждой сессии. Это удобно, когда разработка идёт в одном окне от начала до конца, но означает переезд в новую программу вместо встраивания инструмента в уже настроенное окружение.

Подключение к своему API

Claude Code настраивается через переменные окружения — ANTHROPIC_BASE_URL и ключ. Важная деталь для тех, кто переносит его на сторонний шлюз: переменная для ключа называется ANTHROPIC_AUTH_TOKEN, а не ANTHROPIC_API_KEY — со вторым именем Claude Code решает, что вы работаете через официальный аккаунт Anthropic, и запрашивает логин вместо использования ключа. Через Zukko это выглядит так:

export ANTHROPIC_BASE_URL="https://api.zukko.pro"
export ANTHROPIC_AUTH_TOKEN="fetch_ваш_ключ"

Обратите внимание: адрес без /v1 — Claude Code как Anthropic-совместимый клиент добавляет путь сам и обращается к POST /v1/messages с заголовком anthropic-version: 2023-06-01. Перепутанный суффикс — самая частая причина 404 при первом подключении, и симптом характерный: ключ принимается, а любой вызов модели возвращает 404.

Windsurf в этом смысле устроен иначе: подключение стороннего провайдера обычно идёт через настройки самого приложения, а не через переменные окружения процесса, и объём доступной кастомизации зависит от версии и тарифа приложения — часть конфигурации остаётся внутри интерфейса IDE, а не в переносимом конфиге, который можно скопировать между машинами одной строкой. На момент написания Windsurf не даёт указать свой base URL для всех моделей — проверьте актуальные настройки BYOK в вашей версии. Если нужен VS Code-подобный редактор именно со своим шлюзом, рабочая альтернатива — расширения Cline, Roo Code или Kilo Code в VS Code.

Каталог моделей и переключение между ними

В Zukko один ключ открывает доступ к нескольким линейкам моделей: claude-opus-5-5 (Claude Opus 5.5), claude-sonnet-5, gpt-5.6-sol, gpt-5.6-luna, glm-5.3 и glm-5.3-flash (актуальный список — GET https://api.zukko.pro/v1/models). Для Claude Code, работающего в Anthropic-режиме, это модели вида claude-sonnet-5 в поле model запроса — переключение между Opus и Sonnet не требует смены ключа или конфига, только строки в вызове.

curl https://api.zukko.pro/v1/messages \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","max_tokens":512,"messages":[{"role":"user","content":"проверь этот модуль на race condition"}]}'

Расход и контроль

Через Zukko любой подключённый инструмент упирается в один и тот же биллинг: обычные (нестриминговые) ответы несут заголовки X-Zukko-Cost-Micros (стоимость запроса в микродолларах) и X-Fetch-Balance-Cents (остаток после списания, тоже в микродолларах). Но Claude Code работает в потоковом режиме (stream: true), а у потоковых ответов этих заголовков нет — расход агента смотрят в кабинете («Использование»), через GET /v1/usage или GET /v1/balance. Для агента, который может сделать несколько шагов подряд без участия человека, это заметно: длинная задача с чтением нескольких файлов и правками расходует больше, чем один короткий вопрос.

На уровне ключа можно задать дневной и месячный лимит расхода в долларах и список разрешённых моделей — настраивается в кабинете на странице ключа. Это полезно именно для агентных инструментов: если Claude Code запущен в фоне на CI и должен прогонять правки автоматически, лимит на ключ страхует от неожиданного счёта при зацикливании.

Ошибки первого подключения

Симптомы у обоих инструментов похожи, но диагностика начинается с одного и того же: проверить базовый URL и переменную окружения ключа. Если ключ не принимается — 401 с {"error":{"message":"Invalid API key. Use Authorization: Bearer fetch_*","type":"authentication_error"}}. Если баланс пуст — 402 insufficient_balance, причём проверка происходит до похода к модели, неудачный запрос ничего не стоит. Если модель написана с опечаткой — 404 model_not_found; актуальный список без ключа доступен на GET /v1/models.

Что выбрать

Если разработка уже устроена вокруг терминала и привычного редактора, а хочется добавить агента, не меняя остальной workflow, — это про Claude Code: он встраивается поверх, а не вместо. Если удобнее работать в едином окне, где агент видит контекст редактора без дополнительных объяснений, — это довод в пользу Windsurf. Claude Code подключается к ключу Zukko напрямую; для Windsurf сначала проверьте, позволяет ли ваша версия указать свой base URL. Ключ создаётся в кабинете zukko.pro/app/api-keys↗ и показывается один раз при создании.