⚠️ Hard requirement — read this first
You MUST have an active Claude paid subscription AND the Claude Code CLI installed and logged in (claude login) on the same machine.
vansh-claude does NOT use an Anthropic API key. There is no API-key code path in this repository at all — grep -r "anthropic-ai/sdk" . returns zero matches.
Instead, it spawns claude -p (the official Claude Code headless mode) as a subprocess and rides on your subscription's auth that lives at ~/.claude/. If you don't have an active subscription and a working claude --print "hi" locally, the wizard will refuse to start any bot.
By running vansh-claude you accept Anthropic's Terms of Service and are responsible for compliance — including any policy or limits around headless / automated / multi-user usage of your subscription. Not affiliated with, endorsed by, or sponsored by Anthropic.
📑 Table of contents
🚀 What is vansh-claude?
vansh-claude is a daemon that bridges Telegram bots to Claude Code sessions, with per-bot, per-chat, per-topic isolation on disk. Every Telegram conversation gets its own real directory on your machine with its own Claude Code session, transcript, system prompt, MCP servers, skills, and to-do list. You can cd into any of them over SSH and continue from the terminal exactly where Telegram left off.
In one sentence:
"Each Telegram chat / topic / bot = a folder on disk with its own Claude Code session, with live streaming replies and admin-only access."
It's the missing operator-grade UX for running Claude Code remotely: multi-bot, multi-topic, organized-on-disk, Telegram-native, and subscription-powered with zero API-key dependency.
💡 Why does it exist?
There are good tools in this space, but each has gaps:
| Existing tool | What it gives | What's missing |
|---|
| Anthropic's official Telegram plugin | Single bot ↔ single Claude session, beautiful streaming | No multi-bot, no topic isolation, no scheduling, no multi-tenancy |
| claude-octopus | Multi-LLM orchestration inside Claude Code | No Telegram, no remote-from-phone access |
| octogent | Web dashboard over multiple Claude sessions | Web-only, no Telegram, requires browser |
Plain claude over SSH | Fully featured, native | Not accessible from your phone via Telegram |
vansh-claude fills the gap: multi-bot, multi-topic, organized-on-disk, Telegram-native, subscription-powered. Built for the operator who wants to run their Claude subscription from anywhere.
✨ Feature highlights
