claude-channel-feishu: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

Feishu Channel - Claude Code 的飞书 (Feishu/Lark) 通道插件，实现双向消息桥接。

核心功能：

• 通过飞书私聊和群聊与 Claude Code 交互
• 内置访问控制：配对流程、白名单、策略管理
• WebSocket 长连接模式：本地开发无需公网 IP
• 权限请求转发：将 Claude Code 的权限请求推送到飞书让用户批准

常用命令

# 安装依赖
bun install

# 启动服务 (开发)
bun server.ts

# 启动服务 (生产)
bun run start

环境变量

FEISHU_APP_ID=cli_xxxxx      # 必需：飞书应用 ID
FEISHU_APP_SECRET=xxxxx      # 必需：飞书应用密钥
FEISHU_ENCRYPT_KEY=          # 可选：事件解密密钥
FEISHU_DOMAIN=feishu         # "feishu" (国内) 或 "lark" (国际版)
FEISHU_ACCESS_MODE=dynamic   # "dynamic" (默认) 或 "static"

架构

┌─────────────────────────────────────────────────────┐
│  Claude Code                                         │
│  └── MCP Client (stdio)                             │
└─────────────────────┬───────────────────────────────┘
                      │ stdin/stdout
┌─────────────────────▼───────────────────────────────┐
│  server.ts (单文件架构)                              │
│  ├── MCP Server (tools, notifications)              │
│  ├── Access Control (pairing, allowlist)            │
│  ├── Permission Relay (请求转发)                     │
│  └── Feishu WebSocket Client                        │
└─────────────────────┬───────────────────────────────┘
                      │ WebSocket
┌─────────────────────▼───────────────────────────────┐
│  飞书服务器                                          │
│  └── Message Events                                 │
└─────────────────────────────────────────────────────┘

核心组件 (server.ts)

MCP Tools (3 个)

Tool	描述
reply_to_feishu	发送消息到飞书聊天
reply_with_reaction_feishu	添加表情反应
manage_feishu_access	管理访问控制 (list/pair/allow/remove/policy/group_add 等)

访问控制

配置文件：~/.claude/channels/feishu/access.json

策略	行为
pairing (默认)	未知用户收到配对码，丢弃消息
allowlist	静默丢弃未知用户消息
disabled	丢弃所有私聊

群组默认关闭，需要用 /feishu:access group add <chat_id> 启用。