Environment Variables

Required

Bot token from BotFather. Used to authenticate with the Telegram Bot API.

Example: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Obtain via: send /newbot to @BotFather.

Comma-separated list of Telegram user IDs who are allowed to use the bot. All other users are silently ignored.

Example: 111222333,444555666

To find your Telegram user ID, message @userinfobot.

Default: claude

Path to the Claude Code binary. Set this if claude is not on your PATH.

Default: sonnet

Model used for all Claude Code sessions. Valid values: haiku, sonnet, opus.

Default: ./sessions

Root directory for all user workspace data. Each user gets a subdirectory named by their chat ID.

Default: 600000 (10 minutes)

Idle timeout in milliseconds. The Claude subprocess is terminated after this long with no incoming messages.