MateCode - Claude Code Telegram Bridge

Name: matecode
Rating: 76
Author: aresbit

通过 Telegram 远程控制 Claude Code。

快速命令

bash

# 启动服务
./matecode.sh start

# 停止服务
./matecode.sh stop

# 重启服务
./matecode.sh restart

# 查看状态
./matecode.sh status

# 查看日志
./matecode.sh logs

bash

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt-get install tmux

从 @BotFather 获取 bot token，然后设置环境变量：

bash

export TELEGRAM_BOT_TOKEN="your_token_here"
# 添加到 ~/.zshrc 或 ~/.bashrc 使其永久生效
echo 'export TELEGRAM_BOT_TOKEN="your_token_here"' >> ~/.zshrc

bash

cp hooks/send-to-telegram.sh ~/.claude/hooks/
nano ~/.claude/hooks/send-to-telegram.sh  # 编辑设置 bot token
chmod +x ~/.claude/hooks/send-to-telegram.sh

添加到 ~/.claude/settings.json:

json

{
  "hooks": {
    "Stop": [{"hooks": [{"type": "command", "command": "~/.claude/hooks/send-to-telegram.sh"}]}]
  }
}

文件	用途
`matecode.sh`	主启动脚本
`bridge.py`	Telegram 桥接服务
`hooks/send-to-telegram.sh`	Claude 响应钩子
`start_bridge.sh` / `stop_bridge.sh`	单独控制 bridge

bash

# 检查环境变量
echo $TELEGRAM_BOT_TOKEN

# 检查端口占用
lsof -i :8081

# 查看详细日志
cat bridge.log
tail -f bridge.log

bash

# 手动连接到会话
tmux attach -t claude

# 强制关闭所有相关进程
pkill -f "bridge\.py"
tmux kill-session -t claude