Categories
Web Links

Telecode: Run Claude Code or Codex From Telegram

Telecode is an open-source Telegram bot server that runs Claude Code or Codex on your own machine, so you can code from your phone. What it does, how to install it, and how to keep it locked down.

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.

FeatureDetails
EnginesClaude Code and Codex. Switch with /engine, /claude, or /codex
SessionsPersistent, so the agent remembers the conversation
Shell commandsRun commands on the host from chat
Images and voiceSend screenshots; voice notes are transcribed with Whisper
Spoken repliesOptional text to speech through Fish Audio
MCP servertelecode –enable-mcp exposes the local agents as MCP tools
Access controlWhitelist by Telegram user ID or username
LicenseMIT
Latest release0.1.6, January 10, 2026 (when I checked)

How to set it up

  1. Install Python 3.10 or newer, plus Claude Code or Codex, and sign in to whichever you plan to use.
  2. In Telegram, message @BotFather, create a new bot, and copy the token.
  3. Install Telecode with pip and run it. The first run walks you through the token and settings.
  4. Expose the webhook. Telecode supports ngrok, so Telegram can reach the server on your machine.
  5. 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

Tell me why I'm wrong...