Loading

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

ChatGPT Image 2026年7月25日 15_03_32

我的日常工作中已经深度依赖各种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:手动建飞书应用

  1. 飞书开放平台 创建一个企业自建应用,启用机器人能力。
  2. 开通权限:
    • contact:user.base:readonly(识别用户身份)
    • im:message.p2p_msg:readonly(读取私聊消息)
    • im:message:send_as_bot(机器人发消息)
  3. 事件订阅开启 im.message.receive_v1card.action.trigger,使用长连接接收事件(无需公网)。
  4. 发布应用,拿到 App IDApp Secret,填进上面的配置。
  5. 其他平台(钉钉、Telegram、Slack、Discord、QQ 等)流程类似,具体看仓库里的 Platform Setup Guides,多数同样是「建应用拿凭证 → 填配置」。

五、启动与测试

开一个新终端(千万别在 Claude Code 会话里启动,见第十节),直接运行:

cc-connect

看到日志里输出 connected,说明平台 WebSocket 已经连上。

去聊天软件里搜索你的机器人,发一条 /whoami 测试,能正常回复就成功了。


六、安全加固(别跳过)

扫码或建应用只是「能用了」,但默认下谁给机器人发消息都可能使唤你电脑。务必做两步:

  1. 权限模式选 default:每个动作都要你在手机上点确认。别选 bypassPermissions(那是 yolo 全自动,危险)。
  2. 限制可用用户:在配置或面板里把 admin_from 和平台 allowed_users 都填成你自己的用户 ID,这样只有你能跑高危命令,别人发的不认。

那「你的用户 ID」去哪查?先打开 Inject sender(注入发信人),重启 cc-connect,然后用飞书给机器人随便发一句,Agent 收到的消息会带上你的发信人 ID —— 让它回给你,或看 cc-connect 运行窗口打印的信息,把那串 ID 填回 admin_fromallowed_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    # 删一个

十、参考链接


posted @ 2026-08-10 17:54  拓荒者IT  阅读(16)  评论(0)    收藏  举报