Last updated: November 8, 2026
Some links on this page are affiliate links. If you sign up through them I may earn a commission at no extra cost to you.
When I first saved this in March 2026, it pointed to gettelecode.com, a site pitching an AI terminal you drive from Telegram. That domain no longer loads. The same idea lives on as Telecode, an open-source project on GitHub and PyPI. I cannot confirm the two are the same team, but if you want this setup today, the open-source version is the one to use.
What Telecode does
Telecode is a small Python server that connects a Telegram bot to the AI coding agents on your own computer. You message the bot from your phone, and it runs your request through Claude Code or OpenAI’s Codex in the background, then replies with the result. Your code never leaves your machine except through the agent you already use.
| Feature | Details |
|---|---|
| Engines | Claude Code and Codex. Switch with /engine, /claude, or /codex |
| Sessions | Persistent, so the agent remembers the conversation |
| Shell commands | Run commands on the host from chat |
| Images and voice | Send screenshots; voice notes are transcribed with Whisper |
| Spoken replies | Optional text to speech through Fish Audio |
| MCP server | telecode –enable-mcp exposes the local agents as MCP tools |
| Access control | Whitelist by Telegram user ID or username |
| License | MIT |
| Latest release | 0.1.6, January 10, 2026 (when I checked) |
How to set it up
- Install Python 3.10 or newer, plus Claude Code or Codex, and sign in to whichever you plan to use.
- In Telegram, message @BotFather, create a new bot, and copy the token.
- Install Telecode with pip and run it. The first run walks you through the token and settings.
- Expose the webhook. Telecode supports ngrok, so Telegram can reach the server on your machine.
- Add your own Telegram user ID to the whitelist before you do anything else.
pip install telecode
telecode
Lock it down
A bot that can run shell commands on your computer is powerful, and also exactly what an attacker would want. My rules:
- Whitelist only your own Telegram account. Never run it open.
- Run it as a normal user, not an administrator, and ideally inside a project folder or a separate machine.
- Keep the agent’s own permission prompts on, so destructive commands still need a yes.
- Stop the ngrok tunnel when you are not using it.
- Do not keep API keys or production credentials on the same machine if you can avoid it.
Who it is for
It is handy if you already use Claude Code or Codex and want to check on a long task, fix a small bug, or kick off a build while away from your desk. Anthropic and others have since added their own remote and mobile options, so compare those before you set up a server you have to maintain.
I run this blog with an AI assistant in a similar way, but through a managed hosting API rather than a shell. If that sounds interesting, see how I run this blog through Pressable MCP and WP-CLI. And if your site is on WordPress.com, you can connect ChatGPT or Claude to it directly with no server at all.
Rather manage your site from a chat than a terminal? WordPress.com connects to ChatGPT and Claude on every plan.
FAQ
What is Telecode?
Telecode is an open-source, MIT-licensed Telegram webhook server that runs Claude Code or Codex on your own computer, so you can send coding requests from Telegram.
Is gettelecode.com still online?
No. The gettelecode.com domain did not load when I checked in November 2026. The open-source Telecode project on GitHub and PyPI offers the same idea.
How do I install Telecode?
Install Python 3.10 or newer, then run pip install telecode and start it with the telecode command. You need a Telegram bot token from BotFather.
Is it safe to control my computer from Telegram?
Only if you lock it down. Whitelist your own Telegram account, run it as a normal user, keep the agent’s permission prompts on, and shut the tunnel when you are done.
Can Telecode act as an MCP server?
Yes. Start it with telecode –enable-mcp and it exposes the local Claude Code, Codex, and command line tools over MCP.
Related posts
- How I Code With AI on a Budget: Free Tools and Models From a Hacker News Thread
- How I Run This Blog Through Pressable MCP and WP-CLI
- How to Connect ChatGPT or Claude to Your WordPress.com Site (MCP Guide)
- Pressable MCP: Manage Your WordPress Hosting From Claude or ChatGPT
- Motiontic: The Applied AI Lab Behind Agent Harnesses and MCP Security Audits