CLI Tool

Claude Code, from your phone

A Telegram bridge for Claude Code. Manage projects, run commands, and code on the go — all from a simple chat interface.

$npm install -g clautel

Requires Node.js 18+ and a Claude Code subscription

Quick Start

1

Install

$ npm install -g clautel
2

Setup

$ clautel setup

Creates a manager bot via @BotFather, sets your Telegram ID, and activates your license.

3

Start

$ clautel start

Launches the daemon. DM your bot on Telegram to start coding.

How it works

Manager Bot

One bot to manage all your projects. Use /add to attach Claude to any directory on your machine.

Per-Project Bots

Each project gets its own Telegram bot. Chat with it to run Claude Code in that project's directory.

Full Claude Code

Not a wrapper — runs the real Claude Code SDK. File edits, bash commands, tool use, everything.

Background Daemon

Runs as a background process. Start it once and it stays alive. Install as a launchd service on macOS.

Owner-Only Access

Only your Telegram ID can interact with the bots. Nobody else can access your machine.

Works Anywhere

Your laptop stays at home, you code from the bus. Telegram works on any device.

Telegram Commands

Manager Bot

/add TOKEN /pathAttach a worker bot to a project
/botsList active bots
/remove @botStop and remove a bot
/subscribeGet a license or upgrade
/subscriptionView billing & cancel
/feedbackSend feedback

Worker Bot

Any messageTalk to Claude Code
Photo / fileInclude as context
/modelSwitch model
/costShow token usage
/sessionGet session ID
/newStart fresh session
/cancelAbort current operation

CLI Reference

CommandDescription
clautel setupConfigure bot token, owner ID, and license
clautel startStart the background daemon
clautel stopStop the daemon
clautel statusCheck if the daemon is running
clautel logsTail the daemon logs
clautel activate <key>Activate a license key
clautel deactivateFree up the license activation slot
clautel licenseShow current license status
clautel install-serviceInstall as macOS launchd service
clautel uninstall-serviceRemove the launchd service

Pricing

Pick the plan that matches your Claude subscription. Cancel anytime.

Pro
$4/mo

For Claude Pro subscribers

  • Sonnet model (default)
  • Multiple project bots
  • Background daemon
  • macOS launchd integration
  • All future updates
Get Pro
Popular
Max
$9/mo

For Claude Max subscribers

  • Opus model (default)
  • Multiple project bots
  • Background daemon
  • macOS launchd integration
  • All future updates
Get Max

Requires a separate Claude Code subscription from Anthropic