Как переписать критические части проекта на Rust с помощью Claude Code: пошаговый разбор инструмента rust-anything
Инструмент автоматически профилирует код, генерирует FFI-мосты, записывает эталонное поведение и блокирует коммит при расхождениях.
Разработчик Эркам Яман (Erkam Yaman) опубликовал открытый инструмент rust-anything под лицензией MIT. На 19 ноября 2026 года проект набрал 3990 звёзд и 329 форков на GitHub, а 18 ноября вышла версия 1.5.1 с защитой от зависания генераторов тестов.
Инструмент автоматизирует перенос медленных участков кода на Rust для проектов на TypeScript, Python, C, Go, Ruby и Java. В экспериментальном режиме также поддерживаются PHP и C#. Главная задача утилиты — исключить риски при переписывании: она находит узкие места, генерирует обёртки внешнего интерфейса (FFI), фиксирует эталонный ввод-вывод оригинальной программы и блокирует коммит, пока реализация на Rust не повторит поведение оригинала на 100%.
В чём главная проблема переноса кода с помощью ИИ
Языковые модели вроде Claude Code без труда генерируют синтаксически корректный код на Rust. Трудности возникают на этапе интеграции в работающий проект:
- Потеря идентичности поведения: алгоритм может вернуть правильный ответ на базовых данных, но разойтись с оригиналом на крайних значениях чисел с плавающей точкой, символах UTF-16, регулярных выражениях или сортировке словарей.
- Сложная стыковка интерфейсов: для вызова Rust из Node.js, Python или Go требуется ручная сборка нативных расширений через N-API, PyO3 или CGO с преобразованием типов данных.
- Отсутствие строгих критериев готовности: разработчику приходится вручную писать десятки тестов, чтобы подтвердить эквивалентность нового модуля исходному коду.
Как устроен цикл верификации rust-anything
Инструмент не пишет логику самостоятельно. Создание кода на Rust поручается разработчику или ИИ-агенту (Claude Code, Cursor, Codex). Утилита берет на себя интеграционную и проверочную обвязку, которую модель не способна гарантировать сама.
- 1. Profile: запуск исходной программы под нагрузкой для выявления функций, на которые расходуется большая часть процессорного времени.
- 2. Bridge: анализ типов в исходном файле и автоматическая генерация каркаса крейта на Rust с бинарным протоколом передачи данных и обёртками для вызывающего языка.
- 3. Record: выполнение оригинального кода на сгенерированных крайних случаях (семантические ловушки, непечатаемые символы, экстремальные числа) с сохранением эталонных ответов.
- 4. Diff и Gate: прогон тех же входных данных через скомпилированный Rust-код со строгой проверкой совпадения результатов вплоть до бита.
Подключение к Claude Code и другим агентам
Инструмент доступен в виде системной утилиты через Cargo и npm, а также интегрируется напрямую в Claude Code через протокол MCP (Model Context Protocol) и каталог плагинов:
Для подключения в виде плагина Claude Code используется команда:
Команда setup автоматически регистрирует MCP-сервер в конфигурационном файле ~/.claude.json и добавляет рабочий скилл в ~/.claude/skills/. Перед изменением существующих конфигураций утилита создаёт резервные копии с суффиксом .rust-anything.bak.
Пошаговый процесс: от профилирования до строгих проверок
Процесс миграции критического участка состоит из последовательного вызова набора команд:
- Шаг 1. Профилирование. Команда profile фиксирует стек вызовов и показывает функции с максимальным потреблением ресурсов.
- Шаг 2. Создание моста. Команда bridge анализирует TypeScript-типы и генерирует нативный аддон napi-rs. Флаг --batch ускоряет пересылку массивов через FFI за один переход.
- Шаг 3. Запись эталона. Команда record запускает оригинальную функцию на синтетических краевых тестах и реальных входных данных проекта.
- Шаг 4. Написание логики. Агент Claude Code получает задачу реализовать алгоритм в файле src/port.rs с учётом типов и ограничений.
- Шаг 5. Сверка и гейт. Команда diff сравнивает ответы. Команда gate проверяет отсутствие регрессий и следит за объёмом кода: размер порта не должен превышать исходник более чем в три раза.
Реальные результаты ускорения на тестах автора
Автор проекта опубликовал замеры производительности на реальных библиотеках после переноса горячих функций на Rust при сохранении исходного API:
На задаче нечёткого поиска в словаре из 50 000 ключей в проекте x18n время выполнения запроса на Node.js сократилось с 10,0 мс до 0,5 мс (ускорение в 20 раз). В Python-пакете slugify перенос строковой обработки на Rust через PyO3 сократил время с 98,0 мс до 5,5 мс (в 17 раз).
Ограничения и подводные камни
Инструмент защищает от логических ошибок, но имеет архитектурные границы, которые необходимо учитывать:
- Регулярные выражения: стандартный крейт regex в Rust не поддерживает обратные ссылки и опережающие проверки (lookaround). Если в коде используются сложные шаблоны JavaScript или Python, утилита добавляет тесты на различия движков, но адаптацию шаблона приходится выполнять вручную.
- Плавающая точка: форматирование чисел в текст между языками часто различается. Для численных алгоритмов флаг --float-tolerance допускает расхождение в пределах погрешности округления, но форматирование строк проверяется строго.
- Побочные эффекты: вызовы базы данных и сетевые запросы требуют изолированного тестового окружения, так как генератор выполняет сотни синтетических мутаций.
С чего начать перенос логики
- 1. Установить утилиту через cargo install rust-anything и выполнить команду rust-anything setup для добавления MCP-сервера в Claude Code.
- 2. Запустить бенчмарк или скрипт нагрузки через rust-anything profile для определения медленной функции.
- 3. Сгенерировать FFI-мост командой rust-anything bridge и записать контрольные кейсы через rust-anything record.
- 4. Поручить Claude Code реализацию логики в созданном крейте и подтвердить корректность командой rust-anything gate.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».