Привет! Я Даниил Подольский, программист и архитектор в YADRO. Уже девять месяцев я использую методологию Spec-Driven Development (SDD) и управляю AI-агентами, которые пишут код. При этом я не называю себя вайбкодером — мой подход шире, чем просто общение с ИИ.

Что такое SDD

Spec-Driven Development (SDD) — это подход к разработке ПО, при котором процесс начинается с формальной спецификации: контрактов интерфейсов, форматов данных или архитектурных правил. Эта спецификация становится единым «источником истины» для всей команды.

Метод SDD появился ещё в 1960-х в NASA, был стандартизирован в 2000-х, а в 2025 году получил новую волну популярности благодаря внедрению больших языковых моделей (LLM) в разработку.

Как собрать рабочее место

Для настройки рабочего места SDD-разработчика понадобится:

• Провайдер моделей ИИ.
• AI-агент — в нашем случае Claude Code.
• Claude Code Router — для переключения моделей и конвертации протоколов.
• Средства управления роутером — скрипты, которые мы напишем.
• VSCode с плагином для Claude Code в качестве основной IDE.

Также потребуется доступ к LLM. Мы будем использовать OpenCode Go — платформу с доступом к нескольким моделям. Инструкция по настройке предполагает, что у вас есть подписка на этот сервис.

Настраиваем Claude Code

Можно использовать и другие агенты — например, RooCode, OpenCode или KiloCode. Но мне удобнее работать с Claude, пока я не создам собственный агент.

Установим Claude Code через Homebrew (подходит для macOS и Linux):

brew install claude-code@latest

После установки агент потребует подписку. Чтобы обойти это, настроим конфигурацию вручную.

Создадим файл ~/.claude/settings.json. В нём нужно указать ключ доступа:

Обратите внимание на параметр ANTHROPIC_API_KEY — туда вставляется ваш персональный ключ. Указанный в примере ключ уже удалён и работать не будет.

О ключах доступа

В конфигурации можно использовать два типа ключей:

• ANTHROPIC_AUTH_TOKEN — отправляет заголовок Authorization: Bearer. Подходит для OpenAI-совместимых API, но не все провайдеры его поддерживают. Например, OpenCode Go не принимает его для Anthropic-совместимых точек доступа.
• ANTHROPIC_API_KEY — отправляет заголовок X-Api-Key. Это стандарт для Anthropic-совместимых API. Работает с OpenCode Go, но не поддерживается некоторыми провайдерами, например Z.AI.

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

После настройки ключа Claude Code запускается без подписки.

Добавляем Claude Code Router

Зачем нужен Claude Code Router (CCR)? Чтобы решить две задачи:

• Подключаться к OpenAI-совместимым точкам доступа через конвертацию протокола.
• Переключать модели «на лету» для разных проектов.

Как работает Claude Code Router

Claude Code Router — это прокси-сервер, который принимает запросы по Anthropic-протоколу и перенаправляет их нужному провайдеру, при необходимости конвертируя формат.

Команда ccr code запускает Claude Code как дочерний процесс, предварительно выставив нужные переменные окружения. Посмотреть их можно через ccr activate.

Чтобы прокси работал, сервис CCR должен быть запущен. Управлять им можно командами:

• ccr restart — перезапустить сервис.
• ccr status — проверить состояние.

Установим CCR:

brew install claude-code-router

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

Пишем управляющие скрипты

Создаем обертку для заголовков запроса

Нам нужно, чтобы CCR мог определить, к какому проекту относится запрос. Но Claude Code не передаёт эту информацию напрямую.

Решение — shell-обёртка, которая добавляет заголовок X-Project-Path с путём к проекту перед запуском агента.

Запуск через обёртку:

~/.claude-code-router/routing/wrapper.sh claude

Теперь CCR получает информацию о проекте и может применить нужную модель.

Скрипт custom_router

В конфиге CCR указан путь CUSTOM_ROUTER_PATH — он должен вести к скрипту custom_router.js. Полный код я вынес в отдельный файл, но опишу его логику.

Скрипт был сгенерирован по моему запросу с помощью minimax+kilocode. Я не пишу на JavaScript — мой стек это Go, но ИИ создал рабочую заготовку, которую я минимально отредактировал.

Что делает custom_router.js:

• Извлекает x-project-path из заголовка запроса.
• Ищет файл .claude/model.json в директории проекта.
• Если файл отсутствует — создаёт его со списком моделей из конфига CCR и пустым полем model.
• Проверяет актуальность списка моделей: при расхождении обновляет файл, сохраняя значение model.
• Если model пуст — возвращает null (режим fallback).
• Возвращает строку вида provider,model для выбора модели.

Формат model.json:

Логирование включается через config.LOG = true. Файлы логов сохраняются в ~/.claude-code-router/logs/routing-YYYYMMDD.log.

Добавляем VSCode

VSCode используется как оболочка для агента. Я тестировал и другие IDE — IntelliJ IDEA, OpenIDE, Zed — но остановился на VSCode. У него нет явных преимуществ, но он стабильно работает в моём стеке.

Установить VSCode можно через поисковик. Важно: плагины для агента могут не ставиться без прокси. Удобно прописать HTTP-прокси в настройках редактора.

Устанавливаем плагин anthropic.claude-code и настраиваем запуск агента через нашу обёртку.

Теперь всё готово к работе.

Выбор модели для проекта — через редактирование .claude/model.json. Желаемую модель указывают в поле model. Список доступных моделей автоматически подтягивается из конфига CCR в поле models.

На сегодня всё

Мы настроили рабочее место: подключили OpenCode Go к Claude Code и научились переключать модели динамически, в зависимости от проекта. В следующей статье добавим SDD toolkit и превратим рабочее место в полноценную станцию разработчика по методу Spec-Driven Development.

Привет, Хабр! Меня зовут Даниил Подольский, я программист и архитектор, разрабатываю программное обеспечение и спецификации для создания ПОв YADRO. Вот уже девять месяцев я использую методологию Spec-Driven Development (SDD) в работе и управляю AI-агентами, которые пишут код. При этом я не считаю себя вайбкодером, потому что мой подход к работе более комплексный, чем просто «общение с AI».

Это первая статья из цикла об оборудовании рабочего места SDD-кодера. Я расскажу о базовой настройке AI-агента Claude Code: что делать, если вы хотите оперативно и без перезагрузки переключать используемые модели и делать это для каждого проекта отдельно.

Что такое SDD

Spec-Driven Development (SDD) — это подход к разработке ПО, при котором весь процесс начинается с формальной спецификации (контракта) интерфейсов, форматов данных или архитектурных правил. Спецификация становится единственным «источником истины» для всех участников проекта. Подход SDD появился в 60-х годах прошлого века в недрах NASA, а в середине нулевых был стандартизован. В этой статье мы говорим о формате Spec-Driven Development, который обрел популярность в 2025 году, когда LLM стали активно внедряться в процессы разработки.

Недавно мой коллега написал ,как организовать работу над спецификациями, если раньше такого опыта не было вообще. Ему удалось масштабировать процесс на крупный департамент, так что прочитайте, если еще не пишете спеки. Как видите, они могут пригодиться в Spec-Driven Development-методе.

Как собрать рабочее место

Для успешного запуска нам потребуются:

• Модель, или даже провайдер моделей.
• Агент, а именно — Claude Code.
• Claude Code Router для переключения моделей и конвертации протоколов. Ниже я объясню подробнее, в чем польза этого инструмента.
• Средства управления Claude Code Router, которые мы напишем сами.
• VSCode в качестве оболочки для агента и интегрированного рабочего места (да, так расшифровывается аббревиатура IDE) с плагином для Claude Code.

Для наших целей еще понадобится подключение к LLM. Инструкций, как это сделать, не будет, но будет совет: посмотрите наOpenCode Go.

Все описанные далее шаги предполагают, что вы оформили подписку на OpenCode Go и у вас в распоряжении доступ к нескольким разным моделям. Впрочем, мономодельных провайдеров почти не осталось.

Настраиваем Claude Code

На самом деле можно выбрать и другой агент. Помимо Claude Code, я пробовал RooCode, OpenCode, KiloCode. Разница между ними не очень велика, но мне проще всего оказалось работать с Claude,пока я не сделал своего агента.

В этом разделе будет первая инструкция: ставим Claude Code без соответствующей подписки. Важно: я работаю на MacOS, и моя инструкция для нее. Инструкция должна подойти и для Linux, а для Windows ее легко адаптировать.

Итак, ставим Claude Code.

Установка описана на страницеQuick start. Я решил воспользоваться brew-вариантом:brew install claude-code@latest

После установки запускаем Claude и понимаем, что работает он не очень: свежеустановленный Claude Code требует подписку.

Давайте полечим его от «жадности». Создадим два файла:

Обратите внимание на параметрANTHROPIC_API_KEYв файле~/.claude/settings.json— туда надо вписать ваш ключ. Тот, что указан в статье, работать не будет — я его уже удалил.

Немного о ключах доступа

Их в конфигеможет быть два:

• Если использоватьANTHROPIC_AUTH_TOKEN, Claude Code отправляет с каждым запросом к модели заголовок Authorization: Bearer. Все бы хорошо, но это OpenAI-совместимый способ аутентификации, и не все провайдеры его поддерживают. OpenCode Go, например, поддерживает его для OpenAI-совместимых точек доступа и не поддерживает для Anthropic-совместимых. Да, все модели доступны на OpenCode Go по двум путям и протоколам. А для Claude Code нам нужна именно Anthropic-совместимая.
• Если использоватьANTHROPIC_API_KEY, Claude Code отправляет с каждым запросом к модели заголовок X-Api-Key. Это стандарт для Anthropic-совместимых точек доступа, и при указании именно его Claude Code прекрасно работает с OpenCode Go. Все бы хорошо, но некоторые провайдеры, например Z.AI, не поддерживают этот заголовок на Anthropic-совместимых точках доступа.

Вы должны понять сами, какую переменную указывать. Указать обе не получится — Claude Code будет ругаться.

Теперь запускается! Настроенный Claude Code не требует подписку:

Добавляем Claude Code Router

Вы спросите: «Зачем нам нужен Claude Code Router?» И я отвечу: для двух вещей, одна важней другой:

• мы хотим подключаться нашим Claude Code к OpenAI-совместимым точкам доступа, и нам нужен конвертер протокола;
• мы хотим переключать модели на лету, per project.

Как работает Claude Code Router

Claude Code Router (CCR) — это прокси-сервер, который слушает на указанном адресе и порте, принимает запросы по Anthropic-протоколу и направляет их соответствующему провайдеру, при необходимости конвертируя протокол.

Когда мы выполняем командуccr code, CCR выставляет нужные переменные окружения и запускает Claude как дочерний процесс. Что именно выставляет CCR, можно увидеть, если запустить командуccr activate:

Чтобы проксирование работало, надо держать CCR-сервис запущенным. Запустить его можно командойccr restart, а посмотреть на его состояние — командойccr status.

Давайте поставим Claude Code Router (CCR):brew install claude-code-router.

Создаем для CCR конфигурацию:

Пробуем запустить Claude Code через Claude Code Router. Для начала почистим конфиг Claude Code:

Теперь сам по себе Claude Code работать не сможет, но, если мы запустим его через Claude Code Router, который выставит нужные переменные, все получится.

Пишем управляющие скрипты

Теперь немного уличной магии.

Создаем обертку для настройки заголовков запроса

Нам бы хотелось, чтобы Claude Code использовал ту модель, которую мы указали для конкретного проекта. Для этого мы можем задействовать CCR. Но я внимательно изучил запросы, которые Сlaude Code передает в CCR, и не нашел ни одного признака, по которому CCR мог бы определить, к какому проекту относится конкретный запрос. В запросе есть полные имена файлов, которые добавлены в контекст, но надежным признаком я бы это не назвал.

Поэтому мы создадим shell-обертку, которая будет выставлять нужные переменные и запускать Claude:

Запускаем:~/.claude-code-router/routing/wrapper.shclaude

Теперь у запросов, которые доезжают до CCR, есть заголовок X-Project-Path, на него можно ориентироваться.

Скрипт custom_router

И наконец, выбираем модели. В конфиге CCR мы указали CUSTOM_ROUTER_PATH,  он должен указывать на скриптcustom_router.js. Скрипт великоват, чтобы приводить его прямо в тексте статьи, поэтому я положил егоотдельным файлом. Обязательно загляните и проверьте, что я вам предложил!

Честно сказать, я не писал этот скрипт, потому что вообще не знаю JS — это не мой профиль работы, я пишу на Go. Я получил готовый скрипт от minimax+kilocode по следующему запросу:

Создай custom_router.js согласно спецификации:

Извлекает x-project-path из заголовка

Пытается открыть ${projectPath}/.claude/model.json

Если файл не загружен:

• Если директория .claude не существует — возвращает null
• Если существует — создает model.json со списком моделей из конфига, model = пустая строка

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

• Если список устарел — заменяет на актуальный из конфига
• Если модель из model.json отсутствует в списке — заменяет на пустую строку
• Всегда перезаписывает model.json с актуальной информацией

Если model пуста — возвращает nullВозвращает модель

Как ни странно, этого оказалось достаточно, чтобы создать вполне рабочую заготовку. Я минимально отредактировалскрипт, а теперь предлагаю его вам. Короче, поступаю как настоящий вайбкодер…

Теперь у нас естьcustom_router.js— маршрутизатор выбора модели на основе проекта. Что он делает:

• Извлекаетx-project-pathиз заголовков запроса.
• Читает конфигурацию модели из.claude/model.jsonв проекте.
• Если файл отсутствует, создает его со списком доступных моделей из конфига.
• Если список моделей в конфиге изменился, пересоздает файл, сохраняя параметрmodelбез изменений, включая пустую строку или некорректное значение.
• Возвращает строку формата provider,model для выбора модели. Если проекта или модели нет, возвращаетnullдляfallback.

Формат model.json:

Логирование ведется только приconfig.LOG = true, файл ~/.claude-code-router/logs/routing-YYYYMMDD.log.

Добавляем VSCode

VSCode или другой IDE нужен в качестве оболочки для агента. Я пробовал IntelliJ IDEA, OpenIDE, Zed. Для себя остановился на VSCode, но убойных аргументов в его пользу у меня нет. Разберемся, как настроить VSCode.

Откуда установить VSCode, расскажет поисковик или DuckDuckGo. А я хочу подсветить один момент: скорее всего, нужные плагины для VSCode без VPN или прокси ставиться не будут. Удобно иметь прописанный в настройках VSCode http proxy. Применимы ли мои советы к другой IDE, я не знаю. На первый взгляд, должно подойти, но могут потребоваться доработки.

Далее надо установить плагинanthropic.claude-code:

Настроить запуск Claude Code через обертку:

Можно пользоваться!

Выбор модели в проекте осуществляется через редактирование файла.claude/model.json, если таковой есть. Желаемую модель надо вписывать в поле model. А чтобы всегда знать, какие модели можно туда вписать, router подготовил для нас поле models, в котором перечислены все модели, определенные в конфиге CCR.

На сегодня все

Мы настроили рабочее место и подключили дешевый провайдер OpenCode Go к агенту Claude Code, а еще научились на лету переключать модели, которые он использует. В следующей статье мы превратим наше рабочее место в станцию Spec-Driven Development-программиста, водрузив поверх сделанного SDD toolkit.