Skip to content

Instantly share code, notes, and snippets.

@luc-tielen

luc-tielen/CLAUDE.md

Created March 28, 2026 18:14
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save luc-tielen/78b793ce187474eaa276f7ae58937a16 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save luc-tielen/78b793ce187474eaa276f7ae58937a16 to your computer and use it in GitHub Desktop.
Download ZIP
Remote (voice) controlled Claude Code using Telegram
Raw
README.md

Below are the instructions you need to do to support voice controlled messages in Claude Code. Preferrably you use this from a long-running server instance (e.g. a VPS or Mac Mini).

Prerequisites

  1. Claude Code
  2. Telegram (with your own user account)
  3. whisper (brew install whisper)

Steps

Install the telegram channel plugin

  1. Install plugin for telegram channel support: type /plugin in claude code and search for telegram. Install it
  2. Restart claude with following command: claude --channels plugin:telegram@claude-plugins-official

Pair a Telegram bot with Claude

  1. Register a Telegram bot by sending a message to @BotFather: /start, followed by /newbot. Choose a bot name and continue until you get the bot token.
  2. In claude code: /telegram:configure
  3. Send a message to your new bot in telegram. You will get back a pairing token
  4. In claude code: telegram:access pair
  5. In claude code: /telegram:access policy allowlist

Now your Telegram bot should be connected only to your Telegram account. You should be able to send messages in Telegram, but voice is not supported yet.

Adding support for voice

Voice messages are not supported by default in the Telegram channel. However, we can easily add support by instructing Claude to use whisper for local audio transcription. We can do this by adding a section to the global CLAUDE.md (~/.claude/CLAUDE.md) that tells it to first transcribe all incoming messages. (See below.)

Restart claude, and now voice is supported as well! Multiple languages are supported as well thanks to whisper.

Raw
CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code on this server.

Voice Message Handling (Telegram)

When you receive a channel notification containing a voice or audio file (.ogg, .m4a, .oga) in ~/.claude/channels/telegram/inbox/, BEFORE responding, run:

whisper <file_path> --output_format txt --output_dir /tmp

Then treat the transcription as the actual message and respond to that.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment