tg-claude

[](LICENSE) [](https://nodejs.org) [](https://claude.ai/claude-code)

Personal Telegram bot that turns your Mac into a remote Claude Code terminal. Send messages from your phone — get full Claude Code CLI responses with tool access (Bash, Read, Write, Edit, Grep, etc.).

Single-user, owner-only. Not a multi-user service — one bot, one Telegram account, one Mac. Designed for developers who want to control their own machine remotely.

Not an API wrapper. Spawns the real Claude Code CLI process.

Phone (Telegram) → Bot (Node.js) → Claude Code CLI → response → Bot → Phone

git clone https://github.com/Imolatte/tg-claude.git
cd tg-claude && cp config.example.json config.json
# Edit config.json with your bot token and chat ID
cd worker && npm install && node index.mjs

• Work from your phone when away from desk
• Run Claude Code remotely on your Mac
• Get dangerous operation approvals on your phone
• Quick system commands without opening laptop

• Text → Claude Code with full tool access
• Voice → Groq Whisper STT → Claude
• Photos → downloaded, passed to Claude for Vision analysis
• Files → downloaded with original extension, passed to Claude
• Forwards → analyzed by Claude (text before forward auto-combined)

Real-time updates as Claude works:

🔧 Read: /src/auth.ts
🔧 Edit: /src/auth.ts
🔧 Bash: npm test
📝 Writing response...

Token usage shown after each response: ↓3.2k ↑17k · 4.5s

• Auto-resume sessions across messages (--resume)
• /sessions — inline keyboard to switch/delete sessions
• /new [name] — new session; /name <title> — rename
• /detach — disconnect; /cd <path> — change working directory