电脑上的Claude、Codex如何用飞书微信访问? | cc-connect 上手指南

我的日常工作中已经深度依赖各种Agent了,但是对于Claude、Codex这些没有官方订阅的,只能在电脑前用,离开电脑很不方便。
今天给大家推荐的这款工具,可以将Claude、Codex、OpenCode、Kimi Code等软件像龙虾一样接入你的微信、飞书、钉钉等软件,实现在手机上操作。
闲话少叙,我们发车~
一、cc-connect 能做什么
支持的 AI Agent(10+)
Claude Code、Codex、Cursor Agent、Gemini CLI、Qoder CLI、OpenCode、iFlow CLI、Kimi CLI、Pi、Devin 等;只要遵循 ACP 协议,任意兼容 Agent 都能接进来。
支持的聊天平台(13 个)
飞书、钉钉、企业微信、微信个人号、Telegram、Slack、Discord、LINE、QQ、QQ 官方机器人、微博、金山协作(WPS Xiezuo)、Matrix。
其中飞书 / 钉钉 / 微信 / Telegram / Slack / Discord / QQ / 金山协作 / Matrix 等靠 WebSocket、长轮询或长连接主动向外建链,无需公网 IP;只有 LINE 和企业微信的 Webhook 模式需要配公网地址(企业微信用 WebSocket 模式同样免公网)。
几个值得一提的能力
- Web 管理后台:浏览器里可视化管项目、配服务商、看会话、改定时任务,还能直接在网页和 Agent 对话(用
cc-connect web启动,引入版本以官方文档为准)。 - 多 Agent 编排:在群聊里绑定多个机器人,让 Claude 和 Gemini 互相配合,一个对话里集思广益。
- 自然语言定时任务:发一句「每天早上 6 点总结 GitHub Trending」,自动转成 cron。
- 多模态:发语音或截图,cc-connect 自动做语音识别 / 多模态转发。
- OS 用户隔离(Linux / macOS):用不同 Unix 用户身份启动 Agent,实现文件系统级隔离。
二、安装
cc-connect 是单个二进制,安装方式很多,挑顺手的来。
方式 1:npm(推荐,跨平台,我用的这种方式)
# 稳定版
npm install -g cc-connect
# 想要微信个人号等 beta 功能
npm install -g cc-connect@beta
方式 2:Homebrew(macOS / Linux)
brew install cc-connect
方式 3:下载二进制
去 GitHub Releases 找对应平台(linux-amd64、darwin-arm64、windows-amd64 等),例如 Linux:
curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64
chmod +x cc-connect
sudo mv cc-connect /usr/local/bin/
方式 4:源码编译(需要 Go 1.22+)
git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build
装完验证一下:
cc-connect --version
三、配置文件
cc-connect 所有配置都在 ~/.cc-connect/config.toml。首次使用先准备一份模板:
mkdir -p ~/.cc-connect
cp config.example.toml ~/.cc-connect/config.toml # 见下方说明
注:
config.example.toml随安装包提供(npm 装在全局node_modules/cc-connect/下,或二进制同目录)。不确定在哪就用cc-connect启动时看报错提示,或直接到 GitHub 仓库的config.example.toml复制。
一份典型的配置长这样(具体字段以你手里的 config.example.toml 为准,下面是结构示意):
language = "zh"
# 服务商 API Key 通过环境变量注入,不要直接写进文件
[[providers]]
name = "anthropic"
api_key = "${ANTHROPIC_API_KEY}"
[[providers]]
name = "openai"
api_key = "${OPENAI_API_KEY}"
# 一个项目 = 一个 Agent + 一个聊天平台
[[projects]]
name = "myapp"
admin_from = "你的用户ID" # 谁能执行高危命令(如 /shell),强烈建议填上
[projects.agent]
type = "claudecode" # 可选 claudecode / codex / gemini / cursor ...
[projects.agent.options]
work_dir = "/path/to/your/project" # Agent 的工作目录,建议用绝对路径
[[projects.platforms]] # 平台是数组,可配多个
type = "feishu" # 平台凭证同样走环境变量
[projects.platforms.options]
app_id = "${FEISHU_APP_ID}"
app_secret = "${FEISHU_APP_SECRET}"
allow_from = "*" # 允许给机器人发消息的用户白名单,建议改成你自己的 open_id
几个要点:
- 凭证走环境变量:API Key、平台 App Secret 都通过
${ENV_VAR}注入,别明文写进配置文件,也别提交到 git。 - 权限限制一定要设:项目级
admin_from控制谁能跑高危命令(如/shell),平台级allow_from控制谁能给机器人发消息——两者都填上你自己的用户 ID,避免别人拿你电脑干活(详见第六节安全加固)。
四、连接一个聊天平台(以飞书为例)
飞书有两种接法,新手建议第一种。
接法 A:扫码即连(最省事)
cc-connect 自带 Web 管理面板。启动后在面板里点「Add project」→ 填项目名和工作目录 → Agent 选 Claude Code → 聊天平台选 Feishu / Lark → 点「Start QR Setup」,面板弹出二维码,用手机飞书扫一下授权就连通了。全程不用去飞书开放平台建应用、不用填 App ID / Secret。
接法 B:手动建飞书应用
- 去 飞书开放平台 创建一个企业自建应用,启用机器人能力。
- 开通权限:
contact:user.base:readonly(识别用户身份)im:message.p2p_msg:readonly(读取私聊消息)im:message:send_as_bot(机器人发消息)
- 事件订阅开启
im.message.receive_v1和card.action.trigger,使用长连接接收事件(无需公网)。 - 发布应用,拿到 App ID 和 App Secret,填进上面的配置。
- 其他平台(钉钉、Telegram、Slack、Discord、QQ 等)流程类似,具体看仓库里的 Platform Setup Guides,多数同样是「建应用拿凭证 → 填配置」。
五、启动与测试
开一个新终端(千万别在 Claude Code 会话里启动,见第十节),直接运行:
cc-connect
看到日志里输出 connected,说明平台 WebSocket 已经连上。
去聊天软件里搜索你的机器人,发一条 /whoami 测试,能正常回复就成功了。
六、安全加固(别跳过)
扫码或建应用只是「能用了」,但默认下谁给机器人发消息都可能使唤你电脑。务必做两步:
- 权限模式选
default:每个动作都要你在手机上点确认。别选bypassPermissions(那是 yolo 全自动,危险)。 - 限制可用用户:在配置或面板里把
admin_from和平台allowed_users都填成你自己的用户 ID,这样只有你能跑高危命令,别人发的不认。
那「你的用户 ID」去哪查?先打开 Inject sender(注入发信人),重启 cc-connect,然后用飞书给机器人随便发一句,Agent 收到的消息会带上你的发信人 ID —— 让它回给你,或看 cc-connect 运行窗口打印的信息,把那串 ID 填回 admin_from 和 allowed_users 即可。
嫌麻烦可以先填
*让自己先能用,但别长期用*—— 那等于谁都能使唤你电脑。
七、常用聊天命令
连上之后,在聊天框里用斜杠命令指挥:
| 命令 | 作用 |
|---|---|
/new |
开新的一轮对话,清空之前上下文 |
/mode yolo |
切全自动模式,Agent 不再问你要不要执行 |
/quiet |
关掉「正在思考…」这类提示消息 |
/stop |
中断当前任务 |
/help |
查看所有命令 |
/list |
列出所有项目 |
/switch |
切换当前项目 |
/model |
切换模型 |
/reasoning |
调整推理强度 |
/memory |
读写 Agent 的记忆文件,不用碰终端 |
/dir |
切换下次会话的起始目录 |
/shell |
直接执行 shell 命令(高危,受 allow_from 限制) |
/cron |
管理定时任务 |
Agent 执行操作时通常会问你「让不让干」,回复「允许」或「允许所有」即可;嫌烦就直接 /mode yolo。
八、多项目管理
一个 cc-connect 进程可以同时管多个项目,每个项目用自己的工作目录和 Agent。在配置文件里加多个 [[projects]] 就行:
[[projects]]
name = "后端"
[projects.agent]
type = "claudecode"
[projects.agent.options]
work_dir = "~/projects/backend"
# ...平台配置
[[projects]]
name = "前端"
[projects.agent]
type = "codex"
[projects.agent.options]
work_dir = "~/projects/frontend"
# ...平台配置
聊天里用 /list 看有哪些项目,/switch 切换。
九、定时任务
可以用自然语言让机器人定时干活,比如「每天早上 8 点帮我看看 GitHub Trending」,它自动转成 cron 任务。底层对应命令:
cc-connect cron add "每天早上8点总结 GitHub Trending"
cc-connect cron list # 看所有任务
cc-connect cron del # 删一个
十、参考链接
- 仓库与文档:https://github.com/chenhg5/cc-connect
- 安装指引(INSTALL.md):https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md
- 各平台接入指南:仓库内
docs/与 README 的 Platform Setup Guides - npm 包:https://www.npmjs.com/package/cc-connect

浙公网安备 33010602011771号