uv tool install git+https://github.com/RichardAtCT/claude-code-telegram@v1.3.0
```bash
pip install git+https://github.com/RichardAtCT/claude-code-telegram@v1.3.0
```bash
git clone https://github.com/RichardAtCT/claude-code-telegram.git
cd claude-code-telegram
make dev
```bash
# 复制示例配置
cp .env.example .env

# 编辑配置
nano .env
```textenv
TELEGRAM_BOT_TOKEN=1234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
TELEGRAM_BOT_USERNAME=my_claude_bot
APPROVED_DIRECTORY=/Users/yourname/projects
ALLOWED_USERS=123456789
```bash
# 生产环境运行
make run

# 调试模式运行
make run-debug
```text
You: Can you help me add error handling to src/api.py?
Bot: I'll analyze src/api.py and add error handling...
Claude: [分析代码并提出改进建议]

You: Looks good. Now run the tests.
Bot: Running pytest...
Claude: All 47 tests passed.
```bash
# 服务器上认证
gh auth login

# 对话操作
You: List my repos related to monitoring
Claude: [运行 gh repo list]

You: Clone the uptime one
Claude: [克隆到 workspace]
```textenv
ENABLE_PROJECT_THREADS=true
PROJECT_THREADS_MODE=private
PROJECTS_CONFIG_PATH=config/projects.yaml
```textenv
ENABLE_API_SERVER=true
GITHUB_WEBHOOK_SECRET=your_secret
```textenv
ENABLE_SCHEDULER=true
```textenv
NOTIFICATION_CHAT_IDS=123,456
```text
claude-code-telegram/
├── src/                    # 源代码
├── tests/                  # 测试
├── docs/                    # 文档
├── config/                  # 配置文件
├── .github/workflows/       # GitHub Actions
├── .env.example             # 环境变量示例
├── pyproject.toml           # Python 项目配置
├── poetry.lock              # 依赖锁定
├── Makefile                # 构建脚本
└── README.md              # 项目文档
```bash
# SDK 模式（默认）
claude auth status
# 或检查 ANTHROPIC_API_KEY

# CLI 模式
claude --version
claude auth status
```textenv
CLAUDE_MAX_COST_PER_USER=10.0  # 每用户 10 美元上限