Feishu Claude Code

feishu-claude-code

在飞书里直接和你本机的 Claude Code 对话。

WebSocket 长连接，流式卡片输出，手机上随时 code review、debug、问问题。

复用 Claude Max/Pro 订阅，不需要 API Key，不需要公网 IP。

特性

**流式输出，实时可见**

• Claude 边想边输出，不是等半天发一坨
• 工具调用进度实时显示 (Bash、Read、Edit、Grep 等)
• 长回复自动分段，不丢内容

**跨设备 Session 管理**

• 手机上开始的对话，回到电脑前接着聊
• CLI 终端里的会话也能在飞书恢复 (/resume)
• 后台自动生成会话摘要，方便找回历史对话
• CLI Handover: 终端会话一键移交到飞书继续

**交互式按钮**

• Claude 给出选项时，自动渲染成可点击按钮
• Y/N 确认、编号选项、Plan 模式审批，一键响应
• 输入 / 显示命令菜单，按钮分组一目了然

**群聊支持**

• @机器人 即可对话，不 @ 的消息静默忽略
• 每个群独立 session、模型、工作目录
• /ws 为不同群绑定不同项目，多群并发互不阻塞

**图片识别**

• 直接发截图，Claude 自动下载并分析

**健壮运行**

• 新消息自动中断上一个运行中的任务 (优雅 SIGTERM + SIGKILL)
• 智能空闲超时: 检测子进程存活，编译/下载不会被误杀
• 看门狗 4 小时自动重启，防止 WebSocket 假死
• API 调用自动重试 (指数退避)

快速开始

前置条件

依赖	最低版本	验证命令
Python	3.11+	python3 --version
Claude Code CLI	最新	claude --version
Claude Max/Pro 订阅	-	claude "hi" 能正常回复

安装

git clone https://github.com/joewongjc/feishu-claude-code.git
cd feishu-claude-code

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
# 编辑 .env，填入飞书应用凭证（见下方「飞书应用配置」）

python3 main.py

预期输出：

🚀 飞书 Claude Bot 启动中...
   App ID      : cli_xxx...
✅ 连接飞书 WebSocket 长连接（自动重连）...

从旧版升级的用户可运行 `python3 migrate_sessions.py` 迁移 session 数据（会自动备份）。

命令速查

输入 `/` 可弹出按钮菜单，也可以直接输入命令。

会话管理

命令	说明
/new	开始新 session
/new plan	新 session 并进入 Plan 模式
/resume	列出历史 session（按钮选择）
/resume 3	恢复第 3 个 session
/stop	停止当前运行中的任务
/status	查看当前 session 信息

模型与模式

命令	说明
/model opus	切换到 Opus
/model sonnet	切换到 Sonnet
/model haiku	切换到 H