Как подключить Claude API к своему боту: 5 шагов за вечер

Как понять, что ключ работает

Ключ живой, если в ответ пришёл текст с "type": "message". Внутри три места, на которые стоит посмотреть глазами:

Если вместо этого пришло "type": "error", найди его текст в таблице «Что ломается» ниже: у каждой ошибки там есть причина и выход

На Windows. Команда выше рассчитана на Mac и Linux. На Windows нажми Пуск, набери PowerShell, открой его и вставь это, подставив свой ключ:

$env:ANTHROPIC_API_KEY="sk-ant-..."
Invoke-RestMethod https://api.anthropic.com/v1/messages -Method Post -ContentType "application/json" -Headers @{"x-api-key"=$env:ANTHROPIC_API_KEY; "anthropic-version"="2023-06-01"} -Body '{"model": "claude-sonnet-5-5", "max_tokens": 200, "thinking": {"type": "between_tools"}, "messages": [{"role": "user", "content": "Hi! Who are you? Answer in one sentence"}]}'

Ключ живой, если в ответе есть строка, где слева type, а справа message, и в строке content лежит ответ Claude

Свой бот в Telegram, который отвечает через Claude

Ключ проверен, дальше бот. Нужны три вещи: секретный ключ самого бота от Telegram, Python на компьютере и файл с программой ниже

Есть ли у тебя Python, проверяется одной командой в том же окне: на Mac python3 --version, на Windows python --version. Нужен Python 3.10 или новее. Увидел меньше (на Mac из коробки часто стоит 3.9), «command not found», на Windows «не распознано как имя командлета» или вместо ответа открылся Microsoft Store, скачай установщик с python.org (кнопка Download на главной) и поставь. На Windows в первом окне установщика отметь галочку Add python.exe to PATH, иначе команда так и не найдётся

Шаг 1. Ключ бота. Напиши в Telegram @BotFather, отправь ему /newbot, придумай имя и адрес, который заканчивается на bot. В ответ придёт длинная строка из цифр, двоеточия и букв, в Telegram её называют токеном. Подробно с экранами этот шаг я разобрал в статье как создать телеграм-бота

Шаг 2. Два дополнения для Python. В том же окне одна команда ставит официальное дополнение Claude и дополнение для сообщений в Telegram:

pip install anthropic requests

Ответило «command not found» на pip? Та же установка другой командой: python3 -m pip install anthropic requests на Mac, python -m pip install anthropic requests на Windows. В конце появится строка Successfully installed

Шаг 3. Файл бота. Создай в «Документах» папку bot. Открой простой текстовый редактор (на Mac TextEdit, в меню Формат выбери «Сделать простым текстом», на Windows Блокнот), вставь текст ниже целиком и сохрани в эту папку под именем bot.py:

import os, requests, anthropic

TG = "https://api.telegram.org/bot" + os.environ["TELEGRAM_TOKEN"]
claude = anthropic.Anthropic()  # ключ сам берётся из ANTHROPIC_API_KEY
offset = 0
print("Бот запущен, напиши ему в Telegram")

while True:
    data = requests.get(TG + "/getUpdates", params={"offset": offset, "timeout": 30}, timeout=40).json()
    if not data.get("ok"):
        print("Telegram не принял токен:", data.get("description"))
        break
    for upd in data["result"]:
        offset = upd["update_id"] + 1
        msg = upd.get("message")
        if not msg or "text" not in msg:
            continue
        reply = claude.messages.create(
            model="claude-sonnet-5-5",
            max_tokens=500,
            thinking={"type": "between_tools"},  # отвечать сразу, без долгих раздумий
            system="Ты помощник в Telegram. Отвечай коротко и по-русски.",
            messages=[{"role": "user", "content": msg["text"]}],
        )
        text = "".join(b.text for b in reply.content if b.type == "text")
        requests.post(TG + "/sendMessage", json={"chat_id": msg["chat"]["id"], "text": text})

Что делает программа, по-человечески: всё время ждёт от Telegram новых сообщений, каждое новое отправляет Claude, текст ответа пересылает человеку. Строка thinking просит модель отвечать сразу, без долгих раздумий: так ответ быстрее и дешевле. Эта же программа и есть твой первый запрос к Claude на Python через официальное дополнение. Строка system задаёт характер бота: поменяй её на «Ты консультант моей студии йоги, отвечай на вопросы о расписании» и получишь другого бота

Шаг 4. Запуск. В окне команд перейди в папку бота и запусти его, подставив оба ключа. На Mac:

cd ~/Documents/bot
export TELEGRAM_TOKEN="ключ бота от BotFather"
export ANTHROPIC_API_KEY="sk-ant-..."
python3 bot.py

На Windows в PowerShell:

cd $HOME\Documents\bot
$env:TELEGRAM_TOKEN="ключ бота от BotFather"
$env:ANTHROPIC_API_KEY="sk-ant-..."
python bot.py

В окне появится строка «Бот запущен, напиши ему в Telegram». Открой своего бота, напиши «привет», и через пару секунд придёт ответ от Claude. Бот отвечает, а ключ Claude при этом лежит только у тебя на компьютере

Шаг 5. Где ему жить. Пока окно открыто и компьютер не спит, бот работает. Закрыл крышку ноутбука - бот замолчал. Чтобы он отвечал круглые сутки, программу переносят на арендованный компьютер в интернете. Автор клиента Claude для Nokia пишет, что его посреднику хватает аренды за 4-6 долларов в месяц, такому боту этого тоже хватит с запасом

Почему ключ живёт только у посредника: как это сделано у Nokia

Nokia 2007 года не умеет разговаривать с современным интернетом: её шифрование устарело, и крупные облачные сервисы такие подключения отклоняют. Поэтому автор проекта Claude S40 Эмир Каршыякалы поставил посередине своего посредника, одну программу размером около 7 МБ на арендованном компьютере. Телефон говорит с ним на своём старом языке, посредник пересказывает вопрос Claude и отдаёт ответ обратно

В этой схеме важнее всего, где лежит ключ. Из описания проекта:

1. Ключ Claude хранится только у посредника. Телефон его никогда не видит
2. Телефон получает свой пропуск. При первом запуске он привязывается шестизначным кодом, и этот пропуск можно отозвать, если телефон потерялся
3. Посредник держит лимиты на каждый телефон: сколько вопросов, сколько текста в ответах и сколько поисков в день. И никогда не повторяет платный запрос сам, чтобы сбой связи не списал деньги дважды

Для твоего сайта или приложения правило то же самое. Ключ, вписанный в код страницы, видит любой, кто нажмёт «Просмотреть код»: он скопирует его и будет тратить твой баланс. Поэтому страница или приложение шлют вопрос твоему посреднику, а к Claude ходит только он. Наш бот устроен так же: ключ лежит на компьютере, где запущена программа, а Telegram получает только готовые ответы

Сколько стоит и как не получить счёт на сотни долларов

Доступ к Claude для своих программ оплачивается не подпиской, а за объём текста: отдельно за вопрос и отдельно за ответ. Считается он в токенах, то есть в кусочках текста, цена указана за миллион таких кусочков. На 29 сентября 2026 модель из нашей программы, claude-sonnet-5-5, стоит 2 доллара за миллион кусочков вопроса и 10 долларов за миллион кусочков ответа

Прикинем на пальцах: короткий вопрос это около сотни кусочков, ответ на пару абзацев около трёхсот. Выходит 0,0002 доллара за вопрос плюс 0,003 за ответ, примерно треть цента. На один доллар бот ответит от двухсот до трёхсот раз, в зависимости от длины ответов. Точную смету под свои тексты посчитаешь по статье как посчитать расход токенов

Один ответ стоит копейки. Дорого выходит бот, которого никто не останавливает, пока он отвечает всем подряд. Поэтому до запуска поставь лимит трат:

Что ещё защищает от неприятного счёта:

• Потолок месяца уже есть. На начальном уровне кабинета месячный потолок трат 500 долларов, а новые аккаунты могут стартовать с ещё более низкими лимитами. Свой лимит ставится ниже потолка
• Лимит на человека. В нашей программе его нет, это первое, что стоит добавить, если бот уйдёт к людям. У Claude S40 лимиты стоят на каждый телефон, у бота это будет лимит на каждого собеседника
• Длина ответа. max_tokens=500 в программе обрезает слишком длинные ответы, а значит и расход на каждый из них

Если у тебя другой случай

Уже платишь за Claude Pro или Max. Доступ для программ в подписку не входит. Anthropic прямо пишет: подписка даёт чат на сайте, в приложении и на компьютере, а ключи это отдельный продукт с отдельной оплатой в Claude Console. Как пополнить именно этот баланс, я разобрал в статье как пополнить баланс Claude Console

Ты в России. России нет в списке стран, откуда Anthropic поддерживает такой доступ, а карты российских банков оплату не проходят. Какие пути оплаты реально работают и какие только обещают, я разобрал в статье нужна ли иностранная карта для Claude. Ключи и доступы «за копейки» из Telegram-каналов не покупай, почему это почти всегда обман, я разобрал в статье Claude за копейки из телеграма

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

Нужен бот, который отвечает по твоим материалам. Бот из этой статьи знает только то, что знает Claude. Чтобы он отвечал по твоим урокам, прайсу и частым вопросам, ему нужна своя база знаний. Эту сборку я показал на примере нейрокуратора

Что ломается и что делать

Первые две строки я снял сам, запустив программу без ключа бота и с выдуманным ключом: она останавливается ровно с этими словами. Остальные тексты ошибок взяты из официальной документации Claude

KeyError: 'TELEGRAM_TOKEN'

Бот запущен, напиши ему в Telegram
Telegram не принял токен: Unauthorized

Источники

• Claude S40 на GitHub - как устроен клиент для Nokia 6300: посредник, ключ только у него, пропуск по шестизначному коду, дневные лимиты на телефон, аренда за 4-6 долларов
• Видео Claude S40 на Nokia 6300 - запись автора, 27 сентября 2026
• Документация Claude: как получить ключ - где создаётся ключ, начало sk-ant-, показ один раз
• Документация Claude: первый запрос - проверочная команда и официальное дополнение для Python
• Документация Claude: обзор моделей - имена моделей и цены за миллион кусочков текста
• Документация Claude: лимиты - месячный потолок трат и свой лимит в разделе Billing
• Документация Claude: ошибки - какие бывают ошибки и что они значат
• Документация Claude: поддерживаемые страны - откуда поддерживается доступ
• Справка Claude: почему подписка и ключи оплачиваются отдельно - это разные продукты

Памятка: Claude в своём боте за 5 шагов

Сохрани скриншотом, пригодится, когда будешь делать второго бота или переносить первого на арендованный компьютер

Частые вопросы