How do I use Claude Code from my phone?

Install Clautel (npm install -g clautel), run clautel setup to connect your Telegram, then clautel start. You can now message your Telegram bot to run Claude Code on your machine from anywhere.

Does Clautel work with Claude Pro ($20/mo)?

Yes. Clautel works with both Claude Pro and Claude Max subscriptions. Unlike Remote Control which requires Max ($100+/mo), Clautel starts at $4/mo on any Claude plan.

What is the difference between Clautel and Claude Code Remote Control?

Remote Control is Anthropic's official mobile client, but it requires a Claude Max subscription ($100-200/mo) and doesn't run as a background daemon. Clautel works on Claude Pro ($20/mo), runs as an always-on background daemon, provides per-project Telegram bots, and costs $4-9/mo.

Is Clautel open source?

Yes. Clautel is MIT licensed and fully open source. You can read every line of code at github.com/AnasNadeem/clautel.

Background Daemon

Open Source

Claude Code, from your phone

Name: Clautel
Price: 4.00 USD
Author: Clautel

An open-source background daemon that bridges your Claude Code CLI to Telegram. Per-project bots, works from any device. Requires a Claude Pro or Max subscription.

$npm install -g clautel

Requires Node.js 18+ and a Claude Code subscription

Quick Start

Install

$ npm install -g clautel

Setup

$ clautel setup

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

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.

Session Continuity

Type /resume to see your recent CLI sessions and pick up where you left off, right from Telegram. Or go the other way with /session and claude --resume.

Live Browser Preview

Preview any URL, including localhost, right in Telegram. Click, scroll, type, and navigate with interactive controls. Desktop viewport, screenshots update in-place.

Task Scheduler

Schedule recurring tasks in natural language. "Run tests every morning at 9am" — Claude parses it, sets up the cron job, and runs it autonomously. Persistent across restarts.

Why Clautel

Works with any Claude plan

Compatible with both Pro and Max subscriptions

Always on, no hand-off required

Background daemon keeps running while your machine is awake

Per-project context isolation

Each project gets its own Telegram bot with clean context

Telegram, already on your phone

No new apps, no QR codes, just open and type

Seamless session handoff

Switch between CLI and Telegram mid-session. Your context follows you everywhere

Open source & auditable

MIT licensed. Read every line that runs on your machine. No obfuscation, no telemetry

Telegram Commands

Manager Bot

/add TOKEN /path	Attach a worker bot to a project
/bots	List active bots
/remove @bot	Stop and remove a bot
/schedules	View all scheduled tasks across bots
/subscribe	Get a license or upgrade
/subscription	View billing & cancel
/feedback	Send feedback

Worker Bot

Any message	Talk to Claude Code
Photo / file	Include as context
/model	Switch model
/cost	Show token usage
/session	Get session ID to continue in CLI
/resume	Pick up a recent CLI session here
/preview <url>	Live browser screenshot
/navigate <url>	Go to a different URL
/browser	Show current page
/schedule	Schedule a recurring task
/schedules	List scheduled tasks
/unschedule	Remove a scheduled task
/new	Start fresh session
/cancel	Abort current operation

CLI Reference

Command	Description
clautel setup	Configure bot token, owner ID, and license
clautel start	Start the background daemon
clautel stop	Stop the daemon
clautel status	Check if the daemon is running
clautel logs	Tail the daemon logs
clautel activate <key>	Activate a license key
clautel deactivate	Free up the license activation slot
clautel license	Show current license status
clautel install-service	Install as macOS launchd service
clautel uninstall-service	Remove the launchd service

Pricing

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

7-day free trial on all plans

Pro

$4/mo

For personal projects

7-day free trial
Up to 5 project bots
Opus 4.6 (default)
Background daemon
Session continuity
Live browser preview
Scheduled tasks
macOS launchd integration
All future updates
Unlimited project bots
Group chat support

Get Pro

Popular

Max

$9/mo

For power users

7-day free trial
Unlimited project bots
Group chat support
Opus 4.6 (default)
Background daemon
Session continuity
Live browser preview
Scheduled tasks
macOS launchd integration
All future updates

Get Max

Requires a separate Claude Code subscription from Anthropic

What you can do from your phone

Everything you do in your Claude Code CLI works in Clautel. Plan mode, audits, research, refactors, debugging. Plus features you only get with Clautel.

Audit the auth module for security issues

Claude enters plan mode, reads every file in the module, identifies vulnerabilities, and presents a prioritized fix plan. Same deep analysis as your terminal.

Research how Stripe handles idempotency and apply it to our payment endpoint

Claude reads Stripe docs, studies your codebase, then implements idempotency keys in your payment handler. Full research-to-code, from your phone.

/preview localhost:3000

Live screenshot of your dev server appears in chat. Tap to click, scroll, type. Interactive browser controls, no port forwarding.

/resume

See your recent CLI sessions with timestamps and context previews. Tap one to continue exactly where you left off. Full history intact.

Refactor the user service to use the repository pattern

Claude reads the existing service, creates the repository interface, migrates all data access, updates tests. Multi-file refactor you review in chat.

/schedule run tests and send me a summary every morning at 9am

Claude parses your natural language, creates a cron job, and asks you to confirm. Tasks run autonomously, persist across restarts, and results land in your Telegram chat.

/session

Get the session ID to continue this Telegram conversation in your terminal. Or start in CLI and pick it up on your phone with /resume. Both directions.

Clautel vs Remote Control

Anthropic's official mobile client vs the open-source alternative

Feature	Remote Control	Clautel
Start new sessions from phone	No	Yes
Terminal needs to stay open	Yes	No (daemon)
Network timeout	~10 min disconnect	No timeout
Setup required each time	QR scan	One-time setup
Per-project isolation	No	Yes (separate bots)
Survives reboots	No	Yes (launchd service)
Live dev server preview	No	Yes
Persistent scheduled tasks	/loop (session-scoped, 3-day expiry)	Yes (cron, survives restarts)
Group chat support	No	Yes (Max plan)
Open source	No	Yes (MIT)

Still have questions?

Not sure if Clautel fits your workflow? Book a quick call with the creators. We'll walk you through the setup and answer anything.

Book a 15-min call