Claude Code — агентный инструмент Anthropic, который живёт в терминале: он читает кодовую базу, правит файлы, запускает команды, работает с git и подключает внешние инструменты через MCP. Это самый известный представитель класса «агент-харнесс»: модель здесь не отвечает на вопросы, а выполняет работу — открывает файлы, делает правки и проверяет результат.
Для владельца ключа Vtop AI важно одно: Claude Code разговаривает ровно на том протоколе, который отдаёт наш шлюз, — Anthropic Messages API. Поэтому отдельные прослойки и переходники не нужны: адрес и ключ подставляются двумя переменными окружения, и агент работает через вашу модель из каталога Vtop AI.
Инструмент
- Тип: Терминал
- Разработчик: Anthropic
- Лицензия: Проприетарный (репозиторий — только документация и трекер)
- Протокол: Anthropic Messages API
- Свой адрес API: Да
Подключение к Vtop AI
- Напрямую: да
- Способ: ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN
- Раздел: ключи API
Харнесс — это обвязка вокруг модели: цикл «подумал — вызвал инструмент — посмотрел результат — повторил», доступ к файлам и командной строке, правила проекта, история сессии. Одна и та же модель в разных харнессах решает задачи по-разному, поэтому выбор агента — не менее важное решение, чем выбор модели.
Claude Code умеет работать в нескольких средах: терминал, расширения для популярных редакторов, отдельное приложение и веб-версия. Настройки хранятся файлами, часть параметров переопределяется переменными окружения — именно этим мы и пользуемся при подключении к Vtop AI.
Расход токенов у агента выше, чем у обычного чата: в контекст попадают правила проекта, содержимое прочитанных файлов и результаты команд. Один сеанс «почини баг» может стоить в разы больше, чем переписка о том же баге. Поэтому лимит расходов на ключе и калькулятор токенов — не формальность, а способ не удивиться счёту.
Как подключить
Ключ создаётся в кабинете Vtop AI, там же задаётся лимит расходов и список разрешённых моделей. Дальше достаточно двух переменных окружения: адрес шлюза и сам ключ.
Адрес указывается в ANTHROPIC_BASE_URL. Для ключа подойдёт ANTHROPIC_AUTH_TOKEN: шлюз принимает ключ и в заголовке Authorization, который отправляет эта переменная. Переменная ANTHROPIC_API_KEY тоже работает — шлюз читает ключ и из заголовка x-api-key.
Модель выбирается переменной ANTHROPIC_MODEL или командой /model внутри сессии. Имя модели должно совпадать с тем, что отдаёт эндпоинт списка моделей: копируйте его из каталога, а не набирайте по памяти.
| Переменная | Что означает |
|---|---|
ANTHROPIC_BASE_URL | адрес шлюза Vtop AI — https://vtop-ai.site |
ANTHROPIC_AUTH_TOKEN | ваш ключ из кабинета; уходит в заголовке Authorization |
ANTHROPIC_MODEL | идентификатор модели (необязательно, можно выбрать в сессии) |
Сильные и слабые стороны
Что хорошо
- Протокол совпадает с нашим шлюзом — подключение без прослоек и переходников.
- Расходы видны построчно в журнале использования вместе с остальными запросами.
- Поддерживает кэширование контекста — повторные обращения к тем же файлам стоят дешевле.
На что обратить внимание
- Проприетарный: исходного кода нет, поведение меняется от версии к версии.
- Агентный режим быстро расходует токены — без лимита на ключе счёт растёт незаметно.
- Часть фирменных настроек Claude Code рассчитана на прямое подключение к Anthropic и при работе через шлюз может не действовать.
Сравнение с другими агентами
Та же задача, но разными инструментами — так выглядит выбор между харнессами. Подробный разбор каждого — по ссылке в таблице.
| Агент | Тип | Лицензия | Подключение к Vtop AI |
|---|---|---|---|
| Claude Code — этот агент | Терминал | Проприетарный (репозиторий — только документация и трекер) | ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN |
| Codex CLI | Терминал | Apache-2.0 | напрямую не подключается |
| Gemini CLI | Терминал | Apache-2.0 | напрямую не подключается |
| Crush | Терминал | FSL-1.1-MIT (через два года — MIT) | crush provider add … --type anthropic --base-url |
| OpenCode | Терминал | MIT | provider.anthropic.options.baseURL в opencode.json |
Сравнение всех 14 агентов
Полная таблица подборки — на странице раздела: тип, лицензия, протокол и способ подключения к Vtop AI.
Смотрите также
Частые вопросы
Будет ли Claude Code работать с ключом Vtop AI?
Да. Шлюз Vtop AI реализует Anthropic Messages API целиком — тот же протокол, который использует Claude Code. Разница только в адресе и в том, что ключ выдаёте вы сами, а оплата идёт с вашего баланса.
Какой переменной задавать ключ?
Подойдут обе: ANTHROPIC_AUTH_TOKEN отправляет ключ в заголовке Authorization, ANTHROPIC_API_KEY — в заголовке x-api-key. Шлюз принимает и тот, и другой.
Можно ли ограничить расходы агента?
Да, двумя способами: лимитом расходов на самом ключе и списком разрешённых моделей. Если агент упирается в лимит, дальше запросы не проходят — это ожидаемое поведение, а не сбой.
Какие модели подойдут для агентной работы?
Те, что уверенно держат длинный контекст и умеют вызывать инструменты. Ориентируйтесь на модели Claude из каталога — они рассчитаны именно на такой режим работы.