claude-link 0.2.1

Connect Claude Code to Telegram in one command

claude-link

Control Claude Code from your phone. Nothing more.

Phone → Telegram → claude-link → Claude Code → response → Phone

claude-link is not a bot. It has no AI, no logic, no cloud servers. It's a bridge — it forwards messages between Telegram and the Claude Code CLI running on your machine.

You start it when you want. You stop it when you're done. That's it.

Your existing Claude Code config, skills, CLAUDE.md, and project context — all there, because it's the same session running on your computer.

Install

pip install claude-link

Run

claude-link

Just the first time, it walks you through connecting your Telegram bot. Takes 2 minutes.

No daemon, no background process, no always-on server. It lives while your terminal lives.

Terminal output

[12:35:10] 📩 Message from Santiago: "list my projects"
[12:35:10] 🤖 Claude working...
[12:35:11]    📖 Reading CLAUDE.md
[12:35:12]    ⚙️ Running: ls ~/projects
[12:35:14] ✅ Done (4s)
[12:35:14] 📤 Reply: "You have 3 projects..."

Commands

/cancel — stop current task and clear queue · /new — fresh conversation · /status — bot info · /help — all commands

Voice messages supported with claude-link --enable-voice (requires OpenAI key).

Prerequisites

• Claude Code installed and authenticated
• Python 3.10+
• A Telegram bot token (from @BotFather)
• Your Telegram Chat ID (from @userinfobot)

Security

Single-user only. Config stored with restricted permissions. No shell injection. Nothing stored remotely. Unauthorized attempts logged.

License

MIT