Package Exports

chat-heimerdinger
chat-heimerdinger/dist/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (chat-heimerdinger) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Chat Heimerdinger

IM 与 Claude Code 的桥接工具，让你在 Slack 或飞书中直接与 Claude Code 进行对话式编程。

功能特性

多平台支持：支持 Slack 和飞书（Feishu/Lark）
项目管理：支持多项目切换，自动记忆每个频道的项目上下文
会话持久化：自动恢复上次对话，保持编程上下文连续性
语音消息：支持语音消息，自动转写为文字发送给 Claude Code
实时反馈：流式输出 Claude 的响应，实时显示代码修改
权限控制：支持权限审批流程，安全执行敏感操作

前置准备

1. Node.js 环境

需要 Node.js 18.0.0 或更高版本：

node -v  # 确认版本 >= 18.0.0

2. 安装 Claude Code

确保本机已安装并配置好 Claude Code：

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

3. 创建 IM Bot

根据你要使用的平台，选择对应的配置方式：

Slack 配置

访问 Slack API 创建新应用
选择 From an app manifest
导入本仓库的 slack-bot-demo.json 文件
安装应用到你的 Workspace
重要配置：进入 App Home -> Show Tabs：
- 开启 Messages Tab
- 勾选 **"Allow users to send Slash commands and messages from the messages tab"**（必须勾选，否则无法私聊 Bot）

获取 Token：

Token	位置
Bot Token (xoxb-)	OAuth & Permissions > Bot User OAuth Token
App Token (xapp-)	Basic Information > App-Level Tokens (需创建，scope 选 `connections:write`)
Signing Secret	Basic Information > App Credentials

飞书配置

访问飞书开放平台创建新应用
在 凭证与基础信息 中获取 App ID 和 App Secret
在 事件与回调 中：
- 订阅方式选择 使用长连接接收事件（推荐，无需公网 IP）
- 或选择 Webhook 方式（需要公网 URL）
- 添加事件 im.message.receive_v1
在 权限管理 中添加以下权限：
- im:message - 获取与发送单聊、群组消息
- im:message:send_as_bot - 以应用的身份发送消息
- im:resource - 获取与上传图片或文件资源
- im:chat:readonly - 获取群组信息
启用机器人能力并发布应用

获取凭证：

凭证	位置
App ID	凭证与基础信息 > App ID
App Secret	凭证与基础信息 > App Secret
Encrypt Key (Webhook 模式)	事件与回调 > Encrypt Key
Verification Token (Webhook 模式)	事件与回调 > Verification Token

快速开始

# 初始化配置（交互式选择 Slack 或飞书）
npx chat-heimerdinger init

# 启动服务
npx chat-heimerdinger start

使用

启动服务

# 后台运行（推荐）
npx chat-heimerdinger start

# 前台运行（调试）
npx chat-heimerdinger start -f

# 查看状态
npx chat-heimerdinger status

# 查看日志
npx chat-heimerdinger logs

# 停止服务
npx chat-heimerdinger stop

交互方式

Slack：

直接私信机器人
在频道中 @机器人
发送语音消息

飞书：

直接私信机器人
在群组中 @机器人

命令

命令	说明	平台
`/project`	切换项目	Slack
`/stop`	停止当前执行	Slack
`/clear`	清除会话，开始新对话	Slack

飞书暂不支持斜杠命令，可以直接发送 "切换项目"、"停止" 等文字指令。

配置文件

配置文件位于 ~/.heimerdinger/config.json：

Slack 配置示例：

{
  "activeAdapter": "slack",
  "adapters": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "signingSecret": "...",
      "socketMode": true
    }
  },
  "server": {
    "port": 3150
  },
  "claude": {
    "permissionMode": "acceptEdits"
  }
}

飞书配置示例：

{
  "activeAdapter": "feishu",
  "adapters": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket",
      "domain": "feishu"
    }
  },
  "server": {
    "port": 3150
  },
  "claude": {
    "permissionMode": "acceptEdits"
  }
}

权限模式

模式	说明
`default`	默认，需要确认敏感操作
`acceptEdits`	自动接受文件编辑
`bypassPermissions`	跳过所有权限检查（危险）

飞书连接模式

模式	说明
`websocket`	长连接模式（推荐），无需公网 IP
`webhook`	Webhook 模式，需要公网 URL

飞书域名

域名	说明
`feishu`	feishu.cn（中国区）
`lark`	larksuite.com（国际区）

语音转文字（可选）

需要安装 whisper.cpp：

# 编译 whisper.cpp
git clone https://github.com/ggerganov/whisper.cpp
cd whisper.cpp && make

# 安装到系统
sudo cp build/bin/whisper-cli /usr/local/bin/

# 下载模型
mkdir -p ~/.local/share/whisper
bash models/download-ggml-model.sh small ~/.local/share/whisper

还需要 ffmpeg 进行音频格式转换：

sudo apt install ffmpeg  # Ubuntu/Debian
brew install ffmpeg      # macOS

全局安装（可选）

如果你经常使用，可以全局安装以省去 npx 前缀：

npm install -g chat-heimerdinger

# 之后可以直接使用
hmdg start
hmdg status
hmdg stop

从源码安装

# 克隆项目
git clone https://github.com/a1245582339/chat-heimerdinger.git
cd chat-heimerdinger

# 安装依赖
pnpm install

# 构建
pnpm build

# 全局链接
pnpm link --global

注意事项

项目必须已初始化：需要先在项目目录中使用过 Claude Code，才能在 IM 中选择该项目
权限配置：确保 Bot 已添加所有必要的权限
语音功能可选：如不需要语音转文字，可跳过 whisper.cpp 安装
网络要求：
- Slack：需要能访问 Slack API（Socket Mode 使用 WebSocket）
- 飞书：WebSocket 模式需要能访问飞书开放平台；Webhook 模式需要公网可访问的 URL

开发

# 构建
pnpm build

# link
pnpm link

# 格式化
pnpm format

License

MIT