程序员阿江(Relakkes)
814c02a786
Connecting Feishu meant creating a bot by hand on the open platform and pasting an App ID and App Secret back. Feishu also exposes an RFC 8628 device-authorization flow, so the desktop can now render a QR code, and confirming it in the app creates the bot and stores its credentials directly. `adapters/feishu/registration.ts` implements that protocol rather than importing `registerApp` from `@larksuiteoapi/node-sdk@1.73`: the repository pins 1.60 for the chat client, and the SDK runs the whole poll inside one un-cancellable promise where the desktop needs the stateless begin/poll pair the DingTalk registration already uses. The scan is create-only, so it can never rewrite the configuration of a bot the user already runs, and it pre-fills exactly the scopes, events and callbacks this adapter calls. International tenants finish on Lark's domain, which is now persisted and honoured by the client. WeCom, QQ and Slack join the same session model. WeCom and QQ bind by scanning; Slack has no scan flow, so it uses an app manifest that pre-fills the scopes and Socket Mode. All three run over long connections, so no public callback URL is needed, and all three accept private chats only — pairing authorizes one person, and answering in a group would extend that authorization to everyone else in the room. They are built on a new `adapters/common/chat-runtime.ts` instead of a fourth copy of the loop the five existing adapters each carry. A platform supplies a `ChatPort` — how to say something, how to open a streaming reply, optionally how to send an image — and the runtime owns pairing, command routing, session restore, permission bookkeeping and the translation of the server's stream. The existing five are deliberately left on their own copies; migrating them is a separate change with its own regression surface. Attachments are downloaded through a deferred loader that runs after the pairing gate and inside the per-chat queue. Resolving them eagerly would let an unpaired stranger make the adapter fetch bytes and write them under ~/.claude/im-downloads — on Slack with the bot token attached — and would let a slow attachment overtake a text message sent after it. The sidecar launcher's per-adapter branches become one table. It is declared above the mode dispatch on purpose: `runAdapters` is hoisted and runs at module top level, so a table declared below it is still in its temporal dead zone when the adapters mode reads it — which type checks, lints and unit tests all miss, and only the compiled binary reveals. Verified with the checks `check:impact` selects: adapters, server, desktop, electron, policy, chat-contract, agent-flow, docs, native (sidecar compile, packaging and an adapters-mode smoke against the real binary) and coverage. The scan flows themselves are not verified against live platforms — that needs real WeCom, QQ and Slack accounts and would create real bots. Claude-Session: https://claude.ai/code/session_01CCGoP316AK7wdQG3Ms6Uwq
8.7 KiB
title, nav_title, description, order
| title | nav_title | description | order |
|---|---|---|---|
| IM 接入 | 总览 | 把飞书、Telegram、微信、钉钉、WhatsApp、企业微信、QQ 或 Slack 的私聊接到桌面端，用手机继续同一条会话。 | 0 |
IM 接入
桌面端跑着的会话，可以接到你手机上的 IM 里。绑定之后，在飞书、Telegram、微信、钉钉、WhatsApp、企业微信、QQ 或 Slack 的私聊里发一句话，就是在驱动本机的 Claude Code：出门前让它跑一个长任务，路上用手机看进度、批权限、换项目。
对话对象是你自己绑定的机器人或账号，消息只经过你本机的桌面端，没有中间服务器托管你的代码。
接进来之后能做什么
- 接着聊同一条会话：手机上发的消息进的是本机的 Claude Code 会话，改文件、跑命令、读代码都在你电脑上真实发生。
- 换项目：发
/projects列出最近用过的项目，回复编号或路径就切过去；/new直接开一条新会话。 - 批权限：Claude 要写文件或执行高风险命令时，会把请求推到 IM 里。飞书和钉钉是可点的卡片，Telegram 是按钮，其余平台回复一条文本命令。
- 看状态、叫停：
/status看当前项目、模型和运行状态，/stop中断正在跑的这一轮。
前提是桌面端一直开着。IM 侧只是遥控器，真正干活的是你的电脑。
选哪个平台
八个平台的能力是同一套，差别在接入成本和审批体验。
| 平台 | 怎么接 | 适合谁 | 已知限制 |
|---|---|---|---|
| 飞书 | 在设置页扫码，直接创建机器人并写入凭据 | 国内团队，想要点按钮就能批权限 | 只处理单聊，不处理群聊；改机器人菜单要去开放平台发版本 |
| Telegram | 找 @BotFather 要一个 Bot Token，粘进设置页 |
能连上 Telegram 的个人用户，接入最快 | 只处理私聊；国内网络下需要自己解决连通性 |
| 微信 | 在设置页扫码登录机器人账号 | 只想用微信、不愿再装一个 App | 只处理私聊；权限审批只能回复文本命令 |
| 钉钉 | 在设置页扫码授权，Client ID 和 Secret 自动写入 | 国内企业，钉钉是主力办公工具 | 只处理单聊；要卡片审批得额外配一个模板 ID |
| 用手机 WhatsApp 的「已关联设备」扫码 | 海外用户 | 走个人号的 Web 登录，不是官方 Cloud API；只处理个人私聊 | |
| 企业微信 | 在设置页扫码，直接创建智能机器人 | 用企业微信办公的团队 | 只处理单聊；权限审批只能回复文本命令 |
| 在设置页扫码授权，AppID 和 AppSecret 自动写入 | 习惯用 QQ 的个人用户 | 只处理私聊，不处理群和频道；权限审批只能回复文本命令 | |
| Slack | 用预填好的应用清单创建 App，回填两枚 Token | 海外团队 | 只处理私信；没有扫码流程，要手动粘贴 Token |
拿不定主意就先接 Telegram 或飞书，两者的权限审批体验最好。
配对流程
所有平台的绑定都分两层：先让桌面端拿到平台凭据，再让你这个 IM 账号本人通过配对码获得授权。第二层所有平台都一样。
- 打开「设置」→「IM 接入」。
- 在下方的平台 Tab 里完成绑定：飞书、微信、钉钉、WhatsApp、企业微信、QQ 扫码，Telegram 和 Slack 填凭据。
- 在「默认项目」里挑一个目录。
- 点「保存」。
- 回到顶部的「配对管理」，点「生成配对码」，拿到一枚 6 位码。
- 在对应 IM 里私聊你的机器人，把这 6 位码发过去。
- 看到配对成功提示后，直接发消息就是在跟 Claude Code 对话。
配对码 60 分钟内有效，只能用一次，重新生成后旧码立刻作废。同一枚码是平台无关的，发到哪个平台就绑哪个平台的账号。同一个用户 5 分钟内连续输错 5 次会被限流。
生成配对码和扫码绑定都会立即写入本机配置，不需要再点「保存」；App ID、Bot Token、「允许的用户」和「默认项目」这类手填内容才需要。
配对成功的账号会出现在「已配对用户」列表里，点右侧的「解绑」即可撤销，被解绑的人要重新发一枚新码。
默认项目决定它在哪干活
「默认项目」是新建 IM 会话的工作目录。填了它，手机上发的第一句话就直接在这个目录下开会话；留空的话，机器人会先把最近用过的项目列出来让你选。
同一个 IM 聊天窗口后续的消息会复用同一条会话，桌面端重启后也能接回去。想换目录发 /new，想清空上下文但保留项目发 /clear。
允许访问的项目目录决定它能碰哪些项目
「默认项目」只决定新会话开在哪，不是访问边界。真正的边界是「允许访问的项目目录」：机器人只能列出、打开并在这些目录内的项目里开会话，/projects、/sessions 和按名字、绝对路径选项目都受它约束。
留空就是默认值——你的主目录（如果「默认项目」是主目录之外的某个具体项目目录，也一并包含）。绝大多数人不需要动它。想收紧到某几个目录，就在设置里把它们加进列表。
配置写在 ~/.claude/adapters.json，也可以按平台单独收紧：
{
"allowedProjectRoots": ["~/work", "~/side"],
"whatsapp": { "allowedProjectRoots": ["~/work/sandbox"] }
}
平台级配置替换（不是叠加）全局配置：上面这份配置里 WhatsApp 只能碰 ~/work/sandbox，其余平台是 ~/work 和 ~/side。桌面端设置界面改的是全局那一份，某个平台单独配过之后，界面上的改动就不会影响它了。
独立运行 adapter（不走桌面端）时也可以用 ADAPTER_ALLOWED_PROJECT_ROOTS 环境变量，多个目录用路径分隔符隔开（macOS / Linux 是 :，Windows 是 ;）。这个环境变量比配置文件里的两层都优先。
几条边界规则：
- 目录必须是已存在的绝对路径（
~会展开）。写不存在的路径会被忽略并打日志；一个都解析不出来时回退到默认值，而不是把机器人锁死。 - 默认值不会自动继承
/或/Users这类目录。桌面端以 GUI 方式启动时 sidecar 的工作目录是/，直接拿来当边界等于没有边界。 - 「默认项目」如果落在允许范围之外，新会话会开在列表里第一个允许的目录，并打一条日志——这样
/new不会因为两处配置不一致而失败。
配对仍然是第一道关：没配对的人根本发不了命令，这份目录列表是在此之上的第二道防线。注意主目录里也包含 ~/.claude、~/.ssh 这些敏感目录，需要更强隔离就显式收紧到具体的项目目录。
通用命令
各平台的入口略有差异（飞书可以把命令配成机器人菜单），但这几条到处都能用：
/help— 列出当前可用命令/status— 当前项目、模型、运行状态/projects— 列出最近项目并切换/new— 开一条新会话，可带项目编号或路径/clear— 清空上下文，保留项目绑定/stop— 停止本轮生成
飞书、微信、钉钉、企业微信、QQ 和 Slack 还支持中文别名，例如 帮助、状态、项目列表、新会话、清空、停止。
安全须知
::: warning 这是一把能改你电脑的遥控器 配对成功的 IM 账号可以让 Claude 在你本机读写文件、执行命令。只把配对码发给你自己，别在群里贴，也别把机器人凭据提交进仓库。 :::
授权规则是「允许的用户」加已配对用户取并集，两者都为空时一律拒绝。扫码绑定只是让桌面端拿到账号凭据，不等于放行这个账号的所有联系人。
平台凭据、配对状态和授权名单保存在 ~/.claude/adapters.json，聊天窗口到会话的映射保存在 ~/.claude/adapter-sessions.json。这两个文件都在本机，含有可直接操控你机器的凭据，不要外传。设置页读回配置时敏感字段会被打码。
想在手机浏览器里获得完整界面而不只是聊天，看H5 访问。