How to Build a Telegram Bot With Claude Code in an Afternoon: The Bot in an Afternoon

To build a Telegram bot with Claude Code in an afternoon, follow the Bot in an Afternoon method, our five-step approach at Claude Code Club for going from an idea to a running bot without prior experience. In one breath: decide the one thing the bot does, get a bot token, let Claude write the handler, run it locally to test, and deploy it so it stays on. A single afternoon is genuinely enough.

A Telegram bot is just a small program that listens for messages and replies. You send it a message, it reads it, it responds. The code that does the reading and replying is called the handler, and Claude Code writes it for you. Your part is to decide what the bot should do and to test it. Everything technical, Claude handles inside the Claude desktop app.

Start by deciding the one thing your bot does. One job, said in a sentence: send me the weather every morning, reply with a random quote when I say quote, or forward every message to a group. A bot with one clear job is a bot you can finish in an afternoon. If your idea needs the word and, you are describing two bots. Pick the one that matters most and build that first.

You can always add more later. The point of the afternoon is to get one working bot end to end, from idea to running, so you learn the whole path. A tiny bot that reliably does one thing teaches you far more than an ambitious bot that never quite runs. Choose the smallest useful version of your idea.

Then get a bot token. Telegram has a built-in way to create a new bot inside the app itself: you message its official bot-creation assistant, give your bot a name, and it hands you a token. That token is a long string of letters and numbers that proves your bot is really yours. Copy it somewhere private. Ask Claude Code to walk you through the exact steps if you get stuck.

Treat the token like the key to your bot, because that is exactly what it is. Store it somewhere only you can see, such as a private notes file or a password manager. You will hand it to your project in a safe way in a later step, so for now the only job is to keep it out of any place that other people can read.

Next, let Claude write the handler. The handler is the code that listens for messages and decides how to reply, and it is the heart of your bot. Tell Claude Code your bot's one job and that you have a token, and ask it to write the handler and set up the project. Claude creates the files and explains how the pieces fit together. You do not need to write any of this code yourself.

Then run it locally to test. Running locally means the bot runs on your own computer for now, so you can message it and see if it replies correctly. Ask Claude Code to start the bot and tell you exactly what to do. Open Telegram, message your bot, and watch it respond. If the reply is wrong, describe the problem to Claude and it adjusts the handler. Test until it behaves.

Finally, deploy it so it stays on. When your bot runs locally, it only works while your computer is on and awake. Deploying means putting it somewhere that runs around the clock, so your bot is always ready to reply. Ask Claude Code to recommend a simple hosting option for a small bot and to walk you through putting it there. Keep your token in the private settings of that host, never in the code.

Once deployed, message your bot again to confirm it still works from its new home. Now you can close your laptop and the bot keeps running. That is the full Bot in an Afternoon: decide the one thing, get a token, let Claude write the handler, run it locally, and deploy it. You started the afternoon with an idea and ended it with a working bot.

When your bot is live, come share it in the Claude Code Club community and tell us the one job it does. Someone will want to build the same thing, and your afternoon becomes their starting point. If you hit a wall on tokens or deployment, ask in the community and we will get you unstuck. ⚡