Claude Code может сам встроить SMS-верификацию в ваш проект: дайте ему навык (skill) для API SMS Activate App, храните ключ API в переменной окружения и проверяйте каждый шаг, который тратит деньги.
Настройка занимает около десяти минут. Так же она работает с Codex, Cursor и любым другим агентом для программирования, который читает файлы и запускает команды.
Что агент может делать с API
С ключом агент выполняет всё, что умеет ваш собственный код:
- Ищет доступные номера в выбранной стране и показывает вашу цену.
- Покупает личный номер на 28 дней. С заголовком Idempotency-Key повторный запрос не спишет деньги дважды.
- Читает SMS, которые приходят на номер, и звонки: с ноября 2026 года к короткому звонку прилагается его текст и продиктованный в нём код.
- Освобождает номер или отключает его продление.
- Настраивает вебхук, чтобы коды приходили на ваш сервер без опроса.
Что стоит поручить агенту: сквозной тест вашей регистрации, помощник для CI, который ждёт код, или приёмник вебхуков с проверкой подписи.
Шаг 1: создайте ключ и не храните его в коде
- Создайте аккаунт на странице регистрации и пополните баланс.
- Создайте личный ключ API на вкладке «API-ключи» в аккаунте или в Telegram-боте.
- Задайте ключ переменной окружения в терминале или положите в хранилище секретов проекта, но не в файл, который агент может закоммитить:
Ключ тратит ваш баланс. Claude Code читает переменную, когда запускает команду, и ему не нужно видеть значение в чате. Если ключ попал в файл, коммит или лог, отзовите его в аккаунте и создайте новый.
Шаг 2: дайте Claude Code навык
На сайте опубликован готовый файл навыка для агентов: /api-skill.md. В нём указаны базовый URL, маршруты, лимиты и ошибки, которые нужно обрабатывать. Сохраните его как навык проекта:
Claude Code загружает навык, когда задача подходит под его описание, например: «дождаться SMS с кодом в тесте регистрации». Закоммитьте файл навыка, если им должна пользоваться вся команда. Ключа в нём нет.
Ваш агент не поддерживает навыки? Откройте документацию API и нажмите кнопку, которая копирует промпт для агента. В нём те же правила одним блоком текста, и его можно вставить в любой чат.
Шаг 3: задайте правила проекта
Добавьте несколько строк в CLAUDE.md вашего проекта, чтобы каждая сессия их соблюдала:
Важнее всего второе правило. После выдачи номера покупка окончательна, и деньги за неё не возвращаются, поэтому человек должен видеть каждую покупку до того, как она произойдёт. Claude Code спрашивает разрешение перед запуском команды. Оставьте этот запрос включённым для команд, которые обращаются к маршруту покупки.
Шаг 4: поставьте задачу
Просите результат, а не конкретные вызовы. Например:
Добавь фикстуру pytest, которая арендует один номер США через API SMS Activate App, ждёт SMS на этот номер до пяти минут и возвращает код. Между запусками используй один продлеваемый номер, а не покупай каждый раз новый.
Хороший результат выглядит так:
- Агент ищет номер через GET /v1/public/numbers/search?country=US и показывает вам номер и цену до покупки.
- Покупает через POST /v1/public/numbers с заголовком Idempotency-Key.
- Опрашивает GET /v1/public/numbers/{id}/sms каждые 5–15 секунд с таймаутом или настраивает вебхук.
- Обрабатывает insufficientbalance, numberunavailable и rate_limited как ответы, а не как сбои.
Если агент придумывает маршрут, которого нет в навыке, отправьте его к файлу OpenAPI и попросите сверить.
Шаг 5: проверьте результат перед слиянием
Прежде чем влить код, который написал агент, проверьте четыре вещи:
- В диффе, выводе тестов и логах CI нет ключа.
- Каждая покупка отправляет Idempotency-Key, а повторный запрос использует тот же.
- У каждого ожидания есть таймаут и понятное сообщение об ошибке с номером.
- Тест не покупает новый номер при каждом запуске, если хватит одного продлеваемого номера.
Что нужно знать о расходах
Каждый номер арендуется на 28 дней по цене, которую показывает поиск, и продлевается с баланса, пока включено автопродление. С ноября 2026 года входящие звонки (за минуту) и SMS на номере тоже списываются с баланса по цене для страны, которую API возвращает в поле usagePricing. Прежде чем поручать агенту запуск тестов по расписанию, посмотрите актуальные цены на странице тарифов.
Когда API не подойдёт
API принимает SMS и звонки, но не отправляет их. Используйте его для своих приложений, аккаунтов и тестов. Принимает ли номер платформа, на которой вы проходите верификацию, решает она, а не мы. Поэтому проверьте номер на нужном сервисе, прежде чем строить на нём процесс: как проверить номер перед арендой.
Что читать дальше
- Весь процесс на Python и curl: автоматизация SMS-верификации через API.
- Коды из звонков и вебхуки: как принимать коды из SMS и звонков через вебхуки.
- Справочник: документация API, файл OpenAPI, навык для агента.