The Pitch Is Simple
What if you could text an AI that never sleeps, has access to your server, and responds in seconds?
Not a chatbot. Not a pre-programmed bot that matches keywords. A full AI agent running on your own hardware, connected to Telegram, that you can message from your phone at 2am and get an intelligent response.
That is what Claude Code Channels does. And setting it up costs less than a Netflix subscription.
What It Actually Is
Claude Code is Anthropic's CLI tool for developers. You run it in a terminal, give it tasks, and it reads files, writes code, runs commands. It is powerful but tied to your laptop.
Channels changes that. It connects Claude Code to messaging platforms like Telegram and Discord. Now instead of typing in a terminal, you send a Telegram message. Claude reads it, thinks, acts, and replies.
The key difference: it is not a wrapper around the API. It is the full Claude Code agent with access to your filesystem, your tools, your scripts. Whatever Claude can do in a terminal, it can now do from a Telegram message.
What I Actually Use It For
I have Claude Code running on a VPS connected to a private Telegram bot. Here is what a typical day looks like:
Run Server Commands From Dinner
"Check if n8n is running."
Claude runs docker ps, reads the output, tells me n8n is healthy with 3 active workflows. I did not open a laptop. I did not SSH into anything. I sent a text.
Code From My Phone
"Add a try/catch block around the webhook handler in server.ts."
Claude finds the file, reads it, adds the error handling, saves it. I review the change from my phone and say "looks good." Done.
Web Research On The Go
"What are the top trending topics on Hacker News right now?"
Claude searches the web, summarizes the results, sends them back as a clean Telegram message. Better than scrolling through a browser on a small screen.
Quick DevOps Tasks
"Restart the Docker container for the resume scorer workflow."
Claude runs the command, confirms it restarted, checks the logs for errors. Takes 10 seconds.
Draft Content While Commuting
"Write a LinkedIn post about the AI resume crisis. Use the Robert Half data: 67% of HR leaders say AI applications are slowing hiring."
Claude drafts the post, sends it to Telegram. I review it, make edits by replying, and have a finished post before I get to the office.
On-Call Triage Without a Laptop
"Check the last 50 lines of the n8n container logs for errors."
Claude runs docker logs, filters for errors, tells me what happened. If there is a problem, I can tell it to fix it right from Telegram. If not, I go back to sleep.
What You Need
The setup requires three things:
- ●A Claude subscription (Pro, Max, Team, or Enterprise). This powers the AI. Claude Max gives you Opus 4.6 access, but Sonnet 4.6 is the better choice for a Telegram bot because it responds faster.
- ●A VPS (any Linux server). This runs Claude Code 24/7. You need something that stays on when your laptop is closed. A 4GB VPS ($7/mo range) is enough for Claude Code Channels. If you want to run automation workflows too, grab an 8GB VPS ($10/mo range) instead.
- ●A Telegram account and a bot created through @BotFather. Free. Takes 2 minutes.
Total cost: $7-10/mo for the server + your existing Claude subscription.
The Setup (High Level)
The official steps from Anthropic's docs:
- ●Create a Telegram bot via BotFather
- ●Install the Telegram plugin inside Claude Code
- ●Configure the bot token
- ●Launch Claude Code with
--channels plugin:telegram@claude-plugins-official - ●DM your bot to get a pairing code
- ●Pair your account and lock it down to allowlist mode
That is the happy path. It works if everything goes right.
Get the Weekly IT + AI Roundup
What changed this week in NinjaOne, ServiceNow, CrowdStrike, and AI. One email, every Monday.
No spam, unsubscribe anytime. Privacy Policy
What Actually Happened (The Honest Version)
Here is what the docs do not tell you:
The plugin install fails from the command line. The claude plugin install command did not find the plugin. I had to install it from inside a running Claude Code session using /plugin install telegram@claude-plugins-official. Different command, different context.
Authentication has to happen on the server. I generated an OAuth token on my local machine. It did not work on the VPS. You have to SSH into the server, run claude setup-token there, and complete the auth flow from that machine.
The bot needs a real terminal. Claude Code requires an interactive TTY. Running it as a simple background process does not work. I use tmux (a terminal multiplexer) inside a systemd service so it auto-starts on reboot.
Permission prompts freeze the bot. Every time Claude tries to use a tool it has not been approved for (web search, file read, reply to Telegram), the bot freezes until someone manually approves it. The fix: set broad permissions in the settings files before starting.
The working directory matters. I had permissions configured for /home/claude but the service was starting in /. Different directory means different permission scope. Claude silently ignored my permissions and kept asking.
None of these are dealbreakers. But they took time to figure out. If you are setting this up, those five issues will save you hours.
Making It Permanent
The bot dies when your terminal closes. To keep it running 24/7, I created a systemd service that:
- ●Starts Claude Code in a tmux session on boot
- ●Auto-approves the workspace trust prompt
- ●Restarts if it crashes (30 second delay)
- ●Runs as a non-root user for security
The result: if the VPS reboots for maintenance or updates, the bot comes back online automatically. No human intervention.
What We Have Tested So Far
Here is what we have confirmed working on our setup:
- ●Text messages: Ask anything, get a response in seconds. Web searches, code changes, server commands all work.
- ●File attachments: We sent a resume PDF via Telegram. Claude downloaded it, read the content, and sent back a full summary with career highlights, skills, and education. Documents up to 20MB are supported.
- ●Persistent sessions: The systemd service auto-restarts on reboot. We have had the bot running continuously without manual intervention.
- ●Permission management: Broad permissions are set so the bot does not freeze waiting for approval on common tasks.
This is still evolving. We are actively building on top of this, including n8n automation workflows that use Claude Code Channels for real-time recruiter notifications.
Who This Is For
Developers who want to code, deploy, and debug from their phone without SSH apps.
IT admins who want to check server status, restart services, and triage alerts without opening a laptop.
Solo founders who want an AI assistant they can reach from anywhere, running on infrastructure they control.
Anyone who has thought "I wish I could just text my AI."
The Bigger Picture
This is not just a Telegram bot. It is a pattern. An AI agent running on your own server, connected to your tools, accessible from anywhere.
Today it is Telegram. Tomorrow it could be Slack, Discord, email, or a custom webhook from your monitoring system. The architecture is the same: Claude Code running on a VPS, listening for messages, acting on them.
We are building automation workflows on top of this. Our Recruiter Pro Track uses Claude Code Channels as one of four paths for AI-powered resume screening. The recruiter gets a Telegram notification every time a high-signal candidate applies. No dashboard, no login, just a message on their phone with the scorecard.
That is where this is heading. Not just "talk to AI from your phone." But "AI that watches your systems, your workflows, your pipelines, and tells you when something matters."
Get the Complete Setup Guide
We documented every step, every gotcha, and every config file from this build. The guide includes the systemd service, the auto-approval watcher script, the resume scoring skill, and a working example scorecard.
Download the VPS Setup Guide (PDF) and have your own always-on AI assistant running in under an hour.
A note before you start: This guide is a working proof of concept based on our actual setup. It will get you a functional Telegram bot connected to Claude Code on a VPS. However, your environment may differ. Software versions change, Anthropic updates their plugin system, and VPS configurations vary. Treat this as a foundation to build on, not a guaranteed copy-paste solution. Test everything in your own environment and adapt as needed.
What you need to follow the guide:
- ●A Claude subscription (Pro, Max, Team, or Enterprise)
- ●A VPS. A 4GB VPS ($7/mo range) handles Claude Code Channels. For Claude Code plus automation workflows, grab an 8GB VPS ($10/mo range).
- ●A Telegram account (free)
Want More?
- ●Technical overview: Read our Claude Code Channels breakdown for the full architecture explanation.
- ●Pre-built workflows: Our Recruiter Pro Track shows how to combine Claude Code Channels with n8n workflows for automated resume scoring at scale.