FeishuClaudeCodeBridge 是一个本机常驻服务，用飞书机器人把消息转给本机 Claude Code CLI，再把 Claude Code 的文本结果回到飞书。
它适合已经在本机使用 Claude Code、同时希望通过飞书私聊或群聊交代任务的人。
本项目结构参考 LpcPaul/FeishuCodexBridge，执行层从 Codex CLI 改为 Claude Code CLI。
- 在飞书里和本机 Claude Code 对话。
- 私聊主 Bot 自动管理长期上下文和话题切换。
- 群聊里 @ 机器人后启动一个独立 Claude Code 会话。
- Claude Code 长任务执行时，Bridge 保持任务上下文，不会因为 2 小时空闲规则切走话题。
- 回复默认按手机通信软件可读格式约束：先给结论/摘要/判断，短段落，内容长时先给第一层摘要。
- 不是飞书版终端。
- 不是飞书工作流平台。
- 不做 Claude Code 执行过程可视化。
- 不做结果卡片模板；Claude Code 最终返回什么，就按文本转发什么。
- 不内置飞书文档、表格、多维表格或任务能力；这些由 Claude Code 自己通过正常工具路线处理。
你需要先准备两样东西：
- 本机已经安装并登录 Claude Code CLI。
- 一个飞书自建应用机器人的
App ID和App Secret。
飞书机器人创建步骤见 docs/feishu-app-setup.md。
如果你希望后续直接使用卡片按钮、飞书文档或一条命令创建群组，建议第一次配置应用时就按 docs/initial-permissions.md 把权限一次性申请好。
安装完成后还需要按 docs/post-install.md 做一次飞书后台验收：尤其要把 card.action.trigger 放到「已订阅的回调」并发布新版应用，否则点击卡片按钮会报 code: 200340。
macOS 用户可以运行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/LpcPaul/FeishuClaudeCodeBridge/main/remote-install.sh)"脚本会提示你输入：
Feishu App IDFeishu App Secret
然后自动完成：
- 安装 Python 依赖。
- 探测
claude和node路径。 - 写入本机
.env.feishu。 - 安装 launchd 后台服务。
- 启动 Bridge。
如果你不想使用远程安装脚本，也可以手动安装：
git clone https://github.com/LpcPaul/FeishuClaudeCodeBridge.git
cd FeishuClaudeCodeBridge
./install.sh./bridge status
./bridge restart
./bridge logs
./bridge follow-logs
./bridge uninstall默认运行目录：
~/Library/Application Support/FeishuClaudeCodeBridge
状态数据库：
~/Library/Application Support/FeishuClaudeCodeBridge/state.sqlite
- 私聊机器人：进入长期主 Bot 入口，由 Bridge 管理话题切分。
- 群聊 @ 机器人：启动一个新的 Claude Code 对话。
- 群聊消息回复串：继续同一个 Claude Code 对话。
/new或新会话：当前飞书容器重新开始一个 Claude Code 对话。/clear或清空上下文：清空当前飞书容器绑定的 Claude Code 对话。/status或当前会话：查看当前飞书容器绑定的 Claude Code 会话。继续上个话题：私聊主 Bot 切回上一个话题。
安装后配置文件在：
~/Library/Application Support/FeishuClaudeCodeBridge/app/.env.feishu
常用变量：
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx
FEISHU_CLAUDE_CODE_WORKDIR="$HOME"
PYTHON_BIN=/path/to/python3
NODE_BIN=/path/to/node
CLAUDE_BIN=/path/to/claude
CLAUDE_PERMISSION_MODE=auto
CLAUDE_MODEL=
CLAUDE_ALLOWED_TOOLS=
CLAUDE_DISALLOWED_TOOLS=
CLAUDE_EXTRA_ARGS=
FEISHU_TOPIC_IDLE_SECONDS=7200
FEISHU_TASK_PROGRESS_SECONDS=7200
FEISHU_ACK_TEXT="收到，我要开始干活了，稍等我"Bridge 默认用 Claude Code 非交互模式运行：claude -p --output-format json，已有会话用 --resume <session_id> 延续。CLAUDE_PERMISSION_MODE=auto 适合飞书触发的后台任务；如果希望更保守，可改成 plan 或 default。
当前版本：0.1.1
版本记录见 CHANGELOG.md。